God's Eye View 本地运行完整指南：免 Key、5 分钟免费跑起 3D 实时地球仪
【免费下载链接】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（GEV）把全球飞机、船舶、卫星、地震、公共摄像头和交通数据汇聚到一张照片级 3D 地球仪上，完全在浏览器里运行。本指南教你在本地免费安装并启动它：两条路——Pinokio 一键安装或终端命令行，都不需要任何 API Key。
先给结论：该走哪条路
| 你的情况 | 建议 |
|---|---|
| 没装过任何开发环境，只想看效果 | Pinokio 一键安装，约 3 分钟 |
| 有 Node.js 环境，想改代码、提 PR | 终端部署，5 条命令 |
| 服务器上脚本化运行 | 终端，环境变量直接注入 |
两条路打开的是同一个应用，随时可以切换，不存在"选错就回不去"。无论哪条路，零 Key 即可启动：内置 Esri 卫星底图 + 免费地形，实时航班、卫星、地震、城市摄像头、电台、火箭发射等十几个图层开箱即用。首次运行面板会提供四个起点任务：Live Contacts（实时航空）、Space Missions（太空任务）、Environmental（环境层）或 Explore Manually（自由探索）。
最省事的起步：Pinokio 一键安装
Pinokio 是一个"点一下就跑"的开源应用启动器，GEV 是其中官方收录的应用之一，支持 Windows、macOS 和 Linux。
- 安装或更新 Pinokio 到8.2 或更高版本——8.2 之前（如 8.0.40）的安装器存在缺陷，8.2 已修复；
- 在 Pinokio 中找到 God's Eye View 应用页；
- 点Install，装完点Start，浏览器会自动打开应用。
启动器在背后做的事：安装锁定版本的依赖、寻找空闲本地端口、把服务绑定到127.0.0.1并打开页面。核心逻辑在 start.js 和 scripts/pinokio-start.mjs，安装、启动、更新、修复安装四个菜单动作由 pinokio.js 定义，想看细节可以直接翻这两个文件。
终端起步：4 条命令跑通页面
前置条件：Node.js 24.x（≥24.14.0）或 26.x。Node 25 已停止维护，体检工具会给出警告。
git clone https://gitcode.com/GitHub_Trending/go/gods-eye-view cd gods-eye-view npm ci npm run doctor npm run dev启动后打开http://localhost:4173即可。几点说明：
npm run doctor建议保留。它由 scripts/setup-doctor.mjs 驱动，检查 Node/npm 版本、依赖是否装全、已配置的各数据源 Key 从何处读取（环境变量、.env或 macOS 钥匙串），并打印一份能力摘要——地图用哪一档底图、语音/船舶/火点是否可用。它只报告来源，不打印密钥明文。- macOS 用户有个快捷方式：
./scripts/dev-fresh.sh会先清掉 Vite 缓存、杀掉占用 4173 端口的旧进程，并可直接从系统钥匙串读取已存的密钥，同样支持无 Key 启动。 - 启动有多快？官方在 M5 芯片 + Chrome 环境实测冷启动中位数约1.86 秒（对比基线，非机器承诺），详见 docs/PERFORMANCE.md。
跑起来之后：先点这几样确认图层生效
首次打开别急着折腾设置，按下面的顺序点一遍，基本能覆盖所有主要图层：
- 打开 Live Flights——数千架真实航班基于实时遥测滑行，点任意一架，相机锁定、画出行迹、弹出遥测卡片；
- 按
C进入 Cockpit——视角贴着真实地形贴着飞机一路下潜，中途可切换 NVG / FLIR 等传感器； - 打开 Satellites 图层点击 ISS——以轨道距离跟飞一圈，轨道环实时呈现；
- 按
1–7切换光学滤镜——CRT、NVG、FLIR、Noir、Snow 等风格实时重渲染整颗地球； - 打开 Cameras 图层——Austin、伦敦、加州、芬兰等地的公共摄像头投影进 3D 城市，切到 VIEWSHED 还能看每台摄像头的估算覆盖范围。
快捷键速记：1–7视觉风格、H呼出 HUD、D检测框、C座舱、Esc退出。玩熟了之后可以试试 README.md 里 "Field Missions" 一节的进阶玩法（军机盘旋轨迹回溯、Falcon 9 发射重放、城市海缆下潜等），架构与运行细节在 docs/CURRENT-STATE.md 和 docs/APPLICATION.md。
出问题时的排查顺序
按出现频率排：
- Pinokio 安装失败：先升级 Pinokio 到 8.2 再重试；仍异常就用菜单里的Repair installation（对应 reset.js）一键修复。
npm run doctor报 Node 版本错误：换到 24.14+ 或 26.x；报"dependencies missing"则重跑npm ci。- 端口 4173 被占：终端路径可改用
./scripts/dev-fresh.sh，它会自动清掉占用该端口的进程；也可以自行PORT=4174换端口。 - 图层是空的：先看终端输出——例如没配 AISStream Key 时船舶图层为空、没配 FIRMS Key 时火点图层关闭，这是设计如此而非故障。
- 旧版本 Traffic / Mapped Installations / ALPR 空数据：老版本查询的公共 Overpass 服务现在会拒绝请求，更新到最新版即可。
可选：用密钥把地球仪升级一档
Key 是"升级项"而不是门槛。在应用内点右下角POWER UP芯片打开 Provider Settings，粘贴密钥、点 SAVE KEYS，应用会自动带着新能力重启，无需手改任何文件。常用项：
| Key | 成本 | 解锁内容 |
|---|---|---|
| Cesium ion | 免费个人档（有配额） | Google 照片级 3D 城市 + 全球地形 |
| AISStream | 免费注册 | 全球船舶实时位置 |
| NASA FIRMS | 免费 | 24 小时活跃火点 |
| TomTom | 免费档起步 | 真实路况流速驱动交通模拟 |
| Google Maps | 按量计费 | 3D 瓦片直连 + 应用内地点搜索 |
| OpenAI | 按量计费 | 语音操控 + AI HUD 摘要 |
密钥落盘位置取决于启动方式：Pinokio 路径写入pinokio/ENVIRONMENT，终端路径写入仓库根目录的.env。两个文件写入前都会先设为仅所有者可读写，且不进版本库。OpenAI 语音这条按量计费项内置了实时花费读数与$5 硬上限，超支无从谈起。安全边界——服务器默认只绑定 localhost、LAN 共享的风险与限制——完整说明见 SECURITY.md。
两条路径的差别，一张清单说清
- 上手门槛：Pinokio 点两下鼠标；终端需要 Git + Node.js 24.14+（或 26.x）
- 端口：Pinokio 自动找空闲端口（绑定
127.0.0.1）；终端固定localhost:4173 - 密钥存放：Pinokio 写
pinokio/ENVIRONMENT；终端写仓库根目录.env - 适用人群：Pinokio 适合 Windows 普通用户和想先看效果的人；终端适合开发者、CI 脚本化部署，以及已把密钥存进 macOS 钥匙串的用户
先 Pinokio 尝鲜、再终端深耕，是多数人的节奏。两条路通往同一个免 Key 可用的实时地球仪，剩下的只是你在上面多停留多久的问题。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
