一、Dpanel 简介

Dpanel 是一款国产 Docker 可视化面板系统，提供较为完善的 Docker 管理功能，适合个人开发者及中小规模服务器使用。

主要支持以下功能：

• 查看 Docker 基本信息
• 运行状态统计
• 网络统计
• 磁盘统计
• 用量统计

二、主要功能模块

1. 容器管理

支持以下操作：

• 创建 / 修改容器
• 基本配置
• 环境变量配置
• 关联配置
• 存储配置
• 运行配置
• 资源配置

同时还支持：

• 计划任务
• 容器备份

2. Compose 管理

支持 Docker Compose 的可视化管理与部署。

3. 镜像与仓库管理

支持镜像管理、仓库管理等常见操作。

4. 存储与网络管理

支持 Docker 存储卷及网络的统一管理。

三、安装前准备

在安装 Dpanel 之前，请确保服务器或本地环境已正确安装 Docker。

1. 检查 Docker 是否已安装

docker -v

如果能正常输出 Docker 版本号，说明 Docker 已安装，可以直接跳过 Docker 安装步骤。

2. 安装 Docker

如果没有安装 Docker 请先参考下面的教程安装。

使用 Docker 官方便捷脚本安装 Docker Engine 教程

Debian 与 Ubuntu 上 Docker Engine 安装超详细教程

四、安装教程

注意事项：

创建面板容器时，请根据实际情况修改映射端口。
面板不能绑定 host 网络（请勿使用 –network host 参数）！

默认版本中提供了域名绑定及 HTTPS 证书功能，需要绑定 80 和 443 端口。
如果你不需要这些功能，可以选择安装 Lite 版。

1. 标准版安装（包含域名与 HTTPS 功能）

执行以下命令即可快速完成安装：

docker run -it -d --name dpanel --restart=always \
 -p 80:80 -p 443:443 -p 8807:8080 \
 -v /var/run/docker.sock:/var/run/docker.sock \
 -v dpanel:/dpanel -e APP_NAME=dpanel dpanel/dpanel:latest

2. Lite 版安装（不包含域名转发功能）

docker run -it -d --name dpanel --restart=always \
 -p 8807:8080 -e APP_NAME=dpanel \
 -v /var/run/docker.sock:/var/run/docker.sock \
 -v dpanel:/dpanel dpanel/dpanel:lite

五、首次登录说明

首次登录前，需要先创建面板的账号和密码。

六、忘记密码的处理方式

如果忘记密码，可以通过以下方式重置。

1. 进入容器

docker exec -it dpanel /bin/sh

2. 重置密码

/app/server/dpanel -f /app/server/config.yaml user:reset --password 123456

3. 重置用户名（同时设置密码）

/app/server/dpanel -f /app/server/config.yaml user:reset --password 123456 --username root

七、无法访问面板时的排查

如果 Dpanel 容器已正常运行，但浏览器无法访问面板，大多数情况下是端口未放行导致的。

1. 确认容器是否正常运行

docker ps

确认 dpanel 容器状态为 Up。

2. 确认端口映射是否正确

docker port dpanel

或：

docker ps

查看是否包含如下端口映射（示例）：

• Lite 版：8807 -> 8080
• 标准版：80 -> 80、443 -> 443、8807 -> 8080

3. 放行服务器防火墙端口（一定要注意）

（1）使用 firewalld（CentOS / Rocky / AlmaLinux）

firewall-cmd --permanent --add-port=8807/tcp
firewall-cmd --reload

如果是标准版，还需要放行：

firewall-cmd --permanent --add-port=80/tcp
firewall-cmd --permanent --add-port=443/tcp
firewall-cmd --reload

（2）使用 ufw（Ubuntu / Debian）

ufw allow 8807/tcp

标准版需要额外放行：

ufw allow 80/tcp
ufw allow 443/tcp

查看防火墙状态：

ufw status

（3）云服务器安全组（阿里云 / 腾讯云 / 华为云等）

如果你使用的是云服务器，还需要在云平台控制台的安全组中放行对应端口：

• Lite 版：8807
• 标准版：80、443、8807

转载声明：

转载此文章请注明出处。

若本文内容侵犯了您的权益，请通过本站下方邮箱与我联系，我会尽快处理，谢谢！