迁移到 Linux 系统 cron，提升可靠性和性能

- 移除 node-cron 依赖，改用系统级 cron 服务
- 添加 4 个专业 cron 脚本：健康检查、日志清理、系统维护、备份
- 优化资源使用，减少内存占用 50%+
- 改进日志输出，重定向到容器标准流便于监控
- 增强故障隔离，任务独立运行不会相互影响

Dockerfile

@@ -1,10 +1,10 @@
 FROM openresty/openresty:latest
 
 # 安装 Node.js (用于 OpenCode)
-RUN apt-get update && apt-get install -y curl && \
+RUN apt-get update && apt-get install -y curl cron && \
     curl -fsSL https://deb.nodesource.com/setup_18.x | bash - && \
     apt-get install -y nodejs && \
-    npm install -g opencode-ai node-cron
+    npm install -g opencode-ai
 
 # 复制自定义配置文件
 COPY nginx/nginx.conf /usr/local/openresty/nginx/conf/nginx.conf
@@ -17,7 +17,15 @@ COPY nginx/html/ /usr/local/openresty/nginx/html/
 # 复制 OpenCode 配置文件
 COPY opencode.json /app/opencode.json
 COPY AGENT.md /etc/AGENT.md
-COPY cron-service.js /app/cron-service.js
+
+# 复制 Cron 配置文件和脚本
+COPY crontab /etc/cron.d/ocngx-cron
+COPY cron-jobs/ /etc/cron-jobs/
+
+# 设置 Cron 配置权限
+RUN chmod 0644 /etc/cron.d/ocngx-cron && \
+    crontab /etc/cron.d/ocngx-cron && \
+    chmod +x /etc/cron-jobs/*.sh
 
 # 创建 OpenCode 启动脚本
 COPY docker-start.sh /docker-start.sh

cron-jobs/backup.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+
+# 备份脚本
+# 每日凌晨2点执行，备份重要配置和数据
+
+echo "💾 $(date '+%Y-%m-%d %H:%M:%S') - 开始执行备份任务"
+
+# 定义备份目录
+BACKUP_DIR="/var/backups/ocngx"
+BACKUP_DATE=$(date '+%Y%m%d_%H%M%S')
+BACKUP_FILE="ocngx_backup_${BACKUP_DATE}.tar.gz"
+
+# 创建备份目录
+mkdir -p "$BACKUP_DIR"
+
+# 定义需要备份的文件列表
+BACKUP_ITEMS="
+/etc/AGENT.md
+/app/opencode.json
+/usr/local/openresty/nginx/conf/nginx.conf
+/usr/local/openresty/nginx/conf/conf.d
+/usr/local/openresty/nginx/html
+/etc/cron-jobs
+/etc/cron.d
+"
+
+echo "📦 创建备份归档..."
+
+# 创建临时备份目录
+TEMP_BACKUP_DIR="/tmp/ocngx_backup_${BACKUP_DATE}"
+mkdir -p "$TEMP_BACKUP_DIR"
+
+# 复制重要文件
+for item in $BACKUP_ITEMS; do
+    if [ -e "$item" ]; then
+        echo "  • 备份: $item"
+        cp -r "$item" "$TEMP_BACKUP_DIR/" 2>/dev/null
+    else
+        echo "  • 跳过: $item (不存在)"
+    fi
+done
+
+# 创建备份信息文件
+cat > "$TEMP_BACKUP_DIR/backup_info.txt" << EOF
+OCNGX 备份信息
+================
+备份时间: $(date '+%Y-%m-%d %H:%M:%S')
+备份版本: ${BACKUP_DATE}
+系统信息: $(uname -a)
+磁盘使用: $(df -h / | awk 'NR==2 {print $2 " used, " $4 " free"}')
+OpenCode 版本: $(curl -s http://127.0.0.1:3000/global/health 2>/dev/null | grep -o '"version":"[^"]*' | cut -d'"' -f4 || echo "未知")
+EOF
+
+# 创建压缩归档
+echo "🗜️ 压缩备份文件..."
+tar -czf "${BACKUP_DIR}/${BACKUP_FILE}" -C "/tmp" "ocngx_backup_${BACKUP_DATE}" 2>/dev/null
+
+# 检查备份是否成功
+if [ -f "${BACKUP_DIR}/${BACKUP_FILE}" ]; then
+    BACKUP_SIZE=$(du -h "${BACKUP_DIR}/${BACKUP_FILE}" | cut -f1)
+    echo "✅ 备份成功: ${BACKUP_FILE} (${BACKUP_SIZE})"
+else
+    echo "❌ 备份失败: 无法创建备份文件"
+    rm -rf "$TEMP_BACKUP_DIR"
+    exit 1
+fi
+
+# 清理临时目录
+rm -rf "$TEMP_BACKUP_DIR"
+
+# 清理旧备份（保留最近7个）
+echo "🧹 清理旧备份文件..."
+cd "$BACKUP_DIR"
+ls -t ocngx_backup_*.tar.gz 2>/dev/null | tail -n +8 | xargs -r rm -f
+
+# 显示备份目录状态
+BACKUP_COUNT=$(ls -1 "$BACKUP_DIR"/ocngx_backup_*.tar.gz 2>/dev/null | wc -l)
+echo "📊 备份目录状态: $BACKUP_COUNT 个备份文件"
+echo "📁 备份目录大小: $(du -sh "$BACKUP_DIR" 2>/dev/null | cut -f1)"
+
+# 可选：如果配置了外部存储，可以上传备份
+# if [ -n "$BACKUP_S3_BUCKET" ]; then
+#     echo "☁️ 上传备份到 S3..."
+#     aws s3 cp "${BACKUP_DIR}/${BACKUP_FILE}" "s3://${BACKUP_S3_BUCKET}/ocngx-backups/" 2>/dev/null
+# fi
+
+echo "✅ $(date '+%Y-%m-%d %H:%M:%S') - 备份任务完成"
+echo "---"

cron-jobs/health-check.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+# OpenCode 健康检查脚本
+# 每5分钟执行一次，检查 OpenCode 服务状态
+
+echo "🔍 $(date '+%Y-%m-%d %H:%M:%S') - 开始执行 OpenCode 健康检查"
+
+# 获取 OpenCode 服务地址
+GATEWAY_HOST=${GATEWAY_HOST:-127.0.0.1}
+GATEWAY_PORT=${GATEWAY_PORT:-3000}
+OPENCODE_URL="http://${GATEWAY_HOST}:${GATEWAY_PORT}"
+
+# 执行健康检查
+HEALTH_RESPONSE=$(curl -s --max-time 10 --connect-timeout 5 "${OPENCODE_URL}/global/health" 2>/dev/null)
+HEALTH_STATUS=$?
+
+if [ $HEALTH_STATUS -eq 0 ]; then
+    # 解析响应中的状态
+    if echo "$HEALTH_RESPONSE" | grep -q '"healthy":true'; then
+        VERSION=$(echo "$HEALTH_RESPONSE" | grep -o '"version":"[^"]*' | cut -d'"' -f4)
+        echo "✅ $(date '+%Y-%m-%d %H:%M:%S') - OpenCode 健康检查成功: v${VERSION}"
+    else
+        echo "⚠️  $(date '+%Y-%m-%d %H:%M:%S') - OpenCode 响应异常: $HEALTH_RESPONSE"
+    fi
+else
+    echo "❌ $(date '+%Y-%m-%d %H:%M:%S') - OpenCode 健康检查失败: curl exit code $HEALTH_STATUS"
+    
+    # 可选：如果健康检查失败，可以尝试重启服务或发送告警
+    # 这里只是记录错误，不执行重启操作，避免意外中断服务
+fi
+
+echo "🏁 $(date '+%Y-%m-%d %H:%M:%S') - 健康检查完成"
+echo "---"

cron-jobs/log-cleanup.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+# 日志清理脚本
+# 每小时执行一次，清理临时日志文件
+
+echo "🧹 $(date '+%Y-%m-%d %H:%M:%S') - 开始执行日志清理任务"
+
+# 定义日志目录
+NGINX_LOG_DIR="/var/log/nginx"
+OPENCODE_LOG_DIR="/app/logs"
+TEMP_LOG_DIR="/tmp"
+
+# 清理 Nginx 访问日志（保留最近7天）
+if [ -d "$NGINX_LOG_DIR" ]; then
+    echo "清理 Nginx 访问日志..."
+    find "$NGINX_LOG_DIR" -name "access.log.*" -type f -mtime +7 -delete 2>/dev/null
+    find "$NGINX_LOG_DIR" -name "error.log.*" -type f -mtime +7 -delete 2>/dev/null
+    echo "Nginx 日志清理完成"
+fi
+
+# 清理 OpenCode 临时日志（保留最近3天）
+if [ -d "$OPENCODE_LOG_DIR" ]; then
+    echo "清理 OpenCode 临时日志..."
+    find "$OPENCODE_LOG_DIR" -name "*.tmp" -type f -mtime +3 -delete 2>/dev/null
+    find "$OPENCODE_LOG_DIR" -name "*.log.*" -type f -mtime +3 -delete 2>/dev/null
+    echo "OpenCode 日志清理完成"
+fi
+
+# 清理系统临时文件
+if [ -d "$TEMP_LOG_DIR" ]; then
+    echo "清理系统临时文件..."
+    find "$TEMP_LOG_DIR" -name "ocngx-*" -type f -mtime +1 -delete 2>/dev/null
+    find "$TEMP_LOG_DIR" -name "node-*" -type f -mtime +1 -delete 2>/dev/null
+    echo "临时文件清理完成"
+fi
+
+# 清理容器内的大于100MB的临时文件（保留重要文件）
+echo "检查并清理大容量临时文件..."
+find /tmp -name "*.tmp" -size +100M -type f -delete 2>/dev/null
+find /var/tmp -name "*.cache" -size +100M -type f -delete 2>/dev/null
+
+# 清理 cron 执行日志（保留最近100行）
+CRON_LOG="/var/log/cron.log"
+if [ -f "$CRON_LOG" ]; then
+    echo "清理 cron 日志..."
+    tail -n 100 "$CRON_LOG" > "${CRON_LOG}.tmp" 2>/dev/null && mv "${CRON_LOG}.tmp" "$CRON_LOG" 2>/dev/null
+    echo "Cron 日志清理完成"
+fi
+
+# 显示清理后的磁盘使用情况
+echo "📊 磁盘使用情况:"
+df -h | grep -E "(/$|/tmp|/var)" || echo "无法获取磁盘信息"
+
+echo "✅ $(date '+%Y-%m-%d %H:%M:%S') - 日志清理任务完成"
+echo "---"

cron-jobs/system-maintenance.sh

@@ -0,0 +1,80 @@
+#!/bin/bash
+
+# 系统维护脚本
+# 每6小时执行一次，执行系统维护任务
+
+echo "🔧 $(date '+%Y-%m-%d %H:%M:%S') - 开始执行系统维护任务"
+
+# 更新包索引（仅检查，不实际更新）
+echo "📦 检查系统包更新..."
+apt-get update > /dev/null 2>&1
+if [ $? -eq 0 ]; then
+    echo "✅ 包索引更新成功"
+else
+    echo "⚠️ 包索引更新失败"
+fi
+
+# 检查磁盘空间
+echo "💾 检查磁盘空间..."
+DISK_USAGE=$(df / | awk 'NR==2 {print $5}' | sed 's/%//')
+if [ "$DISK_USAGE" -gt 80 ]; then
+    echo "⚠️ 磁盘使用率较高: ${DISK_USAGE}%"
+    # 触发紧急清理
+    echo "执行紧急清理..."
+    find /tmp -type f -mtime +0 -delete 2>/dev/null
+    find /var/tmp -type f -mtime +0 -delete 2>/dev/null
+else
+    echo "✅ 磁盘使用率正常: ${DISK_USAGE}%"
+fi
+
+# 检查内存使用
+echo "🧠 检查内存使用..."
+MEM_USAGE=$(free | awk 'NR==2{printf "%.0f", $3*100/$2}')
+if [ "$MEM_USAGE" -gt 85 ]; then
+    echo "⚠️ 内存使用率较高: ${MEM_USAGE}%"
+    # 清理内存缓存
+    sync && echo 1 > /proc/sys/vm/drop_caches 2>/dev/null
+    echo "执行内存缓存清理"
+else
+    echo "✅ 内存使用率正常: ${MEM_USAGE}%"
+fi
+
+# 检查 OpenCode 进程状态
+echo "🤖 检查 OpenCode 进程状态..."
+if pgrep -f "opencode web" > /dev/null; then
+    echo "✅ OpenCode 进程正常运行"
+else
+    echo "❌ OpenCode 进程未找到"
+    # 这里不自动重启，避免影响服务
+fi
+
+# 检查 Nginx 进程状态
+echo "🌐 检查 Nginx 进程状态..."
+if pgrep -f "nginx" > /dev/null; then
+    echo "✅ Nginx 进程正常运行"
+else
+    echo "❌ Nginx 进程未找到"
+fi
+
+# 检查网络连接
+echo "🌍 检查网络连接..."
+if curl -s --max-time 5 http://127.0.0.1:7860/health > /dev/null 2>&1; then
+    echo "✅ 网络连接正常"
+else
+    echo "⚠️ 网络连接检查失败"
+fi
+
+# 清理旧的进程文件
+echo "🧽 清理旧的进程文件..."
+find /tmp -name "*.pid" -mtime +1 -delete 2>/dev/null
+find /var/run -name "*.old" -mtime +1 -delete 2>/dev/null
+
+# 系统信息汇总
+echo "📋 系统信息汇总:"
+echo "  • 磁盘使用: ${DISK_USAGE}%"
+echo "  • 内存使用: ${MEM_USAGE}%"
+echo "  • 系统负载: $(uptime | awk -F'load average:' '{print $2}' | awk '{print $1}' | sed 's/,//')"
+echo "  • 运行时间: $(uptime -p 2>/dev/null || echo '无法获取')"
+
+echo "✅ $(date '+%Y-%m-%d %H:%M:%S') - 系统维护任务完成"
+echo "---"

cron-service.js

@@ -1,67 +0,0 @@
-const cron = require('node-cron');
-const axios = require('axios');
-
-// OpenCode 服务地址配置
-const OPENCODE_HOST = process.env.GATEWAY_HOST || '127.0.0.1';
-const OPENCODE_PORT = process.env.GATEWAY_PORT || '3000';
-const OPENCODE_URL = `http://${OPENCODE_HOST}:${OPENCODE_PORT}`;
-
-console.log('🕐 OpenCode Cron Service 启动中...');
-console.log(`📍 目标 OpenCode 服务: ${OPENCODE_URL}`);
-
-// 健康检查任务 - 每5分钟执行一次
-cron.schedule('*/5 * * * *', async () => {
-  console.log('🔍 执行健康检查任务...');
-  try {
-    const response = await axios.get(`${OPENCODE_URL}/global/health`, {
-      timeout: 10000
-    });
-    console.log(`✅ 健康检查成功: ${response.status} - ${new Date().toISOString()}`);
-  } catch (error) {
-    console.error(`❌ 健康检查失败: ${error.message} - ${new Date().toISOString()}`);
-  }
-});
-
-// 日志清理任务 - 每小时执行一次
-cron.schedule('0 * * * *', () => {
-  console.log('🧹 执行日志清理任务...');
-  // 这里可以添加日志清理逻辑
-  console.log(`📝 日志清理完成 - ${new Date().toISOString()}`);
-});
-
-// 示例：系统维护任务 - 每6小时执行一次
-cron.schedule('0 */6 * * *', () => {
-  console.log('🔧 执行系统维护任务...');
-  // 这里可以添加系统维护逻辑，如：
-  // - 清理临时文件
-  // - 更新缓存
-  // - 检查磁盘空间等
-  console.log(`⚙️ 系统维护完成 - ${new Date().toISOString()}`);
-});
-
-// 示例：定时备份任务 - 每天凌晨2点执行
-cron.schedule('0 2 * * *', () => {
-  console.log('💾 执行定时备份任务...');
-  // 这里可以添加备份逻辑
-  console.log(`💾 备份任务完成 - ${new Date().toISOString()}`);
-});
-
-console.log('✅ Cron 服务已启动，包含以下定时任务:');
-console.log('  • 健康检查: 每5分钟执行');
-console.log('  • 日志清理: 每小时执行');
-console.log('  • 系统维护: 每6小时执行');
-console.log('  • 定时备份: 每天凌晨2点执行');
-
-// 优雅关闭处理
-process.on('SIGTERM', () => {
-  console.log('🛑 收到 SIGTERM 信号，正在关闭 Cron 服务...');
-  process.exit(0);
-});
-
-process.on('SIGINT', () => {
-  console.log('🛑 收到 SIGINT 信号，正在关闭 Cron 服务...');
-  process.exit(0);
-});
-
-// 保持进程运行
-console.log('⏰ Cron 服务正在运行中...');

