New API 搭建笔记

📋一、前期准备

服务器 × 1（推荐木念云自营）
域名 × 1（需要提前完成解析，解析有等待时间）
推荐系统：Ubuntu 22
推荐配置：4核4G（安装环境和用户访问都会导致CPU突发）

💡 服务器线路直接影响访问速度与稳定性。

⚙️二、部署方式选择

安装方式分为多种，推荐选择“安装”方式。

                    ✅ 最稳定，方便日后服务器迁移，非常适合新手与长期运营。
                

🌍三、服务器区域选择

根据运营模式确定服务器区域：

运营模式	推荐区域	原因
对接官方API	美国	GPT等官方屏蔽香港IP，美国之间互访延迟最低
对接别人的API	香港	距离国内近，大陆优化线路延迟40–60ms

美国线路参考延迟：优化线路约100–150ms，国际线路约300ms+。线路是决定访问速度的关键因素。

推荐线路：PCCW 300M 或美国4837线路（大陆优化、大带宽，适合生图需求）。

🖥️四、服务器部署流程

购买服务器：选择4核4G、Ubuntu 22系统
SSH连接：使用SSH远程工具连接服务器
挂载数据盘：系统盘+数据盘需挂载到 /3w 目录
安装BBR加速：降低TCP协议延迟，提升速度
安装宝塔面板：可使用工具箱或手动安装
访问面板：浏览器打开面板地址，设置账号密码

⚠️ 若不使用工具，也可手动安装宝塔，同样支持一键命令。

🌐五、域名解析

在域名解析面板中添加记录：

记录类型：A记录
主机记录：二级域名（如 ai.example.cn）
记录值：服务器IP

⏳ 解析需要等待生效，务必提前解析再开始搭建。

🧰六、所需环境安装

在宝塔面板中安装以下组件：

组件	作用
Nginx	域名反向代理必需
PHP	搭建文档站需要（不需要可跳过）
Docker	用于运行New API，可直接在宝塔安装

安装速度受CPU、带宽、脚本时长综合影响，耐心等待。

📦七、安装 New API

关键步骤：

切换目录到数据盘：cd /3w
克隆 New API 文件夹
进入目录：cd new-api
执行启动命令，等待启动成功

⚠️ 默认安装路径在root（系统盘），必须先切换到 /3w 再进行拉取，避免占用系统盘空间。

🔁八、域名反向代理

域名：填入已解析的域名
地址：127.0.0.1
端口：3000（可在配置文件中修改为其他端口）

🔒 若不希望别人通过 IP:3000 访问，防火墙不放开3000端口，仅通过80/443反代访问。

🔐九、SSL证书

在宝塔面板为域名申请免费证书
选择快捷申请方式
首次搭建可通过HTTP访问，后续自动跳转HTTPS

🚀十、系统初始化设置

设置管理员账号密码
选择运营模式：对外经营 / 自用
对外经营：显示模型广场、支持API调用（推荐一般运营者选择）
自用：仅自己使用，不展示模型广场

切换新版前端：系统设置 → 其他设置 → 切换

🔗十一、渠道对接

进入渠道列表，创建渠道
渠道类型必须与上游匹配（如GPT选OpenAI，Claude选对应类型）
粘贴上游API密钥与地址
点击获取模型，全选保存
设置对应分组

渠道分组必须与上游分组对齐，否则客户无法调用对应的模型。

🗂️十二、分组与倍率

创建分组并设置倍率（成本0.4可卖0.5–4不等）
倍率越高利润越高，但注意竞争力
分组描述展示在客户创建密钥的页面中
自动分组：按最高倍率优先，避免亏本

🎫十三、卡密与充值

创建卡密：设置额度（如100）、有效期（永久）、数量（如50个）
客户在钱包中通过兑换码充值
充值链接可指向自己的发卡站或联系QQ
需要先确认合规章条款（系统设置→合规）

合规条款是官方要求，需要勾选确认后，卡密才能正常使用。

⚙️十四、系统设置要点

站点品牌系统名称、Logo、页脚、自定义首页

系统公告首页展示通知信息

顶级导航可关闭模型广场、排行榜、文档等

侧边栏建议关闭娱乐/测额度功能（会消耗用户额度）

⚠️ 修改任何设置后必须点击右上角保存，否则不生效。

👤十五、注册与登录设置

可限制注册邮箱白名单：如仅允许 @qq.com 或 @163.com
支持快捷登录（如第三方平台，需要单独配置）
身份认证项可保持默认，无需改动

💰十六、计费与支付

新用户初始配额：注册送余额（如5元），吸引用户注册
预消耗额度：防止用户没钱时仍请求API导致亏损
邀请奖励：邀请者和被邀请者均可设置奖励额度
货币单位：可选择人民币或美元，汇率可自定义（如7.3）
支付方式：支付宝/微信（需配置易支付或码支付网关）

支付网关需要对接易支付或码支付，填写商户ID和MD5密钥。

💱十七、模型定价与同步

分组定价：为每个分组设置不同的倍率
特殊倍率：可用于内部价、合作伙伴价
模型定价必须同步，否则无法正常调用
同步操作：模型定价 → 勾选模型 → 应用同步，直至全部完成

多分组时，每个分组都需要创建定价并同步，才能保证所有模型可用。

🛡️十八、安全与限制

速率限制：限制每分钟请求次数，防止被刷爆
敏感词：添加违规词（如黄、赌）进行过滤
黑名单/白名单：域名级别访问控制
令牌数量限制：限制单个用户可创建的令牌数

📊十九、仪表盘与邮件

数据仪表盘：展示API访问量、调用数据
可在仪表盘访问常见问题、公告
API地址：支持配置多个站点展示
SMTP邮件：配置163邮箱（开启服务授权码），用于用户配额低时预警

🔄二十、系统更新方法

进入项目目录（可在宝塔文件管理直接进入）
拉取最新镜像
重新执行启动命令
等待启动完成

📄二十一、文档站搭建

使用PHP建站，解析一个文档子域名
可让AI（如豆包）生成文档内容，粘贴发布
在系统设置中修改文档链接地址

拥有自己的文档站，可减少对官方文档的依赖，提升用户体验。

🔁二十二、模型批量同步

对接多个渠道后（如OpenAI、Claude），在模型定价中勾选所有模型
每个分组都需要创建定价
点击应用同步，重复操作直到所有分组完成

⭐搭建要点总结

服务器区域决定互访速度与线路成本
数据盘挂载避免占用系统盘空间
反向代理让网站走80/443端口，更安全
分组与倍率决定你的成本与利润空间
模型同步是上线前的必要动作
文档站可使用PHP建站快速实现

🎯 新手建议按教程走完一遍，再逐步理解每个配置的作用。遇到问题时可回到仪表盘和系统日志排查。