God's Eye View 本地部署怎么做：免密钥免费启动真实 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 是一款跑在浏览器里的实时 3D 地球仪，支持免 API 密钥本地部署：真实航班、船舶、卫星、地震、城市公共摄像头，全部来自真实公开数据，不需要注册任何账号。本文给出 Pinokio 一键与终端两条路线的完整步骤，涵盖环境体检、常见报错处理和可选密钥升级。
本地部署路线选择：三种人，三种走法
先给结论：只看不改，用Pinokio 一键最省事；要读源码、加数据层、提 PR，用终端路线；无头服务器和 CI 脚本化部署只能走终端（直接注入环境变量）。两条路线打开的是同一个应用，随时可以互换，不是二选一。
| 路线 | 适合谁 | 环境要求 | 密钥配置方式 |
|---|---|---|---|
| Pinokio 一键 | 纯体验者，Windows / macOS / Linux 桌面用户 | 无，启动器代装锁定版本依赖 | 应用内 POWER UP 面板 |
| 终端 | 开发者、macOS 钥匙串用户 | Node.js 24.x（≥24.14.0）或 26.x | 应用内面板或.env |
| 脚本 / 无头 | CI、无头服务器 | Node.js 24.x（≥24.14.0）或 26.x | 直接注入环境变量 |
终端路线配合 CONTRIBUTING.md 可以阅读源码、添加图层并提交流程化部署。
Pinokio 一键安装步骤：版本要求与四步操作
Pinokio 是"点一下就跑"的开源应用启动器，God's Eye View 在其应用列表内，Windows、macOS、Linux 均可用。操作四步：
- 安装 Pinokio，或更新到8.2 或更高版本（旧版 8.0.40 存在安装缺陷，8.2 已修复）；
- 在 Pinokio 中打开God's Eye View应用页；
- 点击Install；
- 安装完成后点击Start，浏览器自动打开应用。
背后发生的事一句话概括：启动器安装锁定版本的依赖、挑选一个空闲本地端口、把服务绑定到127.0.0.1并打开页面。菜单中 Install / Start / Update / Repair installation 四个动作由 pinokio/pinokio.js 定义，启动流程在pinokio/start.js和scripts/pinokio-start.mjs。
装不上时：先把 Pinokio 升到 8.2 再重试；仍异常时，用 Pinokio 菜单里的 "Repair installation" 一键修复（对应逻辑在pinokio/reset.js）。
终端启动：Node.js 版本要求与环境体检命令
前置条件：Node.js 24.x（≥24.14.0）或 26.x。Node 25 已停止维护（EOL），体检工具只给警告。命令如下：
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，首次运行面板提供四个入口：Live Contacts（实时航空）、Space Missions（太空任务）、Environmental（环境层）、Explore Manually（自由探索）。
npm run doctor建议每次运行前都跑。它由 scripts/setup-doctor.mjs 驱动，检查 Node/npm 版本、依赖是否装齐、各数据源能力现状，以及每个密钥从哪个来源读到（环境变量、.env或 macOS 钥匙串）——只报告来源，不打印密钥明文。
常见报错修复：版本过旧、依赖缺失、端口占用
- doctor 报
too old; install Node 24.14 or newer：当前 Node 版本过旧，安装 Node 24.14.0 或更新版本、或 26.x 后重跑； - doctor 提示
dependencies missing：执行npm ci补齐依赖； - doctor 对 Node 25 报 WARN（EOL）：可以运行，但建议升级到 24.x 或 26.x；
- 端口 4173 被占用或残留旧进程：运行
./scripts/dev-fresh.sh，它会停掉旧 dev 服务器、清理占用端口的进程、清空 Vite 缓存后重新启动，同样支持无密钥启动； - macOS 钥匙串里已存密钥：
dev-fresh.sh会自动从 Keychain 拉取，无需手写.env。
性能预期：启动要多快
官方在 M5 芯片 + Chrome 环境实测：冷启动中位数约1.86 秒。这是单时间点基线，不是对你机器的保证值，硬件与网络不同会有出入，完整测量表见 docs/PERFORMANCE.md。
✅ 首跑验证：四步确认数据真的在工作
无论走哪条路线，启动后按下面的顺序走一遍即可确认：
先打开Live Flights图层——数千架真实航班基于实时遥测在球面上滑行；点击任意一架，相机锁定目标、身后绘出航迹、实时遥测卡片弹出。
然后对目标飞机按C进入Cockpit（驾驶舱）模式：视角贴着真实地形下潜，中途可以切换 FLIR / 夜视传感器。
接着打开Satellites图层点击 ISS，以轨道距离跟飞一圈，沿轨道环完整绕行。
最后按1–6依次切换 CRT、NVG、FLIR、Noir 等传感器风格滤镜，观察整个地球实时重渲染（Snow 滤镜已下线，其历史实测数据仍保留在性能报告中）。
🔑 可选密钥升级：Provider 配置位置与安全边界
密钥是"升级项"，不是"门槛"。需要某项能力时，点右下角POWER UP芯片打开 Provider Settings，粘贴密钥后点SAVE KEYS，应用自动重启并启用对应能力；全部配置完成后芯片显示POWERED UP。若紧凑布局把芯片藏起来了，在 URL 后加?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）属于显式开启项，启动时会打印风险警告——任何能访问到该地址的人都能经由它使用你配置的密钥，更多细节见 SECURITY.md。
数据边界声明
God's Eye View 是公开数据的探索性可视化，数据可能存在延迟、缺失或推断成分，请勿用于飞行/航海导航、应急决策或投资判断。
【免费下载链接】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），仅供参考
