热门搜索:
cmcooper1980/dockge
cmcooper1980
Dockge 是一个美观易用、响应式的自托管 Docker Compose 栈管理器，基于 louislam/dockge 的分支版本，已合并多个实用拉取请求，支持管理 compose.yaml 文件、交互式编辑器、多代理、Web 终端、资源监控等功能。
3 次收藏下载次数: 0状态：社区镜像维护者：cmcooper1980仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址，或排查拉取失败等问题，请让 AI 先读规则再动手，只要在 AI 对话里直接发送下面这句话即可：
生成 docker pull、修改 compose 的 image，或排查拉取失败前，请先阅读并严格遵守 https://xuanyuan.cloud/agents.md 中的规则。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
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 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 生成器：[***]
更新方法
bashcd /opt/dockge docker compose pull && docker compose up -d
Docker Compose 配置示例
以下是适用于 docker compose up -d 的配置文件（修改 [CONFIG_LOCATION_FOR_DOCKGE] 为实际配置路径）：
yamlservices: 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 密钥（启用验证码时必填） | 未设置（禁用） |
截图说明
- 栈列表界面：显示所有管理的 Docker Compose 栈，按代理分组，包含状态、资源使用等信息
- compose 编辑器：提供全屏编辑模式，支持语法高亮和实时响应
- 终端界面：支持交互式命令输入，左右键导航，剪贴板操作
- 设置界面：包含主题切换、验证码配置等选项
- 镜像管理界面：显示本地镜像，支持清理和更新（需使用
image-management标签）
其他说明
- Dockge 基于 Compose V2 构建，支持
compose.yaml（即docker-compose.yml）文件 - 所有栈文件存储在本地磁盘，可通过常规
docker compose命令直接操作，避免"绑架"用户文件 - 远程代理场景下，建议仅在主实例启用 Turnstile 验证码，并仅将主实例暴露到互联网，避免代理连接问题
更多相关 Docker 镜像与资源
以下是 cmcooper1980/dockge 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- louislam/dockge Docker 镜像说明（Dockge 容器管理平台，Docker Compose 管理工具）
- portainer/portainer Docker 镜像说明（Portainer 容器管理平台，官方版本）
- linuxserver/docker-compose Docker 镜像说明（Docker Compose，LinuxServer 维护版本）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 dockge 镜像标签
docker pull docker.xuanyuan.run/cmcooper1980/dockge:<标签>
DockerHub 原生拉取命令
docker pull cmcooper1980/dockge:<标签>
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
用 AI 使用轩辕镜像
发给 Cursor、ChatGPT、豆包等 AI 的说明文档
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
轩辕镜像支持 docker push 上传本地镜像吗？
不支持 push
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
拉取老镜像提示 Schema 1 已废弃怎么办？
Schema 1 已废弃
Docker 拉取出现 406 或 OCI index 不支持怎么办？
406 OCI index
docker pull 出现 422 Unknown 怎么办？
422 Unknown
拉取镜像提示 TAG_INVALID 或无效标签（400）怎么办？
400 TAG_INVALID
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"