imnotnoahhh/AI-Proxy-Worker

Fork 0

Files

Noah Qin 9a971aa646 "🎉 Initial release: AI Proxy Worker v1.0"

2025-08-17 19:59:10 +08:00

6.0 KiB

Raw Blame History

AI Proxy Worker

🌍 Language / 语言

🇺🇸 English | 🇨🇳 中文

企业级 AI API 安全代理服务 - 让你的前端应用无需暴露 API 密钥即可安全调用 AI 服务，基于 Cloudflare 全球边缘网络提供毫秒级响应。

🚀 基于 Cloudflare Workers 的通用 AI API 代理服务，让你的应用安全调用各种 AI API

✨ 为什么选择 AI Proxy Worker？

🔐 安全第一：API 密钥只存储在服务端，客户端永远无法获取
⚡ 极速响应：基于 Cloudflare 全球边缘网络，毫秒级响应
🤖 多模型支持：当前支持 DeepSeek API，架构设计支持未来扩展更多 AI 服务商
🌊 流式传输：完整支持 SSE 流式响应，实时对话体验
🛡️ 生产就绪：完善的错误处理、安全防护和监控日志
💰 零成本起步：Cloudflare Workers 免费额度足够个人使用

🚀 5分钟快速开始

1. 一键部署

# 安装 Wrangler CLI
npm install -g wrangler

# 克隆项目
git clone https://github.com/qinfuyao/AI-Proxy-Worker.git
cd ai-proxy-worker

# 登录并部署
wrangler login
wrangler secret put DEEPSEEK_API_KEY  # 输入你的 DeepSeek API 密钥
wrangler secret put PROXY_KEY         # 设置访问密钥（可选但推荐）
wrangler publish

2. 立即测试

curl -X POST https://your-worker.workers.dev/chat \
  -H "Authorization: Bearer YOUR_PROXY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

🎯 支持的 AI 模型

模型	用途	特点
`deepseek-chat`	通用对话	DeepSeek-V3，671B 参数，日常对话首选
`deepseek-reasoner`	复杂推理	DeepSeek-R1，逻辑推理和数学问题专家

🔮 发展路线图

当前版本 (v1.0)：

✅ DeepSeek API 完整支持
✅ 双模型支持（对话 + 推理）
✅ 流式响应和完整错误处理

计划中的功能：

🔄 OpenAI API 支持
🔄 Claude API 支持
🔄 Gemini API 支持
🔄 统一的多 AI 路由
🔄 用户级访问控制
🔄 请求限流和配额管理

⚙️ 配置

只需设置两个环境变量即可开始使用：

DEEPSEEK_API_KEY - 你的 DeepSeek API 密钥
PROXY_KEY - 自定义访问密钥（推荐）

📖 完整配置指南：详细配置说明

📱 客户端集成示例

iOS (Swift)

let response = try await URLSession.shared.data(for: URLRequest(
    url: URL(string: "https://your-worker.workers.dev/chat")!,
    headers: ["Authorization": "Bearer YOUR_PROXY_KEY"],
    body: ["model": "deepseek-chat", "messages": [...]]
))

JavaScript

const response = await fetch('https://your-worker.workers.dev/chat', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_PROXY_KEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        model: 'deepseek-chat',
        messages: [{ role: 'user', content: 'Hello!' }]
    })
});

📖 完整文档

📚 详细指南

安装指南 - Windows/macOS 详细安装步骤
部署教程 - 本地CLI vs 网页部署对比
API 文档 - 完整的 API 参考和示例
配置说明 - 高级配置和优化选项

🔧 运维支持

故障排除 - 常见问题和解决方案
监控指南 - 日志查看和性能监控
安全最佳实践 - 生产环境安全配置

💡 使用案例

使用示例 - 各种编程语言的集成示例
最佳实践 - 性能优化和使用建议

🌟 项目亮点

// 🔐 安全：密钥服务端存储
env.DEEPSEEK_API_KEY // 只在 Cloudflare 中存储

// ⚡ 性能：全局边缘计算
Cloudflare Workers // 180+ 数据中心

// 🛡️ 可靠：完善错误处理
{
  "error": "timeout",
  "message": "Request timeout after 30s",
  "timestamp": "2025-01-01T00:00:00.000Z"
}

// 🌊 流式：实时响应
Accept: text/event-stream

🤝 社区与支持

💬 获取帮助

📋 Issues - 报告 Bug 或提出功能建议
💡 Discussions - 社区讨论和经验分享
📖 Wiki - 完整文档和教程

🔧 参与贡献

🤝 贡献指南 - 如何参与项目开发
📝 代码规范 - 代码风格和最佳实践
🧪 测试指南 - 如何编写和运行测试

📊 项目状态

✅ 稳定版本：v1.0.0
🔄 活跃维护：定期更新和 Bug 修复
🌍 生产使用：已在多个项目中稳定运行

🏆 使用案例

"AI Proxy Worker 让我们的 iOS 应用可以安全地集成 AI 功能，无需担心 API 密钥泄露。部署简单，性能出色！"

— iOS 开发者

"从 DeepSeek 切换到其他 AI 服务商只需要几行代码修改，这种灵活性太棒了。"

— 全栈工程师

📄 许可证

本项目采用 MIT License 开源许可证。

🌟 如果这个项目对你有帮助，请给个 Star 支持一下！

⭐ Star • 🍴 Fork • 📢 分享

6.0 KiB Raw Blame History Unescape Escape