在搬瓦工服務器上部署 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。