🚀 使用 Docker Compose 部署 DPanel（Docker 可视化管理面板）

🚀 使用 Docker Compose 部署 DPanel

本文将详细介绍如何使用 Docker Compose 部署 DPanel——一款功能强大的国产 Docker 可视化管理系统。它通过友好的 Web 界面，让您能够轻松管理 Docker 容器、镜像和资源，无需记忆复杂的命令行指令。

📝 项目简介

DPanel 是一款专为 Docker 设计的可视化面板系统，提供完善的 Docker 管理功能。它通过直观的图形界面，显著降低了 Docker 的管理门槛，特别适合新手用户和日常运维管理。

核心特点：

全中文界面：专为中文用户设计，操作更符合国内用户习惯
轻量级设计：资源占用极少，适合各种 Nas 设备及小型服务器
功能全面：支持容器管理、镜像管理、文件浏览、Compose 项目管理等核心功能
安全可靠：运行在容器内部，对宿主机没有依赖及侵入
多服务器管理：支持远程管理其他服务器的 Docker 环境

🔧 部署前准备

系统环境要求

操作系统：支持 Linux、Windows、macOS
Docker 引擎：版本 20.10+
Docker Compose：版本 2.0+
硬件资源：
内存：至少 512MB
存储空间：至少 1GB 可用空间

环境检查

检查 Docker 服务状态 bash systemctl status docker 确保 Docker 服务处于 active (running) 状态
检查 Docker 版本 bash docker --version
检查 Docker Compose 版本 bash docker compose version 确保版本为 2.0 以上

⚙️ 配置 Docker Compose

准备配置文件

创建 docker-compose.yml 文件：

services:
  dpanel:
    # DPanel 官方最新镜像（自动获取最新功能，稳定版可指定版本号，如 dpanel/dpanel:v1.0）
    image: dpanel/dpanel:latest
    container_name: dpanel   # 容器名称（核心！需与下方 APP_NAME 完全一致）
    restart: always  # 容器退出后自动重启，保障面板服务稳定
    ports:
      - 180:80    # HTTP 端口映射：主机 180 → 容器 80（Web 访问入口）
      - 1443:443  # HTTPS 端口映射：主机 1443 → 容器 443（加密访问入口）
      - 8807:8080 # 面板管理端口映射：主机 8807 → 容器 8080（核心功能端口）
    environment:
      APP_NAME: dpanel # 应用名称（必须与 container_name 一致！否则面板无法正常识别容器）
    volumes:
      # 1. Docker 管理依赖：挂载宿主机 docker.sock，让 DPanel 控制本地 Docker
      - /var/run/docker.sock:/var/run/docker.sock
      # 2. 数据持久化：本地 /home/dpanel → 容器 /dpanel（存储面板配置、Docker 数据）
      - /home/dpanel:/dpanel # 将 /home/dpanel 更改为你想要挂载的宿主机目录

关键配置说明

镜像选择：
标准版：dpanel/dpanel:latest（包含域名转发和 HTTPS 功能）
Lite版：dpanel/dpanel:lite（不包含域名转发功能）
端口映射：
180:80：HTTP 访问端口（标准版专用）
1443:443：HTTPS 访问端口（标准版专用）
8807:8080：Web 管理界面端口
数据持久化：
/var/run/docker.sock:/var/run/docker.sock：用于与 Docker 守护进程通信
/home/dpanel:/dpanel：DPanel 数据目录，可自定义宿主机目录
环境变量：
APP_NAME：必须与 container_name 保持一致
可选：INSTALL_USERNAME 和 INSTALL_PASSWORD 预设登录凭证

版本选择建议

版本类型	适用场景	特点
标准版	需要域名绑定和 HTTPS 证书	内置 nginx 及 acme.sh 组件
Lite版	已有反向代理或简单使用	更轻量，不包含域名转发功能

🚀 启动与验证

启动服务

docker compose up -d

验证服务状态

检查容器运行状态 bash docker compose ps 应该看到 dpanel 服务处于 Up 状态
查看服务日志 bash docker compose logs -f
访问 Web 界面 在浏览器中访问 http://你的服务器IP:8807

