NAS 与运维

Dockge:管理 Docker Compose 项目

  • 0 次阅读
  • 0 条评论
文章摘要

Dockge 围绕 Compose 文件管理应用栈,适合在网页中编辑、启动和查看项目日志。栈目录在宿主机与容器内保持相同路径是关键。 项目仍以 Compose 文件为基础,网页提供编辑、启动与日志入口。应用数据保留在各自挂载位置,面板主要负责项目管理。 适合已有多个 Compose 栈的家庭服务器。导入前确认工作目录与相对路径,避免在新位置创建另一份空数据。

项目介绍

Dockge 围绕 Compose 文件管理应用栈,适合在网页中编辑、启动和查看项目日志。栈目录在宿主机与容器内保持相同路径是关键。

项目仍以 Compose 文件为基础,网页提供编辑、启动与日志入口。应用数据保留在各自挂载位置,面板主要负责项目管理。

适合已有多个 Compose 栈的家庭服务器。导入前确认工作目录与相对路径,避免在新位置创建另一份空数据。

核心功能

功能 作用与使用方式
栈列表 集中查找项目
配置编辑 维护 Compose 文件
生命周期 启动停止和重建
日志观察 查看组件运行情况
目录管理 确认配置实际保存位置

功能示意

Dockge 功能示意图

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

Dockge 官方界面示例
项目官方界面示例,展示上游演示数据。

项目信息

项目 说明
类型 Docker
分类 NAS 与运维
项目仓库 louislam/dockge
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 在群晖创建 /volume1/docker/stacks 和 Dockge 独立目录,确认路径没有与现有项目冲突。
  2. 保存示例并启动,通过 NAS 的 5001 端口初始化管理员;若该端口由 DSM 等占用,修改左侧端口。
  3. 先导入一个测试项目,检查编辑后的文件实际写入位置,再逐个接入现有栈。

首次使用与操作检查

先导入无重要数据的测试栈,修改一个环境变量并重建,检查文件与实际容器一致。

接入旧项目先备份配置。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。只回退镜像不一定能回退已经迁移过的数据库。

参考资料