在搬瓦工服务器上部署 docker 管理神器 dockge

Dockge ，专为 Docker Compose 设计的轻量级管理工具。它主打“响应式设计”和“基于文件管理”，能够将你的 Docker 堆栈（Stack）直接映射为文件系统中的 compose.yaml 文件，管理起来更加直观、安全。（像本站很多部署docker应用的教程，就可以直接把镜像按指引复制到 dockge 里面，然后使用一键部署就可以了。）

本文将教你如何在一台全新的搬瓦工 (Debian / Ubuntu) 服务器上，从零开始部署 Dockge 并接管你的 Docker 应用。

准备工作

服务器系统：Debian 11/12 或 Ubuntu 20.04/22.04/24.04

第一步：系统更新与基础环境配置

拿到一台全新的 VPS，第一件事永远是更新系统软件源，防止出现依赖报错。

# 1. 更新软件包列表并升级现有软件
sudo apt update && sudo apt upgrade -y

# 2. 安装必要的基础工具
sudo apt install -y vim curl wget git

第二步：安装 Docker 与 Docker Compose

Dockge 本身是基于 Docker 运行的，且它的核心功能是管理 Docker Compose。我们需要安装官方最新版的 Docker。

# 1. 卸载可能存在的旧版本（防止冲突）
for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done

# 2. 添加 Docker 官方 GPG 密钥
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# 3. 添加 Docker 软件源 (自动识别 Debian 或 Ubuntu)
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/$(. /etc/os-release && echo "$ID") \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 4. 再次更新源并安装 Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 5. 启动 Docker 并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker

# 6. 验证安装是否成功
docker --version
docker compose version

第三步：规划目录结构

Dockge 的设计理念是**“管理文件即管理容器”**。我们需要规划两个目录：

Dockge 自身的数据目录。
存放其他 Docker 应用（Stacks）的目录。

我们统一存放在 /opt 目录下，方便管理。

# 创建目录
# /opt/dockge 用于存放 Dockge 自己的配置
# /opt/stacks 用于存放你未来部署的各种应用（如 Nginx, MySQL 等）
sudo mkdir -p /opt/dockge
sudo mkdir -p /opt/stacks

第四步：编写 Dockge 的配置文件

进入 /opt/dockge 目录，使用 vim 创建并编辑 compose.yaml 文件。

cd /opt/dockge
vim compose.yaml

Vim 操作提示：

输入命令后进入界面，按键盘上的 i 键进入编辑模式（左下角会显示 -- INSERT --）。
复制下方代码块的内容，粘贴进去。
按 Esc 键退出编辑模式。
输入 :wq 并回车，保存并退出。

请复制以下内容：

version: "3.8"
services:
  dockge:
    image: louislam/dockge:1
    restart: unless-stopped
    ports:
      # 左边是宿主机端口，如果 5001 被占用请修改
      - 5001:5001
    volumes:
      # 挂载 Docker 守护进程，这是必须的
      - /var/run/docker.sock:/var/run/docker.sock
      # Dockge 自身的数据存储位置
      - ./data:/app/data
      # 【重要】这里指定 Dockge 管理哪个目录下的堆栈
      # 如果你的应用想放在其他地方，请修改这里
      - /opt/stacks:/opt/stacks
    environment:
      # 告诉 Dockge 堆栈目录在哪里
      - DOCKGE_STACKS_DIR=/opt/stacks

第五步：启动 Dockge

配置文件写好后，直接在当前目录启动即可。

# 启动容器（-d 表示后台运行）
docker compose up -d

如果看到类似 [+] Running 1/1 ... Container dockge-dockge-1 Started 的提示，说明部署成功。

注意事项：如果你的 VPS 开启了防火墙（如 UFW ），请务必放行 5001 端口（TCP）。

# 如果使用 UFW 防火墙，运行以下命令放行端口
sudo ufw allow 5001/tcp

第六步：初始化与使用

打开浏览器，访问 http://你的VPS_IP:5001。
你会看到初始化界面，设置管理员账号和密码。
点击 Create Account 完成创建。

如何使用 Dockge 部署第一个应用？

进入 Dockge 首页后，你会发现界面非常简洁：

点击左上角的 + Compose 按钮。
Stack Name：输入应用名称（例如 uptime-kuma）。
在右侧的编辑器中，直接粘贴你的 docker-compose 配置，或者使用它提供的图形化界面添加容器。
点击右上角的 Deploy。

Dockge 会自动在 /opt/stacks/uptime-kuma/ 下生成 compose.yaml 文件，并拉取镜像启动容器。

为什么选择 Dockge？

通过以上步骤，你已经拥有了一个现代化的 Docker 管理面板。相比于 Portainer，Dockge 有以下优势：

原生 Compose 支持：它不会把配置隐藏在数据库里，而是实实在在地保存在 /opt/stacks 目录下。即使哪天你不想用 Dockge 了，你的所有服务依然可以通过命令行正常管理。
Git 风格：你可以随时在目录下手动编辑 compose.yaml，Dockge 界面会实时同步更新。
轻量级：占用资源极低，非常适合小内存 VPS。