初始设置

首次访问会显示初始化界面： - 创建管理员账号和密码 - 或使用预设凭证（如配置了 INSTALL_USERNAME 和 INSTALL_PASSWORD）

（2）获取首次登录信息

DPanel 首次启动会生成默认账号密码，需从日志中获取：

# 筛选日志中的账号密码（关键词：username、password、账号、密码）
docker compose logs dpanel | grep -E 'username|password|账号|密码'

示例输出（不同版本可能略有差异）：

    dpanel  | 默认账号：admin
    dpanel  | 默认密码：dpanel123

（3）访问 DPanel Web 界面

打开浏览器，输入 http://服务器IP:180 或 https://服务器IP:1443（如本地测试：http://localhost:180）；
输入日志中获取的 “默认账号” 和 “默认密码”，点击「登录」；
登录后进入 DPanel 主界面（显示 Docker 容器列表、镜像列表），说明部署成功。

🔌 基础配置与使用

系统概览

登录后进入概览页面，可以查看： - 宿主机基本信息（CPU、内存、磁盘使用情况） - Docker 运行状态统计 - 容器数量、镜像数量等用量统计

容器管理

DPanel 提供完善的容器管理功能： - 创建/修改容器：支持基本配置、环境变量、存储配置等 - 生命周期管理：启动、停止、重启、删除容器 - 实时监控：查看容器状态、日志和资源使用情况

文件管理

内置文件浏览器功能： - 浏览容器内部文件系统 - 在线编辑配置文件 - 上传下载文件

Compose 项目管理

支持多种方式的 Compose 管理： - 通过文本、远程地址、挂载目录添加 docker-compose.yml - 可视化部署和管理多容器应用 - 应用商店功能，快速部署常用应用

🔌 基础配置与使用2

DPanel 界面简洁，新手可从 “核心功能试用” 入手，快速掌握 Docker 管理：

1. 步骤 1：修改默认密码（安全必做）

首次登录后需立即修改默认密码，避免被未授权访问：

点击界面右上角「个人中心」（或「设置」图标）；
找到「密码修改」选项，输入旧密码（如 dpanel123），设置新密码（建议包含字母 + 数字 + 符号，如 DPanel@2024!）；
点击「保存」，下次登录需使用新密码。

2. 步骤 2：管理 Docker 容器（核心功能）

以 “启动 / 停止容器” 为例，操作流程：

左侧菜单栏点击「容器管理」，界面会显示宿主机所有 Docker 容器（包括 DPanel 自身）；
找到目标容器（如 nginx），点击右侧「启动」/「停止」按钮，无需执行 docker start/stop 命令；
点击「日志」可查看容器实时输出，点击「进入容器」可打开终端（类似 docker exec -it）。

3. 步骤 3：部署新容器（以 Nginx 为例）

通过面板可视化部署容器，无需编写 docker run 命令：

左侧菜单栏点击「容器管理」→「创建容器」；
填写关键参数（按界面提示）：
- 镜像名称：nginx:latest；
- 容器名称：my-nginx；
- 端口映射：主机 8081 → 容器 80；
- 数据挂载（可选）：主机 ./nginx/html → 容器 /usr/share/nginx/html；
点击「创建」，DPanel 会自动拉取镜像并启动容器，完成后在「容器管理」中可看到新容器。

4. 步骤 4：查看 Docker 系统信息

在「仪表盘」界面可实时查看：

资源监控：宿主机 CPU、内存、磁盘使用率；
Docker 状态：容器总数、运行中容器数、镜像数、数据卷数；
最近操作日志：容器启动 / 停止、镜像拉取等操作记录。

🛠️ 维护与管理

日常维护操作

1.服务启停

   # 停止服务
   docker compose down

   # 启动服务
   docker compose up -d

2.数据备份

   # 备份 DPanel 数据目录
   tar -czf dpanel-backup-$(date +%Y%m%d).tar.gz /home/dpanel

3.服务更新

   # 进入部署目录
   cd /path/to/dpanel

   # 拉取最新镜像并重启
   docker compose pull
   docker compose down
   docker compose up -d

