Dockge项目简介
Dockge 是由知名开源项目 Uptime Kuma 的开发者精心打造的一款专业工具，专门致力于优化 Docker Compose 堆栈的管理流程。该工具通过提供完整的可视化操作界面和简洁直观的用户交互逻辑，成功地将复杂的 docker-compose.yaml 文件管理任务转化为任何人都能轻松掌握的轻量级服务。
项目源码地址：https://github.com/louislam/dockge
官方项目网站：https://dockge.kuma.pet/
标准docker-compose配置文件：
services:
dockge:
image: docker.1ms.run/louislam/dockge:1
restart: unless-stopped
ports:
- 5101:5001
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./data/data:/app/data
- ./data/stacks/:/opt/stacks/
environment:
- DOCKGE_STACKS_DIR=/opt/stacks/
主要功能特性
-
🧑💼 全方位管理您的
compose.yaml配置文件- 支持完整的生命周期操作：创建、编辑、启动、停止、重启、删除
- 便捷的Docker镜像版本更新功能
-
⌨️ 集成交互式编辑器用于编辑
compose.yaml文件 -
🦦 内置交互式网页终端模拟器
-
🕷️（1.4.0版本新增）多代理支持功能——允许用户在单一界面中管理来自不同Docker主机的多个堆栈
-
🏪 智能将
docker run ...命令行指令转换为标准的compose.yaml配置文件 -
📙 基于文件系统的架构设计 - Dockge 不会接管您的撰写文件，这些文件仍然按照常规方式存储在您的磁盘上。您可以使用标准的
docker compose命令与这些文件进行交互 -
🚄 完全响应式设计 - 所有操作都是实时响应的。镜像拉取进度、容器状态变化和终端输出信息都实现了实时更新
-
🐣 用户友好的精美界面设计 - 如果您曾经喜欢 Uptime Kuma 的用户界面和用户体验设计，那么您一定会对这款工具产生同样的好感
适用用户群体与使用场景
🔹 初级开发人员与容器技术新手
无需深入了解Compose文件语法细节，仅通过直观的可视化界面就能快速部署Nginx、数据库等常见服务组件，特别适合用于快速构建个人博客系统或创建测试环境。
🔹 追求运维效率的专业人士
- 批量更新操作：通过单一操作即可更新所有服务的镜像版本，有效避免了逐条手动执行命令的繁琐过程
- 故障诊断支持：实时日志显示面板有助于快速定位容器启动失败等常见问题
🔹 资源受限环境用户
与Portainer等功能全面的管理工具相比，Dockge仅需约5MB内存就能稳定运行，资源消耗极低，特别适合在树莓派等边缘计算设备上部署使用
安装指南与使用体验
使用上述提供的docker-compose配置文件启动容器服务后，在浏览器中访问地址：http://<nas-ip>:5101，首次访问时需要注册一个管理员账户：
在注册账户的过程中，请记得将界面语言设置为简体中文。完成注册并成功登录后，您将进入系统的主界面：
Dockge设计上不会自动识别系统中已运行的其他容器，按照开发者的设计理念，通过其他方式启动的容器不属于Dockge的管理范畴。但是如果用户希望让Dockge管理已存在的容器，可以按照以下步骤操作：
- 在
./data/stacks/目录下创建一个新的文件夹（请注意：此目录会映射到Dockge容器内的/opt/stacks/目录）。例如，如果要将已运行的excalidraw项目纳入Dockge管理，就需要创建./data/stacks/excalidraw文件夹 - 将原始
excalidraw项目的docker-compose.yml配置文件复制到新创建的./data/stacks/excalidraw目录中 - 返回浏览器界面，在右上角功能区找到扫描选项：
完成扫描后，即可在Dockge界面中看到excalidraw项目已经显示出来，此时就可以通过Dockge对其进行全面管理了。
Dockge还有一个备受好评的功能是能够自动将docker run命令转换为docker-compose配置文件。在浏览网络寻找有趣项目时，许多项目仅提供docker run命令，这些命令的可读性和可维护性较差。以往可能需要借助AI工具将这些命令转换为docker-compose格式后再导入管理面板，现在可以直接在Dockge主界面输入原始的docker run命令：
点击转换按钮后，系统会自动处理命令转换，此时只需为新的堆栈指定一个名称即可完成整个转换过程：
关于创建全新compose堆栈的具体操作方法，本文不再详细展开说明，因为Dockge完整支持中文界面，相信各位用户都能轻松掌握相关操作流程。
总结与优势
- Dockge通过极简主义的设计理念和场景化的功能配置，重新定义了Docker Compose管理的用户体验标准
- 其核心功能中将
docker run...命令自动转换为docker compose格式文件的能力，在实际使用中表现出极高的便利性和实用性 - 整个项目设计轻量高效，不会消耗过多系统资源，建议在NAS设备上作为常驻服务进行部署使用