cmcooper1980/dockge Docker Image Overview

cmcooper1980/dockge

Dockge 是一个美观易用、响应式的自托管 Docker Compose 栈管理器，基于 louislam/dockge 的分支版本，已合并多个实用拉取请求，支持管理 compose.yaml 文件、交互式编辑器、多代理、Web 终端、资源监控等功能。

1 收藏0 次下载

🔒 更安全的专业镜像服务

中文简介版本下载

🔒 更安全的专业镜像服务

Dockge

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

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

可用架构

Docker 标签	架构支持
固定版本号	amd64 / arm64 / armv7
latest	amd64 / arm64 / armv7

核心功能与特性

主要功能

🧑‍💼 管理 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 [***] --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 "[***]" --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

环境变量说明

环境变量	描述	默认值
DOCKGE_STACKS_DIR	栈目录路径（必须与挂载卷的源路径和目标路径一致）	/opt/stacks
TURNSTILE_SITE_KEY	Cloudflare Turnstile 站点密钥（启用验证码时必填）	未设置（禁用）
TURNSTILE_SECRET_KEY	Cloudflare Turnstile 密钥（启用验证码时必填）	未设置（禁用）