部署
GeoTwin 可以以预装好平台的一体机交付，也可以部署在客户自己的服务器上。本文档说明服务器部署；一体机用户请从快速开始开始。
部署形态
| 形态 |
适用场景 |
需要准备 |
| 一体机 |
单站点、快速上线、数据必须留在本地 |
电源、网络与现场运维人员 |
| 服务器部署 |
已有数据中心、集群或多租户使用 |
主机、数据库、存储与 TLS 证书 |
系统要求
具体配置取决于数据量、并发用户数和渲染负载。以下是旧版 Server 手册给出的起点。
硬件
- CPU：试点 8 核以上；生产 16 核以上。
- 内存：试点 32 GB；三维场景渲染较多时 64 GB 以上。
- GPU：云渲染建议独立显卡；轻量二维业务可使用集成显卡。
- 存储：平台与数据库使用 SSD；瓦片、点云与模型使用可扩展的独立存储。
软件
- 操作系统：Windows Server 或 CentOS 9（或兼容的 Linux 发行版）。
- 数据库：PostgreSQL 或达梦 DM8。
- 容器：Docker；集群部署可使用 Kubernetes。
- 浏览器：当前版本的 Chrome、Edge 或 Safari，并启用 WebGL。
网络
- Web 入口通过 HTTPS（443）发布，HTTP（80）跳转到 HTTPS。
- 数据库、对象存储和内部服务端口只开在私网。
- 只开放实际使用的 API 与云渲染端口。
- 远程站点上线前先测试延迟；大瓦片和点云请求对往返时延比较敏感。
安装步骤
- 准备主机、DNS 记录与 TLS 证书。
- 安装并调优数据库，创建独立数据库与账号。
- 准备瓦片、模型、全景和附件的文件存储。
- 安装 GeoTwin 服务包，配置数据库与存储连接。
- 启动服务，检查健康检查接口。
- 以管理员登录，导入许可，创建第一个租户与项目。
- 导入一份小数据集并发布一个服务，做端到端验证。
安装参数（数据库、存储路径、端口、许可）请记录在客户自己的配置台账中，不要写入公开仓库。
反向代理
在 nginx 或现有网关上终止 TLS，再转发到平台服务。最小配置示例：
server {
listen 443 ssl;
server_name geotwin.your-domain.com;
ssl_certificate /etc/letsencrypt/live/geotwin.your-domain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/geotwin.your-domain.com/privkey.pem;
client_max_body_size 2g;
location / {
proxy_pass http://geotwin-app:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
如果用户会上传大型点云或模型包，请调大 client_max_body_size。
备份与升级
- 每次升级前备份数据库、文件存储与配置。
- 平台与数据库在同一台机器时，升级前做主机快照。
- 在维护窗口内升级，先停止写入流量。
- 升级后先验证登录、一个已发布服务和一个场景，再恢复对外访问。
运维检查
下一步