cmcooper1980/dockge

cmcooper1980

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

3 次收藏下载次数: 0状态：社区镜像维护者：cmcooper1980仓库类型：镜像最近更新：5 个月前

让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这段话即可：

请先阅读并遵守：https://xuanyuan.cloud/agents.md

未读文档前不要生成 pull 命令或排错方案。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

Dockge

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

可用架构

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 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: docker.xuanyuan.run/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 密钥（启用验证码时必填）	未设置（禁用）

截图说明

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

其他说明

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

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 dockge 镜像标签

docker pull docker.xuanyuan.run/cmcooper1980/dockge:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull cmcooper1980/dockge:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

一键安装

一键安装 Docker

Linux Docker 一键安装

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

爱快 4.0 · iKuai 镜像加速

宝塔面板

一键配置镜像源

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

专属域名用法

专属域名 · 开启停用 · 多仓库

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 专业版 · 企业版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

docker.sock / daemon

账号

失败是否计费

manifest · blob · 计费

申请开票（企业 / 个人）

开票 · 发票 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

Docker 标签

架构支持

固定版本号

amd64 / arm64 / armv7

latest

amd64 / arm64 / armv7

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

yaml

services:
  dockge:
    image: docker.xuanyuan.run/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 密钥（启用验证码时必填）

未设置（禁用）

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。