私有化部署验收:装完怎么确认真的能用
装完那一刻最像成功了:容器全 Up、网页能打开、登录也进得去。但**「能打开」和「能用」之间隔着六道关**,任何一道没过,表现都是一样的——点下去没反应,或者弹一句看不懂的英文报错。
这篇给一份可以照着打勾的清单。每一条都写清三件事:怎么验、验不过是什么原因、去哪修。整篇照着走一遍,大概二十分钟。
先说清楚适用范围
这篇是验收,不是安装教程。还没装上平台的,先看私有化部署流程记录:从裸机到能对话;要装第二台云端电脑的,看那一篇的第八节。
一、第一关:网页打得开
浏览器输 http://你的IP,能看到登录页就算过。
打不开先别怀疑装错了,按这个顺序看机器上的状态:
docker ps --format '{{.Names}}\t{{.Status}}'正常应该看到一串 Up 的容器(一套完整平台是十几个到二十个)。如果只有一两个、或者有 Restarting,就是平台没起来,去 docker compose logs 看第一个报错的容器。
容器都 Up 但网页还是打不开,就查两处:
ss -tlnp | grep -E ':80|:443'- 这一条没输出 → 80 端口没在听,多半是前面的容器没起全;
- 有输出但外面连不上 → 安全组没放行。云服务器默认只开 22,80/443 要自己去控制台加规则。这是新装机器最常见的一条,跟平台本身没关系。
二、第二关:能登录,并且看得见「系统管理」
登录页长这样,左边品牌区,右边是密码登录和验证码登录两个页签:

用管理员账号进去之后,第一眼看的不是首页好不好看,而是左侧菜单里有没有「系统管理」:

没有「系统管理」,说明这个账号不是管理员。后面授权、模型、沙盒三关全都要在系统管理里操作,账号不对就先解决账号,别往下走。
三、第三关:授权位填了没有
这一关有个很好用的判断法:点开左侧的「伙伴」。
看到整页只有一句「请联系官方获取试用或商业授权」,就是没授权:

这时去 系统管理 → 系统配置 → 系统设置 → 基础配置,拉到页面最下面,会看到设备信息和「请输入授权码」:

授权码是一机一码,跟页面上的设备信息绑定。授权这一步的完整流程、申请入口、失败怎么查,写在私有化部署流程记录的第五节,这里不重复。
顺序别搞反
「授权」和「开菜单」是两件事:授权决定能不能用,开菜单决定看不看得见。企业版默认不把「资料库」和「伙伴」放进菜单,需要管理员自己加。只开菜单不填授权码,点进去还是那句提示。
四、第四关:模型能不能回一句话
授权过了,随便打开一个预置智能体(比如「翻译助手」),在右边的预览框里发一句 hello。
三种结果,对应三种毛病:
回话了 → 这一关过了,直接看第五关。
弹 403 Forbidden from /api/proxy/model/api/chat → 平台没接到可用的模型。系统里可能登记了模型条目,但没有可调通的配置(Key 过期、额度为零、Base URL 平台访问不到)。
回一句 The agent failed to correctly identify the necessary data. → 这个报错看着像"智能体理解不了",实际多半也是模型没接上。平台收不到模型的正常响应,就在调用链上兜了个底。
接通模型有三条路,按你手上有什么选:
- 有生态平台账号:左侧「生态市场」→ 模型 → 「+ 使用该模型」→ 选发布范围,一键下发到自己的空间。不用手填配置,见生态市场;
- 有供应商的 API Key:组件资源 → 模型管理 →
+ 模型,填 Key、点连通性测试,见大模型接入; - 只想给全平台加一个:管理员在系统管理 → 模型管理里配,见模型管理(平台级)。
三条路的共同坑:配完必须「启用」+ 勾对「可用范围」,否则智能体里那个下拉框里根本选不到它。
五、第五关:沙盒是「在线」还是「离线」
去 系统管理 → 系统配置 → 沙盒配置 看列表:

状态是绿色的「在线」才算过。一直是「离线」,按这三条查,按出现频率排序:
| 现象 | 原因 | 怎么改 |
|---|---|---|
沙盒机器上 curl 明明通,平台里永远离线 | 根地址里写了端口。平台会拿「根地址」自己拼上「Agent端口」,你写 http://10.0.0.5:9086,它拼出来就是 http://10.0.0.5:9086:9086 | 根地址只写到 IP:http://10.0.0.5,端口单独填在 Agent端口 那一栏 |
填的是 127.0.0.1 | 平台跑在容器里,这个地址指向容器自己 | 换成沙盒机器的内网 IP |
| 填了通信key,反而连不上 | 官方部署包里的 rcoder 默认关掉了密钥校验 | 这一栏留空;除非你确实在沙盒的 config.yml 里打开了校验 |
改完保存,一般几秒内变绿。
想在机器上自己确认沙盒服务活着,跑这一条:
curl -s -o /dev/null -w "%{http_code}\n" http://你的沙盒IP:9086/health返回 200 就说明沙盒自己是好的,问题在平台这边的填写。顺带一提:9088(远程桌面)直接访问根路径会返回 404,那是正常的,它没有首页。
六、第六关:让它真的动一次手
前五关都是"配置通不通",这一关验的是它能不能干活。
随便新建一个任务,说一件小到不能再小的事,比如「在当前目录建一个 hello.txt,写一行 hi」。跑起来之后,去沙盒那台机器上看:
docker ps --format '{{.Names}}\t{{.Status}}'正常情况下会多出一个对应用户的容器——沙盒是每个用户一个容器,跑任务时才起来。同时在平台的沙盒列表里,「使用中」那一列会从 0/5 变成 1/5。
任务结束、文件也能在平台的对话里点开,这一关就算过了。到这里,这套平台才叫"能用"。
到这一步还报错,多半不是部署的问题
第六关失败时,先回头看第四关——模型没接通,任务一定跑不起来。其次是资源:4 核 16G 的机器上,平台自己就要占掉 9G 左右,剩下六七个 G 只够跑一个人,第二个人进来就会失败。这时候要加机器,不是重装。
七、六关过了之后
验收通过只是"今天能用"。接下来三件日常的事,越早做越省事:
- 备份:数据库和用户数据目录先做一份快照。沙盒上的用户数据在
computer-project-workspace这个卷里,重建容器不会丢,但换机器会; - 升级前先留一份
docker-compose.yml:升级脚本会拿标准模板跟它比对,你手工改过的端口、挂载对不上就会被拦下来,见常见问题; - 把管理员账号和授权码记下来:授权码跟设备信息绑定,换机器、重装、重建容器都可能失效,重新申请要时间。
八、卡在哪一关,看哪一篇
| 卡在 | 先看 |
|---|---|
| 网页打不开、容器起不来 | 安装与部署总览 |
| 授权码、菜单、界面和主站不一样 | 私有化部署流程记录 |
| 模型调不动、403、智能体不回话 | 大模型接入、生态市场 |
| 沙盒离线、任务跑不起来 | 沙盒配置、智能体电脑部署 |
| 上面都看过了还是不行 | 常见问题,或者到技术交流群问(群号 1790753084) |
一句话记住
能打开、能登录、有授权、模型回话、沙盒在线、跑通一个任务——六件事按顺序过,前面不过就别急着看后面。私有化部署九成的问题,都在这六步里的某一步。
