CC Router Ping

Claude Code API 监控系统

一个用于监控 Claude Code API 公益站点连通性和响应速度的全栈项目。

✨ 功能特性

- 🔍 使用 Claude CLI 实时监控多个 API 端点的连通性
- ⚡ 检测实际响应时间和速度
- 📊 可视化展示站点状态
- 🔄 自动定时刷新（30秒间隔）
- 🎨 现代化深/浅色主题切换
- 🧵 多线程并发测试，提高效率
- 🔗 邀请链接展示（仅在线站点显示）
- ➕ 动态添加监控端点
- ☁️ Serverless架构，支持Vercel部署
- 🔒 API路由中转，隐藏后端服务器IP

🏗️ 架构设计

Serverless架构

优势：
- ✅ 前端部署在Vercel，全球CDN加速
- ✅ 后端服务器IP不暴露在浏览器
- ✅ API请求通过Vercel中转，增加安全性
- ✅ 支持无域名的后端服务器部署

前置要求

必须安装 Claude Code CLI 工具

确保系统中已安装 claude 命令行工具。如果未安装，请访问：
https://docs.claude.com/claude-code

验证安装：

📁 项目结构

工作原理

本系统通过以下方式测试 API 连通性：

1. 为每个端点配置环境变量：
   - ANTHROPIC_AUTH_TOKEN - API 密钥
   - ANTHROPIC_BASE_URL - API 基础地址

2. 执行命令：claude --print "请回复'测试成功'"

3. 分析结果：
   - 如果输出包含 4xx 或 5xx 错误码 → 标记为离线，返回完整错误信息
   - 如果输出包含"成功"字样 → 标记为在线
   - 其他情况 → 标记为错误

4. 记录从执行命令到收到响应的完整时间作为响应时间参考

🚀 快速开始

方式一：Vercel部署（推荐）

详细步骤请查看 DEPLOY.md

简要步骤：

1. 部署后端服务器

2. 部署到Vercel

3. 配置环境变量

   在Vercel项目设置中添加：
   - BACKEND_URL = 你的后端服务器地址（如 http://123.45.67.89:3000）

4. 访问你的Vercel域名即可！

方式二：本地部署

1. 安装后端依赖

2. 配置 API 端点

编辑 backend/config.json 文件，添加你要监控的 API 站点：

配置说明：
- name: 站点名称
- apiBase: API 基础地址
- apiKey: API 密钥
- testInterval: 自动测试间隔（毫秒）
- timeout: 请求超时时间（毫秒）

3. 启动后端服务

服务将在 http://localhost:3000 启动

4. 访问前端页面

直接在浏览器中打开 frontend/index.html 文件，或使用本地服务器：

然后访问 http://localhost:8080

API 接口

GET /api/status
获取所有端点的最新状态

响应示例：

POST /api/test
手动触发一次测试

响应格式： 与 GET /api/status 相同

GET /api/config
获取配置信息（不包含 API 密钥）

GET /health
健康检查接口

状态说明

- 在线 (online): API 正常响应
- 离线 (offline): 无法连接到 API
- 错误 (error): 请求返回错误状态码
- 未知 (unknown): 尚未测试

响应时间评级

- 快速:  3000ms (红色)

技术栈

后端
- Node.js (内置 child_process 模块)
- Express
- Claude Code CLI (必须)

前端
- HTML5
- CSS3 (Modern Grid & Flexbox)
- Vanilla JavaScript (ES6+)

开发建议

使用 nodemon 自动重启

修改端口

设置环境变量 PORT:

或修改前端 script.js 中的 API_BASE…