标签搜索

目 录CONTENT

文章目录

VPS中部署 Dockge:一个精美易用的自托管 Docker Compose 堆栈管理器

yyzq
2025-08-27 / 0 评论 / 1 点赞 / 37 阅读 / 1,530 字

前言

在日常使用 VPS 的过程中,我们常常需要通过 Docker 来运行各种服务。虽然 docker-compose 命令行很强大,但对新手来说不够直观,对老手来说管理多个堆栈也比较繁琐。
这时候,一个界面美观、操作简洁的自托管工具就显得尤为重要。
Dockge 正是这样一款开源项目,它提供了一个现代化、反应迅速的 Web 界面,让我们能够轻松管理 Docker Compose 堆栈,不仅比命令行更直观,而且比传统的 Portainer 更加专注于 docker-compose.yaml 文件的管理。Dockge 的作者还有一个著名的开源项目 uptime 监控软件 ,有兴趣可以看我之前的uptime部署教程
本文将带你在 VPS 上快速部署 Dockge,体验一键管理堆栈的高效与便捷。

✨ 功能特点

  • 🧑‍💼 管理你的 compose.yaml 文件
    创建 / 编辑 / 启动 / 停止 / 重启 / 删除
  • 更新 Docker 镜像
  • ⌨️ compose.yaml 的交互式编辑器
  • 🦦 交互式网页终端
  • 🕷️ (1.4.0 🆕)支持多个代理 — 你可以在一个界面中管理来自不同 Docker 主机的多个堆栈
  • 🏪 将 docker run … 命令转换为 compose.yaml
  • 📙 基于文件的结构 — Dockge 不会“劫持”你的 compose 文件,它们仍然存储在你的硬盘上,你可以使用普通的 docker compose 命令进行操作

项目图片

以下是与该项目相关的一些图片:
image-1756260162620

部署方法

使用Docker安装

本教程使用docker的方式安装部署,简单便捷
164b6ac419e23bc5390dc46601a202bf

准备条件

1)一台服务器或者NAS

我们使用飞牛云NAS或者VPS来演示
需要vps的可以看以下信息
莱卡云官网

2)本项目使用到的github

https://github.com/louislam/dockge
image-1756260280351
目前只有1个 stars
更多功能或者二次修改可以访问GitHub

3)域名(可选)

域名可以根据自己的需求绑定

①《飞牛NAS上搭建》

鉴于飞牛云NAS已经自带docker-compose管理器了
image-1756260414091
使用起来也是很好用
不建议在飞牛云NAS上安装
如果想尝鲜的可以尝试下

新建项目:

dockge

compose配置如下:

services:
  dockge:  # 定义名为 dockge 的服务
    image: louislam/dockge:1  # 使用 dockge 镜像,版本号为 1
    restart: always  # 容器异常退出时总是自动重启
    ports:
      - 5001:5001  # 将宿主机 5001 端口映射到容器 5001 端口
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载 Docker 套接字,用于管理容器
      - ./data:/app/data  # 持久化 dockge 的应用数据到本地 ./data 目录
      - /opt/stacks:/opt/stacks  # 存放 stacks 配置文件目录
    environment:
      - DOCKGE_STACKS_DIR=/opt/stacks  # 设置 stacks 的目录路径
      - TZ=Asia/Shanghai  # 设置容器时区为上海
      - DOCKGE_ENABLE_CONSOLE=true  #true打开终端关闭请改为false

启动即可
image-1756260719673
正常启动
image-1756260732043
飞牛云的
ip:5001
端口即可打开
image-1756260769323
配置好管理员信息登录即可
image-1756260812902

补充docker可用的镜像仓库

国内如果无法拉取镜像的可以使用
仓库1

https://proxy.1panel.live/

仓库2

https://docker.1panel.top/

仓库3

https://mirror.azure.cn/

仓库4

https://hub.rat.dev/

仓库5

https://docker.1ms.run

仓库6

https://docker.itelyou.cf/

仓库7

https://abc.itelyou.cf/

仓库8

https://docker.ywsj.tk/

②《vps上搭建》

一、Docker环境部署

在vps安装docker和docker-compose
Docker官方安装文档(英文)
https://duan.yyzq.eu.org/docker-001
Docker-Compose官方安装文档(英文)
https://duan.yyzq.eu.org/docker-002
Centos安装Docker和Docker-compose(中文)
https://duan.yyzq.eu.org//03
Ubuntu安装Docker和Docker-compose(中文)
https://duan.yyzq.eu.org//04

推荐直接用一键脚本

docker安装脚本

bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)

docker-compose安装脚本

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose

二、创建docker-compose.yml文件

mkdir dockge;cd dockge #创建一个目录,并进入此目录

然后再新建docker-compose.yml

vim docker-compose.yml
services:
  dockge:  # 定义名为 dockge 的服务
    image: louislam/dockge:1  # 使用 dockge 镜像,版本号为 1
    restart: always  # 容器异常退出时总是自动重启
    ports:
      - 5001:5001  # 将宿主机 5001 端口映射到容器 5001 端口
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载 Docker 套接字,用于管理容器
      - ./data:/app/data  # 持久化 dockge 的应用数据到本地 ./data 目录
      - /opt/stacks:/opt/stacks  # 存放 stacks 配置文件目录
    environment:
      - DOCKGE_STACKS_DIR=/opt/stacks  # 设置 stacks 的目录路径
      - TZ=Asia/Shanghai  # 设置容器时区为上海
      - DOCKGE_ENABLE_CONSOLE=true  #true打开终端关闭请改为false

三、执行容器运行命令

docker-compose up -d #运行容器
docker-compose ps  #查看是否开启成功

正常启动如下所示

docker-compose ps
NAME              IMAGE               COMMAND                  SERVICE   CREATED          STATUS                    PORTS
dockge-dockge-1   louislam/dockge:1   "/usr/bin/dumb-init …"   dockge    33 minutes ago   Up 33 minutes (healthy)   0.0.0.0:5001->5001/tcp, [::]:5001->5001/tcp

四、打开web页面使用

成功以后需要打开自己相应的端口(8082)防火墙就可以web端访问了
打开自己VPS/或者飞牛云NAS的ip加端口就可进入初始化页面

http://ip:5001

image-1756260769323
配置好管理员密码信息登录即可
image-1756260812902

测试下docker命令转docker-compose配置

docker run -d \
  --name redis \
  -p 6379:6379 \
  -e TZ=Asia/Shanghai \
  --restart always \
  redis:latest 

image-1756261880036

其他功能自行探索

五、绑定域名

如需绑定域名的自行绑定
绑定域名可以参考
NginxProxyManager
https://duan.yyzq.eu.org//npm-ch
绑定完域名配置好证书就可以用域名来访问了

有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我
有任何问题可以直接留言或者问我

欢迎关注我们的微信公众号!
微信公众号

1

评论区