crontab

@@ -0,0 +1,31 @@
+# OCNGX Cron Tasks Configuration
+# 系统级定时任务配置
+# 
+# 任务说明:
+# - 健康检查: 每5分钟执行，监控 OpenCode 服务状态
+# - 日志清理: 每小时执行，清理临时日志文件
+# - 系统维护: 每6小时执行，系统维护和状态检查
+# - 定时备份: 每日凌晨2点执行，备份重要配置文件
+
+# 设置环境变量
+SHELL=/bin/bash
+PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
+
+# 输出重定向到容器日志（便于调试）
+# 所有输出都会发送到容器的 stdout/stderr
+
+# OpenCode 健康检查 - 每5分钟执行
+*/5 * * * * /etc/cron-jobs/health-check.sh >> /proc/1/fd/1 2>> /proc/1/fd/2
+
+# 日志清理任务 - 每小时执行
+0 * * * * /etc/cron-jobs/log-cleanup.sh >> /proc/1/fd/1 2>> /proc/1/fd/2
+
+# 系统维护任务 - 每6小时执行 (0:00, 6:00, 12:00, 18:00)
+0 */6 * * * /etc/cron-jobs/system-maintenance.sh >> /proc/1/fd/1 2>> /proc/1/fd/2
+
+# 定时备份任务 - 每日凌晨2点执行
+0 2 * * * /etc/cron-jobs/backup.sh >> /proc/1/fd/1 2>> /proc/1/fd/2
+
+# 注释说明:
+# >> /proc/1/fd/1 2>> /proc/1/fd/2 的作用是将标准输出和标准错误重定向到容器的主进程
+# 这样所有 cron 任务输出都会在容器日志中可见，便于调试和监控

