x86 + 银河麒麟 V11 离线部署
本文是 x86_64 + 银河麒麟 V11 基线。龙芯 LoongArch64 + 统信 UOS 是另一条基线,见龙芯 + 统信 UOS;两条基线的结论不能互相外推。 本章只解决一件事:客户现场是国产操作系统、但 CPU 仍是 x86_64 时,离线部署与标准流程有哪些差异。标准流程本身不变,仍按部署方案与前提的确认清单执行。结论先行
- 软件栈已在 x86_64 + 麒麟 V11 上完整跑通(GIS Agent 全栈 + 离线 PostgreSQL/PostGIS + 局域网大模型接入),不需要修改产品源码,也不要求客户升级 Docker 引擎。
- 本文的 CPU 仍是 x86_64;CPU 国产化(龙芯)是另一条基线,且 MapGIS 相关能力仍需 x86 承载。
- 推理硬件仍未国产化:仍依赖 NVIDIA / AMD 加速卡生态,国产加速卡未采购、未实测。
- 麒麟现场的失败几乎都不在”装不上”,而在四道现场闸门。
deploy.sh自检全绿、容器全部 healthy,仍不等于”能对话”。
先选基线
国产化边界
实测环境基线
下表全部取自一台麒麟 V11 实测机的只读探测,用途是和客户提供的机器逐项对账。该实测机是低配虚机,不能当交付配置用,交付配置以部署方案与前提的硬件章节为准。
两条必须核对的语义:
docker命令存在不代表守护进程存在——该机出厂只有docker-cli,引擎要另装moby。- daemon 的 API 版本决定会话工作区的挂载语义(本机
1.43低于1.44),必须按下方闸门 3 走对应档位,且不能凭docker version里 CLI 的版本号判断。
麒麟软件源缺什么,怎么补
麒麟源只有内网可达时才装得动:这类目标机通常没有外网出口,只有一段局域网 HTTP 代理。此时
dnf 不读 http_proxy 环境变量,只认 /etc/dnf/dnf.conf 里的 proxy=http://<代理主机>:<代理端口>。两条配套判据:
- 验证出网一律用
curl -sS -o /dev/null -w '%{http_code}\n' <地址>,不要用ping:ICMP 不走 HTTP 代理,ping全丢包不代表代理坏了。 - 远程执行环境通常带注入的代理变量。要测”不带代理是否真的不通”,必须
env -i <命令>把环境清干净,否则这条阴性对照会静默走代理而假性成功。
端口与防火墙:容器发布端口和宿主自建端口不是一回事
麒麟默认开着firewalld,实测出现同一台机器上两类端口行为不一致,现场极易误判成部署失败。
即只有”跨机器直连宿主自建数据库”这一种场景需要动防火墙。放行命令(按现场端口替换,需 root):
nc -vz <数据库服务器> 17072,期望从不可达变为 succeeded。放行后仍不通,再查数据库自身的 listen_addresses 与认证配置,不要先怀疑本产品。
数据库离线包在麒麟上的落地要点
交付的 PostgreSQL 17 + PostGIS 离线包在 Ubuntu 24 上构建,在麒麟上可直接运行,不要重编:其二进制最高只依赖GLIBC_2.34,低于麒麟 V11 的 glibc 2.38。需要处理的只有共享库和参数。
- PostGIS 缺 7 个共享库:
libcurl-gnutls.so.4、libjbig.so.0、libjpeg.so.8、libdeflate.so.0、libbz2.so.1.0、librtmp.so.1、libsasl2.so.2。补入包的lib目录后pg_ctl restart,12 个扩展CREATE EXTENSION全过,postgis_version()返回3.5。筛库必须用ldconfig -p的 soname 全集精确比对;用”带空格的前缀匹配”会把无关库一起拷进来。 - 监听与认证:自建实例监听
0.0.0.0:17072,pg_hba至少放行127.0.0.1/32、172.16.0.0/12、<现场网段>三条scram-sha-256。 psql与initdb必须显式带-p 17072:不带端口会去连默认5432的本地 socket 直接失败,该报错容易被误读成”库没起来”。- 编排侧走 remote 拓扑:宿主自建库用
--database-url postgresql://<用户>@<数据库服务器>:17072/<库名>传入,不要用 colocated 分支(那条分支依赖同名容器做地址重写与联网)。容器内探测宿主端口时用宿主内网地址或172.17.0.1,不要指望host.docker.internal(部分镜像里没有这个解析)。
四道现场闸门
麒麟离线机的失败按下面顺序排查,任何一跳不过都表现为”装好了但没法用”。
部署顺序:
deploy.sh → 代理收尾(闸门 1 的 override 与变量透传)→ 上传授权 → 建会话验收。代理收尾必须在 deploy.sh 之后执行,重放不会破坏 users/ 布局。
老引擎机器部署完成后,deploy.sh 日志应出现”会话工作区挂载模式=shim”与”GISAgent 同构环境下 <WS> 可写且跨用户不可见”两行;缺任何一行都按未通过处理。只有显式打开降级开关才会退回共享布局,此时同机用户互相可见会话产物,必须写进交付单由客户确认。
现场确认清单
开工前在目标机上跑一遍(全部只读、不需要 root),共 14 条命令,把结果与上方基线逐项对账。麒麟现场完整部署流程(裸机 → 能对话)
十个编号步骤,每步只给”命令 → 期望读数 → 不通过时看哪儿”。下面用<数据库服务器>、<GIS-Agent-IP>、<模型服务> 三个占位符,单机体时三者同值。
各步骤不通过时的定位:
- 步骤 2 只有 Client 段没有 Server 段 → 机器上只有
docker-cli,守护进程没装或没起;dnf拉不动源 → 按上方代理判据用curl验出网。 - 步骤 4 md5 不一致 → 重传,不要拆分或改名 bundle 内部目录。
- 步骤 5 连不上 → 先确认有没有带
-p 17072;扩展报错 → 按ldconfig -p全集精确补库。仅”其它机器直连宿主自建库”时才动防火墙。 - 步骤 6 数据库 TCP 预检失败 → 回步骤 5(监听地址、认证配置、防火墙三查);日志读到的挂载模式既不是
shim也不是native→ 现场显式开了降级开关,必须写进交付单。单机体也走remote。 - 步骤 7 返回
000→ 容器仍没出网,先查NO_PROXY是否含现场网段与172.16.0.0/12,再查会话容器的变量透传白名单是否漏了变量名。 - 步骤 8 校验失败 → 先核对机器码与本机是否一一对应;未授权时不会拉起会话容器,这不是部署失败。授权指纹只取
os / machine_id / cpu_id / system_uuid / volume_serial,不含主机名,所以容器重建不会失效、无需重传。 - 步骤 9 下拉没有该模型基本都是三件事之一:运行配置里的地址与模型 ID 没改对、GISAgent 未重启、复用了旧会话或旧的 ACP 运行实例。先排步骤 7,容器出网没通时这里必坏。
- 步骤 10 报无法写入工作目录 → 闸门 3;“复验通过但真实会话仍异常” → 闸门 4 的三个陷阱;只有
ACP session created不算通过。
http_code 非 000、步骤 10 卷侧路径带用户子树。其余步骤全绿只是”装上了”。步骤 8 与步骤 9 顺序可换,但都必须在步骤 10 之前完成。