阿里云轻量服务器 Docker 部署 OneAPI 踩坑实录
环境:阿里云轻量应用服务器 / Alibaba Linux 4 / OpenClaw 镜像 / Docker
目标:用 Docker 部署 OneAPI 网关,统一聚合各家大模型免费额度,兜底切阿里百炼
结果:部署成功,但「浏览器访问不了 3000 端口」卡了很久,记录完整排查链路
一、背景与目标
在阿里云轻量服务器上,通过 Docker 部署 OneAPI(开源大模型 API 网关/中转),把智谱 GLM、Kimi、Groq 等免费额度聚合到一个统一入口,免费额度耗尽后自动降级到阿里百炼付费兜底,再喂给 OpenClaw(龙虾)Agent 使用。
架构示意:
OpenClaw(龙虾) ↓ 只连一个地址 http://公网IP:3000/v1 OneAPI 网关(Docker 容器,同机部署) ├─ 渠道1:智谱 GLM-4-Flash(免费,优先级1) ├─ 渠道2:Groq(免费,优先级2) ├─ 渠道3:Kimi(免费,优先级3) └─ 渠道4:阿里百炼(付费兜底,优先级99)二、部署过程(正常步骤)
1. 拉取镜像并启动容器
dockerpull justsong/one-apidockerrun-d\--nameone-api\--restartalways\-p3000:3000\-v/admin/oneapi:/data\-eTZ=Asia/Shanghai\justsong/one-api参数说明:
-p 3000:3000:把容器 3000 端口映射到宿主机 3000-v /admin/oneapi:/data:数据持久化,防止容器重建丢配置- 最好不要用root用户,自己单独建一个运行程序的用户,我用的admin
--restart always:开机自启 + 异常自动重启
2. 验证容器状态
docker</