God‘s Eye View 本地部署教程:零密钥免费跑通实时 3D 地球仪,10 分钟选对安装路线-港品优选

God's Eye View 本地部署教程:零密钥免费跑通实时 3D 地球仪,10 分钟选对安装路线

【免费下载链接】gods-eye-viewA spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.项目地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view

God's Eye View 是一个在浏览器里运行的实时 3D 地球仪:真实航班、船舶、卫星、地震、城市摄像头与交通,全部来自公开数据源,不配置任何 API Key 也能完整启动。本地部署只有两条路——Pinokio 一键安装和终端部署。前者适合只看不改的桌面用户,后者适合要读源码、提 PR 或做无头服务器/CI 脚本化部署的人。两条路打开的是同一个应用,随时可以互换。

🧭 先定路线:五个维度的选型对比

选型不用靠感觉,对照下表的维度逐项判断即可:

维度	Pinokio 一键安装	终端部署
是否读改代码、提 PR	不需要	需要;配 CONTRIBUTING.md 与单元测试
是否要装 Git 和 Node.js	不需要,启动器装锁定版本的依赖	必须;Node 要求24.x(≥24.14.0)或 26.x
无头服务器 / CI 脚本化	不适用(GUI 启动器)	唯一选择,直接注入环境变量
系统差异与密钥来源	Windows/macOS 均可,跨平台测试完善	macOS 且密钥在系统钥匙串里时,启动脚本可一键取钥
出问题的回退成本	菜单 "Repair installation" 一键修复	重跑`npm ci`补齐依赖

决策叙述:如果三个问题里——不改代码、机器上不想碰依赖、不是无头/CI 场景——命中任意两条,走 Pinokio;只要有一条命中"要改代码"或"脚本化部署",走终端。

📦 两条安装路线,各一步一验收

路线 A:Pinokio 一键安装(纯使用优先)

菜单里的 Install / Start / Update / Repair installation 四个动作定义在 pinokio/pinokio.js,启动逻辑在 pinokio/start.js 与 scripts/pinokio-start.mjs。

把 Pinokio 装好或升到 8.2 及以上。→ 成功标志:应用列表里能看到 "God's Eye View" 条目。8.0.40 的 Configure 面板会把密钥写到错误路径并记录提交值,8.2 已修复。
打开 "God's Eye View" 应用页,点击 Install。→ 成功标志:菜单从 "Install" 变成 "Start"。背后发生的事:启动器在本地安装锁定版本的依赖,不读你机器上的全局 Node。
点击 Start,等浏览器自动打开。→ 成功标志:出现可交互的 3D 地球。背后发生的事:启动器挑选一个空闲本地端口,把服务严格绑定到127.0.0.1(strictPort),然后打开页面——局域网里的其他人访问不到它。
仍装不上时:先把 Pinokio 升到 8.2 再试;还不行,用菜单里的 "Repair installation"(对应 pinokio/reset.js)重建安装。

路线 B:终端部署(改代码 / 无头 / CI 优先)

前置要求:Node24.14.0+ 或 26.x;Node 25 已停止维护,体检会给出警告但不阻止。

克隆仓库。→ 成功标志:目录出现package.json、pinokio/、scripts/。
```
git clone https://gitcode.com/GitHub_Trending/go/gods-eye-view cd gods-eye-view
```
安装依赖。→ 成功标志:生成node_modules/。
```
npm ci
```
背后发生的事:npm ci按package-lock.json装锁定版本,和 Pinokio 路线装的是同一套依赖。
跑体检。→ 成功标志:Node/npm 版本、依赖完整性、各数据源能力、每个密钥的来源(环境变量 /.env/ macOS 钥匙串)全部有交代。
```
npm run doctor
```
体检由 scripts/setup-doctor.mjs 驱动,只报告密钥从哪来,不打印密钥明文。建议每次启动前都跑一遍。
启动开发服务器。→ 成功标志:打开http://localhost:4173,首次运行面板出现四个入口:Live Contacts(实时航空)、Space Missions(太空任务)、Environmental(环境层)、Explore Manually(自由探索)。
```
npm run dev
```
背后发生的事:Vite 启动本地 dev server,默认只绑 localhost;服务器默认是"本地代理"角色——它替浏览器转发数据源请求,所以默认不暴露到网络是有意为之。

