v2.3.0

Claude EndPoints Forwarder v2.3.0

🔧 修复

令牌解析机制修复

• 修复配置继承问题：解决了令牌在配置阶段错误继承的问题
• 实现动态解析：令牌和 API 密钥改为在请求时动态解析，确保组切换时使用正确的密钥
• 修复组密钥共享：修复了同组端点之间密钥共享不正确的问题
• 改进故障转移：修复了组切换时密钥使用错误的问题

系统稳定性改进

• 重试逻辑优化：改进了组切换和冷却机制的实现
• 健康检查修复：修复了健康检查中的令牌使用问题
• 代理处理修复：修复了代理请求中的令牌注入问题

📚 文档更新

• 配置说明修正：更新了配置文件中关于令牌继承的错误说明
• 最佳实践指南：添加了正确的令牌配置和使用方法
• 双语文档：完整更新中英文 README 文档

🐛 其他修复

• 修复 TUI 编辑优先级的问题
• 修复部分 UI 显示问题
• 修复了在组故障转移场景下的令牌处理错误

⬆️ 升级说明

此版本修复了关键的令牌解析问题，强烈建议升级以确保组管理和故障转移功能的正确性。

⚠️ 注意

组管理与功能是新添加的实验性功能，如果遇到任何问题欢迎提交issues

📦 安装

git clone https://github.com/xinhai-ai/endpoint_forwarder.git
cd endpoint_forwarder
go build -o endpoint_forwarder

---

注意：此版本包含重要的错误修复，请参考更新后的文档了解正确的配置方法。

📦 下载说明

请根据您的操作系统下载对应的版本：

• Windows: endpoint_forwarder-windows-amd64.zip (64位) 或 endpoint_forwarder-windows-arm64.zip (ARM64)
• macOS: endpoint_forwarder-darwin-amd64.tar.gz (Intel) 或 endpoint_forwarder-darwin-arm64.tar.gz (Apple Silicon)
• Linux: endpoint_forwarder-linux-amd64.tar.gz (64位) 或 endpoint_forwarder-linux-arm64.tar.gz (ARM64) 或 endpoint_forwarder-linux-arm.tar.gz (ARM32)

🚀 快速开始

1. 下载适合您系统的压缩包
2. 解压文件
3. 复制 example.yaml 为 config.yaml 并根据需要修改配置
4. 运行程序: ./endpoint_forwarder -config config.yaml

📋 版本信息

• 版本: v2.3.0
• 提交: 4ce1954
• 构建时间: 2025-09-02T20:37:25+08:00

查看更多信息请参阅 README.md

Full Changelog: v2.2.0...v2.3.0

v2.2.0

Claude EndPoints Forwarder v2.2.0

端点分组管理

• 支持将端点按组进行管理，每组可设置独立的优先级
• 组内端点支持独立的优先级设置
• 智能组选择机制，优先使用高优先级的活跃组

冷却机制

• 当组内所有端点失败时，自动进入冷却状态
• 可配置的冷却时间（默认600秒）
• 冷却期间组内端点不会被选中，避免重复失败

优化改进

• 健康检查仅针对活跃组中的端点，提高效率
• 重试逻辑支持组级别的故障转移
• TUI界面显示组状态和冷却信息
• 配置文件新增组管理相关设置

配置更新

• 新增 group.cooldown 配置项
• 端点配置支持 group 和 group-priority 字段
• 更新示例配置文件展示分组功能
• 新增api-key适配X-Api-Key 鉴权方法
• 允许在TUI中临时或永久更新端点的优先级

📦 下载说明

请根据您的操作系统下载对应的版本：

• Windows: endpoint_forwarder-windows-amd64.zip (64位) 或 endpoint_forwarder-windows-arm64.zip (ARM64)
• macOS: endpoint_forwarder-darwin-amd64.tar.gz (Intel) 或 endpoint_forwarder-darwin-arm64.tar.gz (Apple Silicon)
• Linux: endpoint_forwarder-linux-amd64.tar.gz (64位) 或 endpoint_forwarder-linux-arm64.tar.gz (ARM64) 或 endpoint_forwarder-linux-arm.tar.gz (ARM32)

🚀 快速开始

