cmcooper1980/dockge

Dockge

基于 louislam/dockge 的分支版本，Dockge 是一个美观易用、响应式的自托管 Docker Compose 栈管理器，已合并多个实用拉取请求，提供直观的界面用于管理 Docker Compose 栈，适合自托管用户高效管理容器化应用。

!GitHub Repo stars !Docker Pulls !Docker Image Version (latest semver) !GitHub last commit (branch)

可用架构

核心功能与特性

主要功能

• 🧑‍💼 管理 compose.yaml 文件：支持创建、编辑、启动、停止、重启、删除，以及更新 Docker 镜像
• ⌨️ 交互式 compose.yaml 编辑器：提供直观的编辑界面
• 🦦 交互式 Web 终端：支持容器内命令行操作，含剪贴板复制粘贴功能
• 🕷️ 多代理支持（1.4.0+）：可在单一界面管理来自不同 Docker 主机的多个栈
• 🏪 命令转换：将 docker run ... 命令转换为 compose.yaml 文件
• 📙 基于文件的结构：compose 文件存储在本地磁盘，可通过常规 docker compose 命令交互
• 🚄 响应式设计：所有操作（拉取/启动/停止进度、终端输出）实时响应
• 🐣 易用美观的 UI：延续 Uptime Kuma 的优秀 UI/UX 设计风格
• 🎨 主题设置：支持主题切换
• 📊 资源使用统计：显示容器资源占用情况
• 🔄 批量更新：提供"全部更新"按钮

已合并的拉取请求

• PR #387：Global.env 编辑器及在 Docker 操作中的使用（作者：syko9000）
• PR #414：设置/更新友好名称（作者：lohrbini）
• PR #575：设置中启用主题选项（作者：CampaniaGuy）
• PR #582：移除终端缓冲区日志输出到控制台（作者：black-dragon74）
• PR #593：按代理对栈进行分组（作者：ESPGranEdu）
• PR #634：Docker 构建期间构建前端（作者：Jamie-）
• PR #637：实现终端左右键导航（作者：lukasondrejka）
• PR #649：添加容器控制按钮（作者：mizady）
• PR #700：添加资源使用统计（作者：justwiebe）
• PR #714：条件性栈文件删除（作者：husa）
• PR #724：删除失败时添加强制删除按钮（作者：DomiiBunn）
• PR #730：添加"全部更新"按钮（作者：DomiiBunn）
• PR #785：添加 Cloudflare Turnstile 验证码（作者：Kambaa）
• PR #786：使用 Codemirror 替换编辑器（作者：andersmmg）
• PR #800：改进使用代理时的栈列表 UI（作者：maca134，含 Dracrius 的 QOL 提交）
• PR #813：修复"已退出"状态显示（作者：Aymendje）
• PR #822：为终端组件添加剪贴板复制粘贴支持（作者：Dimariqe）
• PR #827：全屏 yaml 编辑器（作者：Joshua-Beatty）
• PR #834：更新过程中添加镜像清理（作者：MazziaRick）
• PR #863：添加 Docker 镜像管理功能（作者：felix068，当前位于 feature/image-management 分支，对应 Docker 标签 image-management）
• 提交 fc96f4e（作者：Dracrius）：切换为按钮组并匹配现有 UI 风格，修复服务消息输出空格，添加处理状态和启动/停止/重启事件
• 提交 789f25a（作者：Dracrius）：仅单个容器时隐藏容器控制按钮

使用场景与适用范围

• 自托管服务器用户：需要集中管理多个 Docker Compose 应用栈的个人或小型团队
• Docker 初学者：通过直观 UI 降低 Docker Compose 管理难度
• 多主机环境管理者：通过多代理功能在单一界面管理不同主机上的容器栈
• 注重 UI/UX 的用户：偏好美观、响应式界面的用户（尤其喜欢 Uptime Kuma 风格）
• 需要终端交互的场景：通过 Web 终端直接操作容器，无需 SSH 登录主机
• 安全需求较高的场景：可启用 Cloudflare Turnstile 验证码增强安全性

安装与使用指南

