告别繁琐命令行!dPanel 一款极其轻量、优雅的 Docker 可视化管理面板部署全攻略

在容器化技术普及的今天,Docker 已经成了开发者和 NAS 玩家的标配。虽然 docker ps 命令很酷,但当容器数量突破两位数时,一个直观、响应迅速的可视化面板就显得尤为重要。

图片[1]-告别繁琐命令行!dPanel 一款极其轻量、优雅的 Docker 可视化管理面板部署全攻略-奇蛙小屋

今天小编要安利的是 dPanel。如果你觉得 Portainer 太重,或者不喜欢某些面板复杂的配置,那么 dPanel 绝对是你的“白月光”。它极简、高效,且完全基于 Docker 生态,是轻量化运维的不二之选。


🌟 为什么选择 dPanel?

dPanel 是一款专为简化 Docker 容器管理而生的开源面板。它不追求花哨的堆砌,而是直击痛点:

  • ⚡ 极简安装:一行命令,秒级启动。
  • 📊 实时监控:图形化展示容器 CPU、内存使用情况。
  • 📂 全能管理:支持镜像拉取、容器生命周期控制、网络管理及卷映射。
  • 📝 日志透视:内置实时日志查看器,排查错误不再痛苦。
  • 🏗️ Compose 支持:完美兼容 Docker Compose,复杂应用一键编排。

🛠️ 准备工作

在开始部署之前,请确保你的服务器或 NAS 已具备以下环境:

环境要求建议版本说明
操作系统Linux (Ubuntu/CentOS/Debian) / Synology / QNAP只要能跑 Docker 即可
Docker20.10.0+核心运行环境
Docker Compose2.0.0+推荐安装,方便管理
网络开放 8080 端口(默认端口,可自定义)

💾 部署方案汇总

dPanel 官方提供了多种部署方式,你可以根据自己的习惯选择最适合的一种。

方案一:使用 Docker (最快体验)

如果你想快速上手,直接执行以下指令:

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

标准版本中提供了域名绑定及证书功能,需要绑定 80 及 443 端口,如果你不需要这些功能,请使用 Lite 版。 Lite 版与标准版只有镜像地址区别,除不再需要映射 80 及 443 端口外,其余配置均一致。

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

Podman 与 Docker 命令兼容,将创建命令中的 docker 替换成 podman 运行即可,例如:

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

Podman 可以在非 root 用户下管理容器. 创建面板容器时,你需要先激活普通用户的 podman.sock 会话

systemctl --user enable --now podman.socket

将用户的 podman.sock 文件映射到面板容器的 /var/run/docker.sock 文件

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

💡 参数解析:

  • -v /var/run/docker.sock...:必选,让面板有权管理宿主机的 Docker。
  • -v /opt/dpanel:/dpanel:可选,持久化保存面板自身的配置文件。

方案二:使用 Docker Compose (推荐,易于维护)

这是最完整的部署方式,支持面板所有的代理与自动证书功能。

  1. 创建配置文件nano docker-compose.yml
  2. 填入以下内容
services:
  dpanel:
    # 标准版:dpanel/dpanel:latest | Debian版:dpanel/dpanel:latest-debian
    # 如果追求极简,可使用 Lite版:dpanel/dpanel:lite
    image: dpanel/dpanel:latest
    container_name: dpanel
    restart: always
    ports:
      - "80:80"          # 用于 HTTP 访问/证书挑战
      - "443:443"        # 用于 HTTPS 访问
      - "8807:8080"      # 自定义端口:通过 8807 访问面板管理界面
    environment:
      - APP_NAME=dpanel  # 重要:必须与 container_name 保持一致
      - TZ=Asia/Shanghai
      # 如果处于特殊网络环境,可在此配置代理
      - HTTP_PROXY=
      - HTTPS_PROXY=
      # 如果需要通过二级目录访问,请配置此项
      - DP_SYSTEM_BASEURL=
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      # 挂载面板数据,请将冒号前的路径修改为你的宿主机实际路径
      - /home/dpanel:/dpanel
      # 如果需要单独管理 Compose 文件,可以取消下方注释
      # - /opt/compose:/dpanel/compose
    extra_hosts:
      - "host.dpanel.local:host-gateway"
    logging:
      driver: "json-file"
      options:
        max-size: "5m"
        max-file: "10"

⚠️ 小编提醒: > * APP_NAME:官方强调该变量必须与 container_name 保持一致,否则可能会导致容器互联或管理逻辑异常。

  • 端口占用:如果你的服务器 80 或 443 端口已被 Nginx 占用,请修改冒号左侧的端口,或者切换到 Lite 版镜像(Lite 版仅需映射 8080 端口)。

💡 部署要点总结 (避坑指南)

配置项说明
镜像选择默认推荐 latest (Alpine);需要更好兼容性选 latest-debian;追求极致精简选 lite
存储映射请务必确保 /home/dpanel 目录有读写权限,否则配置无法保存。
Windows/macOS如果你在桌面端 Docker 部署,请将路径改为 //var/run/docker.sock
日志限制官方配置中默认限制了日志大小为 5MB,有效防止面板日志撑爆硬盘,非常贴心!

🎨 界面概览与初次使用

部署完成后,在浏览器输入 http://你的服务器IP:8080 即可进入管理界面。

  1. 初始化:首次进入无需复杂设置,面板会自动识别本地 Docker 守护进程。
  2. 仪表盘:一眼看清当前运行了多少容器,系统负载如何。
  3. 容器操作:点击容器名称,你可以直接在网页端进行 停止、重启、查看日志 甚至 进入终端 (Shell)

📝 总结与评价

优点 ✅

  • 轻量化:内存占用极低,即使在 1G 内存的 VPS 上也能流畅运行。
  • 响应快:UI 设计非常现代,操作几乎没有延迟。
  • 无侵入:它只是一个 Docker 的“皮肤”,删除面板不会影响你正在运行的任何容器。

缺点 ❌

  • 功能广度:相比 Portainer,在集群管理(Swarm/K8s)方面功能尚在完善中。
  • 权限控制:目前更适合个人或小团队使用,多租户权限细分较弱。

小编建议:如果你是个人开发者、NAS 玩家或小型服务器运维人员,dPanel 是目前市面上最平衡、最好用的轻量级面板之一。


🔗 项目资源

资源名称链接地址
GitHub 项目主页donknap/dpanel
官方文档dPanel Docs
小编推荐指数⭐⭐⭐⭐⭐ (5/5)
© 版权声明
THE END
喜欢就支持一下吧
点赞18 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容