1. 下载适合您系统的压缩包
2. 解压文件
3. 复制 example.yaml 为 config.yaml 并根据需要修改配置
4. 运行程序: ./endpoint_forwarder -config config.yaml

📋 版本信息

• 版本: v2.2.0
• 提交: e5d85de
• 构建时间: 2025-09-01T22:22:58+08:00

查看更多信息请参阅 README.md

Full Changelog: v2.1.0...v2.2.0

v2.1.0

Claude Request Forwarder v2.1.0

🐛 问题修复

• 修复Gzip处理: 解决非流式请求中gzip编码响应显示压缩二进制数据而非可读内容的问题
• 内容不匹配预防: 消除客户端接收解压内容但仍保留压缩头部的情况
• 修复可能因此导致的claude code 报错

📦 下载说明

请根据您的操作系统下载对应的版本：

• Windows: endpoint_forwarder-windows-amd64.zip (64位) 或 endpoint_forwarder-windows-arm64.zip (ARM64)
• macOS: endpoint_forwarder-darwin-amd64.tar.gz (Intel) 或 endpoint_forwarder-darwin-arm64.tar.gz (Apple Silicon)
• Linux: endpoint_forwarder-linux-amd64.tar.gz (64位) 或 endpoint_forwarder-linux-arm64.tar.gz (ARM64) 或 endpoint_forwarder-linux-arm.tar.gz (ARM32)

🚀 快速开始

1. 下载适合您系统的压缩包
2. 解压文件
3. 复制 example.yaml 为 config.yaml 并根据需要修改配置
4. 运行程序: ./endpoint_forwarder -config config.yaml

📋 版本信息

• 版本: v2.1.0
• 提交: c9e1caa
• 构建时间: 2025-08-29T18:34:18+08:00

查看更多信息请参阅 README.md

What's Changed

• feat: 支持命令行动态设置端点优先级 by @lisiao in #1

New Contributors

• @lisiao made their first contribution in #1

Full Changelog: v2.0.0...v2.1.0

v2.0.0

Claude Request Forwarder v2.0.0

🚀 Endpoint Forwarder v2.0.0 - 重大功能更新

这是一个里程碑式的重大更新，引入了全新的TUI界面、完整的令牌统计系统和增强的调试功能！

🖥️ 全新TUI终端界面

• 实时监控界面 - 现代化的终端用户界面，告别纯命令行体验
• 多标签视图 - 5个专业监控界面：
  • 📊 Overview - 系统概览和关键指标
  • 🎯 Endpoints - 端点状态和详细信息
  • 🔗 Connections - 活跃连接和历史记录
  • 📝 Logs - 实时日志流和过滤
  • ⚙️ Configuration - 配置查看和热重载
• 响应式布局 - 自适应终端大小，完美显示效果
• 实时数据刷新 - 1秒间隔更新，掌握系统实时状态

🪙 Claude API令牌统计系统

• 完整令牌追踪 - 准确统计输入/输出令牌使用量
• 缓存令牌支持 - 独立统计缓存创建和读取令牌
• 历史数据可视化 - 过去连接的令牌使用历史
• 端点级别统计 - 每个端点的详细令牌消耗分析
• 实时令牌监控 - TUI界面中的令牌使用实时显示

🐛 增强调试功能

• 服务器响应调试 - 显示服务器返回内容前200字符
• SSE流调试 - 累积流式事件并定期输出调试信息
• 优化日志格式 - 使用中文标识符，便于快速识别和调试
• Token Parser优化 - 修复日志显示问题，确保调试信息正确输出

🔧 系统改进

• 配置热重载 - 无需重启即可应用配置更改
• 用户体验优化 - 更直观的界面和更流畅的操作
• 日志系统增强 - 结构化日志和更好的错误信息
• 监控数据完整性 - 连接历史、性能指标和令牌统计的完整记录

📦 使用方法

启用TUI界面 (推荐)
./endpoint_forwarder -config config/config.yaml

传统控制台模式
./endpoint_forwarder -config config/config.yaml --no-tui

🎯 适用场景

