Dockge使用详细指南

以下是 Dockge 的详细使用说明，涵盖安装、配置、操作及常见问题处理：

Dockge 使用详细指南

一、安装步骤

1. 准备工作

  • 环境要求：支持 Docker 的 Linux 系统（如 NAS、服务器）。
  • 安装路径：建议使用官方推荐路径 /opt/dockge。

2. 安装命令

1
2
3
4
5
6
7
8
9
10
11
# 创建目录
mkdir -p /opt/dockge

# 进入目录
cd /opt/dockge

# 下载 Dockge 的 compose 文件
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml

# 启动服务
docker compose up -d

3. 访问 Dockge

  • 端口：默认 5001。
  • 访问地址：http://<宿主机IP>:5001。
  • 首次访问：需设置管理员账号密码。

二、基础操作

1. 创建并管理堆栈

步骤 1：新建堆栈

  1. 登录 Dockge 后，点击 Compose → New Stack。
  2. 输入堆栈名称（如 my-stack）。
  3. 在 Compose File 区域粘贴或编写 docker-compose.yml 内容。

步骤 2：配置 Compose 文件示例

1
2
3
4
5
6
7
8
version: '3'
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"  # 宿主机80端口映射到容器80端口
    volumes:
      - /opt/stacks/nginx/html:/usr/share/nginx/html  # 绝对路径挂载

步骤 3：启动堆栈

  • 点击 Start 按钮，实时查看部署日志。
  • 成功后堆栈状态变为 Running。

步骤 4：编辑与管理

  • 在堆栈列表中，可执行 Stop、Restart、Delete 等操作。
  • 点击 Edit 可修改 Compose 文件并重新部署。

2. 将 Docker Run 命令转换为 Compose

示例场景

假设原有命令：

1
docker run -d -p 8080:80 -v /data:/app myapp

转换步骤

  1. 在 Dockge 的 Compose → New Stack 页面。
  2. 在 Convert Docker Run 区域粘贴命令：
    1
    docker run -d -p 8080:80 -v /data:/app myapp
  3. 点击 Convert，自动生成对应的 Compose 配置：
    1
    2
    3
    4
    5
    6
    7
    8
    version: '3'
    services:
      myapp:
        image: myapp
        ports:
          - "8080:80"
        volumes:
          - /data:/app

3. 终端功能

  • 访问路径：顶部菜单栏 → Terminal。
  • 支持命令：
    • docker：管理容器（如 docker ps）。
    • ls、cd、dir：查看和切换目录。
    • 限制：出于安全考虑，仅支持上述命令。

三、高级配置与注意事项

1. 自定义堆栈存储路径

  • 默认路径：/opt/stacks（所有 Compose 文件和配置保存在此）。
  • 修改路径：
    1. 编辑 /opt/dockge/compose.yaml，修改 WORKDIR 参数：
      1
      2
      environment:
        - WORKDIR=/mnt/media_rw/your_path/stacks  # 替换为实际路径
    2. 重启服务：
      1
      docker compose down && docker compose up -d

2. 端口映射与安全

  • 限制端口仅本地访问：
    在 Compose 文件中指定 Host 为 127.0.0.1：
    1
    2
    ports:
      - "127.0.0.1:8080:80"  # 仅宿主机本地可访问

3. 与原有容器共存

  • 不影响现有容器：Dockge 仅管理通过其部署的容器，不影响其他 Docker 容器。
  • 查看所有容器：通过 docker ps 或 NAS 的 Docker 管理工具。

四、NAS 特殊配置（以绿联NAS为例）

1. 磁盘路径问题

  • 绿联NAS磁盘路径：
    • 默认路径如 /mnt/dm-0 可能不稳定，建议使用 media_rw 的绝对路径：
      1
      /mnt/media_rw/<UUID>/.ugreen_nas/<user_id>/
    • 示例路径：
      1
      /mnt/media_rw/9e39d6bc-b42d-43a4-8f13-877e0311e23f/.ugreen_nas/196151/

2. 部署 Windows 容器（如下载机）

  1. 在 Dockge 中新建堆栈，使用 dockur/windows 镜像：
    1
    2
    3
    4
    5
    6
    7
    services:
      windows:
        image: dockur/windows
        ports:
          - "3389:3389"  # 远程桌面端口
        volumes:
          - /mnt/media_rw/your_path:/mnt  # 挂载NAS存储

五、常见问题排查

1. 访问地址无法打开

  • 检查端口：确认 5001 端口未被占用，且防火墙允许访问。
  • 服务状态：运行 docker ps 确认 Dockge 容器是否运行：
    1
    docker ps | grep dockge

2. Compose 文件路径错误

  • 绝对路径要求：确保 Compose 文件中的路径为绝对路径（如 /opt/data），而非相对路径（如 ./data）。

3. 容器无法启动

  • 日志查看：在 Dockge 的堆栈详情页点击 Logs 查看实时日志。
  • 依赖问题：检查镜像是否可用，或网络/端口是否冲突。

六、功能对比与替代方案

功能 Dockge Portainer（对比）
界面简洁度 ✅ 适合新手 ❌ 功能复杂，学习成本高
终端功能 ✅ 基础命令支持 ✅ 完全终端访问
管理非 Compose 容器 ❌ 不支持 ✅ 支持全部容器
价格 ✅ 免费 ✅ 免费（企业版收费）

七、总结

Dockge 是一款轻量级的 Docker Compose 管理工具，适合追求简单易用的用户。其核心优势在于将 Compose 文件管理和容器部署无缝结合，同时支持通过 Web 界面快速操作。对于 NAS 用户（如绿联NAS），通过 Dockge 可以避免频繁使用 SSH，提升部署效率。如需更复杂的容器管理，可考虑 Portainer 作为补充工具。