部署安装这是整件事的地基。New API 支持 Docker 单容器、Docker Compose、1Panel、宝塔、集群部署等多种方式。企业内网场景推荐 Docker Compose自带 postgres 和 Redis数据不丢。1.1 前置条件一台 Linux 服务器Ubuntu/CentOS已装好 Docker 和 Docker Compose。建议最低 4 核 8G 。1.2 Docker Compose 部署git clone https://github.com/QuantumNous/new-api.git cd new-api git checkout v1.0.0-rc.4 #请checkout最新版本这是2026年5月7日最新版本 vim docker-compose.yml # 根据实际修改端口、密码改成强密码默认都是123456 docker compose up -d项目自带的docker-compose.yml已配好 postgres、Redis 和 New API 三个服务只需改端口和密码。1.3 初始化服务启动后访问http://服务器IP:3000端口建议使用80并做外网的映射首次打开会进入初始化引导设置管理员账号密码。记好这个密码后面所有管理操作都靠它。模式采用自用模式1.4 常用运维命令docker logs -f new-api # 看实时日志 docker logs --tail100 new-api # 看最近100行 docker ps # 查看服务状态 docker compose down # 在compose.yml同级目录执行停止移除服务 docker compose up -d # 在compose.yml同级目录执行重启服务二、基础设置2.1 速率设置在系统设置→速率限制设置中启用用户模型请求速率限制限制周期1分钟用户每周期最多请求次数50次2.2 系统设置内部进行账号统一管理不允许除管理员外的任何人登录该平台所以做账号限制在系统设置→系统设置中的配置登录注册处。关闭允许通过免密码进行注册和允许新用户注册在系统设置→顶栏管理中关闭模型广场、关于2.3 绘图设置关闭在系统设置→绘图设置中关掉全部绘图功能如果你有生图模型就在此注意配置三、CodingPlan 的采集与分发通常建议仅从一家采购同样的模型提供团队内部统一使用模型厂商采购 API Key │ ▼ New API 添加渠道统一录入 Key │ ▼ 渠道分组按部门/项目隔离 │ ▼ 创建订阅套餐设定配额与有效期 │ ▼ 分发令牌给用户绑定分组与限额 │ ▼ 用户通过令牌调用标准 API │ ▼ 日志审计与看板全链路监管3.1 渠道分组不同部门、不同项目可能需要用不同的 Key 池。通过分组实现渠道隔离创建分组如研发一部、产品二部在渠道中指定该渠道属于哪个分组用户只能访问自己分组内的渠道。在系统设置→分组与模型定价设置的分组管理中添加内部各部门的分组。倍率都按照1设计每个组视人数给分配账号一般设定比人数多1个~2个账号即可3.2 模型定价模型定价的主要目的是为了统一内部模型叫法给模型设置统一的价格方便后续的管理设计示例如下xxx-glm-4.71$/1M Token xxx-kimi-k2.52$/1M Token xxx-kimi-k2.63$/1M Token xxx-glm-k2.63$/1M Token3.3 添加渠道每个采购到的 API Key 对应一个渠道。管理员登录后进入「渠道」页面选择服务商类型一般使用 OpenAI / Claude 等名称按照key来源构建如厂商-key结尾4字符填入 API Key密钥勾选该 Key 支持的模型高级配置中可设 Base URL代理地址代理地址必须填写根据国内模型厂商给的地址进行填写。一般国内模型厂商会给 Claude、OpenAI 两种接入方式的地址跟选择的工具有关系。3.4 多 Key 轮询同一个服务商采购了多个 Key 时用多 Key 模式一个渠道挂多个 Key系统自动轮询使用。单个 Key 失败自动跳过恢复后重新启用。支持两种轮询策略顺序轮询和加权随机建议按照加权随机的模式使用。