逸云 GIS - 用户手册部署文档
逸云 GIS 以独立可执行程序的形式交付，无需安装 Node.js 环境或其他依赖，开箱即用。
部署模式
逸云 GIS 支持两种网络部署模式，根据使用场景选择：
| 模式 | 适用场景 | 访问方式 | 是否需要 Nginx |
|---|---|---|---|
| 直接访问 | 本机使用、内网小规模使用（<10人） | http://IP:3000 | 不需要 |
| Nginx 代理 | 公网部署、多用户并发、需要域名/HTTPS | https://域名 | 需要 |
直接访问模式
Node.js 直接对外提供服务，简单方便，适合本机或内网小规模使用。
用户 → Node.js (HTTP:3000 / HTTPS:3443)
- 零配置，双击即用
- 支持内置 HTTPS（配置证书后）
- 静态文件和 API 共享 Node.js 进程资源
- 无缓存/压缩/限流等生产级优化
Nginx 代理模式
Nginx 作为反向代理对外服务，Node.js 仅监听本地端口，适合公网部署。
用户 → Nginx (80/443) → Node.js (localhost:3000)
- HTTPS 由 Nginx 高效处理，Node.js 只跑 HTTP
- 静态资源缓存 + Gzip 压缩，性能更优
- 安全限流、IP 访问控制
- Node.js 崩溃时 Nginx 可返回降级页面
详见: Nginx 配置
部署方式
Windows 部署
在 Windows 服务器或个人电脑上快速部署，双击即可运行。
Linux 部署
在 Linux 服务器上部署，适合生产环境。
Nginx 配置
公网部署 Nginx 反向代理配置指南，实现 HTTPS、域名访问和性能优化。
公有云部署
阿里云、腾讯云、AWS 等公有云平台部署指南。
私有云部署
企业私有数据中心部署方案。
运维管理
环境配置
系统环境变量和配置文件说明。
备份恢复
数据备份策略和恢复操作。
监控维护
系统监控和日常维护指南。
系统要求
| 环境 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU | 2核 | 4核+ |
| 内存 | 4GB | 8GB+ |
| 磁盘 | 20GB | 100GB+ |
| 网络 | 10Mbps | 100Mbps+ |
| 操作系统 | Windows 10+ / Linux | Windows Server 2022+ / Ubuntu 22.04+ |
发布包内容
收到的发布包（压缩包）包含以下内容：
gisnode/
├── node.exe # 主程序（pkg 打包后的独立可执行文件）
├── dist/ # 前端页面
│ ├── index.html # 主页面
│ └── assets/ # 静态资源
├── docs/ # 用户手册文档
├── native/ # 原生模块
│ ├── better_sqlite3.node # SQLite 原生模块
│ └── gdal.node # GDAL 原生模块（可选）
├── gdal-runtime/ # GDAL 运行时（可选，用于 COG 元数据提取）
├── data/ # 数据目录
│ ├── gisnode.db # 主数据库
│ ├── etl.db # ETL 数据库
│ └── ... # 其他数据文件
├── certs/ # SSL 证书目录（可选）
└── .env # 环境配置文件
快速开始
- 解压发布包到目标目录
- 编辑
.env文件配置参数（可选） - 运行
node.exe启动服务 - 浏览器访问
http://localhost:3000
详细步骤请参考 Windows 部署 或 Linux 部署。