• Claude API代理服务 - 透明转发Claude API请求
• 多端点负载均衡 - 智能路由和故障转移
• API使用量监控 - 精确的令牌消耗统计
• 开发调试环境 - 详细的请求/响应调试信息
• 生产环境监控 - 实时系统状态和性能指标

🔄 从v1.x升级

此版本完全向后兼容v1.x配置文件。只需：

1. 下载新版本二进制文件
2. 使用现有配置文件启动
3. 享受全新的TUI体验！

🔍 调试和监控

• 启用调试日志获得更详细的服务器响应信息
• 使用TUI界面实时监控系统性能和令牌使用
• 查看连接历史了解API调用模式

📦 下载说明

请根据您的操作系统下载对应的版本：

• Windows: endpoint_forwarder-windows-amd64.zip (64位) 或 endpoint_forwarder-windows-arm64.zip (ARM64)
• macOS: endpoint_forwarder-darwin-amd64.tar.gz (Intel) 或 endpoint_forwarder-darwin-arm64.tar.gz (Apple Silicon)
• Linux: endpoint_forwarder-linux-amd64.tar.gz (64位) 或 endpoint_forwarder-linux-arm64.tar.gz (ARM64) 或 endpoint_forwarder-linux-arm.tar.gz (ARM32)

🚀 快速开始

1. 下载适合您系统的压缩包
2. 解压文件
3. 复制 example.yaml 为 config.yaml 并根据需要修改配置
4. 运行程序: ./endpoint_forwarder -config config.yaml

📋 版本信息

• 版本: v2.0.0
• 提交: c3cf65e
• 构建时间: 2025-08-28T10:45:03+08:00

查看更多信息请参阅 README.md

Full Changelog: v1.4.1...v2.0.0

v1.4.1

Claude Request Forwarder v1.4.1

修复代理没有正确生效的问题

📦 下载说明

请根据您的操作系统下载对应的版本：

• Windows: endpoint_forwarder-windows-amd64.zip (64位) 或 endpoint_forwarder-windows-arm64.zip (ARM64)
• macOS: endpoint_forwarder-darwin-amd64.tar.gz (Intel) 或 endpoint_forwarder-darwin-arm64.tar.gz (Apple Silicon)
• Linux: endpoint_forwarder-linux-amd64.tar.gz (64位) 或 endpoint_forwarder-linux-arm64.tar.gz (ARM64) 或 endpoint_forwarder-linux-arm.tar.gz (ARM32)

🚀 快速开始

1. 下载适合您系统的压缩包
2. 解压文件
3. 复制 example.yaml 为 config.yaml 并根据需要修改配置
4. 运行程序: ./endpoint_forwarder -config config.yaml

📋 版本信息

• 版本: v1.4.1
• 提交: 4633ce3
• 构建时间: 2025-08-27T13:08:26+08:00

查看更多信息请参阅 README.md

Full Changelog: v1.4.0...v1.4.1

v1.4.0

Claude Request Forwarder v1.4.0

主要新功能：

• 🔄 配置文件自动重载：支持配置文件热更新，无需重启服务
• 🔁 HTTP状态码感知重试：5xx服务器错误、400请求错误、429频率限制自动重试
• 📋 详细日志输出：显示重试原因、状态码和端点切换信息
• ⚡ 组件热更新：所有模块支持配置变更时自动更

技术改进：

• 添加fsnotify文件监听支持
• 增强RetryHandler支持HTTP响应分析
• ConfigWatcher实现线程安全的配置管理
• 智能重试决策算法

📦 下载说明

请根据您的操作系统下载对应的版本：

• Windows: endpoint_forwarder-windows-amd64.zip (64位) 或 endpoint_forwarder-windows-arm64.zip (ARM64)
• macOS: endpoint_forwarder-darwin-amd64.tar.gz (Intel) 或 endpoint_forwarder-darwin-arm64.tar.gz (Apple Silicon)
• Linux: endpoint_forwarder-linux-amd64.tar.gz (64位) 或 endpoint_forwarder-linux-arm64.tar.gz (ARM64) 或 endpoint_forwarder-linux-arm.tar.gz (ARM32)

🚀 快速开始

1. 下载适合您系统的压缩包
2. 解压文件
3. 复制 example.yaml 为 config.yaml 并根据需要修改配置
4. 运行程序: ./endpoint_forwarder -config config.yaml

