群晖 Synology、OpenWrt 软路由、VPS 安装 Docker Compose 与 Dockge 图形化容器面板保姆级教程

告别繁琐的命令行 docker run 与 vim 修改配置文件！手把手演示在 VPS、OpenWrt 软路由与群晖 NAS 三大平台安装 Docker Compose 并部署高颜值可视化面板 Dockge。

## 为什么需要 Docker Compose 与 Dockge？

很多开源项目作者只提供 `docker-compose.yaml` 部署文件，如果手动转换成 `docker run` 命令不仅容易写错环境变量，后期更新维护也极其麻烦。而由 Uptime Kuma 作者开发的 **Dockge** 提供了极度清爽的 Web 图形化界面，只需复制粘贴 `compose.yaml` 点击部署即可一键拉起容器栈。

## 一、Linux VPS 一键安装 Docker 与 Dockge

SSH 登录 VPS，先执行系统更新并运行 Docker 官方安装脚本，随后创建目录拉起 Dockge：

```bash
# 1. 一键安装 Docker 与 Docker Compose 插件
curl -fsSL https://get.docker.com | bash
docker -v && docker compose version

# 2. 创建 Dockge 目录并启动容器 (默认端口 5001)
mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml
docker compose up -d
```

部署完成后浏览器访问 `http://VPS_IP:5001` 创建管理员账号即可使用。

## 二、OpenWrt 软路由与群晖 NAS 安装避坑指南

由于部分 OpenWrt 固件与旧版群晖套件未内置新版 `docker compose`，可按以下步骤手动安装二进制文件：

1. **下载对应架构的二进制包**：前往 Docker Compose GitHub Releases 下载 `docker-compose-linux-x86_64`（ARM 软路由则选 `aarch64`），重命名为 `docker-compose`。
2. **上传并赋予执行权限**：将其放入系统环境变量目录（如 `/usr/libexec/docker/cli-plugins/` 或 `/usr/local/bin/`），SSH 执行 `chmod +x docker-compose`。
3. **群晖 NAS 5001 端口冲突解决**：
   - 群晖 DSM 默认占用了 `5001` 端口！因此在拉取 Dockge 的 `compose.yaml` 后，务必用记事本打开将其中的端口映射由 `5001:5001` 修改为 **`5002:5001`（或其他未占用端口）**；
   - 在 Docker 目录下手动新建一个名为 `data` 的文件夹，然后执行 `docker-compose up -d`（注意二进制安装版中间带横杠 `-`），即可通过 `http://群晖IP:5002` 访问 Dockge！