200字
【保姆级教程】Docker Compose + DPanel 面板一键安装指南
2025-12-18
2025-12-18

在折腾 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. 创建配置文件

使用 nanovim 创建一个 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% 是因为云厂商的防火墙没开端口。

  1. 云服务商安全组:登录阿里云/腾讯云/AWS 后台,找到“安全组”或“防火墙”规则,放行 TCP 端口 8807

  2. 系统防火墙 (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 文件重置(会丢失配置),或者通过命令行重置密码工具(需参考官方文档)。建议妥善保管密码。


评论