📋 版本信息

• 版本: v1.4.0
• 提交: 5279f88
• 构建时间: 2025-08-27T12:50:16+08:00

查看更多信息请参阅 README.md

Full Changelog: v1.3.0...v1.4.0

v1.3.0

Claude Request Forwarder v1.3.0

📦 下载说明

请根据您的操作系统下载对应的版本：

• Windows: endpoint_forwarder-windows-amd64.zip (64位) 或 endpoint_forwarder-windows-arm64.zip (ARM64)
• macOS: endpoint_forwarder-darwin-amd64.tar.gz (Intel) 或 endpoint_forwarder-darwin-arm64.tar.gz (Apple Silicon)
• Linux: endpoint_forwarder-linux-amd64.tar.gz (64位) 或 endpoint_forwarder-linux-arm64.tar.gz (ARM64) 或 endpoint_forwarder-linux-arm.tar.gz (ARM32)

🚀 快速开始

1. 下载适合您系统的压缩包
2. 解压文件
3. 复制 example.yaml 为 config.yaml 并根据需要修改配置
4. 运行程序: ./endpoint_forwarder -config config.yaml

📋 版本信息

• 版本: v1.3.0
• 提交: 8a98bff
• 构建时间: 2025-08-27T11:46:42+08:00

查看更多信息请参阅 README.md

Full Changelog: v1.2.0...v1.3.0

v1.2.0

Claude Request Forwarder v1.2.0

更新默认超时时间为300秒，以解决在长非流请求下的断开问题

📦 下载说明

请根据您的操作系统下载对应的版本：

• Windows: endpoint_forwarder-windows-amd64.zip (64位) 或 endpoint_forwarder-windows-arm64.zip (ARM64)
• macOS: endpoint_forwarder-darwin-amd64.tar.gz (Intel) 或 endpoint_forwarder-darwin-arm64.tar.gz (Apple Silicon)
• Linux: endpoint_forwarder-linux-amd64.tar.gz (64位) 或 endpoint_forwarder-linux-arm64.tar.gz (ARM64) 或 endpoint_forwarder-linux-arm.tar.gz (ARM32)

🚀 快速开始

1. 下载适合您系统的压缩包
2. 解压文件
3. 复制 example.yaml 为 config.yaml 并根据需要修改配置
4. 运行程序: ./endpoint_forwarder -config config.yaml

📋 版本信息

• 版本: v1.2.0
• 提交: 480b34f
• 构建时间: 2025-08-26T22:33:55+08:00

查看更多信息请参阅 README.md

Full Changelog: v1.0.0...v1.2.0

v1.0.0

Claude Request Forwarder v1.0.0

Release v1.0.0: Claude Request Forwarder 首个正式版本

主要功能：

• 多端点负载均衡和故障转移
• 智能路由策略（优先级和最快响应）
• 代理支持（HTTP/HTTPS/SOCKS5）
• 流式响应优化
• 健康检查和快速测试
• 完整的重试机制
• 多平台二进制文件支持

📦 下载说明

请根据您的操作系统下载对应的版本：

• Windows: endpoint_forwarder-windows-amd64.zip (64位) 或 endpoint_forwarder-windows-arm64.zip (ARM64)
• macOS: endpoint_forwarder-darwin-amd64.tar.gz (Intel) 或 endpoint_forwarder-darwin-arm64.tar.gz (Apple Silicon)
• Linux: endpoint_forwarder-linux-amd64.tar.gz (64位) 或 endpoint_forwarder-linux-arm64.tar.gz (ARM64) 或 endpoint_forwarder-linux-arm.tar.gz (ARM32)

🚀 快速开始

1. 下载适合您系统的压缩包
2. 解压文件
3. 复制 example.yaml 为 config.yaml 并根据需要修改配置
4. 运行程序: ./endpoint_forwarder -config config.yaml

📋 版本信息

• 版本: v1.0.0
• 提交: a316521
• 构建时间: 2025-08-26T22:03:59+08:00

查看更多信息请参阅 README.md

Full Changelog: https://github.com/xinhai-ai/endpoint_forwarder/commits/v1.0.0