快速开始（本地部署）

在自己的服务器上用离线包安装 GeoBridge，然后按在线快速开始的步骤发布第一个服务。安装过程不需要访问外网。

1. 环境要求

• Linux（x86_64）服务器；也可以在 macOS 上试用（Apple silicon 以仿真方式运行，只适合试用）。
• Docker 20.10 及以上，Docker Compose v2（docker compose 命令）2.20 及以上；运行安装脚本的用户能执行 docker。
• Docker 可用内存建议 8 GB 及以上；不足时安装脚本给出警告但继续安装。
• 磁盘：镜像约 3 GB，另按数据量预留。
• 端口：对外端口（默认 80）与本机应用端口（默认 9086）空闲。

2. 下载离线包并核对

从下载页获取离线包 geobridge-0.1.0-linux-amd64.tar.gz 与同名的 .sha256 校验文件，复制到服务器上的同一目录，核对后解压：

sha256sum -c geobridge-0.1.0-linux-amd64.tar.gz.sha256
tar xzf geobridge-0.1.0-linux-amd64.tar.gz
cd geobridge-0.1.0

sha256sum -c 输出 OK 才说明文件完整。

3. 安装

./install.sh --offline --host <对外 IP 或域名>

• --offline：从离线包加载全部镜像，启动时不拉取镜像，服务器不需要访问外网。
• --host：浏览器访问平台用的 IP 或域名，不带 http:// 与路径。云服务器请填公网 IP 或域名（本机检测到的通常是私网地址）。
• 对外端口默认 80，被占用时用 --port <端口> 换一个。

安装脚本依次检查环境与端口、生成配置、加载镜像、启动服务，并等待全部服务就绪（最长 5 分钟）。安装脚本可以重复运行，已有的配置不会被覆盖。

常见问题：

• 提示「端口 … 已被占用」：用 --port 换端口重新运行，或停掉占用端口的程序。
• 提示「服务在 5 分钟内未就绪」：较慢的机器上首次启动可能超过 5 分钟，服务会继续启动；稍后用 docker compose ps 查看状态，或重新运行安装脚本。

4. 首次登录

安装完成后，屏幕上会打印访问地址、管理员账号 admin 与一个随机生成的初始密码：

访问地址：http://<主机>[:<端口>]/geobridge-mapserver/console/
管理员账号：admin

• 用浏览器打开访问地址，用 admin 与初始密码登录（有图形验证码），登录后立即在个人资料中修改密码。
• 初始密码只在第一次安装时打印。之后需要查看时，它保存在部署目录下 .env 文件的 GEOBRIDGE_ADMIN_INITIAL_PASSWORD 一项；改这一项不会改变管理员密码。
• 请妥善备份部署目录下的 .env：其中的密钥不可更换，丢失后已加密的数据无法解密。

本地部署的平台地址是访问地址去掉末尾的 /console/，即 http://<主机>[:<端口>]/geobridge-mapserver。SDK 的 baseUrl 与沙箱的「平台地址」都填它。

5. 发布第一个服务

接下来与在线系统相同，按快速开始（在线）第 2–6 步操作：上传数据、发布服务、设为公开或创建 API Key、用 SDK 加载、在沙箱里试运行。几处差异：

• 用 admin 登录后同样需要先新建一个工作空间（在线快速开始第 1 步的后半部分）。
• 第 5 步代码里的 baseUrl、vendor/ 文件的下载地址都换成你的平台地址，例如 http://<主机>/geobridge-mapserver/sandbox/vendor/geobridge-sdk.umd.js。
• 第 6 步可以直接打开你自己平台上的沙箱 http://<主机>/geobridge-mapserver/sandbox/，「平台地址」默认就是本平台；也可以用官网的在线沙箱，把「平台地址」改成你的平台地址（浏览器能访问到即可）。