187 lines
5.9 KiB
Markdown
187 lines
5.9 KiB
Markdown
# AI Proxy Worker
|
||
|
||
<div align="center">
|
||
|
||
**🌍 Language / 语言**
|
||
|
||
[🇺🇸 English](./README.en.md) | [🇨🇳 中文](./README.md)
|
||
|
||
</div>
|
||
|
||
**企业级 AI API 安全代理服务** - 让你的前端应用无需暴露 API 密钥即可安全调用 AI 服务，基于 Cloudflare 全球边缘网络提供毫秒级响应。
|
||
|
||
> 🚀 基于 Cloudflare Workers 的通用 AI API 代理服务，让你的应用安全调用各种 AI API
|
||
|
||
[](https://deploy.workers.cloudflare.com/?url=https://github.com/qinfuyao/AI-Proxy-Worker)
|
||
[](./LICENSE)
|
||
|
||
## ✨ 为什么选择 AI Proxy Worker？
|
||
|
||
- 🔐 **安全第一**：API 密钥只存储在服务端，客户端永远无法获取
|
||
- ⚡ **极速响应**：基于 Cloudflare 全球边缘网络，毫秒级响应
|
||
- 🤖 **多模型支持**：当前支持 DeepSeek API，架构设计支持未来扩展更多 AI 服务商
|
||
- 🌊 **流式传输**：完整支持 SSE 流式响应，实时对话体验
|
||
- 🛡️ **生产就绪**：完善的错误处理、安全防护和监控日志
|
||
- 💰 **零成本起步**：Cloudflare Workers 免费额度足够个人使用
|
||
|
||
## 🚀 5分钟快速开始
|
||
|
||
### 1. 一键部署
|
||
```bash
|
||
# 安装 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. 立即测试
|
||
```bash
|
||
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` - 自定义访问密钥（推荐）
|
||
|
||
> 📖 **完整配置指南**：[详细配置说明](./docs/Configuration.md)
|
||
|
||
## 📱 客户端集成示例
|
||
|
||
### iOS (Swift)
|
||
```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
|
||
```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!' }]
|
||
})
|
||
});
|
||
```
|
||
|
||
## 📖 完整文档
|
||
|
||
### 📚 详细指南
|
||
- **[安装指南](./docs/Installation.md)** - Windows/macOS 详细安装步骤
|
||
- **[部署教程](./docs/Deployment.md)** - 本地CLI vs 网页部署对比
|
||
- **[API 文档](./docs/API-Reference.md)** - 完整的 API 参考和示例
|
||
- **[配置说明](./docs/Configuration.md)** - 高级配置和优化选项
|
||
|
||
### 🔧 运维支持
|
||
- **[故障排除](./docs/Troubleshooting.md)** - 常见问题和解决方案
|
||
- **[监控指南](./docs/Monitoring.md)** - 日志查看和性能监控
|
||
- **[安全最佳实践](./docs/Security.md)** - 生产环境安全配置
|
||
|
||
### 💡 使用案例
|
||
- **[使用示例](./docs/Examples.md)** - 各种编程语言的集成示例
|
||
- **[最佳实践](./docs/Best-Practices.md)** - 性能优化和使用建议
|
||
|
||
## 🌟 项目亮点
|
||
|
||
```javascript
|
||
// 🔐 安全：密钥服务端存储
|
||
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](../../issues) - 报告 Bug 或提出功能建议
|
||
- [💡 Discussions](../../discussions) - 社区讨论和经验分享
|
||
|
||
### 🔧 参与贡献
|
||
- [🤝 贡献指南](./docs/Contributing.md) - 如何参与项目开发
|
||
- [📝 代码规范](./docs/Code-Style.md) - 代码风格和最佳实践
|
||
- [🧪 测试指南](./docs/Testing.md) - 如何编写和运行测试
|
||
|
||
### 📊 项目状态
|
||
- ✅ **稳定版本**：v1.0.0
|
||
- 🔄 **活跃维护**：定期更新和 Bug 修复
|
||
- 🌍 **生产使用**：已在多个项目中稳定运行
|
||
|
||
## 🏆 使用案例
|
||
|
||
> "AI Proxy Worker 让我们的 iOS 应用可以安全地集成 AI 功能，无需担心 API 密钥泄露。部署简单，性能出色！"
|
||
>
|
||
> — iOS 开发者
|
||
|
||
> "从 DeepSeek 切换到其他 AI 服务商只需要几行代码修改，这种灵活性太棒了。"
|
||
>
|
||
> — 全栈工程师
|
||
|
||
## 📄 许可证
|
||
|
||
本项目采用 [MIT License](./LICENSE) 开源许可证。
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
**🌟 如果这个项目对你有帮助，请给个 Star 支持一下！**
|
||
|
||
[⭐ Star](../../stargazers) • [🍴 Fork](../../fork) • [📢 分享](https://twitter.com/intent/tweet?text=AI%20Proxy%20Worker%20-%20%E5%9F%BA%E4%BA%8E%20Cloudflare%20Workers%20%E7%9A%84%E9%80%9A%E7%94%A8%20AI%20API%20%E4%BB%A3%E7%90%86%E6%9C%8D%E5%8A%A1&url=https://github.com/qinfuyao/AI-Proxy-Worker)
|
||
|
||
</div> |