Skip to content

vickyyd/keep_alive

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

API Keep-Alive 保活工具

这是一个API保活工具,部署在Cloudflare Workers上,通过定时调用API来维持API的活跃状态,防止因长期不使用而失效。

功能特性

  • 🔄 自动保活: 定时调用配置的API以保持活跃状态
  • 📊 统计监控: 实时统计API调用次数、成功率等数据
  • 🎯 多API支持: 支持配置多个API端点同时管理
  • 💾 数据持久化: 使用Cloudflare D1数据库存储调用历史和统计数据
  • 🌐 Web界面: 提供直观的Web管理界面
  • 流式响应: 支持流式API调用,提高响应效率
  • 🔧 灵活配置: 支持动态更新API配置

部署步骤

1. 准备工作

在Cloudflare控制台中:

  1. 创建一个新的Cloudflare Worker
  2. 创建一个D1数据库,命名为 claude_keeper_d1
  3. 将D1数据库绑定到Worker中

2. 配置API

main.js 文件中配置你的API信息:

const API_CONFIGS = [
  {
    name: "Claude API 1",           // API显示名称
    apiName: "claude-4-sonnet",     // 调用的模型名称
    url: "https://api.example.com/v1/chat/completions", // API完整URL
    apiKey: "your-api-key-here"     // API密钥
  },
  // 可以添加更多API配置
];

3. 设置定时任务

在Cloudflare Worker的触发器页面中设置Cron触发器:

  • 建议设置为每1-5分钟执行一次
  • Cron表达式示例: */5 * * * * (每5分钟)

4. 部署代码

main.js 的内容复制到Cloudflare Worker编辑器中,然后部署。

使用方法

Web界面

访问你的Worker域名即可打开管理界面,支持:

  • 查看所有API的状态和统计信息
  • 手动调用单个或所有API
  • 查看调用历史记录
  • 清空历史数据
  • 更新API配置

API端点

  • GET / - 主页面,显示完整的状态面板
  • GET /invoke/{api_index} - 调用指定索引的API
  • GET /invoke-all - 调用所有配置的API
  • GET /api/data - 获取统计数据和历史记录
  • POST /api/clear-history - 清空历史记录
  • POST /api/update-configs - 更新API配置
  • GET /debug-cron - 查看定时任务执行情况

配置说明

全局配置

const CONFIG = {
  HISTORY_LIMIT: 50,          // 历史记录保留条数
  CACHE_TTL: 300000,          // 缓存有效期(毫秒)
  MAX_RETRIES: 3,             // API调用失败重试次数
  DEBUG_MODE: false,          // 调试模式开关
  QUESTIONS: [                // 保活调用使用的问题列表
    "Hi",
    "How are you", 
    "Ok"
  ]
};

数据库结构

工具会自动创建以下数据表:

  • api_stats - API统计信息
  • api_history - API调用历史
  • next_schedule - 下次调度时间

注意事项

  1. API配置安全: 请确保API密钥的安全性,不要暴露在公开代码中
  2. 调用频率: 建议根据API的使用条款设置合适的调用频率
  3. 资源消耗: 定时任务会消耗Cloudflare Workers的请求配额
  4. 数据备份: 定期备份D1数据库中的重要数据

故障排除

如果遇到问题,可以:

  1. 检查Cloudflare Worker的实时日志
  2. 使用Web界面的调试功能查看Cron执行情况
  3. 确认D1数据库绑定是否正确
  4. 验证API配置是否有效

许可证

本项目遵循MIT许可证。

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •