项目介绍
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。
第一次使用:先更新一个测试容器
选择一个可随时重建、没有重要业务数据的容器,记录镜像标签、端口、网络、环境变量与挂载路径。
在 DockerCopilot 中备份这个容器的设置,然后检查备份目录是否生成文件。另行备份应用数据;数据库应用优先使用自己的导出或备份功能。
使用更新检查或指定镜像标签更新。观察任务进度,完成后回到应用页面确认版本、登录、数据和功能。
确认更新结果后再处理旧容器与旧镜像。不要一开始就自动删除所有旧资源,也不要把应用数据库降级当作普通容器回退。
验证一个项目的更新和恢复流程后,再按业务分批维护其他容器。由 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 删除本项目容器和网络,保留宿主机目录,勿顺带删除其他应用的数据。