项目介绍
DPanel 提供 Docker 容器、镜像和 Compose 项目的网页管理界面。下面介绍部署配置、群晖项目目录和启动步骤。挂载 Docker socket 后,面板能够管理宿主机上的容器,管理入口应限制访问范围。
services:
dpanel:
image: dpanel/dpanel:latest
container_name: dpanel
restart: unless-stopped
network_mode: bridge
ports:
- 9095:8080
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- /volume1/docker/dpanel/data:/dpanel
environment:
- APP_NAME=dpanel补充:部署与使用
配置与操作示例
精简版 Compose
只需要容器与项目管理时,可用官方 Lite 镜像,避免占用 NAS 的 80 和 443 端口:
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/dpanel/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/dpanel /volume1/docker/dpanel/data
cd /volume1/docker/dpanel
HALO_PREPARE
cd /volume1/docker/dpanel
services:
dpanel:
image: dpanel/dpanel:lite
environment:
APP_NAME: dpanel
ports:
- "8807:8080"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- /volume1/docker/dpanel/data:/dpanel
restart: unless-stopped
lite 是浮动发行通道;标准版还包含域名转发功能,不能认为只改标签就完成了端口规划。首次访问 http://NAS_IP:8807 后按初始化流程设置管理员,检查容器列表与所属项目。
Docker socket 让面板具备管理宿主容器的能力,所以先限制管理入口的访问,再接入已有项目。Compose 创建的业务应保留原项目文件,不让两个管理器同时改同一份配置。先用一个非关键测试容器验证启动、停止、日志和恢复操作,再处理正式服务。
启动与状态检查
在保存 compose.yaml 和所需 .env 的项目目录执行:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
config 用于检查配置,不会启动服务。示例使用上游浮动发行通道;长期运行可改为项目实际发布的固定标签或已记录的镜像摘要,不猜写版本号。日志中出现的初始密码和访问凭据仅在自己的终端查看。
常见问题
- 面板显示成功但应用不可用:还要查看应用端口、日志和依赖,不能只看容器运行状态。
- Docker socket 不是普通文件接口,挂载后意味着较高主机管理能力。
更新与备份
保存面板数据、项目定义与各应用数据,面板备份不能代替业务备份。
更新前记录当前镜像或仓库提交,停止会写入的任务并备份持久化数据;阅读版本迁移说明后再拉取并重建。数据库已经迁移时,回退还需要匹配的数据副本。需要暂时停服务可用 docker compose stop,不要把删除卷或清空数据目录当作更新步骤。