new-api 配置实战:从源码构建 + CLIProxyAPI 渠道 + Caddy 反代
以实际生产环境为例,记录 new-api 从源码编译、systemd 服务配置、接入 CLIProxyAPI 渠道,到 Caddy 自动 HTTPS 反代的完整链路。所有配置均来自真实运行的机器。
new-api 系列(十):接入国际支付——Stripe、PayPal 与海外收银
面向海外用户的 API 付费服务,需要对接 Stripe、PayPal 等国际支付渠道。本文详解 Stripe Checkout 一键接入、PayPal REST API 回调处理、Paddle 全球税务代缴,以及 LemonSqueezy 的零门槛方案。含完整的 Webhook 验签与额度充值代码。
new-api 系列(九):接入国内支付——支付宝、微信与自动充值
new-api 自带额度系统但缺少支付环节。本文详解三种方案让用户自助充值:个人免签支付(V免签/码支付)、第三方聚合支付(易支付)、以及适合小团队的半自动方案。从零搭建支付回调,实现充值即到账。
new-api 系列(八):进阶——多实例、负载均衡与 SSO
团队规模扩大后的进阶玩法:多 new-api 实例联邦、跨区域渠道调度与负载均衡、OIDC/OAuth 单点登录集成、自定义模型路由策略,以及与其他工具(CLIProxyAPI、Ollama)的组合使用。
new-api 系列(七):生产环境部署与安全加固
从内网测试到公网服务,生产环境部署 new-api 需要反向代理、HTTPS、数据库优化、备份恢复、安全加固。本文覆盖 Nginx 和 Caddy 两种反代方案、MySQL 调优、自动备份脚本、防火墙与 fail2ban 配置。
new-api 系列(六):监控、日志与告警
日志和监控是运维 new-api 的核心能力。本文详解请求日志的使用、渠道健康检查的配置、Webhook 告警的接入(钉钉/飞书/企业微信/Slack),以及如何通过 Prometheus + Grafana 搭建可视化监控面板。
new-api 系列(五):计价模型与成本控制
new-api 支持灵活的模型定价系统——按 Token、按次、按模型差异化定价。本文详解如何配置价格、设置倍率、估算成本、平衡收支,以及如何用定价策略引导用户选择更经济的模型。
new-api 系列(四):令牌与用户管理
令牌是分发给用户的访问凭证,new-api 的权限、额度、限流全部围绕令牌展开。本文详解如何创建和管理令牌/用户、设置额度策略、配置 IP 白名单、模型访问控制,以及管理员 vs 普通用户的角色区分。
new-api 系列(三):渠道配置——接入各类模型提供商
渠道是 new-api 连接上游模型提供商的核心概念。本文详解如何添加 OpenAI、Anthropic、Gemini、DeepSeek、通义千问、Ollama 等渠道,配置模型映射与别名,以及渠道优先级、权重、健康检查等高级特性。
new-api 系列(二):安装部署——从零搭建 new-api
三种方式安装 new-api:二进制直接运行(推荐)、Docker Compose、以及从 one-api 迁移。覆盖 SQLite 和 MySQL 两种数据库方案,systemd 服务配置,以及首次登录后的安全设置。
new-api 系列(一):认识 new-api——新一代 AI API 管理网关
new-api 是 one-api 的下一代继任者,一个开源的 AI API 管理分发系统。它把多个模型提供商的 API 统一成一个 OpenAI 兼容端点,支持用户管理、计费、限流、用量统计。
CLIProxyAPI(六):结合 new-api 打造多用户 API 网关
将 CLIProxyAPI 接入 new-api,实现用户管理、计费、限流,一套 CLI OAuth 订阅支撑整个团队。