性能基线:官方在Apple M5 + Chrome下实测冷启动中位数约1.86 秒(初始 settle 口径),属于单时间点基线而非保证值,完整数据与测量条件见 docs/PERFORMANCE.md。

🔧 故障排查速查表

现象	原因	处理
doctor 报`too old; install Node 24.14 or newer`	Node 低于 24.14	装 Node 24.14+ 或 26.x,重跑`npm run doctor`
doctor 提示依赖缺失	未装或装不完整	`npm ci`后重跑体检
Node 25 收到 WARN(EOL)	25 已停止维护,分配基准被跳过	可继续运行;建议升到 24.x / 26.x
端口4173被占用、页面是旧版	残留 dev 进程或旧 Vite 缓存	跑`./scripts/dev-fresh.sh`:停旧服务器、清理占端进程、清空`node_modules/.vite`后重启;同样支持无 Key 启动
macOS 钥匙串里已存密钥	终端路线可自动取钥	`dev-fresh.sh`会自动从 Keychain 拉取,无需手写`.env`
Pinokio 安装异常	旧版 Pinokio(8.0.40)缺陷	升 8.2+ 重试;仍异常用菜单 "Repair installation"
Pinokio 内嵌视图卡顿	内嵌浏览器渲染路径问题(官方性能文档有记录)	用系统浏览器打开同一个本地 URL,不要拿两种渲染口径直接对比帧率

🔑 密钥:升级项,不是门槛

需要某个付费或注册级能力时,点右下角POWER UP芯片打开 Provider Settings,粘贴密钥后点SAVE KEYS,应用自动重启并启用对应能力;全部配置完成后芯片显示POWERED UP。若紧凑布局把芯片藏住了,访问?setup=1可重新打开同一面板。

能力	费用	密钥变量	是否必需
Google 照片级 3D 城市 + 全球地形	免费档	`CESIUM_ION_TOKEN`	否
全球船舶实时位置	免费注册	`AISSTREAM_API_KEY`	否
24 小时活跃火点	免费	`FIRMS_MAP_KEY`	否
语音操控 + AI HUD 摘要	按量计费(应用内$2软警告、$5硬上限)	`OPENAI_API_KEY`	否
直连 3D 瓦片 + 应用内地点搜索	按量计费	`GOOGLE_MAPS_API_KEY`	否

密钥到底存在哪里:Pinokio 路线写入pinokio/ENVIRONMENT,终端路线写入仓库根目录.env。两个文件落盘前都会先设为仅所有者可读写,内容是本地明文,且都被排除在版本库之外。不手动改文件是最省心的路径:应用内粘贴即可。

安全边界:服务器默认只绑定 localhost;局域网共享(HOST=0.0.0.0)是显式开启项,启动时会打印风险警告,提示该 dev server 会把已配置的 API Key 代理给任何能访问到它的人。更多细节见 SECURITY.md。

✅ 首跑验收:按这个顺序点一遍

无论走哪条路线,按交互顺序逐项确认,每项都写清了通过标准:

打开 Live Flights 图层。→ 通过标准:数千架真实航班基于实时遥测滑行;点击任意一架,相机锁定、航迹绘出、遥测卡片弹出。
对目标飞机按C进入 Cockpit。→ 通过标准:视角贴着真实地形下潜,中途可切换 FLIR / 夜视传感器,画面不穿模。

打开 Satellites 图层,点击 ISS。→ 通过标准:以轨道距离完成一圈跟飞,轨道位置与实际公开数据一致。
切换视觉预设。→ 通过标准:Normal、CRT、NVG、FLIR、Anime、Noir 六个滤镜间实时重渲染,无黑屏或卡死。

🏁 一句话决策

先用 Pinokio 尝鲜;当出现"要读源码、要加数据层、要 CI 化部署、要脚本注入密钥"中任意一个信号时,切到终端路线——两条路打开的是同一个免费可用的实时地球仪,唯一的付费项是 OpenAI 语音,且应用内自带花费读数与$5硬上限。

数据边界声明:本项目是公开数据的探索性可视化,数据可能存在延迟、缺失或推断成分,请勿用于飞行/航海导航、应急决策或投资判断。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析