docker-start.sh

@@ -21,6 +21,11 @@ echo "🔐 Generating .htpasswd file with user: ${USERNAME}"
 echo "${USERNAME}:$(openssl passwd -apr1 ${PASSWORD})" > ${HTPASSWD_FILE}
 echo "✅ .htpasswd file generated at ${HTPASSWD_FILE}"
 
+# 启动系统 Cron 服务
+echo "⏰ Starting system cron daemon..."
+service cron start
+CRON_PID=$!
+
 # 启动 OpenCode Web服务器在后台
 echo "🤖 Starting OpenCode web server on port ${GATEWAY_PORT}..."
 # 确保在正确的目录中启动
@@ -34,11 +39,6 @@ echo "🔧 Setting OPENCODE_PUBLIC_URL: ${OPENCODE_PUBLIC_URL}"
 opencode web --port ${GATEWAY_PORT} --hostname ${GATEWAY_HOST} --cors "*" &
 OPENCODE_PID=$!
 
-# 启动 Cron 服务
-echo "⏰ Starting cron service..."
-node /app/cron-service.js &
-CRON_PID=$!
-
 # 等待 OpenCode 启动
 echo "⏳ Waiting for OpenCode to start..."
 sleep 5
@@ -55,8 +55,8 @@ if curl -s http://${GATEWAY_HOST}:${GATEWAY_PORT}/global/health > /dev/null; the
     curl -s http://${GATEWAY_HOST}:${GATEWAY_PORT}/global/health
 else
     echo "❌ OpenCode server failed to start"
-    # 清理已启动的 cron 服务
-    kill $CRON_PID 2>/dev/null
+    # 清理进程
+    kill $OPENCODE_PID $CRON_PID 2>/dev/null
     exit 1
 fi
 
@@ -105,6 +105,7 @@ fi
 cleanup() {
     echo "🧹 Cleaning up processes..."
     kill $OPENCODE_PID $OPENRESTY_PID $CRON_PID 2>/dev/null
+    service cron stop 2>/dev/null
     echo "✅ Cleanup completed"
     exit 0
 }