在折腾 VPS、NAS 或者家庭服务器时,我们经常需要管理各种 Docker 容器。虽然命令行(CLI)很酷,但对于日常监控、日志查看和快速部署,一个好用的可视化面板是必不可少的。
今天我们要介绍的是 DPanel(并不是 1Panel,虽然名字很像)。DPanel 是一款国人开发、主打轻量化的 Docker 管理面板。相比 Portainer,它的界面更符合国人使用习惯,资源占用极低(内存仅需 ~20M),非常适合配置不高的服务器。
本教程将手把手教您如何一键安装 Docker 环境并部署 DPanel。
📋 准备工作
在开始之前,请确保您拥有以下环境:
一台 Linux 服务器/VPS(推荐系统:Debian 11/12, Ubuntu 20.04/22.04/24.04, 或 CentOS 7+)。
Root 权限(或者拥有 sudo 权限的用户)。
SSH 客户端(如 Termius, Xshell, 或者系统自带终端)。
🚀 第一步:一键安装 Docker & Docker Compose
Docker 是 DPanel 运行的基础。如果您的服务器是全新的,请务必先执行此步骤。我们将使用 Docker 官方的一键安装脚本,这是最安全、最稳定的方法。
1. 更新系统软件包
为了防止安装过程中报错,首先更新系统的软件源。
Bash
# Debian / Ubuntu 用户执行:
apt update && apt upgrade -y
# CentOS / Rocky Linux 用户执行:
yum update -y
2. 执行 Docker 一键安装脚本
复制并运行以下命令,该脚本会自动识别您的系统并安装最新版的 Docker Engine 和 Docker Compose 插件。
Bash
curl -fsSL https://get.docker.com | bash
3. 启动并设置开机自启
安装完成后,执行以下命令确保 Docker 正在运行并会在重启后自动启动:
Bash
systemctl start docker
systemctl enable docker
4. 验证安装
检查 Docker 和 Compose 是否安装成功:
Bash
docker --version
docker compose version
如果能看到版本号输出(例如 Docker version 27.x.x),说明环境准备完毕!
🛠️ 第二步:安装 DPanel 面板 (最推荐的 Compose 方式)
虽然 DPanel 也有官方的一键脚本,但我强烈建议使用 Docker Compose 方式安装。为什么?因为以后如果您需要升级、修改端口或者迁移数据,保留一个 docker-compose.yml 文件比记住一串复杂的命令要方便得多。
1. 创建安装目录
为了文件整洁,我们在 /opt 目录下创建一个专门的文件夹:
Bash
mkdir -p /opt/dpanel
cd /opt/dpanel
2. 创建配置文件
使用 nano 或 vim 创建一个 docker-compose.yml 文件:
Bash
nano docker-compose.yml
将以下内容完整复制并粘贴进去:
YAML
services:
dpanel:
image: dpanel/dpanel:lite # 使用 lite 版本,轻量且专注于容器管理
container_name: dpanel
restart: unless-stopped
ports:
- "8807:8080" # 左边的 8807 是您访问面板的端口,可根据需要修改
environment:
- APP_NAME=dpanel
volumes:
- /var/run/docker.sock:/var/run/docker.sock # 必须挂载,否则无法管理 Docker
- ./data:/dpanel # 将面板数据挂载到当前目录的 data 文件夹,防丢失
📝 进阶说明:
Image 选择:
dpanel/dpanel:lite是轻量版,不包含域名转发(Nginx)功能,适合纯粹作为 Docker 管理器使用。如果您需要 DPanel 自带的域名反代功能,请改用dpanel/dpanel:latest并增加- "80:80"和- "443:443"的端口映射。端口:默认通过
8807访问。如果该端口被占用,请修改冒号左边的数字(例如"9999:8080")。
按 Ctrl + O 保存,然后按 Enter 确认,最后按 Ctrl + X 退出编辑器。
3. 启动 DPanel
在当前目录下(/opt/dpanel)执行启动命令:
Bash
docker compose up -d
当您看到 [+] Running 1/1 ... Container dpanel Started 时,恭喜您,安装成功!
🔌 第三步:防火墙设置 (关键步骤)
很多同学安装完打不开,99% 是因为云厂商的防火墙没开端口。
云服务商安全组:登录阿里云/腾讯云/AWS 后台,找到“安全组”或“防火墙”规则,放行 TCP 端口 8807。
系统防火墙 (UFW/Firewalld):
如果您使用 Ubuntu (UFW):
Bash
ufw allow 8807/tcp ufw reload如果您使用 CentOS (Firewalld):
Bash
firewall-cmd --zone=public --add-port=8807/tcp --permanent firewall-cmd --reload
💻 第四步:初始化与使用
1. 访问面板
打开浏览器,输入您的服务器 IP 加上端口号: http://您的服务器IP:8807
2. 创建管理员账户
第一次访问时,系统会要求您创建一个管理员账号。
用户名:设置您的用户名
密码:设置强密码
3. 开始管理
登录后 ,您将看到简洁的仪表盘。
概览:查看 CPU、内存使用率。
容器:在这里可以一键 停止/重启/删除 容器,也可以查看实时日志(Log)。
镜像:管理本地下载的 Docker 镜像。
文件:DPanel 提供了一个非常方便的文件管理器,可以直接浏览和修改容器内的文件(这对于修改配置极其好用!)。
💡 常见问题 (FAQ)
Q: 为什么我安装的是 Lite 版?标准版有什么区别? A: Lite 版去掉了内置的 Nginx 域名转发功能,体积更小,不占用 80/443 端口,更适合已经有独立网关(如 Nginx Proxy Manager)的用户。如果您希望 DPanel 帮您自动管理域名 HTTPS 证书,可以使用标准版。
Q: 如何更新 DPanel? A: 非常简单,进入安装目录执行两行命令即可:
Bash
cd /opt/dpanel
docker compose pull && docker compose up -d
Q: 忘记密码怎么办? A: 可以通过删除数据卷中的 dpanel.db 文件重置(会丢失配置),或者通过命令行重置密码工具(需参考官方文档)。建议妥善保管密码。