如何快速搭建高效API网关：new-api完整部署指南

【免费下载链接】new-api 基于One API的二次开发版本，仅供学习使用！ 项目地址: https://gitcode.com/gh_mirrors/ne/new-api

New API是基于One API二次开发的新一代大模型网关与AI资产管理系统，它提供了一个统一、高效的API网关解决方案，帮助开发者快速部署和管理多个AI模型的API接口。作为专业的API网关，它特别适合微服务管理和快速部署场景。

🚀 快速开始部署指南

前置环境准备

在开始部署之前，请确保您的系统满足以下基本要求：

• Docker环境：Docker和Docker Compose
• 数据库支持：SQLite（默认）或MySQL ≥ 5.7.8 / PostgreSQL ≥ 9.6
• 系统资源：建议2GB以上内存

使用Docker Compose一键部署

这是最推荐的部署方式，只需几个简单步骤：

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/ne/new-api.git
cd new-api

# 启动服务
docker-compose up -d

部署完成后，访问 http://localhost:3000 即可进入管理界面。

new-api现代化管理控制台界面，提供直观的API网关管理体验

✨ 核心功能特性

多模型统一管理

New API支持众多主流AI模型，包括：

• 🤖 OpenAI系列：GPT-4、GPT-3.5等全系列模型
• 🎨 Midjourney代理：通过Midjourney-Proxy支持图像生成
• 💬 Claude消息格式：完整的Anthropic Claude支持
• 🌐 Google Gemini：Google最新Gemini模型集成
• 🔄 重排序模型：Cohere、Jina等rerank模型

智能路由与负载均衡

系统提供强大的智能路由功能：

• ⚖️ 渠道加权随机：根据配置权重分配请求
• 🔄 失败自动重试：智能失败重试机制
• 🚦 用户级别限流：精细化流量控制

支付与计费系统

内置完整的商业化功能：

• 💰 多支付渠道：支持易支付、Stripe等支付方式
• 📊 灵活计费策略：按次数、按token等多种计费模式
• 🔄 缓存计费支持：OpenAI、Azure、DeepSeek等模型缓存计费

⚙️ 环境配置详解

关键环境变量配置

# 会话密钥（多机部署必须）
SESSION_SECRET=your_session_secret

# 数据库连接
SQL_DSN=mysql://user:password@host:port/database

# Redis缓存配置
REDIS_CONN_STRING=redis://localhost:6379

new-api多模型API网关架构示意图，展示统一入口和智能路由机制

🔧 高级部署方案

多机集群部署

对于生产环境，建议采用多机部署方案：

1. 设置共享会话密钥：确保所有实例使用相同的SESSION_SECRET
2. 配置中央Redis：用于会话共享和缓存
3. 数据库集群：使用MySQL或PostgreSQL集群
4. 负载均衡：通过Nginx或云负载均衡器分发流量

宝塔面板部署

对于不熟悉命令行的用户，可以通过宝塔面板一键部署：

1. 安装宝塔面板（≥ 9.2.0版本）
2. 在应用商店搜索New-API
3. 点击安装并配置相关参数

🛡️ 安全最佳实践

安全配置建议

• 🔒 定期更换密钥：定期轮换SESSION_SECRET和CRYPTO_SECRET
• 🔐 网络隔离：将API网关部署在内网环境
• 📊 访问日志：启用详细日志记录和监控
• 🚨 速率限制：配置适当的API调用频率限制

📈 性能优化技巧

缓存策略优化

# 启用Redis缓存
REDIS_CONN_STRING=redis://localhost:6379/0

# 内存缓存配置
MEMORY_CACHE_ENABLED=true
CACHE_EXPIRATION=300

数据库优化

• 使用连接池管理数据库连接
• 定期清理历史日志数据
• 为频繁查询的表添加合适索引

🌟 实际应用场景

企业级AI服务管理

New API特别适合以下场景：

• 🏢 企业内部AI平台：统一管理多个AI模型服务
• 🎓 教育机构：为学生和研究人员提供AI能力
• 💼 创业公司：快速集成多种AI能力，降低开发成本
• 🔧 开发者工具：为开发者提供统一的API访问接口

new-api系统监控和统计分析仪表盘，实时展示API使用情况和性能指标

❓ 常见问题解答

Q: 如何迁移现有的One API数据？

A: New API完全兼容原版One API数据库结构，只需将数据库文件或连接字符串配置到新系统即可。

Q: 支持哪些支付方式？

A: 目前支持易支付、Stripe等主流支付渠道，后续会持续增加更多支付方式。

Q: 如何添加自定义模型？

A: 通过管理界面的"渠道管理"功能，可以添加支持完整调用地址的自定义模型。

🎯 总结

New API作为一个功能强大的API网关解决方案，为开发者提供了快速部署、统一管理多个AI模型的完整工具链。无论是个人学习还是企业级应用，都能通过New API实现高效的微服务管理和API网关部署。

通过本文的指南，您应该已经掌握了New API的部署方法和核心功能。现在就开始您的API网关之旅，体验高效、统一的AI模型管理吧！

【免费下载链接】new-api 基于One API的二次开发版本，仅供学习使用！ 项目地址: https://gitcode.com/gh_mirrors/ne/new-api