龙芯 + 统信 UOS 信创适配
本文是第二条信创基线,和 x86 + 银河麒麟 V11 并列;两条基线的结论不能互相外推。 一句话:除 MapGIS 10 与 claude 2.x 外,GIS Agent 主站、知识库、数据层、GIS 工具链和可用的 AI Agent 运行时(opencode / qwen-code / qoder)已在 LoongArch64 上跑通;MapGIS 相关能力仍需 x86 服务器承载。
一、结论与边界
三条硬边界:
- MapGIS 不在龙芯支持范围内。MapGIS 10 安装包是 x86-64 ELF,
postgiscli与 4 个内置 agent 镜像都继承它;强行运行会在启动阶段报exec format error,不是配置错误。 - AI Agent 不是全部可移植。opencode 已移植到 Node 24/loong64;qwen-code、qoder 可用;claude 2.x 是平台原生二进制,没有 loong64 版本。
- E2E 不是 52/52 全绿。52 例中 51 例有完整助手回复,自动化检测通过 30 例;6 失败 / 16 超时集中在系统浏览器长时间 WebGL 渲染,不能据此判定 agent 功能失败。
二、两条信创基线怎么选
三、实测环境基线
下表是最终验证机的主要读数;信创现场版本差异大,部署前必须用只读命令对账。版本提示:早期 UOS 20 / glibc 2.28 / Docker 20.10.3 环境也能跑,但需要按“老引擎”处理挂载垫片;最终验证环境是 UOS V25 + Docker 26,步骤更简单。不要把两套版本的具体读数混用。
四、推荐拓扑:B1 混合架构
龙芯上最容易踩的坑,是“想把 MapGIS 也搬过来”。正确做法是承认边界,把 MapGIS 相关部分留在 x86:- gisagent 通过本地 docker socket 创建 ACP 会话容器;MapGIS agent 只能在 x86 跑,gisagent 在龙芯就调度不到它们。
- 远程 Docker 需要改产品代码,不在当前版本范围。
- B1 保持产品代码不变,只把“无 MapGIS 依赖”的服务放到龙芯。
五、部署流程(精简版)
5.1 先做只读探测
uname -m=loongarch64;docker version同时有 Client 和 Server;docker info能看到Storage Driver: overlay2、Cgroup Version: 1;docker compose version能出版本。
5.2 容器引擎与编排
- UOS 官方源通常没有可用的 Docker 引擎包;需要离线 deb,或从麒麟 V10 SP3 的 loongarch64 RPM 解包安装。
- 早期环境可用 Docker 20.10.3 + containerd 1.4.3;最终验证环境为 Docker 26 + Compose 1.29。
- 老引擎(
API < 1.45)不支持volume-subpath,需要挂载垫片;垫片必须放在镜像内/usr/local/bin/docker,因为 agent 的runtime.env.PATH只认标准目录。 daemon.json建议:data-root放/data/docker、overlay2、关闭 seccomp 限制(UOS/loong64 内核与默认 seccomp 不兼容)。
5.3 基础镜像必须用 UOS rootfs
不要用 Debian/Alpine 的 loong64 基础镜像:它们的 8 字节 sigset 与本机内核要求的 16 字节不一致,表现为select() returned error: Invalid argument、timeout: sigprocmask: Invalid argument,甚至 Go 二进制启动即 SIGSEGV。
推荐链路:
/usr是独立 overlay 挂载,打包时不要用--one-file-system;- 排除 UOS 安全模块路径,否则
docker import可能 EPERM; - 排除过度会丢
libusec.so.1,导致镜像内useradd失败; - 基础镜像内要显式创建
/tmp并chmod 1777。
5.4 构建/导入镜像
需要构建或导入的 loong64 镜像:gisagentknowledge-mcp-httppostgis-gatewayagent-qwen-codeagent-qoderagent-opencode
agent-claude(2.x 无 loong64 原生包;1.x 会话不可用)postgiscli与 MapGIS 系列(x86-64 ELF)hello-mcp、amd64 helper(未构建/不适用);ocr_cli镜像未纳入本包,OCR 由 geoscan + tesseract 回退提供
package.sh 已带 loong64 分支:MAPGIS_SUPPORTED=0、LOONG64_READY_IMAGES、assert_no_mapgis_layer。打包前逐镜像校验 Architecture = loong64,不要把 amd64 镜像 load 到龙芯。
5.5 数据层:源码编译 PostgreSQL/PostGIS
既有 x86 离线包不能直接用:早期 UOS 20 的 glibc 2.28 低于 PG17 离线包要求的 2.34。最终验证环境用源码编译:- PostgreSQL 17.11
- GEOS 3.12.2
- PROJ 9.3.1
- PostGIS 3.6.4
/data/gis-stack(pgsql/ + deps/ + data/ + etc/),systemd 托管,监听 17072。关键点:
postgres专用系统用户 +RemoveIPC=no,否则 logind 会删掉 PG 共享内存;psql/initdb必须显式带-p 17072;postgis-3.so与libgeos_c.so.1/libproj.so.25要固化 rpath,DT_RUNPATH 不传递二级依赖;- 验收:
SELECT postgis_version();返回 3.6,ST_Transform/ST_Buffer/ST_AsMVT可用。
5.6 部署 gisagent / knowledge MCP
B1 使用compose-b1-loong64.yml,两个服务:
四条接线必须满足:
- 挂完整的
agent.json,不要用只含一项的最小配置替换,否则内置 4 个 agent 全部消失; __BUNDLE_ROOT__替换成宿主路径(agent 容器由宿主 daemon 创建,bind 源必须是宿主路径);- 挂
/var/run/docker.sock; - 挂
gisagent-workspace-data卷到/workspace,并预创建网络、卷、skill 子目录。
GISAGENT_ADMIN_USERNAME / GISAGENT_ADMIN_EMAIL / GISAGENT_ADMIN_PASSWORD,缺一个就会退化为“需要已有 admin 用户”,表现为登录报账号密码错误。密码放同目录 .env(600),不要写进仓库。
5.7 授权:双指纹
龙芯上宿主与容器的机器指纹不同:- 宿主:
machine_id有值,cpu_id/system_uuid可能为空; - 容器:
machine_id可能不同,system_uuid可能被容器运行时填充。
/etc/machine-id,签发双指纹许可证(宿主 + 容器都覆盖)。product_uuid / board_serial 为空时,确认 fallback 来源,避免换机免重签或同机重复签发。
5.8 Agent 与模型
- qwen-code:纯 JS 入口,可在龙芯跑。镜像内必须有 uid 1001 的 passwd 条目;每个用户的 runtime home 卷要
chown -R 1001:1001。Coding Plan key 走https://coding.dashscope.aliyuncs.com/v1,不是普通 DashScope 兼容端点。 - opencode:官方基于 Bun,无 loong64;已移植到 Node 24(better-sqlite3、node-pty、watcher-shim 等),作为原生 ACP agent 可用。
- qoder:已构建 loong64 镜像;home 卷同样要改属主。
- claude 2.x:平台原生二进制,无 loong64,不要浪费时间。
- 内置 4 个 docker-user-container agent:依赖 x86 MapGIS 镜像;龙芯上应使用原生 agent,或把 agent 面留在 x86(B1)。
5.9 验收判据
- 把 amd64 镜像 load 到龙芯,运行应报
exec format error; - 未授权时新建会话应返回“系统未授权”,而不是假装成功;
- Provider 连接矩阵应 32/32 通过;
- 原生 opencode 用户级用例应 PASS(登录→绑定→建会话→发消息→收到回复)。
六、三个关键缺陷(已修复)
这三个都不是 LoongArch 指令集问题,而是运行时、镜像、技能注入的工程问题;换架构时同样要检查。
七、能力矩阵
E2E 结果怎么读
- 52 例中 51 例会话里有完整助手回复(472–935 字),说明 agent 侧确实执行了任务;
- 自动化检测通过 30 例;6 失败 / 16 超时,集中在系统浏览器(deepin browser)长时间 WebGL 渲染后假死/变慢;
- 失败/超时项不是 agent 没回复,而是 Playwright 选择器/浏览器渲染问题;
- 不要把“自动化 30/52”写成“功能 30/52”,也不要把“51/52 有回复”写成“52/52 全通过”。
八、常见坑速查
九、交付物与复现
配套交付物(按内部交付流程提供,不在公网文档直接挂载):- 《龙芯 UOS-GISAgent 适配汇报》PPT / 单文件 HTML(16 页)
- 《龙芯 UOS-GISAgent 测试报告》DOCX
docker-uos-xinchuang-adaptationchange 目录:环境基线、B1 部署、LoongArch 打包、opencode 移植、集成测试、能力边界、踩坑清单
build-gisagent-image-loongarch64.shbuild-node-app-image-loongarch64.shbuild-compose-loongarch64.shpackage.sh的 loong64 分支compose-b1-loong64.ymlassets/verify.sh
B1-DEPLOYMENT.md / PACKAGING-LOONG64.md 执行。
十、结论
- 不需要 MapGIS:龙芯 + UOS 可以作为独立信创基线交付,主站、知识库、数据层、GIS 工具链和可用的 Agent 运行时(opencode / qwen-code / qoder)均可跑;claude 2.x 与 MapGIS 不在内。
- 需要 MapGIS:用 B1 混合拓扑,gisagent + MapGIS agent 留 x86,龙芯承载数据库/知识库;不要承诺 MapGIS 在龙芯运行。
- 全栈国产化且必须含 MapGIS:当前不成立,需等 MapGIS 厂商提供 loongarch64 包,或增加 x86 服务器。
- 性能/并发:4C/31GB 验证机不能作为生产配置承诺;按实际业务量和部署方案与前提重新评估。
使用提示: 先回答三个问题再选型——“CPU 是 x86 还是龙芯?""业务是否必须用 MapGIS?""是单机还是 x86 + 龙芯混合?” 三个答案决定用哪条基线,不要拿麒麟 x86 的结论直接套龙芯。