64 lines
3.5 KiB
Markdown
64 lines
3.5 KiB
Markdown
# 会话记录总结：大模型 API 中转与 Docker 部署指南
|
||
|
||
本文件记录了关于开源大模型 API 网关（`new-api`）、相关生态工具、Docker 部署环境选择以及如何在 Linux 上进行操作的完整对话过程。
|
||
|
||
---
|
||
|
||
## 1. 核心仓库分析：New API 与 Sub2API 的区别
|
||
- **QuantumNous/new-api (New API)**：
|
||
- **定位**：专业、通用的企业级/团队级自托管 AI API 网关。
|
||
- **核心**：基于官方 API Key 进行路由分发、负载均衡、高可用及精细化计费/额度管理。几乎无封号风险。
|
||
- **Wei-Shaw/sub2api (Sub2API)**：
|
||
- **定位**：主打订阅池化（拼车共享）的一站式 AI API 中转服务。
|
||
- **核心**：将网页端包月账号（如 ChatGPT Plus、Claude Pro）通过协议逆向转为标准 API 共享使用。极易触发风控封号。
|
||
|
||
---
|
||
|
||
## 2. 边缘工具生态链（5个开源仓库分析）
|
||
- **`farion1231/cc-switch`**：跨平台的桌面端 API 调度与外壳管理工具，用于一键切换命令行工具的 API 供应商及 MCP 插件。
|
||
- **`totec448-spec/chat-on-steroids`**：将网页版 ChatGPT 结合浏览器扩展与本地 MCP 协议，赋予其读写本地代码和执行终端命令能力的本地编程助手。
|
||
- **`fb0sh/MCPod`**：用于打包、运行和管理本地 MCP Server 的容器化或后端轻量环境。
|
||
- **`router-for-me/CLIProxyAPI`**：底层的协议转译与中转核心，将各大厂命令行工具或免费测试通道包装为标准的 OpenAI/Claude API。
|
||
- **`linguo2625469/workbuddy2api-panel`**：腾讯 CodeBuddy 的逆向网关与自动化任务管理面板（内置自动做任务脚本，现已停更）。
|
||
|
||
---
|
||
|
||
## 3. 部署环境与操作系统选择
|
||
- **系统核心原则**：Docker 的核心技术强依赖 Linux 内核。
|
||
- **服务器系统建议**：
|
||
- **强烈反对**：在旧版 Windows Server 2012 上强行部署。
|
||
- **强烈推荐**：**Ubuntu 24.04 LTS** 或 Debian 12。如果购买的是 Windows 系统服务器，可在腾讯云后台免费一键重装为 Linux。
|
||
- **硬件替代方案**：使用同事的 **Mac mini** 运行 Docker Desktop 也是极佳且稳定的本地服务器选择。
|
||
|
||
---
|
||
|
||
## 4. New API 服务器端部署全流程（Linux + Docker）
|
||
|
||
1. **配置域名解析**：
|
||
- 在域名注册商处添加 A 记录，将子域名（例如 `api.trivoo.online`）解析至服务器公网 IP。
|
||
2. **安装 Docker 基础环境**：
|
||
```bash
|
||
curl -fsSL https://get.docker.com | bash
|
||
sudo systemctl enable --now docker
|
||
```
|
||
3. **拉取代码并配置密钥**：
|
||
```bash
|
||
git clone https://github.com/QuantumNous/new-api.git
|
||
cd new-api
|
||
openssl rand -hex 32
|
||
```
|
||
修改 `docker-compose.yml`，设置 `SESSION_SECRET`、HTTPS 信任域名及数据库/Redis 密码。
|
||
4. **启动后台容器**：
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
5. **配置 Nginx 与 HTTPS**：
|
||
- 安装 Nginx 和 Certbot，配置反向代理将流量转发至 `http://127.0.0.1:3000` 并签发 SSL 证书。
|
||
6. **后台初始化与调用**：
|
||
- 访问域名创建管理员账号，添加上链渠道（官方 API Key），生成分发令牌即可在客户端调用。
|
||
|
||
---
|
||
|
||
## 5. 远程访问与 Linux 运维互动
|
||
- **访问方式**：Linux 服务器通常通过命令行操作。初学者可直接使用腾讯云后台自带的 **Workbench（网页终端）**，无需在本地下载复杂软件。
|
||
- **AI 运维模式**：用户只需负责打开终端，将报错或需求交由 AI，“复制粘贴”AI 提供的标准命令，即可轻松实现无痛部署。 |