一个主打便捷的 Docker 容器管理工具，支持所有平台。

• 一键更新容器（自动拉取最新镜像并重建）
• 指定镜像和 tag 更新
• 启动、停止、重启容器
• 重命名容器
• 删除无 TAG 镜像 / 未使用镜像
• 更新进度实时查看
• 容器配置备份与恢复
• 导出为 docker-compose.yml
• 群组管理（批量更新、定时任务、批量启动/停止/重启）
• 容器日志实时查看
• 容器网络信息显示（端口映射、网络模式、内部 IP）
• Bark 推送通知（镜像更新、群组任务完成）
• 容器状态变化实时监控与通知
• 镜像来源标记（远程/本地，自动识别私有镜像）
• 私有 Registry 认证（支持多个私有库，密码加密存储）
• 多环境管理（连接远程 DockerCopilot 实例，统一管理多个 Docker 环境）
• 重启服务（在 Web 界面一键重启 DockerCopilot 服务）

创建 docker-compose.yml 文件：

services:
  dockercopilot:
    image: muuua/docker-copilot:latest
    container_name: dockercopilot
    restart: always
    privileged: true
    network_mode: bridge
    ports:
      - 12712:12712
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai
      - secretKey=your_secret_key_here  # 必填，至少8位且非纯数字

启动服务：

docker-compose up -d

访问 http://localhost:12712/manager 进入管理界面。

docker run -d \
  --name dockercopilot \
  --restart always \
  --privileged \
  -p 12712:12712 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ./data:/data \
  -e TZ=Asia/Shanghai \
  -e secretKey=your_secret_key_here \
  muuua/docker-copilot:latest

支持自定义 Docker Registry 镜像地址，解决国内访问 Docker Hub 慢的问题：

镜像加速示例：

environment:
  - REGISTRY_MIRRORS_ENABLED=true
  - REGISTRY_MIRRORS=docker.m.daocloud.io,docker.1ms.run

优先级：用户配置 > 官方 Docker Hub > 内置加速器列表

支持 HTTP/HTTPS/SOCKS5 代理，应用于所有 HTTP 请求：

代理配置示例：

environment:
  - PROXY_ENABLED=true
  - PROXY_TYPE=http
  - PROXY_HOST=192.168.1.1
  - PROXY_PORT=7890

代理连接失败时会自动回退到直连。

支持配置私有 Docker Registry 的认证信息，用于拉取需要认证的私有镜像：

配置方式：

在 Web 界面「设置」→「私有 Registry 认证」中配置，支持添加多个私有 Registry。

工作原理：

1. 检查镜像更新时，自动根据镜像名匹配对应的私有 Registry 认证
2. 若远程 Registry 返回 404（镜像不存在），自动标记为「本地镜像」
3. 镜像列表中显示来源标签：「远程」（绿色）或「本地」（灰色）

私有镜像（如 registry.example.com/myapp:latest）需要配置对应 Registry 的认证信息才能正常检查更新。

适用于 NAS、树莓派等低性能设备优化：

低性能模式示例：

services:
  dockercopilot:
    image: muuua/docker-copilot:latest
    container_name: dockercopilot
    restart: always
    privileged: true
    ports:
      - 12712:12712
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai
      - secretKey=your_secret_key_here
      - LOW_POWER_MODE=true
      - MAX_CONCURRENT_CHECKS=1
      - CHECK_INTERVAL_MINUTES=60

所有配置支持三种方式设置，优先级从高到低：

1. 环境变量（最高优先级）
2. Web 界面设置（保存到数据库）
3. 默认值

环境变量设置会覆盖数据库中的配置，适合 Docker 部署时固定配置。

services:
  dockercopilot:
    # ... 其他配置
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/data
      - /path/to/backups:/backups  # 自定义备份目录
    environment:
      - BACKUP_DIR=/backups

services:
  dockercopilot:
    # ... 其他配置
    environment:
      - DOCKER_HOST=tcp://192.168.1.100:2375
    # 不需要挂载 docker.sock

DockerCopilot 支持通过 Bark 发送推送通知到 iOS 设备。

在设置页面配置 Bark 推送：

1. 在 iOS 设备上安装 Bark App
2. 获取推送密钥（App 首页显示）
3. 在 DockerCopilot 设置页面填写：
   • 服务器地址：默认 https://api.day.app，可自建服务器
   • 推送密钥：Bark App 中获取的密钥
   • 通知模式：
     • 始终通知：所有事件都发送通知
     • 仅失败时通知：只在操作失败时通知
     • 仅全部成功时通知：只在全部成功时通知
   • 显示具体明细：在通知中显示每个容器的详细结果

实时监控 Docker 容器状态变化，在以下事件发生时发送通知：

在设置页面的「容器状态变化通知」区域可以：

• 开启/关闭状态监控总开关
• 选择需要通知的事件类型

注意：容器状态变化通知依赖 Bark 推送配置，请先完成 Bark 配置。

DockerCopilot 支持连接多个远程 DockerCopilot 实例，实现统一管理多个 Docker 环境。

• 本地环境：程序启动时自动创建，代表当前运行的 Docker 环境
• 远程环境：连接其他部署的 DockerCopilot 实例
• 环境切换：在顶部导航栏快速切换当前操作的环境
• 统计信息：显示每个环境的容器数、镜像数、Volume 数、CPU 核心数、内存大小

1. 在「环境管理」页面点击「添加环境」
2. 填写远程 DockerCopilot 的 URL（如 http://192.168.1.100:12712）
3. 填写远程系统的 secretKey
4. 点击「测试连接」验证配置
5. 保存后自动刷新环境状态

• 切换环境：点击顶部导航栏的环境选择器，选择目标环境
• 连接环境：在环境列表点击「连接」按钮切换到该环境
• 刷新状态：点击「刷新」更新环境的统计信息

切换到远程环境后，容器列表、镜像列表等页面将显示远程环境的数据，所有操作也将在远程环境执行。

在「环境管理」页面，每个环境都提供「重启服务」按钮，可一键重启对应环境的 DockerCopilot 服务。

• 本地环境：直接重启当前运行的容器
• 远程环境：调用远程实例的重启 API

前提条件：所有环境的容器都需配置重启策略，确保重启后 Docker 自动拉起服务：

# Docker Compose
restart: always  # 或 unless-stopped

# Docker Run
docker run --restart=always ...  # 或 --restart=unless-stopped

本地服务重启后页面会自动刷新；远程服务重启后会自动刷新环境状态。

• Go 版本：1.23+
• 前端：Vue 3 + Vite + TailwindCSS
• 数据库：SQLite3

# 开发模式运行
./dev.sh

# 构建前端
cd frontend && npm run build

# 构建后端
go build -o dockerCopilot .

确保已正确挂载 Docker socket：

volumes:
  - /var/run/docker.sock:/var/run/docker.sock

并且容器具有访问权限（privileged: true）。

默认情况下更新后会删除旧容器。如需保留，设置环境变量：

environment:
  - DelOldContainer=false

检查时区设置是否正确：

environment:
  - TZ=Asia/Shanghai

AGPL-3.0