Nexent Linux 部署:用 deploy.sh

摘要

摘要 :如果按单容器思路手写一个只有 nexent:latest 的 docker-compose.yml,再访问 8000 端口,部署必然失败:Nexent 是 PostgreSQL、Elasticsearch、Redis、MinIO 加六个应用服务的微服务栈,官方入口是仓库根目录的 deploy.sh,Web 端口是 3000。本文面向要在 Linux 服务器上自建智能体平台的运维与开发者,把环境核对、克隆、.env 配置、TUI 组件选择、首次登录、租户初始化到三项结果验证写成可直接照做的命令,并逐处列出真实截图的采集步骤。读完后你能一次跑通整套服务,并用容器状态、HTTP 响应和登录后业务菜单三类证据自证部署成功。

文章目录

    • 摘要
    • [一、背景与问题:为什么"手写单容器 compose"跑不起来](#一、背景与问题:为什么"手写单容器 compose"跑不起来)
    • 二、环境与版本:官方要求与核心组件介绍
      • [2.1 官方系统要求(原文数值)](#2.1 官方系统要求(原文数值))
      • [2.2 本机实测信息【待实测填写】](#2.2 本机实测信息【待实测填写】)
      • [2.3 下载链接](#2.3 下载链接)
    • 三、操作步骤
      • [3.1 部署前体检](#3.1 部署前体检)
      • [3.2 克隆仓库并记录耗时](#3.2 克隆仓库并记录耗时)
      • [3.3 配置 `.env`(首次部署前必做)](#3.3 配置 .env(首次部署前必做))
      • [3.4 执行部署](#3.4 执行部署)
      • [3.5 服务与端口核对](#3.5 服务与端口核对)
      • [3.6 首次登录与租户初始化](#3.6 首次登录与租户初始化)
    • 四、关键配置与命令
      • [4.1 改端口、开 HTTPS](#4.1 改端口、开 HTTPS)
      • [4.2 离线部署(无公网服务器)](#4.2 离线部署(无公网服务器))
      • [4.3 卸载(想保留数据就别用 delete-all)](#4.3 卸载(想保留数据就别用 delete-all))
      • [4.4 部署链路时序](#4.4 部署链路时序)
    • 五、结果验证:怎么判断"真的跑起来了"
    • 六、常见问题
    • 七、总结
    • 参考资料

一、背景与问题:为什么"手写单容器 compose"跑不起来

先看一份常见的错误配置:

yaml 复制代码
services:
  nexent:
    image: nexent:latest
    container_name: nexent-linux
    environment:
      - NEXENT_MODE=server
    ports:
      - "8000:8000"
    restart: unless-stopped

这段 YAML 是本文要拆掉的反面样例,不要复制到服务器。它把 Nexent 当成单进程服务,只声明了一个 services.nexent;image: nexent:latest 在官方镜像源里并不存在,NEXENT_MODE=server 也不是官方 .env 变量,8000:8000 更会把浏览器指到一个没人监听的端口。预期结果是 docker compose up 直接报镜像拉取失败;即使换成真实镜像,缺少 PostgreSQL、Elasticsearch、Redis、MinIO 也会让应用起不来。还要留意 restart: unless-stopped 会把失败掩盖成"反复重启",排错时先把它关掉再看首次报错。

四个问题,逐条说清楚:

写法 问题 官方事实
image: nexent:latest 官方不存在这个单镜像,平台不是单进程 应用由 nexent-config、nexent-runtime、nexent-mcp、nexent-web、nexent-data-process、nexent-northbound 六个服务组成
NEXENT_MODE=server 无此变量,属杜撰 实际配置集中在 deploy/env/.env,如 NEXENT_WEB_PORT、NEXENT_SUPER_ADMIN_PASSWORD
8000:8000 端口错 Web 入口是 3000 (NEXENT_WEB_PORT),可选 HTTPS 入口 3100
docker compose up -d --build 直接起 缺基础设施 官方 deploy.sh docker 会按 TUI 选择生成配置,并拉起 Elasticsearch、PostgreSQL、Redis、MinIO

一句话结论:Nexent 的正确部署入口是脚本,不是手写 compose。手写既能跑通的概率为零,也拿不到官方后续升级与离线部署能力。
#mermaid-svg-DwIArVUYKaKeEWt2{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-DwIArVUYKaKeEWt2 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-DwIArVUYKaKeEWt2 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-DwIArVUYKaKeEWt2 .error-icon{fill:#552222;}#mermaid-svg-DwIArVUYKaKeEWt2 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-DwIArVUYKaKeEWt2 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-DwIArVUYKaKeEWt2 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-DwIArVUYKaKeEWt2 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-DwIArVUYKaKeEWt2 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-DwIArVUYKaKeEWt2 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-DwIArVUYKaKeEWt2 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-DwIArVUYKaKeEWt2 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-DwIArVUYKaKeEWt2 .marker.cross{stroke:#333333;}#mermaid-svg-DwIArVUYKaKeEWt2 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-DwIArVUYKaKeEWt2 p{margin:0;}#mermaid-svg-DwIArVUYKaKeEWt2 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-DwIArVUYKaKeEWt2 .cluster-label text{fill:#333;}#mermaid-svg-DwIArVUYKaKeEWt2 .cluster-label span{color:#333;}#mermaid-svg-DwIArVUYKaKeEWt2 .cluster-label span p{background-color:transparent;}#mermaid-svg-DwIArVUYKaKeEWt2 .label text,#mermaid-svg-DwIArVUYKaKeEWt2 span{fill:#333;color:#333;}#mermaid-svg-DwIArVUYKaKeEWt2 .node rect,#mermaid-svg-DwIArVUYKaKeEWt2 .node circle,#mermaid-svg-DwIArVUYKaKeEWt2 .node ellipse,#mermaid-svg-DwIArVUYKaKeEWt2 .node polygon,#mermaid-svg-DwIArVUYKaKeEWt2 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-DwIArVUYKaKeEWt2 .rough-node .label text,#mermaid-svg-DwIArVUYKaKeEWt2 .node .label text,#mermaid-svg-DwIArVUYKaKeEWt2 .image-shape .label,#mermaid-svg-DwIArVUYKaKeEWt2 .icon-shape .label{text-anchor:middle;}#mermaid-svg-DwIArVUYKaKeEWt2 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-DwIArVUYKaKeEWt2 .rough-node .label,#mermaid-svg-DwIArVUYKaKeEWt2 .node .label,#mermaid-svg-DwIArVUYKaKeEWt2 .image-shape .label,#mermaid-svg-DwIArVUYKaKeEWt2 .icon-shape .label{text-align:center;}#mermaid-svg-DwIArVUYKaKeEWt2 .node.clickable{cursor:pointer;}#mermaid-svg-DwIArVUYKaKeEWt2 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-DwIArVUYKaKeEWt2 .arrowheadPath{fill:#333333;}#mermaid-svg-DwIArVUYKaKeEWt2 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-DwIArVUYKaKeEWt2 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-DwIArVUYKaKeEWt2 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-DwIArVUYKaKeEWt2 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-DwIArVUYKaKeEWt2 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-DwIArVUYKaKeEWt2 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-DwIArVUYKaKeEWt2 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-DwIArVUYKaKeEWt2 .cluster text{fill:#333;}#mermaid-svg-DwIArVUYKaKeEWt2 .cluster span{color:#333;}#mermaid-svg-DwIArVUYKaKeEWt2 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-DwIArVUYKaKeEWt2 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-DwIArVUYKaKeEWt2 rect.text{fill:none;stroke-width:0;}#mermaid-svg-DwIArVUYKaKeEWt2 .icon-shape,#mermaid-svg-DwIArVUYKaKeEWt2 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-DwIArVUYKaKeEWt2 .icon-shape p,#mermaid-svg-DwIArVUYKaKeEWt2 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-DwIArVUYKaKeEWt2 .icon-shape .label rect,#mermaid-svg-DwIArVUYKaKeEWt2 .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-DwIArVUYKaKeEWt2 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-DwIArVUYKaKeEWt2 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-DwIArVUYKaKeEWt2 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 克隆仓库
核对 deploy/env/.env
执行 bash deploy.sh docker
TUI 选择组件/端口策略/镜像源
Compose 拉起基础设施与应用服务
浏览器访问 3000 端口
超管创建租户与租户管理员
换租户管理员登录并验证

图1:手写单容器配置与官方部署入口的逐项差异示意。

二、环境与版本:官方要求与核心组件介绍

2.1 官方系统要求(原文数值)

资源 最低要求 推荐配置
CPU 4 核 8 核
内存 8 GiB 16 GiB
磁盘 40 GiB 100 GiB
架构 x86_64 / ARM64 ---
软件 Docker Engine 18.09+、Docker Compose v2 仍受维护的 Docker Engine 与 Compose v2

官方安装页特别注明:推荐配置适用于启用完整应用、数据处理和 Docker 沙箱的环境;模型服务通常独立部署,不计入上表资源。README 对 Docker 的要求写得更保守:Docker 24+、Compose v2+。按 24+ 准备不会错。

2.2 本机实测信息【待实测填写】

下表请在你自己的服务器上执行后填写,避免把别的机器上的数值当成自己的环境:

项目 采集命令 / 位置 你的实测值
操作系统 cat /etc/os-release 【待实测填写】
CPU / 内存 / 磁盘 nproc、free -h、df -h 【待实测填写】
Docker / Compose 版本 docker version、docker compose version 【待实测填写】
Nexent 版本 仓库根目录 cat VERSION;页面左下角也显示版本号 【待实测填写】
克隆耗时 time git clone <仓库地址> 的 real 行 【待实测填写】
镜像拉取总耗时 部署脚本结束前后各记一次 date +%s,或终端日志时间戳 【待实测填写】
是否做了配置修改 如 WSL 内存、Docker 镜像加速、ulimit、swap 【待实测填写】

版本提示:官方文档站当前正文标注对应 v2.5.0 ,可能与仓库当前版本不一致。以你本地 cat VERSION 和页面左下角显示为准,文章里写自己这个号。

2.3 下载链接

从 AtomGit 拉取时,请到仓库页点"克隆/下载"复制页面给出的地址,替换下面命令中的 URL;不要凭猜测拼 .git 后缀。项目主页与官方文档入口见文末。

三、操作步骤

3.1 部署前体检

bash 复制代码
cat /etc/os-release
docker version
docker compose version
nproc
free -h
df -h /

六条命令分别回答部署前的六个问题:系统发行版、Docker 引擎版本、Compose 是否 v2、可用 CPU 核数、可用内存、根分区剩余空间。docker version 要同时看到 Client 与 Server 两段,只有 Client 说明守护进程没起;free -h 看 available 列而不是 free 列;df -h / 要对照官方最低 40 GiB。把这些输出整段贴进【待实测填写】,后面判断资源是否够用才有基线可对照,不要凭印象写"机器配置还行"。

docker compose version 必须是 v2。若只有老版 docker-compose 独立命令,先升级。Ubuntu 22.04 可用:

bash 复制代码
sudo apt update
sudo apt install -y docker.io docker-compose-plugin
sudo systemctl enable --now docker
docker compose version

3.2 克隆仓库并记录耗时

bash 复制代码
cd /opt
time git clone https://github.com/ModelEngine-Group/nexent.git
cd nexent
cat VERSION

把 time 输出的 real 值填进 2.2 的表。若服务器在国内且拉取很慢,先测一下仓库镜像可达性,再决定用官方源还是 AtomGit 源------把两种源的实测耗时写进文章,读者才能判断自己该选哪个。

3.3 配置 .env(首次部署前必做)

Docker 与 Kubernetes 共用 deploy/env/.env。脚本会保留已有配置,并补入 deploy/env/.env.example 新增的变量;.env 不存在时优先复用旧版 docker/.env,否则从模板创建。部署前确认 .env.example 可读。

bash 复制代码
ls -l deploy/env/.env.example
cp -n deploy/env/.env.example deploy/env/.env
grep -nE 'NEXENT_WEB_PORT|NEXENT_SUPER_ADMIN_PASSWORD|ROOT_DIR|SITE_URL' deploy/env/.env

ls -l 先确认模板文件确实存在,避免路径写错后 cp 静默失败;cp -n 的 -n 保证已经改过的 .env 不被模板覆盖,重装时尤其重要;grep -nE 只把四个关键变量连同行号打出来,方便核对端口、超管密码、数据根目录和站点地址。预期输出是四行 变量名=值,若某行缺失说明模板版本不同,需要对照官方安装页确认新变量名,不要自行补一个猜测的键。这几个变量决定了后面所有验证动作的地址,值得先花一分钟确认。

首次部署 v1.8.0 及以上会自动创建超级管理员 suadmin@nexent.com,默认密码 Nexent@123,创建成功后终端显示。生产环境务必在首次部署前覆盖默认密码:

bash 复制代码
# 在 deploy/env/.env 中设置,值请自行替换,不要写进文章
NEXENT_SUPER_ADMIN_PASSWORD=<你的强密码>

这行只改超管初始密码一个变量。官方首次部署 v1.8.0 及以上会自动创建 suadmin@nexent.com,默认值公开可查,生产环境必须在第一次拉起容器之前改掉------容器起来后再改 .env 不会回写已经创建好的账号。<你的强密码> 是占位符,请换成自己生成的随机串并只保存在本机密码管理器里;文章里不要出现真实密码,截图时也要打码。改完用上一条 grep 复查行内值已生效,再进入部署步骤。

3.4 执行部署

bash 复制代码
bash deploy.sh docker

脚本打开 Bash TUI:方向键或 j/k 移动,空格多选,回车确认,b/Backspace 返回,q 退出。三组选项:

选项组 可选值 建议
组件 infrastructure(必选)、application(默认)、data-process(默认)、terminal、monitoring 首次跑通用默认三项
端口策略 development(默认,暴露调试端口)、production(只发生产入口) 服务器排障期用 development,稳定后切 production
镜像源 general(默认)、mainland(中国大陆镜像源)、local-latest 国内服务器优先试 mainland

不想进 TUI 可以直接传参:

bash 复制代码
# 复用已保存的 deploy/docker/deploy.options 或内置默认值
bash deploy.sh docker --defaults

# 显式指定:默认组件 + development 端口策略 + 标准镜像源
bash deploy.sh docker \
  --components infrastructure,application,data-process \
  --port-policy development \
  --image-source general

# 国内网络换镜像源
bash deploy.sh docker --image-source mainland

四条命令是同一入口的不同用法。--defaults 复用 deploy/docker/deploy.options 里保存过的非敏感选项,适合重装;--components 用逗号分隔组件,infrastructure 必选,application 与 data-process 默认带,terminal、monitoring 按需加;--port-policy development 决定端口策略;--image-source mainland 只换镜像源,不改组件组合。预期是脚本先打印选项摘要再开始拉镜像,若卡在拉取阶段,先记下耗时再判断要不要换源,别直接中断重装。

成功部署后,非敏感选项保存在 deploy/docker/deploy.options,--defaults 下次会优先复用。

3.5 服务与端口核对

服务 默认端口 外部端口
nexent-web 3000 3000(NEXENT_WEB_PORT)
nexent-config 5010 5010
nexent-mcp 5011 / 5015 5011 / 5015
nexent-data-process 5012 5012
nexent-northbound 5013 5013
nexent-runtime 5014 5014
PostgreSQL 5432 5434
Elasticsearch 9200 9210
MinIO API / 控制台 9000 / 9001 9010 / 9011
Redis 6379 6379
SSH(terminal 组件) 22 2222

3.6 首次登录与租户初始化

官方文档给的初始化顺序是固定的,跳过任何一步都会看到"空平台":

  1. 浏览器打开 http://localhost:3000(服务器远程访问换成 http://<服务器IP>:3000);
  2. 用 suadmin@nexent.com 与终端显示/.env 里设置的密码登录;
  3. 进入租户资源 → 创建租户 → 创建租户管理员;
  4. 退出超管,用租户管理员账号重新登录。

原因:超级管理员仅用于权限管理,无权开发智能体、无权创建知识库。很多"平台部署成功了但什么菜单都没有"的截图,根因就在这一步。

图2:部署脚本拉起的四类组件与数据卷关系图。

四、关键配置与命令

4.1 改端口、开 HTTPS

bash 复制代码
# deploy/env/.env
NEXENT_WEB_PORT=3000
NEXENT_HTTPS_PORT=3100
SITE_URL=http://<服务器IP>:3000

NEXENT_WEB_PORT 是 HTTP 入口,NEXENT_HTTPS_PORT 是启用 HTTPS 后的入口,两者可以并存;SITE_URL 必须写浏览器实际访问的地址,包含协议、服务器 IP 或域名和端口,它会被写进回调与跳转链接。改端口前先确认宿主机端口没被占用,改完必须重新执行部署让配置生效,并用 curl -I 验证新地址返回。若只改了 .env 却没重跑脚本,容器仍监听旧端口,这是最常见的"改了没用"来源。

bash 复制代码
# 自签证书,内网部署推荐
bash deploy.sh docker --defaults --https-mode self-signed

# 自有证书
bash deploy.sh docker --defaults --https-mode custom \
  --https-cert-file /path/to/server.pem \
  --https-key-file /path/to/server.key

--https-mode self-signed 让脚本生成自签证书,适合内网或本机验证,浏览器提示证书不受信任属于预期现象,不要当成部署失败;custom 模式要同时给 --https-cert-file 与 --https-key-file 两个完整路径,容器内必须能读到,路径写错会在启动阶段直接报错。两种方式都会把入口切到 3100,所以 SITE_URL 要同步改成 https://,回调地址里的旧端口也要一起替换,否则登录跳转会失败。

启用 HTTPS 后需同步更新 SITE_URL;若改过入口端口,OAUTH_CALLBACK_BASE_URL、CAS_CALLBACK_BASE_URL 中含旧端口的地址也要一起改。自签证书放在 <ROOT_DIR>/nginx/ssl/,浏览器会提示不受信任。

4.2 离线部署(无公网服务器)

从 GitHub Actions 的 Build Offline Deployment Package 工作流下载对应架构的产物,产物默认只保留 30 天:

bash 复制代码
unzip nexent-<version>-amd64.zip -d nexent
cd nexent
bash deploy.sh --load-images docker

# 需要重新选组件/端口/镜像源时
bash deploy.sh --load-images --config docker

# 复用旧离线包配置
bash deploy.sh --reuse-from /path/to/previous/nexent --load-images docker

<version> 要替换成离线包实际文件名,别照抄尖括号;-d nexent 解压到与在线部署一致的目录结构,后续命令才能复用同一套路径。--load-images 先导入本地镜像再拉起容器,省掉公网拉取;首次用 --config 重新走组件与端口选择,--reuse-from 则从上一版目录继承配置。预期现象是导入镜像时逐条打印 Loaded image,若报文件不存在,先核对压缩包是否完整解压、架构是否为 amd64。

4.3 卸载(想保留数据就别用 delete-all)

bash 复制代码
bash uninstall.sh docker                      # 交互决定数据去留
bash uninstall.sh docker --keep-volumes      # 非交互卸载并保留数据
bash uninstall.sh docker --delete-volumes true
bash uninstall.sh docker delete-all          # 容器 + 持久数据全清

四个命令的差别全在数据去留。不带参数时脚本交互式询问,--keep-volumes 非交互保留数据,适合排错后重装;--delete-volumes true 与 delete-all 都会删除持久化数据,后者连容器一起清。执行前先确认 ./volumes 下四个目录是否需要备份,并把 docker ps -a 的输出留证。预期结果是容器列表清空但数据目录仍在(保留模式);若重装后知识库为空,多半是这一步选错了参数。

数据卷默认落在 ./volumes(ROOT_DIR 可改):postgresql、elasticsearch、redis、minio。重装又要复用旧数据,必须保留 volumes。

图:容器启动状态迁移(与部署流程图的分工)

前面的流程图讲"操作怎么走",这张状态图讲"容器卡在哪一步"。出现 Restarting 时不必重跑整个脚本,先按状态回到容器启动分支定位资源与依赖问题。
#mermaid-svg-Fhy9rIQgMFPT5crp{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-Fhy9rIQgMFPT5crp .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-Fhy9rIQgMFPT5crp .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-Fhy9rIQgMFPT5crp .error-icon{fill:#552222;}#mermaid-svg-Fhy9rIQgMFPT5crp .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-Fhy9rIQgMFPT5crp .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-Fhy9rIQgMFPT5crp .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-Fhy9rIQgMFPT5crp .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-Fhy9rIQgMFPT5crp .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-Fhy9rIQgMFPT5crp .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-Fhy9rIQgMFPT5crp .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-Fhy9rIQgMFPT5crp .marker{fill:#333333;stroke:#333333;}#mermaid-svg-Fhy9rIQgMFPT5crp .marker.cross{stroke:#333333;}#mermaid-svg-Fhy9rIQgMFPT5crp svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-Fhy9rIQgMFPT5crp p{margin:0;}#mermaid-svg-Fhy9rIQgMFPT5crp defs #statediagram-barbEnd{fill:#333333;stroke:#333333;}#mermaid-svg-Fhy9rIQgMFPT5crp g.stateGroup text{fill:#9370DB;stroke:none;font-size:10px;}#mermaid-svg-Fhy9rIQgMFPT5crp g.stateGroup text{fill:#333;stroke:none;font-size:10px;}#mermaid-svg-Fhy9rIQgMFPT5crp g.stateGroup .state-title{font-weight:bolder;fill:#131300;}#mermaid-svg-Fhy9rIQgMFPT5crp g.stateGroup rect{fill:#ECECFF;stroke:#9370DB;}#mermaid-svg-Fhy9rIQgMFPT5crp g.stateGroup line{stroke:#333333;stroke-width:1;}#mermaid-svg-Fhy9rIQgMFPT5crp .transition{stroke:#333333;stroke-width:1;fill:none;}#mermaid-svg-Fhy9rIQgMFPT5crp .stateGroup .composit{fill:white;border-bottom:1px;}#mermaid-svg-Fhy9rIQgMFPT5crp .stateGroup .alt-composit{fill:#e0e0e0;border-bottom:1px;}#mermaid-svg-Fhy9rIQgMFPT5crp .state-note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-Fhy9rIQgMFPT5crp .state-note text{fill:black;stroke:none;font-size:10px;}#mermaid-svg-Fhy9rIQgMFPT5crp .stateLabel .box{stroke:none;stroke-width:0;fill:#ECECFF;opacity:0.5;}#mermaid-svg-Fhy9rIQgMFPT5crp .edgeLabel .label rect{fill:#ECECFF;opacity:0.5;}#mermaid-svg-Fhy9rIQgMFPT5crp .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Fhy9rIQgMFPT5crp .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-Fhy9rIQgMFPT5crp .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Fhy9rIQgMFPT5crp .edgeLabel .label text{fill:#333;}#mermaid-svg-Fhy9rIQgMFPT5crp .label div .edgeLabel{color:#333;}#mermaid-svg-Fhy9rIQgMFPT5crp .stateLabel text{fill:#131300;font-size:10px;font-weight:bold;}#mermaid-svg-Fhy9rIQgMFPT5crp .node circle.state-start{fill:#333333;stroke:#333333;}#mermaid-svg-Fhy9rIQgMFPT5crp .node .fork-join{fill:#333333;stroke:#333333;}#mermaid-svg-Fhy9rIQgMFPT5crp .node circle.state-end{fill:#9370DB;stroke:white;stroke-width:1.5;}#mermaid-svg-Fhy9rIQgMFPT5crp .end-state-inner{fill:white;stroke-width:1.5;}#mermaid-svg-Fhy9rIQgMFPT5crp .node rect{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-Fhy9rIQgMFPT5crp .node polygon{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-Fhy9rIQgMFPT5crp #statediagram-barbEnd{fill:#333333;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-cluster rect{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-Fhy9rIQgMFPT5crp .cluster-label,#mermaid-svg-Fhy9rIQgMFPT5crp .nodeLabel{color:#131300;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-cluster rect.outer{rx:5px;ry:5px;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-state .divider{stroke:#9370DB;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-state .title-state{rx:5px;ry:5px;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-cluster.statediagram-cluster .inner{fill:white;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-cluster.statediagram-cluster-alt .inner{fill:#f0f0f0;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-cluster .inner{rx:0;ry:0;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-state rect.basic{rx:5px;ry:5px;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-state rect.divider{stroke-dasharray:10,10;fill:#f0f0f0;}#mermaid-svg-Fhy9rIQgMFPT5crp .note-edge{stroke-dasharray:5;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-note rect{fill:#fff5ad;stroke:#aaaa33;stroke-width:1px;rx:0;ry:0;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-note rect{fill:#fff5ad;stroke:#aaaa33;stroke-width:1px;rx:0;ry:0;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-note text{fill:black;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram-note .nodeLabel{color:black;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagram .edgeLabel{color:red;}#mermaid-svg-Fhy9rIQgMFPT5crp #dependencyStart,#mermaid-svg-Fhy9rIQgMFPT5crp #dependencyEnd{fill:#333333;stroke:#333333;stroke-width:1;}#mermaid-svg-Fhy9rIQgMFPT5crp .statediagramTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-Fhy9rIQgMFPT5crp :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} bash deploy.sh docker
TUI 确认
写入 .env 与 deploy.options
docker ps 校验
资源不足或依赖未就绪
升配或减组件后重跑
首次登录并初始化租户
待部署
镜像拉取
组件选择
容器启动
全部 Up
反复重启

4.4 部署链路时序

Nexent Web Docker Compose deploy.sh 操作者 Nexent Web Docker Compose deploy.sh 操作者 #mermaid-svg-2baBLMbZkReO2buq{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-2baBLMbZkReO2buq .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-2baBLMbZkReO2buq .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-2baBLMbZkReO2buq .error-icon{fill:#552222;}#mermaid-svg-2baBLMbZkReO2buq .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-2baBLMbZkReO2buq .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-2baBLMbZkReO2buq .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-2baBLMbZkReO2buq .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-2baBLMbZkReO2buq .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-2baBLMbZkReO2buq .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-2baBLMbZkReO2buq .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-2baBLMbZkReO2buq .marker{fill:#333333;stroke:#333333;}#mermaid-svg-2baBLMbZkReO2buq .marker.cross{stroke:#333333;}#mermaid-svg-2baBLMbZkReO2buq svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-2baBLMbZkReO2buq p{margin:0;}#mermaid-svg-2baBLMbZkReO2buq .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-2baBLMbZkReO2buq text.actor>tspan{fill:black;stroke:none;}#mermaid-svg-2baBLMbZkReO2buq .actor-line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-2baBLMbZkReO2buq .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-2baBLMbZkReO2buq .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-svg-2baBLMbZkReO2buq .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-svg-2baBLMbZkReO2buq #arrowhead path{fill:#333;stroke:#333;}#mermaid-svg-2baBLMbZkReO2buq .sequenceNumber{fill:white;}#mermaid-svg-2baBLMbZkReO2buq #sequencenumber{fill:#333;}#mermaid-svg-2baBLMbZkReO2buq #crosshead path{fill:#333;stroke:#333;}#mermaid-svg-2baBLMbZkReO2buq .messageText{fill:#333;stroke:none;}#mermaid-svg-2baBLMbZkReO2buq .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-2baBLMbZkReO2buq .labelText,#mermaid-svg-2baBLMbZkReO2buq .labelText>tspan{fill:black;stroke:none;}#mermaid-svg-2baBLMbZkReO2buq .loopText,#mermaid-svg-2baBLMbZkReO2buq .loopText>tspan{fill:black;stroke:none;}#mermaid-svg-2baBLMbZkReO2buq .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-2baBLMbZkReO2buq .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-2baBLMbZkReO2buq .noteText,#mermaid-svg-2baBLMbZkReO2buq .noteText>tspan{fill:black;stroke:none;}#mermaid-svg-2baBLMbZkReO2buq .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-svg-2baBLMbZkReO2buq .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-svg-2baBLMbZkReO2buq .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-svg-2baBLMbZkReO2buq .actorPopupMenu{position:absolute;}#mermaid-svg-2baBLMbZkReO2buq .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-2baBLMbZkReO2buq .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-2baBLMbZkReO2buq .actor-man circle,#mermaid-svg-2baBLMbZkReO2buq line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-svg-2baBLMbZkReO2buq :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} bash deploy.sh docker 生成配置并拉起容器 返回容器状态 终端输出超级管理员密码 浏览器访问 3000 端口 返回登录页 超管登录并创建租户管理员 租户管理员可用业务菜单

图3:从容器状态到业务菜单的六项部署验证证据链。

五、结果验证:怎么判断"真的跑起来了"

三项判断依据,缺一项都不算部署完成:

验证项 命令 / 动作 通过标准
容器状态 docker ps --format 'table {``{.Names}}\t{``{.Status}}' 基础设施与所选应用服务均为 Up,无反复 Restarting
HTTP 入口 curl -I http://localhost:3000 返回正常 HTTP 状态码,无连接拒绝
业务可用 超管建租户 → 换租户管理员登录 左侧出现"模型管理""知识库""智能体开发"等业务菜单

六、常见问题

Q1:3000 端口被占用?

ss -tlnp | grep 3000 或 lsof -i :3000 找到占用进程;官方 FAQ 说明可在 Docker Compose 配置中修改端口,安装文档给出的变量是 NEXENT_WEB_PORT。改完重新部署,并把 SITE_URL 一起改。

Q2:镜像拉取超时?

bash deploy.sh docker --image-source mainland 切国内镜像源;df -h 确认磁盘 ≥40 GiB;docker pull 单测某个镜像定位是网络还是仓库问题。

Q3:容器反复重启?

按 docker ps → docker logs <容器名> → free -h 的顺序查。官方 FAQ 给的容器日志命令就是 docker logs <容器名称>。8 GiB 是最低配,启用完整组件 + 沙箱时吃紧,是资源问题就升到推荐 16 GiB,或先只部署 infrastructure,application。

Q4:想让容器访问宿主机上的 Ollama?

容器内 localhost 指向容器自己。官方 FAQ 给三种方式:http://host.docker.internal:11434/v1、宿主机真实 IP(防火墙放行)、或在 Compose 对应服务加:

yaml 复制代码
extra_hosts:
  - "host.docker.internal:host-gateway"

Q5:沙箱创建失败?

官方 FAQ 的五步排查:Docker 服务状态、Runtime 能否只读访问 /var/run/docker.sock、NEXENT_SANDBOX_DOCKER_IMAGE 镜像是否拉取、NEXENT_SANDBOX_WORKSPACE_VOLUME 卷是否存在、沙箱资源限制是否超过主机余量。对应命令:

bash 复制代码
docker images nexent/nexent-sandbox
docker volume inspect nexent-agent-workspace
docker logs nexent-runtime --tail 100

Q6:超管登录后没有业务菜单?

不是 bug。超管只做权限管理,必须创建租户与租户管理员后换号登录。

七、总结

这篇只解决一个问题:在 Linux 服务器上按官方方式把 Nexent 真正跑起来。核心结论是放弃手写单容器 compose,改用仓库根目录 bash deploy.sh docker,让脚本按组件、端口策略、镜像源生成配置并拉起整套微服务;Web 入口是 3000 而不是 8000,配置文件是 deploy/env/.env 而不是虚构的环境变量。部署之后还有一道容易被忽略的门槛:首次创建的 suadmin@nexent.com 只是权限账号,必须依次创建租户、租户管理员并换号登录,平台才会出现模型、知识库、智能体等业务菜单。判断成功不要靠"命令没报错",而要靠容器全部 Up、3000 端口 HTTP 正常响应、租户管理员能看到业务菜单这三项,并把对应的真实截图与日志留证。文中标为【待实测填写】的下载耗时、机器配置、容器状态输出与三张截图,需要你在自己的服务器上补齐------只有这些数值和截图来自你实际操作过的一台机器,整篇结论才算有证据。

还要留意适用边界:这套判定针对官方 deploy.sh 生成的 Docker Compose 栈,离线包与自定义编排要按各自的资源口径复核;文中命令在 Linux 与 WSL 的 Docker 引擎上通用,但端口和数据卷路径要以本机 .env 为准。版本升级后参数可能改名,发布前请对照官方安装页复核一次,别把某个版本的组件清单当成长期不变的约定。

参考资料

相关推荐
去码头整点薯条9823 分钟前
NFS服务器
linux·运维·服务器
蜗牛一步步往上爬1 小时前
第一章 初识Linux shell
linux·运维·服务器
拂拉氏1 小时前
【知识讲解】 Linux线程中锁的认识
linux·互斥锁
无足鸟ICT2 小时前
【RHCA+】系统调优配置文件
linux·服务器
七夜zippoe2 小时前
Nexent 模型配置:4 字段与 9 个槽位
数据库·人工智能·模型·nexent
饿了吃洗衣凝珠2 小时前
DNS域名解析服务器
运维·服务器
布莱克6053 小时前
Swift 字符串详解:从基础用法到性能与最佳实践
服务器·开发语言·ssh·字符串·swift
时间的拾荒人3 小时前
Shell 脚本核心语法详解(下篇):流程控制、函数、重定向与文件包含
linux·运维·服务器·bash·脚本编程
cpolar技术支持4 小时前
容器数是 6 个、6 个、还是 6 个,可服务早被换掉了:用一个 5.5MB 的 Go 单文件把机器每周的变化记下来,再给它套一层别人看不懂的入口
python·docker·ai·cpolar