支持 ChatGLM/文心一言的 API 管理镜像部署手册
1. 为什么你需要这个镜像——告别密钥混乱与模型适配烦恼
你是否遇到过这样的场景：
- 项目里同时调用文心一言写营销文案、用 ChatGLM 做内部知识问答、再接入通义千问生成技术文档，结果每个模型都要单独配置
api_key、base_url、请求头格式、流式开关逻辑……代码里堆满条件判断； - 测试环境用的是本地 Ollama 的 Qwen2，生产环境切到百度千帆的文心一言 4.5，一改
base_url和模型名，就报400 Bad Request——原来千帆不支持 OpenAI 原生的temperature字段命名，得改成top_p； - 运维同事半夜被报警电话叫醒：'线上服务崩了！查了一小时发现是讯飞星火的 API 密钥过期了，但没人知道它被用在哪个微服务里……'
这些问题，不是你代码写得不够好，而是缺一个统一的 API 网关层。
这不是一个需要你从零搭建的复杂系统，而是一个真正'开箱即用'的镜像——它把所有主流大模型（包括 ChatGLM、文心一言、通义千问、讯飞星火等）的差异全部封装掉，对外只暴露标准的 OpenAI API 接口。你写的代码，今天调用本地 Ollama，明天切到百度千帆，后天换成 Azure OpenAI，完全不用改一行业务逻辑。
更关键的是：它不只做协议转换。它内置密钥管理、流量控制、额度审计、多渠道负载均衡、用户分组权限、甚至支持微信/飞书/邮箱登录——你拿到的不是一个工具，而是一套可直接交付给客户或上线生产的小型 AI 中台。
下面，我们就从零开始，用最直白的方式，带你完成一次完整部署。
2. 三步完成部署：从拉取镜像到调用文心一言
整个过程不需要编译、不依赖 Python 环境、不修改配置文件——所有操作都在终端敲几行命令。我们以最常见的 Linux 服务器（Ubuntu/CentOS）为例，全程耗时约 3 分钟。
2.1 拉取并启动镜像（10 秒）
# 一行命令拉取并后台运行（使用默认端口 3000）
docker run -d \
--name one-api \
-p 3000:3000 \
-v /path/to/one-api-data:/app/data \
--restart=always \
registry.cn-hangzhou.aliyuncs.com/one-api/one-api:latest
说明：
-v参数将容器内数据目录挂载到宿主机，确保重启后配置不丢失；--restart=always让容器随系统自启，适合生产环境；镜像已预置所有依赖，无需额外安装 Node.js 或数据库。
等待 10 秒后，执行：
docker logs one-api | grep "Server is running"
看到类似 Server is running on http://localhost:3000 即表示启动成功。
2.2 首次登录与安全加固（30 秒）
打开浏览器，访问 http://你的服务器 IP:3000，你会看到登录页。
重要提醒：首次必须用 root 用户登录，初始密码为 123456（这是镜像文档明确强调的安全要求）。
登录后第一件事：立即修改密码。
点击右上角头像 → '修改密码'，输入旧密码 123456，设置强密码（建议含大小写字母 + 数字 + 符号）。这一步不可跳过——否则任何知道 IP 的人都能接管你的 API 网关。
2.3 添加文心一言渠道（2 分钟）
进入左侧菜单【渠道管理】→ 点击【+ 新建渠道】：
| 字段 | 填写内容 | 说明 |
|---|
