openpanel/openpanel-ui

OpenPanel UI Docker镜像文档

镜像概述

OpenPanel UI Docker镜像是OpenPanel开源服务器管理面板的容器化部署版本，旨在通过容器化技术简化服务器管理流程。该镜像提供直观的Web管理界面，支持对服务器资源、网站、数据库、SSL证书及系统服务进行集中管理与配置，适用于个人开发者、小型团队及企业用户的服务器运维场景。

核心功能与特性

• 直观Web管理界面：提供图形化操作界面，无需复杂命令即可完成服务器配置与管理
• 多服务支持：集成网站（Nginx/Apache）、数据库（MySQL/PostgreSQL）、FTP等服务的管理功能
• SSL证书自动化：支持Let's Encrypt证书自动申请、部署与续期
• 容器化优势：独立于宿主环境，部署快速、升级便捷，降低环境依赖冲突
• 资源监控：实时展示服务器CPU、内存、磁盘及网络资源使用情况
• 用户权限管理：支持多用户角色配置，实现精细化权限控制

使用场景与适用范围

• 个人服务器管理：适用于个人开发者管理VPS或独立服务器，简化网站部署与维护
• 小型团队运维：支持团队协作管理多台服务器，统一配置与监控
• 开发测试环境：快速搭建隔离的服务器管理环境，用于功能测试与流程验证
• 生产环境部署：通过容器化确保环境一致性，提升部署稳定性与可维护性

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本）及Docker Compose（可选）
• 服务器开放80/443端口（Web访问）及面板管理端口（默认8080，可自定义）

快速启动

通过以下命令快速部署OpenPanel UI容器：

bash
docker run -d \
  --name openpanel-ui \
  -p 8080:8080 \
  -v /var/openpanel:/data \
  -e ADMIN_USER=admin \
  -e ADMIN_PASSWORD=your_secure_password \
  openpanel/ui:latest

参数说明

端口映射

• -p 8080:8080：将容器内面板Web端口（8080）映射至宿主服务器端口，可根据需求修改宿主端口（如 -p 8888:8080）

数据持久化

• -v /var/openpanel:/data：挂载宿主目录/var/openpanel至容器内/data目录，用于持久化存储配置文件、日志及数据

环境变量配置

Docker Compose配置示例

创建docker-compose.yml文件，简化多容器协同部署：

yaml
version: '3.8'
services:
  openpanel-ui:
    image: openpanel/ui:latest
    container_name: openpanel-ui
    ports:
      - "8080:8080"
    volumes:
      - /var/openpanel:/data
      - /var/run/docker.sock:/var/run/docker.sock  # 允许管理宿主机Docker服务
    environment:
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=SecurePass123!
      - SSL_ENABLED=true
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问与初始化

部署完成后，通过浏览器访问 http://<服务器IP>:8080，使用配置的管理员账户登录，根据引导完成初始化设置（如语言选择、服务器基础配置等）。

注意事项

• 数据备份：定期备份/var/openpanel目录，避免配置与数据丢失
• 安全加固：建议修改默认管理员密码，通过环境变量ADMIN_PASSWORD设置强密码
• 端口安全：生产环境中建议通过防火墙限制面板访问IP，或启用SSL（SSL_ENABLED=true）并仅允许HTTPS访问
• 版本更新：通过docker pull openpanel/ui:latest获取最新镜像，重新部署容器以更新面板功能

参考链接

• 官方文档：[***]
• GitHub仓库：https://github.com/openpanel