项目介绍
Dockge 围绕 Compose 文件管理应用栈,适合在网页中编辑、启动和查看项目日志。栈目录在宿主机与容器内保持相同路径是关键。
项目仍以 Compose 文件为基础,网页提供编辑、启动与日志入口。应用数据保留在各自挂载位置,面板主要负责项目管理。
适合已有多个 Compose 栈的家庭服务器。导入前确认工作目录与相对路径,避免在新位置创建另一份空数据。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 栈列表 | 集中查找项目 |
| 配置编辑 | 维护 Compose 文件 |
| 生命周期 | 启动停止和重建 |
| 日志观察 | 查看组件运行情况 |
| 目录管理 | 确认配置实际保存位置 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | NAS 与运维 |
| 项目仓库 | louislam/dockge |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 在群晖创建 /volume1/docker/stacks 和 Dockge 独立目录,确认路径没有与现有项目冲突。
- 保存示例并启动,通过 NAS 的 5001 端口初始化管理员;若该端口由 DSM 等占用,修改左侧端口。
- 先导入一个测试项目,检查编辑后的文件实际写入位置,再逐个接入现有栈。
首次使用与操作检查
先导入无重要数据的测试栈,修改一个环境变量并重建,检查文件与实际容器一致。
接入旧项目先备份配置。DSM 可能占用默认管理端口,只修改宿主端口;栈目录映射按官方要求保持一致。
Docker Compose
以下为整理后的配置示例。使用前替换目录、端口和凭据;浮动镜像标签会随上游变更,正式使用时应记录实际镜像摘要。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/dockge/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/dockge /volume1/docker/dockge/data /volume1/docker/stacks
cd /volume1/docker/dockge
HALO_PREPARE
cd /volume1/docker/dockge
services:
dockge:
image: louislam/dockge:1
restart: unless-stopped
ports:
- "5001:5001"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- /volume1/docker/dockge/data:/app/data
- /volume1/docker/stacks:/volume1/docker/stacks
environment:
DOCKGE_STACKS_DIR: /volume1/docker/stacks
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 挂载 Docker Socket 赋予管理容器的高权限,管理入口只对可信用户开放。
- /volume1/docker/stacks 两侧路径必须一致;其他卷需要同时修改挂载与环境变量。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
备份 Dockge 的 data 和各个栈目录,各应用的挂载数据仍需单独备份。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。