2026年2月11日 (三) 18:22 Liam

2026-02-11T18:22:27Z

←上一版本		2026年2月11日 (三) 11:22的版本
第132行：		第132行：
	* Git 风格：你可以随时在目录下手动编辑 <code>compose.yaml</code>，Dockge 界面会实时同步更新。		* Git 风格：你可以随时在目录下手动编辑 <code>compose.yaml</code>，Dockge 界面会实时同步更新。
	* 轻量级：占用资源极低，非常适合小内存 VPS。		* 轻量级：占用资源极低，非常适合小内存 VPS。
			[[Category:500 常见应用指南 — Application Guides]]

2026年2月11日 (三) 06:15 Pan

2026-02-11T06:15:17Z

←上一版本		2026年2月10日 (二) 23:15的版本
第48行：		第48行：

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

	# Dockge 自身的数据目录。		# Dockge 自身的数据目录。

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

2026-02-10T08:29:55Z

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

在搬瓦工服务器上部署 docker 管理神器 dockge - 版本历史

2026年2月11日 (三) 18:22 Liam

2026年2月11日 (三) 06:15 Pan