soulteary/cronicle

Docker Cronicle

简单轻量的Cronicle Docker解决方案。告别繁琐的配置与安装，一键启动您的定时任务中心。

镜像概述和主要用途

Cronicle是一款功能强大的开源定时任务调度系统，支持任务计划、执行、监控与日志管理。本Docker镜像提供了简单轻量的部署方案，旨在简化Cronicle的安装与配置流程，帮助用户快速搭建稳定可靠的定时任务中心，适用于各类定时任务管理场景。

核心功能和特性

• 一键部署：无需手动配置依赖，通过简单命令即可启动服务
• 数据持久化：支持本地持久化存储任务数据、日志及插件，确保数据不丢失
• 时区同步：可挂载本地时区文件，保证任务执行时间与系统时区一致
• 插件扩展：支持自定义插件目录挂载，扩展系统功能
• 轻量高效：优化镜像体积，资源占用低，运行稳定

使用场景和适用范围

• 服务器定时任务管理（如日志清理、数据备份）
• 自动化脚本执行（如数据同步、报表生成）
• 周期性任务调度与监控（如服务健康检查、API调用）
• 需要可视化界面管理定时任务的场景

详细使用方法和配置说明

获取镜像

拉取最新版本

bash
docker pull docker.xuanyuan.run/soulteary/cronicle

指定版本拉取

bash
docker pull docker.xuanyuan.run/soulteary/cronicle:0.9.16  # 例如拉取v0.9.16版本

支持版本

DockerHub地址：https://hub.docker.com/r/soulteary/cronicle
已支持版本：

• https://github.com/jhuckaby/Cronicle/releases/tag/v0.9.16
• https://github.com/jhuckaby/Cronicle/releases/tag/v0.9.11
• https://github.com/jhuckaby/Cronicle/releases/tag/v0.9.11
• https://github.com/jhuckaby/Cronicle/releases/tag/v0.8.62

Docker快速启动

通过以下命令启动容器，实现数据、日志和插件的本地持久化：

bash
docker run \
        -v /etc/localtime:/etc/localtime:ro \  # 挂载本地时区文件（只读）
        -v /etc/timezone:/etc/timezone:ro \    # 挂载时区配置（只读）
        -v `pwd`/data/data:/opt/cronicle/data:rw \    # 持久化任务数据（读写）
        -v `pwd`/data/logs:/opt/cronicle/logs:rw \    # 持久化日志文件（读写）
        -v `pwd`/data/plugins:/opt/cronicle/plugins:rw \  # 挂载插件目录（读写）
        -p 3012:3012 \  # 映射Web界面端口
        --hostname cronicle \  # 设置容器主机名
        --name cronicle \       # 设置容器名称
        soulteary/cronicle

服务启动后，通过浏览器访问：http://localhost:3012

Docker Compose部署

创建docker-compose.yml文件（示例配置）：

yaml
version: '3'
services:
  cronicle:
    image: docker.xuanyuan.run/soulteary/cronicle
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
      - ./data/data:/opt/cronicle/data:rw
      - ./data/logs:/opt/cronicle/logs:rw
      - ./data/plugins:/opt/cronicle/plugins:rw
    ports:
      - "3012:3012"
    hostname: cronicle
    container_name: cronicle
    restart: unless-stopped

启动服务：

bash
docker-compose down && docker-compose up -d

服务启动后，通过浏览器访问：http://localhost:3012

Traefik集成

如需通过Traefik反向代理访问，可参考docker-compose.traefik.yml配置文件（需自行准备Traefik环境）。

配置说明

持久化目录

端口映射

• 默认Web管理界面端口：3012，需映射至主机端口（如-p 3012:3012）

默认账户

首次登录使用以下默认账户：

• 用户名：admin
• 密码：admin
  注意：登录后建议立即修改密码以保障安全。

界面截图

首页

计划任务

事件管理

任务监控

账户与管理