Skip to content

私有化部署验收:装完怎么确认真的能用 ​

装完那一刻最像成功了:容器全 Up、网页能打开、登录也进得去。但**「能打开」和「能用」之间隔着六道关**,任何一道没过,表现都是一样的——点下去没反应,或者弹一句看不懂的英文报错。

这篇给一份可以照着打勾的清单。每一条都写清三件事:怎么验、验不过是什么原因、去哪修。整篇照着走一遍,大概二十分钟。

先说清楚适用范围

这篇是验收,不是安装教程。还没装上平台的,先看私有化部署流程记录:从裸机到能对话;要装第二台云端电脑的,看那一篇的第八节。

一、第一关:网页打得开 ​

浏览器输 http://你的IP,能看到登录页就算过。

打不开先别怀疑装错了,按这个顺序看机器上的状态:

bash
docker ps --format '{{.Names}}\t{{.Status}}'

正常应该看到一串 Up 的容器(一套完整平台是十几个到二十个)。如果只有一两个、或者有 Restarting,就是平台没起来,去 docker compose logs 看第一个报错的容器。

容器都 Up 但网页还是打不开,就查两处:

bash
ss -tlnp | grep -E ':80|:443'
  • 这一条没输出 → 80 端口没在听,多半是前面的容器没起全;
  • 有输出但外面连不上 → 安全组没放行。云服务器默认只开 22,80/443 要自己去控制台加规则。这是新装机器最常见的一条,跟平台本身没关系。

二、第二关:能登录,并且看得见「系统管理」 ​

登录页长这样,左边品牌区,右边是密码登录和验证码登录两个页签:

登录页:左边是品牌区,右边是「密码登录 / 验证码登录注册」两个页签

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

登录后的首页:嗨 admin,有什么我可以帮忙的吗?

没有「系统管理」,说明这个账号不是管理员。后面授权、模型、沙盒三关全都要在系统管理里操作,账号不对就先解决账号,别往下走。

三、第三关:授权位填了没有 ​

这一关有个很好用的判断法:点开左侧的「伙伴」。

看到整页只有一句「请联系官方获取试用或商业授权」,就是没授权:

点开「伙伴」,整页只有一句「请联系官方获取试用或商业授权」

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

系统设置页最下方:「请联系官方获取试用或商业授权,当前设备信息:dmi-uuid:…」,下面是「请输入授权码」和保存按钮

授权码是一机一码,跟页面上的设备信息绑定。授权这一步的完整流程、申请入口、失败怎么查,写在私有化部署流程记录的第五节,这里不重复。

顺序别搞反

「授权」和「开菜单」是两件事:授权决定能不能用,开菜单决定看不看得见。企业版默认不把「资料库」和「伙伴」放进菜单,需要管理员自己加。只开菜单不填授权码,点进去还是那句提示。

四、第四关:模型能不能回一句话 ​

授权过了,随便打开一个预置智能体(比如「翻译助手」),在右边的预览框里发一句 hello。

三种结果,对应三种毛病:

回话了 → 这一关过了,直接看第五关。

弹 403 Forbidden from /api/proxy/model/api/chat → 平台没接到可用的模型。系统里可能登记了模型条目,但没有可调通的配置(Key 过期、额度为零、Base URL 平台访问不到)。

回一句 The agent failed to correctly identify the necessary data. → 这个报错看着像"智能体理解不了",实际多半也是模型没接上。平台收不到模型的正常响应,就在调用链上兜了个底。

接通模型有三条路,按你手上有什么选:

  • 有生态平台账号:左侧「生态市场」→ 模型 → 「+ 使用该模型」→ 选发布范围,一键下发到自己的空间。不用手填配置,见生态市场;
  • 有供应商的 API Key:组件资源 → 模型管理 → + 模型,填 Key、点连通性测试,见大模型接入;
  • 只想给全平台加一个:管理员在系统管理 → 模型管理里配,见模型管理(平台级)。

三条路的共同坑:配完必须「启用」+ 勾对「可用范围」,否则智能体里那个下拉框里根本选不到它。

五、第五关:沙盒是「在线」还是「离线」 ​

去 系统管理 → 系统配置 → 沙盒配置 看列表:

沙盒列表:云端电脑-01,0/5 使用中,在线、已启用

状态是绿色的「在线」才算过。一直是「离线」,按这三条查,按出现频率排序:

现象原因怎么改
沙盒机器上 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 里打开了校验

改完保存,一般几秒内变绿。

想在机器上自己确认沙盒服务活着,跑这一条:

bash
curl -s -o /dev/null -w "%{http_code}\n" http://你的沙盒IP:9086/health

返回 200 就说明沙盒自己是好的,问题在平台这边的填写。顺带一提:9088(远程桌面)直接访问根路径会返回 404,那是正常的,它没有首页。

六、第六关:让它真的动一次手 ​

前五关都是"配置通不通",这一关验的是它能不能干活。

随便新建一个任务,说一件小到不能再小的事,比如「在当前目录建一个 hello.txt,写一行 hi」。跑起来之后,去沙盒那台机器上看:

bash
docker ps --format '{{.Names}}\t{{.Status}}'

正常情况下会多出一个对应用户的容器——沙盒是每个用户一个容器,跑任务时才起来。同时在平台的沙盒列表里,「使用中」那一列会从 0/5 变成 1/5。

任务结束、文件也能在平台的对话里点开,这一关就算过了。到这里,这套平台才叫"能用"。

到这一步还报错,多半不是部署的问题

第六关失败时,先回头看第四关——模型没接通,任务一定跑不起来。其次是资源:4 核 16G 的机器上,平台自己就要占掉 9G 左右,剩下六七个 G 只够跑一个人,第二个人进来就会失败。这时候要加机器,不是重装。

七、六关过了之后 ​

验收通过只是"今天能用"。接下来三件日常的事,越早做越省事:

  • 备份:数据库和用户数据目录先做一份快照。沙盒上的用户数据在 computer-project-workspace 这个卷里,重建容器不会丢,但换机器会;
  • 升级前先留一份 docker-compose.yml:升级脚本会拿标准模板跟它比对,你手工改过的端口、挂载对不上就会被拦下来,见常见问题;
  • 把管理员账号和授权码记下来:授权码跟设备信息绑定,换机器、重装、重建容器都可能失效,重新申请要时间。

八、卡在哪一关,看哪一篇 ​

卡在先看
网页打不开、容器起不来安装与部署总览
授权码、菜单、界面和主站不一样私有化部署流程记录
模型调不动、403、智能体不回话大模型接入、生态市场
沙盒离线、任务跑不起来沙盒配置、智能体电脑部署
上面都看过了还是不行常见问题,或者到技术交流群问(群号 1790753084)

一句话记住

能打开、能登录、有授权、模型回话、沙盒在线、跑通一个任务——六件事按顺序过,前面不过就别急着看后面。私有化部署九成的问题,都在这六步里的某一步。