查看“︁在搬瓦工服务器上部署 docker 管理神器 dockge”︁的源代码

Dockge ，专为 Docker Compose 设计的轻量级管理工具。它主打“响应式设计”和“基于文件管理”，能够将你的 Docker 堆栈（Stack）直接映射为文件系统中的 <code>compose.yaml</code> 文件，管理起来更加直观、安全。（像本站很多部署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</code>
----

== 第二步：安装 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 <nowiki>https://download.docker.com/linux/debian/gpg</nowiki> -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] <nowiki>https://download.docker.com/linux/$(</nowiki>. /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</code>
----

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

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

我们统一存放在 <code>/opt</code> 目录下，方便管理。
 # 创建目录
 # /opt/dockge 用于存放 Dockge 自己的配置
 # /opt/stacks 用于存放你未来部署的各种应用（如 Nginx, MySQL 等）
 sudo mkdir -p /opt/dockge
 sudo mkdir -p /opt/stacks</code>
----

== 第四步：编写 Dockge 的配置文件 ==
进入 <code>/opt/dockge</code> 目录，使用 <code>vim</code> 创建并编辑 <code>compose.yaml</code> 文件。
 '''cd''' /'''opt'''/dockge
 '''vim''' compose.yaml</code>
Vim 操作提示：

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

请复制以下内容：
 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</code>
----

== 第五步：启动 Dockge ==
配置文件写好后，直接在当前目录启动即可。
 # 启动容器（-d 表示后台运行）
 '''docker''' compose up -d</code>
如果看到类似 <code>[+] Running 1/1 ... Container dockge-dockge-1 Started</code> 的提示，说明部署成功。

注意事项： 如果你的 VPS 开启了防火墙（如 UFW ），请务必放行 5001 端口（TCP）。
 # 如果使用 UFW 防火墙，运行以下命令放行端口
 '''sudo''' ufw allow 5001/tcp</code>
----

== 第六步：初始化与使用 ==

# 打开浏览器，访问 <code><nowiki>http://你的VPS_IP:5001</nowiki></code>。
# 你会看到初始化界面，设置管理员账号和密码。
# 点击 Create Account 完成创建。
[[File:Image1453.png|center|thumb|800x800px]]

=== 如何使用 Dockge 部署第一个应用？ ===
进入 Dockge 首页后，你会发现界面非常简洁：

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

Dockge 会自动在 <code>/opt/stacks/uptime-kuma/</code> 下生成 <code>compose.yaml</code> 文件，并拉取镜像启动容器。
[[File:6f9340.jpg|center|thumb|800x800px]]
[[File:Image786.png|center|thumb|800x800px]]
[[File:Image7861.png|center|thumb|800x800px]]
----

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

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