smied/hestia-cp

开源控制面板 Docker 镜像文档

镜像概述

本镜像为开源控制面板的容器化版本，旨在简化服务器管理流程，整合多服务配置、系统监控、用户权限控制等核心功能。通过容器化部署，可快速搭建轻量、可扩展的服务器管理平台，降低传统服务器配置的复杂度，适用于不同规模的服务器运维需求。

核心功能与特性

核心功能

• 多服务管理：支持Web服务器（Nginx/Apache）、数据库（MySQL/PostgreSQL）、FTP等常用服务的一键配置与启停
• 系统监控：实时展示CPU、内存、磁盘IO、网络流量等服务器资源使用状态
• 用户权限控制：基于角色的访问控制（RBAC），支持多用户管理及权限细分
• 配置备份与恢复：自动/手动备份服务配置文件，支持一键恢复历史配置
• 日志集中管理：整合各服务日志，提供检索与分析功能

特性优势

• 开源免费：基于MIT协议开源，无商业许可限制
• 轻量部署：容器化设计，最小化依赖，支持单机/集群部署
• 界面友好：Web图形化界面，无需命令行操作即可完成复杂配置
• 跨平台兼容：支持Linux x86_64/ARM架构，兼容主流Docker环境
• 社区支持：活跃的开源社区，提供持续更新与问题解决方案

使用场景与适用范围

适用场景

• 个人开发者：快速搭建与管理个人服务器（如博客、测试环境）
• 小型企业：简化IT基础设施维护，降低运维人员学习成本
• 多服务器集群：通过统一界面管理分布式服务器节点
• 临时环境部署：快速创建隔离的测试/演示环境，用完即删

硬件要求

• 最低配置：1核CPU、2GB内存、10GB磁盘空间
• 推荐配置：2核CPU、4GB内存、20GB SSD磁盘

使用方法与配置说明

快速启动（docker run）

bash
docker run -d \
  --name open-source-control-panel \
  -p 8080:80 \  # 宿主机端口映射（根据需求调整）
  -v /opt/control-panel/data:/app/data \  # 数据持久化卷
  -v /opt/control-panel/logs:/app/logs \  # 日志存储卷
  -e ADMIN_USER=admin \  # 管理员用户名（默认：admin）
  -e ADMIN_PASSWORD=SecurePass123! \  # 管理员密码（建议自定义）
  --restart unless-stopped \
  open-source-control-panel:latest

访问方式

容器启动后，通过浏览器访问 http://宿主机IP:8080，使用配置的管理员账号密码登录。首次登录需完成初始化向导（如设置时区、更新系统组件）。

Docker Compose 部署（推荐）

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  control-panel:
    image: open-source-control-panel:latest
    container_name: control-panel
    ports:
      - "8080:80"
    volumes:
      - ./data:/app/data
      - ./logs:/app/logs
    environment:
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=SecurePass123!
      - TZ=Asia/Shanghai  # 设置时区
    restart: unless-stopped

启动命令：docker-compose up -d

配置参数说明

环境变量

持久化配置

• 数据卷挂载：必须挂载 /app/data 目录以持久化配置文件、用户数据等；建议挂载 /app/logs 目录保存日志
• 备份策略：定期备份宿主机挂载目录（如 /opt/control-panel/data），避免数据丢失

注意事项

1. 生产环境需修改默认管理员密码，并启用HTTPS（可通过反向代理配置Nginx+SSL）
2. 容器启动后首次登录需完成安全初始化（如禁用默认用户、更新系统组件）
3. 高负载场景下建议调整宿主机资源限制（通过 --memory --cpus 参数）
4. 如需外部访问，需开放宿主机对应端口的防火墙规则（如 ufw allow 8080/tcp）