NAS 与运维

DockerCopilot:群晖 Compose 安装与容器更新备份

  • 5 次阅读
  • 0 条评论
文章摘要

DockerCopilot 用于协助更新容器并保存相关配置。容器更新会涉及镜像、启动参数、挂载和旧容器的处理,更新工具能执行操作,并不意味着应用数据库一定可以在新旧版本之间自由切换。

项目介绍

DockerCopilot 提供容器更新、备份和管理界面。下面提供完整 Compose 和启动命令,并说明群晖目录准备、登录密钥生成及首次更新测试。建议先用一个已备份的小型容器验证,再处理重要服务。

version: '3'
services:
  dockerCopilot:
    image: 0nlylty/dockercopilot:UGREEN  # 官方镜像地址
    container_name: dockerCopilot       # 设置自定义的项目名称
    restart: always
    environment:
      - secretKey=请设置自己的密码             # 自己设置密码,需要大于八位且非纯数字
      - DOCKER_HOST=unix:///var/run/docker.sock
      - hubURL=https://docker.nju.edu.cn # 自定义加速地址
      - DelOldContainer=true            # 是否删除旧镜像,填true或false
    ports:
      - "12712:12712"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /volume1/docker/dc/data:/data   # 自己设置路径。目前存储备份文件,未来可能存储配置文件
    privileged: true

镜像加速地址

https://docker.1ms.run
https://k-docker.asia
https://docker.1panel.live
https://dockerproxy.cn
https://docker.nastool.de
https://docker.agsv.top
https://docker.agsvpt.work
https://docker.m.daocloud.io
https://dockerhub.anzu.vip
https://docker.chenby.cn
https://docker.jijiai.cn

补充:部署与使用

群晖安装前准备

群晖使用 Container Manager(旧版 DSM 为 Docker 套件),准备 /volume1/docker/dockercopilot 作为项目目录。本文使用项目当前的通用镜像 0nlylty/dockercopilot:latest,不要使用旧教程中针对绿联环境的 UGREEN 标签。

本应用需要管理 Docker 守护进程,配置包含 Docker socket 和官方示例中的特权模式。管理页面只供可信局域网使用,不直接映射到公网。它能备份容器设置,但数据库和媒体文件仍需单独备份。

1. 创建目录并生成登录密钥

通过 SSH 登录群晖后执行:

sudo -i
mkdir -p /volume1/docker/dockercopilot/data
cd /volume1/docker/dockercopilot
if [ ! -s .env ]; then
  umask 077
  printf 'DOCKERCOPILOT_SECRET=dc%s\n' "$(openssl rand -hex 16)" > .env
fi
chmod 600 .env
cat .env

保存显示的密钥,首次进入页面时使用。命令生成的密钥包含字母,满足官方“不少于八位且非纯数字”的要求;已有 .env 时不会重新生成。不要将此文件或密钥截图公开。

2. 保存完整 Compose

在该目录创建 compose.yaml,内容如下。在 Container Manager 中创建项目时,项目路径选择同一个目录,并导入此文件,使 Compose 能读取旁边的 .env。

services:
  dockercopilot:
    image: 0nlylty/dockercopilot:latest
    container_name: dockercopilot
    restart: unless-stopped
    privileged: true
    ports:
      - "12712:12712"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /volume1/docker/dockercopilot/data:/data
    environment:
      TZ: Asia/Shanghai
      DOCKER_HOST: unix:///var/run/docker.sock
      secretKey: "${DOCKERCOPILOT_SECRET}"  # 自己设置密码,需要大于八位且非纯数字

/data 保存工具支持的备份文件;socket 用于读取和操作群晖的 Docker 容器。不设置不存在的 UID/GID 参数,也不额外挂载业务应用的数据目录。管理端口 12712 若已被占用,只修改冒号左侧,并相应修改浏览器访问端口。

3. 检查配置并启动

cd /volume1/docker/dockercopilot
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100 dockercopilot

浏览器打开 http://群晖IP:12712,使用第一步生成的密钥进入管理页面。若提示找不到 docker compose,先确认已安装并启动 Container Manager;使用旧 Docker 套件的设备可以将命令中的 docker compose 换成已安装的 docker-compose。

第一次使用:先更新一个测试容器

  1. 选择一个可随时重建、没有重要业务数据的容器,记录镜像标签、端口、网络、环境变量与挂载路径。

  2. 在 DockerCopilot 中备份这个容器的设置,然后检查备份目录是否生成文件。另行备份应用数据;数据库应用优先使用自己的导出或备份功能。

  3. 使用更新检查或指定镜像标签更新。观察任务进度,完成后回到应用页面确认版本、登录、数据和功能。

  4. 确认更新结果后再处理旧容器与旧镜像。不要一开始就自动删除所有旧资源,也不要把应用数据库降级当作普通容器回退。

  5. 验证一个项目的更新和恢复流程后,再按业务分批维护其他容器。由 Compose 管理的应用,要同步保留其原始 Compose 文件,避免面板修改与文件定义不一致。

常见问题

  • 登录密钥错误:在项目目录私下查看 .env,核对是否复制了完整的 dc 开头字符串;修改 .env 后执行 docker compose up -d --force-recreate 让环境变量生效。

  • 页面无法访问:检查 docker compose ps、日志、DSM 防火墙,以及 12712 是否被其他服务占用。

  • 看不到容器或无法更新:确认 /var/run/docker.sock 存在且挂载正确,并检查日志中的 Docker API 错误。不要用“只读挂载 socket”作为限制 API 操作的措施。

  • 镜像拉取失败:先单独检查群晖的 Docker 镜像访问。给应用设置 HTTP 代理不等于给 Docker 守护进程设置镜像拉取代理,不直接照抄旧教程中的公共镜像加速站。

  • 更新后应用异常:比对旧容器参数及应用迁移日志,恢复已备份的数据和配置。DockerCopilot 的设置备份不能替代数据库备份。

更新与备份

更新本工具时执行:

cd /volume1/docker/dockercopilot
docker compose pull
docker compose up -d
docker compose logs --tail=100 dockercopilot

备份 compose.yaml、.env 和 data 目录。.env 包含登录密钥,应保存在私有备份中。停止本工具用 docker compose stop;docker compose down 删除本项目容器和网络,保留宿主机目录,勿顺带删除其他应用的数据。

官方资料