系统要求

• Docker/Podman：Docker 20+ 或 Podman（Podman 用户需安装 podman-docker，Debian 系统可通过 apt install podman-docker 安装）
• 操作系统：
  • ✅ 支持的 Linux 发行版：Ubuntu、Debian（Bullseye 或更新版本）、Raspbian（Bullseye 或更新版本）、CentOS、Fedora、ArchLinux
  • ❌ 不支持：Debian/Raspbian Buster 或更低版本、Windows（计划后续支持）
• 架构：armv7、arm64、amd64（x86_64）

基本安装步骤

默认栈目录：/opt/stacks，默认端口：5001

bash
# 创建存储栈和 Dockge 配置的目录
mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge

# 下载 compose.yaml
curl https://raw.githubusercontent.com/cmcooper1980/dockge/master/compose.yaml --output compose.yaml

# 启动服务
docker compose up -d

# 若使用 docker-compose V1 或 Podman
# docker-compose up -d

服务启动后，通过 http://localhost:5001 访问 Dockge。

高级安装（自定义端口和路径）

如需自定义端口或栈目录，可通过以下方式生成 compose.yaml 文件：

bash
# 替换 5001 为自定义端口，/opt/stacks 为自定义栈目录
curl "https://dockge.kuma.pet/compose.yaml?port=5001&stacksPath=/opt/stacks" --output compose.yaml

下载后，需将镜像从 louislam/dockge:1 修改为 cmcooper1980/dockge。

也可使用交互式 compose.yaml 生成器：[***]

更新方法

bash
cd /opt/dockge
docker compose pull && docker compose up -d

Docker Compose 配置示例

以下是适用于 docker compose up -d 的配置文件（修改 [CONFIG_LOCATION_FOR_DOCKGE] 为实际配置路径）：

yaml
services:
  dockge:
    image: cmcooper1980/dockge:latest
    container_name: dockge
    restart: unless-stopped
    environment:
      # 指定栈目录（必须与挂载卷的源路径和目标路径一致）
      DOCKGE_STACKS_DIR: /opt/stacks
      # 取消注释并输入有效的 Cloudflare Turnstile 密钥以启用验证码
      # 注意：仅在主实例上启用 Turnstile（如使用远程代理），否则远程代理无法连接
      #- TURNSTILE_SITE_KEY=0x4AAAAAAXXXXXXXX # 取消注释以启用
      #- TURNSTILE_SECRET_KEY=0x4AAAAAAXXXX   # 取消注释以启用
    ports:
      # 主机端口:容器端口
      - 5001:5001
    volumes:
      - type: bind
        source: /var/run/docker.sock
        target: /var/run/docker.sock
        bind:
          create_host_path: true
      - type: bind
        source: [CONFIG_LOCATION_FOR_DOCKGE] # 配置文件存储路径
        target: /app/data
        bind:
          create_host_path: true
      # 如需使用私有仓库，需共享认证文件：
      # - /root/.docker/:/root/.docker

      # 栈目录（⚠️ 注意：必须使用绝对路径，源路径和目标路径需匹配 DOCKGE_STACKS_DIR）
      - type: bind
        source: /opt/stacks
        target: /opt/stacks
        bind:
          create_host_path: true

环境变量说明

截图说明

• 栈列表界面：显示所有管理的 Docker Compose 栈，按代理分组，包含状态、资源使用等信息
• compose 编辑器：提供全屏编辑模式，支持语法高亮和实时响应
• 终端界面：支持交互式命令输入，左右键导航，剪贴板操作
• 设置界面：包含主题切换、验证码配置等选项
• 镜像管理界面：显示本地镜像，支持清理和更新（需使用 image-management 标签）

其他说明

• Dockge 基于 Compose V2 构建，支持 compose.yaml（即 docker-compose.yml）文件
• 所有栈文件存储在本地磁盘，可通过常规 docker compose 命令直接操作，避免"绑架"用户文件
• 远程代理场景下，建议仅在主实例启用 Turnstile 验证码，并仅将主实例暴露到互联网，避免代理连接问题