部署方案与前提
本页与离线部署:技能影响范围配对使用。那页回答”技能层面哪些环节会在离线时断”,本页回答”要准备几台机器、每台做什么、网络怎么连、部署前检查什么”。 内容取自《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 业务服务器配置
这台机器运行
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 只调用模型服务,不负责模型推理。
实施前客户需要提供什么
部署前确认清单
按顺序确认,确认一项再做下一项。- 明确部署方案:私有化局域网模型,还是公网模型。
- 按方案准备服务器:GIS Agent、数据库、Token 服务器(私网模型需要)。
- 在 GIS Agent 业务服务器执行
docker ps和docker compose version。 - 确认 GIS Agent 能访问数据库端口。
- 使用局域网模型时,确认 GPUStack worker 为
READY、目标模型为RUNNING。 - 使用局域网模型时,从 GIS Agent 运行环境验证
/v1/models和/v1/chat/completions,确认模型 ID 和鉴权有效。 - 使用公网模型时,确认 GIS Agent 能访问模型 API 的
443端口。 - 上传离线包,按”数据库 → 局域网模型(如有)→ GIS Agent”的顺序部署。
- 用浏览器访问
http://<GIS-Agent-IP>:17076/,登录后完成授权。
与技能影响范围的关系
本页是机器与网络层面的准备;离线部署:技能影响范围是技能与出图层面的准备,按前端库、底图瓦片、注记字体、要素数据四个环节把 49 个技能分成 L1–L6。两个口径不同但方向一致:- 手册的联网能力矩阵针对
agent-*运行面,结论是纯局域网下四条 Agent 默认不可用,必须改指向内网兼容端点; - 技能影响页针对制图产出,结论是 42 个技能需要本地化底图、字体或数据源,只有 7 个可直接离线出图。