Skip to main content

部署方案与前提

本页与离线部署:技能影响范围配对使用。那页回答”技能层面哪些环节会在离线时断”,本页回答”要准备几台机器、每台做什么、网络怎么连、部署前检查什么”。 内容取自《GIS Agent 离线部署用户手册》V3.25(2026-10-18)第一至第六章;命令级细节、实际案例与故障处理见实施与运维要点,信创现场见x86 + 银河麒麟 V11 和龙芯 + 统信 UOS。
一句话结论:私有化部署通常按 3 台机器 规划——数据库服务器、GIS Agent 业务服务器、Token 服务器。三台机器职责分离,用户只访问 GIS Agent 业务服务器。

三机职责

公网模型场景下,Token 服务器可以是外部模型服务,不一定单独采购本地机器;私网模型场景必须单独准备 GPU Token 服务器。

服务器数量随方案变化

数据库已由客户提供、且使用公网大模型时,我方只需要 1 台 GIS Agent 业务服务器。

我方提供什么

离线包全部由我方提供,实施人员不需要自行制作安装包:
  • 数据库离线包
  • GIS Agent 离线包
  • 局域网大模型离线包(只有使用局域网大模型时需要)
部署顺序固定为 数据库 → 局域网模型(如有)→ GIS Agent。

实施只需记住这一条链路

使用局域网大模型时再增加一跳:
用户不直接访问数据库和模型服务器。

GIS Agent 业务服务器配置

这台机器运行 postgis_gateway、gisagent、agent-acp、Web 和知识库服务。采购和扩容遵循”内存优先”,同时保证磁盘空间、Docker 和容器网络可用。

数据库服务器

优先使用客户现有的 PostgreSQL / PostGIS;没有现成数据库时,使用我方数据库离线包部署。本项目按 16 核、32GB 内存 规划,磁盘容量、IOPS、PostgreSQL 版本和备份资源由运维按数据量确认。数据库服务器不要与 GPU 模型服务器混用,除非项目已单独确认。

Token 服务器

Token 服务器只在需要独立模型服务或私网大模型场景时准备。公网方案只需要可访问模型 API;私网方案需要 GPU、驱动、推理引擎和模型权重。 GIS Agent 包对模型能力的最低要求是不低于 Qwen3.8-27B-FP8。首次验收建议先以 32K 或 64K 上下文启动,确认显存、延迟和工具调用稳定后再提高到 256K。GPU 型号、卡数、显存和并发能力不作为固定客户承诺,最终以 GPUStack、vLLM / SGLang、GPU 厂商兼容矩阵和现场压测结果为准。

网络结构与端口

访问关系

模型 API 端口由 GPUStack 或现场模型网关决定,实施时填写实际端口,不要直接套用 17076。

GIS Agent 内部端口

以下端口默认只给容器或内网服务使用,不需要对客户办公网开放。

网络配置判断要点

  • 局域网大模型:GIS Agent 能访问数据库和 Token 服务器即可,不要求访问公网。
  • 公网大模型:GIS Agent 能访问公网模型 API 的 443 端口即可,不需要 GPU 模型服务器。
  • 用户只访问 GIS Agent 的 17076,不要让用户直接访问数据库和模型服务器。
  • 私网三台服务器之间必须有路由,防火墙按上表放行;GPUStack 管理端口只对运维网或 GIS Agent 开放。
  • 多机部署时 GIS Agent 通过数据库服务器的 IP/DNS 和 TCP 端口访问 PostgreSQL,不使用数据库容器名、跨主机 Docker network 或数据库服务器上的 localhost。
  • 数据库离线包的端口映射通常是 17072:5432,因此连接地址写成 <数据库服务器IP或DNS>:17072;客户提供原生 PostgreSQL 时填实际监听端口,不能机械套用 17072。

公网大模型和局域网大模型怎么选

局域网方案把数据留在客户内网,并可以规划更大参数量的模型,代价是需要 GPU、显存、推理引擎和模型运维;公网方案不需要本地 GPU、接入更快,但依赖公网、密钥和第三方服务。两类方案共用同一套 GIS Agent 离线包,GIS Agent 只调用模型服务,不负责模型推理。

实施前客户需要提供什么

部署前确认清单

按顺序确认,确认一项再做下一项。
  1. 明确部署方案:私有化局域网模型,还是公网模型。
  2. 按方案准备服务器:GIS Agent、数据库、Token 服务器(私网模型需要)。
  3. 在 GIS Agent 业务服务器执行 docker ps 和 docker compose version。
  4. 确认 GIS Agent 能访问数据库端口。
  5. 使用局域网模型时,确认 GPUStack worker 为 READY、目标模型为 RUNNING。
  6. 使用局域网模型时,从 GIS Agent 运行环境验证 /v1/models 和 /v1/chat/completions,确认模型 ID 和鉴权有效。
  7. 使用公网模型时,确认 GIS Agent 能访问模型 API 的 443 端口。
  8. 上传离线包,按”数据库 → 局域网模型(如有)→ GIS Agent”的顺序部署。
  9. 用浏览器访问 http://<GIS-Agent-IP>:17076/,登录后完成授权。
清单全绿只代表”环境具备了”,不代表”能对话”。验收判据见实施与运维要点的部署后验收一节;信创现场还要再叠加对应基线的闸门,见x86 + 银河麒麟 V11 或龙芯 + 统信 UOS。

与技能影响范围的关系

本页是机器与网络层面的准备;离线部署:技能影响范围是技能与出图层面的准备,按前端库、底图瓦片、注记字体、要素数据四个环节把 49 个技能分成 L1–L6。两个口径不同但方向一致:
  • 手册的联网能力矩阵针对 agent-* 运行面,结论是纯局域网下四条 Agent 默认不可用,必须改指向内网兼容端点;
  • 技能影响页针对制图产出,结论是 42 个技能需要本地化底图、字体或数据源,只有 7 个可直接离线出图。
落地顺序建议:先按本页把三台机器和网络打通,再按技能影响页处置 L1(前端库),然后依次处理 L2 底图、L3 注记字体、L4 数据与 L5 自有服务地址。