监控与日志

查看实时日志 bash docker compose logs -f
资源监控
通过 DPanel 概览页面监控系统资源
定期检查磁盘使用情况，避免存储空间不足

🐛 常见问题排查

1. 无法访问 Web 界面

问题现象：浏览器访问 http://IP:8807 无响应

解决方案： - 检查防火墙设置，确保端口已开放 - 验证容器状态：docker compose ps - 查看服务日志：docker compose logs

2. 文件管理功能加载缓慢

问题现象：首次打开文件管理时加载很慢

解决方案： - 这是正常现象，系统在首次使用时需要初始化文件浏览器组件 - 可以考虑预部署文件浏览器容器

3. 用量统计显示异常

问题现象：用量统计页面显示超时或数据不准确

解决方案： - 检查磁盘访问权限 - 确认 /var/run/docker.sock 挂载正确 - 查看详细错误日志

4. 容器名称与 APP_NAME 不匹配

问题现象：DPanel 功能异常或无法启动

解决方案： - 确保 container_name 与 APP_NAME 环境变量值完全一致 - 重新创建容器并保持名称一致

5. 域名转发功能异常

问题现象：标准版的域名绑定和 HTTPS 证书功能不正常

解决方案： - 确认使用标准版镜像 - 检查 80 和 443 端口映射是否正确 - 或改用 Lite 版配合外部反向代理

通过本教程，您应该已经成功部署并配置了 DPanel 可视化管理面板。DPanel 的直观界面和丰富功能将极大提升您的 Docker 管理效率，让容器运维变得更加简单高效。如果在使用过程中遇到其他问题，可以参考 DPanel 官方文档或社区支持资源。

🐛 常见问题排查2

1. Web 界面无法访问（ERR_CONNECTION_REFUSED）

原因 1：端口未开放或容器未启动。解决：
1. 检查容器状态：docker compose ps，确保 dpanel 状态为 Up；
2. 重新开放端口：sudo ufw allow 180/tcp && sudo ufw allow 1443/tcp && sudo ufw allow 8807/tcp；
3. 云服务器需在安全组中添加对应端口规则。
4. 原因 2：HTTPS 证书未生成（首次启动未完成）。解决：等待 1-2 分钟，HTTPS 证书需时间自动生成，或暂时用 HTTP 端口（180）访问。

2. 无法管理 Docker 容器（提示 “Docker 连接失败”）

原因 1：docker.sock 挂载错误或权限不足。解决：
1. 确认配置中 volumes 包含 - /var/run/docker.sock:/var/run/docker.sock；
2. 重新赋予权限：sudo chmod 666 /var/run/docker.sock；
3. 重启 DPanel 容器：docker compose restart。
4. 原因 2：Docker 服务未启动。解决：启动 Docker 服务：sudo systemctl start docker。

3. 忘记登录密码（无法进入面板）

原因：修改后忘记密码，或默认密码丢失。
解决：通过容器命令行重置密码（需先停止容器）：

    # 1. 停止 DPanel 容器
    docker compose down

    # 2. 删除密码配置文件（重置为默认密码，不同版本路径可能不同）
    sudo rm -rf /home/dpanel/config/password.json

    # 3. 重启容器，重新获取默认密码
    docker compose up -d
    # 4. 查看新默认密码
    docker compose logs dpanel | grep -E '密码|password'

4. 容器启动后，面板显示 “Docker 版本不兼容”

原因：DPanel 版本与宿主机 Docker 版本不匹配（如 DPanel 要求 Docker ≥ 20.10，宿主机版本过低）。
解决：
1. 查看宿主机 Docker 版本：docker --version；
2. 升级 Docker 到最新版本（参考 Docker 官方升级指南）；
3. 重启 DPanel 容器：docker compose restart。

通过以上步骤，新手可快速搭建 DPanel 并实现 Docker 可视化管理，无需记忆复杂命令。DPanel 适合个人学习、家庭服务器运维，如需探索更多高级功能（如多用户权限、远程 Docker 管理），可参考 DPanel 官方文档（通常在面板「帮助中心」可找到）。