Dockge

一、网站简介

Dockge 是一款面向 Docker 用户的、自托管的容器栈管理工具。如果你已经厌倦了在终端里反复敲打 docker-compose up -d，或者觉得 Portainer 这类通用面板对于管理多个 compose.yaml 文件不够直观，那么 Dockge 很可能就是你的菜。它的核心设计理念非常清晰：以项目（Stack）为中心，让你能像管理代码仓库一样，在一个简洁的 Web 界面里集中管理所有 Docker Compose 配置文件。编辑上手体验后，感觉它特别适合那些已经熟悉 Docker Compose 语法，但希望提升部署和管理效率的中高级用户。

二、核心功能有哪些？与 Portainer 有何不同？

Dockge 的功能非常聚焦，主要围绕 Docker Compose 栈的生命周期管理：

1. 栈的集中管理：所有 compose.yaml 文件都存放在你指定的目录（如 /opt/stacks），Dockge 会扫描并列表展示。你可以一键启动、停止、重启、更新（拉取新镜像）整个栈。
2. Compose 文件编辑器：内置 Web 编辑器，可以直接修改 compose.yaml 文件，保存后立即生效，无需再 SSH 到服务器。这对快速调整环境变量、映射端口等操作非常方便。
3. 实时日志查看：可以直接在网页上查看容器运行的实时日志，排错更直观。
4. 简单的交互式部署：虽然主打管理已有 Compose 文件，但也提供了基础的表单，可以交互式地创建新的栈。

与 Portainer 的关键区别：Portainer 是一个功能全面的 Docker 图形化管理平台，涵盖容器、镜像、网络、卷等所有维度。而 Dockge 更像一个 “Compose 文件专属管家”，它不管理单独的容器或镜像，只管理由 Compose 文件定义的“栈”。因此，它的界面更简洁，学习曲线更低，对于深度使用 Compose 部署多服务应用的用户来说，操作路径更短、更高效。

三、如何快速上手部署 Dockge？

官方提供的安装步骤极其简单，本质上就是用一个 Compose 文件来部署 Dockge 本身，这正好体现了它“吃自己的狗粮”的理念。以下是核心步骤：

1. 准备目录：在宿主机上创建两个目录，分别用于存放你自己的业务栈和 Dockge 自身的配置。
2. 下载 Compose 文件：进入 Dockge 目录，从 GitHub 下载官方的 compose.yaml 文件。
3. 一键启动：执行 docker compose up -d，Dockge 服务就会跑起来。
4. 访问与配置：默认通过服务器 IP 和端口（如 http://your-server-ip:5001）访问。首次启动后，你需要在设置里指定你的业务栈存放路径（即上面的 /opt/stacks），Dockge 才能扫描并管理你的项目。

整个过程不到5分钟，对于 Docker 用户来说毫无门槛。

四、适合哪些人群使用？

• 个人开发者或小团队：在单台或多台服务器上维护多个博客、数据库、API 服务等 Compose 项目，需要轻量级统一管理。
• Homelab 爱好者：家庭实验室里部署了 Jellyfin、Nextcloud、Home Assistant 等一系列自建服务，用 Dockge 管理比记一堆命令或用通用面板更顺手。
• 追求效率和简洁的运维人员：已经熟练使用 Docker Compose，但希望减少命令行操作，通过 Web 界面实现快速启停、更新和日志查看。

不太适合完全不懂 Docker Compose 语法的新手，因为它的基础是建立在你已经能编写正确的 compose.yaml 文件之上。

五、有哪些使用技巧和注意事项？

使用技巧：

• Git 集成最佳实践：强烈建议将 /opt/stacks 目录初始化为一个 Git 仓库，每个栈放在独立子目录。这样，所有 Compose 文件的变更都可以通过 Git 追溯，结合 Dockge 的 Web 编辑，实现了可视化的基础设施即代码（IaC）工作流。
• 环境变量管理：对于敏感信息，建议仍然使用 .env 文件，并在 Compose 文件中引用。Dockge 目前主要编辑 compose.yaml，对 .env 的支持是间接的（通过管理 Compose 文件本身）。

注意事项（避坑建议）：

• 非通用管理面板：请明确 Dockge 不管理独立的容器、镜像或卷。如果你需要这些功能，应使用 Portainer 或直接使用 Docker CLI。Dockge 是补充，而非替代。
• 网络与权限：确保 Dockge 容器有足够的权限访问 Docker 守护进程（通常通过绑定 /var/run/docker.sock 实现，这在安全上需要留意），并且能访问你指定的 stacks 目录。
• 免费与开源：Dockge 是完全开源且免费的自托管方案，无需担心订阅费用。安全和可靠性取决于你的部署环境。

六、编辑的真实使用建议

在实际使用一段时间后，我的建议是：将 Dockge 作为你 Docker Compose 项目的“操作前台”，而将 Git 作为“版本后台”。

对于新手，不要一上来就尝试用它的表单创建复杂栈。最好的方式是：

1. 先在本地或通过命令行，用一个测试用的 compose.yaml（比如部署一个 Nginx）确保能正确运行。
2. 将这个文件放到 Dockge 管理的 stacks 目录中。
3. 在 Dockge 界面上找到这个栈，尝试进行启动、停止、查看日志、编辑文件并重启等操作。

这样你能最快地理解 Dockge 的工作模式——它是对现有工作流的增强，而不是颠覆。一旦熟悉，你会发现管理十几个 Compose 项目变得异常轻松，更新服务版本也就是点一下“更新”按钮的事，效率提升非常明显。