如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Docker容器,用于Cronicle单服务器主节点部署。
0.8.28、latest https://github.com/javanile/cronicle/blob/master/Dockerfile0.8.28-letsencrypt、letsencrypt https://github.com/javanile/cronicle/blob/master/Dockerfile.letsencrypt0.8.28-s3、s3 https://github.com/javanile/cronicle/blob/master/Dockerfile.s3基于nodejs Docker镜像的Cronicle服务器最新版本。
与latest镜像功能相同,但增加了Let's Encrypt证书支持,可使Cronicle服务器通过SSL运行。如无需SSL,建议使用latest标签。
与latest镜像功能相同,但增加了Amazon S3存储支持。如无需S3存储,建议使用latest标签。
shdocker pull javanile/cronicle:latest
基础运行:
shdocker run -p 3012:3012 javanile/cronicle:latest
带持久化数据和日志的运行:
shdocker run --name cronicle \ -v /path-to-cronicle-storage/data:/opt/cronicle/data:rw \ -v /path-to-cronicle-storage/logs:/opt/cronicle/logs:rw \ --hostname localhost -p 3012:3012 javanile/cronicle:latest
Web UI可通过以下地址访问:http://localhost:3012
注意:请替换
localhost主机名,此仅用于测试!如重命名主机名,建议同时设置环境变量CRONICLE_base_app_url。 例如:docker run --name cronicle --hostname cronicle-host -p 3012:3012 -e CRONICLE_base_app_url='http://cronicle-host:3012' intelliops/cronicle:latest
Cronicle进程以cronicle用户(ID 1001,GUID 1001)运行。使用Docker绑定挂载时需相应设置权限。
| 路径 | 描述 |
|---|---|
| /opt/cronicle/data | 数据卷 |
| /opt/cronicle/logs | 日志卷 |
| /opt/cronicle/plugins | 插件卷 |
环境变量
Cronicle支持特殊环境变量语法,可指定命令行选项或覆盖配置设置。变量名格式为CRONICLE_key,其中key为命令行选项(见下表)或JSON配置属性路径。
通过环境变量覆盖配置属性时,可指定config.json中的顶级JSON键,或使用双下划线(__)作为路径分隔符的嵌套属性路径。布尔属性可使用1(真)和0(假)。
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| CRONICLE_base_app_url | 服务器上Cronicle的完整URL(含非标准端口),用于自引用链接 | http://localhost:3012 |
| CRONICLE_WebServer__http_port | Web UI的HTTP端口(除非明确了解,否则建议保持默认) | 3012 |
| CRONICLE_WebServer__https_port | Web UI的SSL端口(除非明确了解,否则建议保持默认) | 443 |
| CRONICLE_web_socket_use_hostnames | 设置为1时,强制Web UI使用主机名而非IP地址连接后端服务器(含AJAX API调用和Websocket流) | 1 |
| CRONICLE_server_comm_use_hostnames | 设置为1时,强制服务器间使用主机名而非LAN IP地址通信 | 1 |
| CRONICLE_web_direct_connect | 设置为0时,Web UI连接URL中的主机名/端口(需始终解析到主服务器),适用于单服务器或反向代理场景;设置为1时,直接连接各服务器(适用于多服务器及负载均衡场景) | 0 |
| CRONICLE_socket_io_transports | 自定义socket.io传输方式,WebSocket不允许时可将polling置于首位,否则设为["websocket"] | ["polling", "websocket"] |
自定义配置文件
可在以下路径提供自定义配置文件:
sh/path-to-cronicle-storage/data/config.json.import
该文件在Cronicle首次启动时加载。如需强制重新加载,删除以下文件并重启容器:
sh/path-to-cronicle-storage/data/.setup_done
Web界面默认凭据:admin / admin
shdocker-compose run --rm cronicle apply -m backup-script -h production -e my-event backup.sh
shdocker-compose stop && docker-compose rm -fr && docker-compose build && docker-compose up
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。





来自真实用户的反馈,见证轩辕镜像的优质服务