企业官网建设流程全解析

Dockge 使用教程：自托管 Docker Compose 栈可视化管理

【免费下载链接】dockgeA fancy, easy-to-use and reactive self-hosted docker compose.yaml stack-oriented manager项目地址: https://gitcode.com/GitHub_Trending/do/dockge

Dockge 是一款自托管的 Docker Compose 可视化工具，通过网页完成容器栈的创建、编辑与镜像拉取，无需记忆命令行参数。适合想用浏览器管理 compose 栈的新手和普通用户。

🧭 项目定位

Dockge 是围绕 compose.yaml 文件的容器栈管理器，部署在自己的服务器上。它面向以 Docker Compose 方式管理应用的用户，也兼顾对命令行不太熟悉的新手。

核心特性：

• 完整的栈生命周期管理：创建、编辑、启动、停止、重启、删除，以及镜像拉取更新；compose.yaml 是 Docker 中描述多服务容器的标准配置文件
• 交互式 Web 终端，在浏览器里直接进入运行中的容器
• 可将docker run命令行转写为 compose.yaml，方便已有命令的使用者迁移
• 操作反馈实时：拉取、启停的进度与终端输出同步刷新；1.4.0 起还支持从多个 Docker 主机统一管理栈

安装与验证

环境要求

• Docker 20 以上版本，或 Podman（Podman 需另装 podman-docker 组件）
• 可运行容器引擎的 Linux 发行版，如 Ubuntu、Debian（Bullseye 及以上）、CentOS、Fedora
• 支持 amd64、arm64、armv7 三种架构

安装步骤

第 1 步：创建目录。/opt/stacks存放各栈的文件，/opt/dockge存放 Dockge 自身数据。

mkdir -p /opt/stacks /opt/dockge cd /opt/dockge

第 2 步：准备 compose.yaml。仓库根目录已附带官方 compose.yaml，默认端口 5001、栈目录/opt/stacks，把其中内容保存为本地compose.yaml即可。

第 3 步：启动服务。

docker compose up -d

验证

终端执行docker ps确认容器处于运行状态，再在浏览器打开http://localhost:5001。首次进入会引导你设置管理员密码，登录后可看到栈概览页面。

版本更新

后续升级只需拉取新镜像并重建容器：

cd /opt/dockge docker compose pull && docker compose up -d

界面走查

左侧导航栏包含以下模块，也是 Dockge 日常 Docker 管理的操作入口：

• 栈概览：汇总每个栈的运行状态与容器资源占用
• Compose 编辑器：新建栈或修改既有 compose.yaml，带语法提示
• 终端：在页面内打开容器内的 shell
• 控制台：查看各类操作的执行日志
• 设置：常规、外观、安全（可开启两步验证）、全局环境变量与版本信息

页面路由结构可参考前端 router 定义。

最小用例：部署一个 Nginx

1. 在概览页点击新建栈，命名my-nginx，Dockge 会在/opt/stacks下生成对应目录与 compose.yaml
2. 在编辑器中写入如下内容：

services: web: image: nginx:latest ports: - "8080:80"

3. 保存后点击部署，页面实时显示拉取镜像与启动容器的进度
4. 容器状态变为运行中，即表示部署完成
5. 浏览器访问http://localhost:8080，看到 Nginx 欢迎页说明端口映射正常

选型与注意事项

Dockge 和 Portainer 怎么选？如果你的应用全部以 compose 形式部署，Dockge 更轻量、进度反馈更直观，两者也可以并存使用；若还需要管理单个容器或网络资源，Portainer 覆盖的面更广。

已有的栈怎么接入？停掉原服务后，把配置文件放到/opt/stacks/<栈名>/compose.yaml，再点击页面右上角菜单中的“Scan Stacks Folder”，列表里就会出现这些栈。

配置上最容易踩的坑？栈目录的卷映射要求宿主机路径与容器内路径完全一致，即/opt/stacks:/opt/stacks；两边不一致时，文件可能被写到错误的位置。

适合以 compose 方式部署应用、希望全程用浏览器完成管理的用户，Docker 新手的上手成本也很低。

【免费下载链接】dockgeA fancy, easy-to-use and reactive self-hosted docker compose.yaml stack-oriented manager项目地址: https://gitcode.com/GitHub_Trending/do/dockge