使用 Docker Compose 部署 Docker管理工具 DPanel

发表于 分类于
基于官方 Compose 示例，说明如何用 Docker Compose 拉起 DPanel 面板。

前言

如果你希望在单机或轻量服务器上用可视化方式管理 Docker 容器与 Compose 项目，DPanel 是一个常见选择。

官方同时提供 docker run 与 Compose 两种方式，后者更适合写入仓库、做多环境差异化。

下文以官方文档中的 Compose 片段为主线，说明标准版与 Lite 版的端口差异、数据持久化路径，以及在 Windows / macOS 下挂载 docker.sock 的注意点。

镜像标签与端口请以你部署时阅读的官方文档为准，按需替换。

官网

DPanel

前置条件

宿主机需要已安装 Docker Engine，并启用 Compose（docker compose 子命令）。
面板依赖访问 Docker 守护进程，因此必须把宿主机的 Docker socket 挂进容器。
规划一块磁盘目录用于持久化面板数据（下文示例用 /home/dpanel，请改成你的实际路径）。

实现

若使用阿里云镜像加速拉取，把 image 换成文档提供的 registry.cn-hangzhou.aliyuncs.com/dpanel/dpanel:latest 即可。

创建文件夹

1
2
3
mkdir -p /data/tools/docker-compose-root/compose-dpanel

cd /data/tools/docker-compose-root/compose-dpanel

docker-compose.yaml

1
2
3
4
5
6
7
8
9
10
11
12
13
services:
  dpanel:
    image: dpanel/dpanel:lite
    container_name: dpanel
    restart: always
    ports:
      - "8807:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/dpanel
      - /data/tools/docker-compose-root:/data/tools/docker-compose-root
    environment:
      - APP_NAME=dpanel

首次登录会跳转到账号密码设置页面，设置后就是登录页面。

注意

这里映射的 /data/tools/docker-compose-root，是因为管理页面的Compose会在容器内找配置文件，映射后才能正常找到。

我这里所有的compose启动的都在/data/tools/docker-compose-root这个文件夹下。

启动与访问

在项目目录执行下列命令即可完成后台启动。
启动成功后，用浏览器访问 http://宿主机IP:8807（若你改过端口映射，则改用对应主机端口）。

1
docker compose up -d

查看容器是否在跑，可用 docker compose ps 或 docker ps。