mcuadros/ofelia 读取 TOML/INI 配置或 Docker label，在指定 schedule 对目标容器执行 run/exec 命令，相当于 Docker 原生 cron。典型用于备份脚本、日志轮转或周期性 health check。必须挂载 /var/run/docker.sock，具有宿主机容器控制权，禁止部署于不可信多租户 Kubernetes。与 K8s CronJob 相比面向 docker compose 单机栈；生产应限制配置文件权限并审计 job 命令。

快速启动

docker run -d --name ofelia \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v $(pwd)/config.ini:/etc/ofelia/config.ini \
  docker.io/mcuadros/ofelia:latest daemon --docker

推荐实践

docker run -d --name ofelia \
  --restart unless-stopped \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /data/ofelia/config.ini:/etc/ofelia/config.ini:ro \
  docker.io/mcuadros/ofelia:0.3.12 \
  daemon --docker --config=/etc/ofelia/config.ini

核心参数说明

• -v /var/run/docker.sock:... — 控制宿主机 Docker 引擎
• -v .../config.ini:... — cron job 定义文件
• daemon --docker — 从 Docker label 或配置文件读取任务
• --restart unless-stopped — 调度器持续运行
• 固定 tag — 与 compose 栈版本 pin
• 警告 — docker.sock 等效 root，禁止不可信环境