上帝视角在浏览器中实时俯瞰全球——God‘s Eye View 完全安装与使用指南你有没有想过坐在电脑前就能实时看到全球数千架飞机在空中穿梭、数百艘轮船在海上航行、甚至国际空间站正从你头顶掠过这不是科幻电影里的场景。God’s Eye View上帝视角是一个开源项目它把全球公开的实时数据信号——航班应答机、船舶信标、卫星轨道参数、地震监测仪、公共摄像头——全部汇聚到一个浏览器里的 3D 地球仪上。效果看起来像一个绝密的指挥驾驶舱但背后每一行代码都可以被审查每一个数据源都是公开的。这个项目最初是一个病毒式传播的 YouTube 系列视频播放量超过 500 万。创作者把代码开源后社区迅速将它扩展到了全球范围——本 Fork 版本包含了约 5200 个世界摄像头包覆盖 20 个国家还加入了地图标签和生产级部署支持。下面我们就来详细拆解如何从零开始安装和运行这个项目以及它到底能做什么。一、项目到底是什么God‘s Eye View 是一个完全运行在浏览器中的实时全球态势感知工具。它的核心理念可以用一句话概括这个世界已经在广播了——航班应答机、船舶信标、轨道元素、地震仪、公共摄像头——这个项目只是把这些信号变成了可见的。它提供了 13 个实时数据图层其中10 个完全不需要任何 API 密钥就能使用图层你能看到什么数据源是否需要密钥地图底图Google 照片级 3D、Bing 航拍、OSMGoogle / Ion / OSMGoogle 必需实时航班数千架实时飞机 航线历史OpenSky adsb.lol可选军用航班ADS-B 军用交通琥珀色标记adsb.lol不需要实时船舶全球数千艘船只AISStream免费密钥卫星约 840 个核心目标按类别着色CelesTrak不需要地震全球 24 小时内地震活动USGS不需要交通流量街道级实时拥堵状况TomTom OSMTomTom 可选CCTV 摄像头网络约 800 个公共摄像头投射到 3D 空间城市 API不需要广播电台全球 750 个电台模拟调谐器Radio Browser不需要共享单车实时站点可用性GBFS不需要活跃火灾NASA FIRMS 实时检测24 小时内NASA FIRMS免费密钥太空任务30 天内发射记录含载荷和回收详情Launch Library 2可选军事设施视口范围内的军事设施背景OpenStreetMap不需要此外还内置了 4351 个数据中心、704 座水坝和 712 条海底电缆的静态基础设施数据。这个项目的视觉风格刻意模仿了“被禁止进入的驾驶舱”——但每一层数据都标注了来源和新鲜度状态包括部分、延迟、模拟和不可用等状态。正如项目文档中所说“一半的魔力在于它看起来像一个被禁止的驾驶舱。另一半在于每一行代码都是可检查的。”二、安装前的准备你需要什么2.1 系统要求Node.js是唯一的硬性依赖。项目要求Node.js 24.14.x 或 26.x这个版本要求在package.json中被强制执行。如果你还没有安装 Node.js建议去 nodejs.org 下载对应版本。操作系统方面项目在 Windows、macOS 和 Linux 上都可以运行。macOS 用户还有额外的便利——可以用 Keychain 管理 API 密钥。浏览器建议使用 Chrome 或 Edge 等基于 Chromium 的浏览器以获得最佳的 WebGL 和 3D Tiles 渲染性能。2.2 API 密钥策略一层一层地解锁这是整个项目最人性化的设计——你不需要一次性准备好所有密钥。项目把所有功能分为三个层级无需注册开箱即用零配置免费密钥注册后粘贴即可不花钱按量计费需要绑定支付方式费用可控但真实必需密钥只有一个Google Maps API Key。它负责提供照片级的 3D 地球底图。没有它整个星球就是一个灰色球体。强烈建议获取的免费密钥AISStream实时全球船舶数据注册只需两分钟NASA FIRMS实时火灾检测TomTom把交通图层从“近似模拟”变成真实路况按量计费的密钥OpenAI API Key语音控制和 AI 场景摘要功能Cesium ion TokenBing 航拍底图所有密钥的获取方式都在项目的 README 中有详细链接。Google Maps 密钥在 Google Cloud Console 获取使用 Map Tiles APIOpenAI 密钥在 platform.openai.com 获取。三、安装步骤详解3.1 第一步克隆仓库gitclone https://github.com/uhrichsam4/gods-eye-view.gitcdgods-eye-view3.2 第二步配置环境变量从示例文件创建你的.env文件cp.env.example .env然后用你喜欢的文本编辑器打开.env至少填入 Google Maps API KeyGOOGLE_MAPS_API_KEY你的密钥如果你有其他密钥也可以一并填入。密钥也可以通过环境变量直接传入不一定非要写在.env文件里。macOS 用户的进阶玩法你可以把密钥存到系统 Keychain 里项目提供的dev-fresh.sh脚本会自动从 Keychain 中拉取。添加密钥的命令是security add-generic-password-U-sgoogle-maps-api-aapi-key-wsecurity add-generic-password-U-sopenai-api-aapi-key-wsecurity add-generic-password-U-saisstream-api-aapi-key-w项目支持的 Keychain 服务名包括google-maps-api、openai-api、aisstream-api、firms-map、cesium-ion、tomtom-api等。3.3 第三步安装依赖npminstall这一步会安装项目的所有依赖。项目的技术栈非常精简——没有使用 React、Vue 或 Angular 等前端框架而是采用Vanilla JavaScript CesiumJS Vite的组合。CesiumJS 负责 3D 地球渲染Vite 提供开发服务器和构建工具。这意味着依赖树很小安装速度很快。3.4 第四步启动开发服务器npmrun dev ----hostlocalhost--port4173关键安全说明开发服务器默认绑定到localhost这意味着只有你自己的机器可以访问。你的 API 密钥全程留在本机不会暴露到网络上。如果你在 macOS 上还有一条捷径./scripts/dev-fresh.sh这个脚本会清除 Vite 缓存并从 Keychain 中自动拉取你的密钥然后启动服务器。3.5 第五步打开浏览器访问http://localhost:4173。首次启动的冷启动时间在较新的笔记本电脑上不到两秒项目文档记录的 M5/Chrome 环境下中位数为 1.86 秒这是一个参考基准不是硬件要求。3.6 局域网共享可选但有风险如果你想让同一局域网内的其他人访问你的实例npmrun dev ----host0.0.0.0--port4173但是请务必注意一旦服务器对局域网可见你配置的 API 密钥就会被任何能访问该地址的人代理使用。项目建议在开放之前设置好速率限制和供应商侧的预算上限。速率限制的环境变量包括GEV_RATELIMIT_OPENAI_PER_MIN和GEV_RATELIMIT_GOOGLE_PER_MIN可以在.env.example中找到详细说明。但需要强调的是这些只是应用层的保护措施不是账单上限。真正的安全网是供应商侧的预算警报和配额设置。四、首次使用五分钟上手安装完成、打开页面后你会看到一张首次运行卡片提供三个预设任务实时联系人、太空任务、环境态势。你也可以跳过预设手动探索。下面是一条建议的探索路径五分钟之内你就会忘记这是一次演示① 点亮天空。选择“实时联系人”任务或者手动打开“航班”图层。数千架实时飞机就会出现它们沿着真实的遥测数据滑行检测网格已经在读取场景。点击任意一架飞机相机会锁定它身后拖出一条轨迹实时遥测卡片弹出。② 进入驾驶舱。在你跟踪的飞机上点击COCKPIT你会“坐进”这架飞机跟着它一起下降。飞行过程中可以切换传感器风格——从 NVG夜视切换到 Ironbow FLIR热成像。③ 降落到繁忙机场。搜索一个机场下降到滑行道打开3D飞机模型——地面上的航班、滑行轨迹、整个停机坪都在实时运转。④ 通过公共摄像头观察。打开CCTV图层对准奥斯汀、伦敦或加州。这些摄像头画面不是嵌入的网页而是直接投射到 3D 城市中。切换到VIEWSHED模式每个摄像头会绘制出它估计的覆盖体积——哪里能看到哪里是盲区。⑤ 追踪轨道上的物体。打开“卫星”图层点击国际空间站ISS你会跟着它一起在轨道距离上飞行轨道环清晰可见。⑥ 切换光学效果。按键盘1到7可以在 CRT、NVG、FLIR 等传感器效果之间切换整个实时星球会通过不同的“传感器”重新渲染。⑦ 和它对话需要 OpenAI 密钥。试试说“带我去 LAX选中最近的空中飞机。”⑧ 回家。按Reset Globe或者直接说“重置地球”一键回到完整地球视图。五、核心功能深度解析5.1 驾驶舱模式这是整个项目最具沉浸感的功能。当你点击任意一架被跟踪的飞机上的COCKPIT按钮时相机会“坐进”这架飞机跟着它一起飞行下方的地形始终保持在视线中。这不是简单的摄像机跟随——项目使用真实的高程基准geoid-aware和渲染的地形网格让飞机停在停机坪上、摄像头站在街角上而不是漂浮在空中。驾驶舱还自带一个简报条附近实时信号、区域新闻头条、真实的本地天气。你还可以开启WX模式从飞机周围的实时观测数据中渲染出体积云效果。Contacts联系人功能保持着 250 公里范围内的所有目标清单——你可以在飞机之间跳转直接落入下一架飞机的驾驶舱。5.2 语音控制28 个工具的对话式操作语音功能需要 OpenAI 密钥但即使没有整个应用仍然可以运行——只是麦克风按钮会提示语音不可用。语音系统的核心设计理念是它知道自己正在看什么。AI 代理在回答之前会拉取实时场景上下文——坐标、街道名称、活跃图层、视图比例。你在飞行中问“这是哪个城市”它能准确回答。实体问答点击任意飞机、船只或数据中心问“这是什么”它会用该对象的实时遥测数据来回答。视觉锚定在街道级别它会读取视口截图来识别可读的标牌和建筑名称并且被明确指示绝不幻觉标签。电影级取景说“让我看看头顶上的飞机”相机就会拉远、调整角度像导演一样构图实时交通。语音命令覆盖了四个核心场景指挥相机“带我去东京”、“慢慢环绕这个区域”、“画一条从国会大厦到 Zilker 公园的步行路线”、“飞我们刚画的路线”、“缩小到地球视图”标注世界“勾画德克萨斯州的边界”、“标注德州议会大厦及其庭院”、“埃菲尔铁塔到卢浮宫有多远”——它会画出实际的包围边界而不是一个圆圈分析查询“现在德克萨斯州上空有多少架航班”、“哪些船正驶向奥克兰”、“洛杉矶附近最大的火灾是哪个”、“有东西在四万英尺以上飞行吗”、“ISS 下次什么时候过境”操作控制台“切换到夜视并打开航班图层”、“打开摄像头覆盖范围”、“播放奥斯汀附近的新闻电台”、“跟踪那架飞机”然后“进入驾驶舱”还有快速命令层“显示全球基础设施”、“播放轨道观察”、“把检测密度设为 50%”、“下一个联系人——只要直升机”、“显示太空任务”、“切换到 Bing 航拍”。5.3 实时数据图层详解航班图层的数据来自 OpenSky 和 adsb.lol。项目的一个精妙设计是客户端故意将航班渲染为比实时慢一个轮询间隔这样就可以在已知定位点之间进行平滑插值。数据每 15-30 秒到达一次地球渲染“一个间隔之前”的状态航位推算填补空白。卫星图层使用 SGP4 轨道传播算法轨道环通过 GMST 实时校准锁定在卫星上——没有漂移没有逐秒闪烁。大约 840 个核心目标按类别着色点击DENSE芯片可以加载完整的 Starlink 壳层。CCTV 摄像头网络是最有创意的图层之一。约 800 个公共摄像头被投射到 3D 空间中——奥斯汀、加州Caltrans、伦敦TfL。摄像头位置是公开的姿态是估计的先验值你可以通过在摄像头本身拖拽一个小控件来校准它。交通图层在没有 TomTom 密钥时是一个近似模拟但一旦接入 TomTom整个城市就会被实时拥堵密度“上色”。潜入约 8 公里以下圆点会根据真实拥堵状况变色。广播图层配有一个模拟调谐器——你可以拖动指针扫过最多 750 个电台地球会飞到每个广播电台的位置。这个“调谐器”的模拟手感是整个项目中最有氛围感的设计之一。5.4 场景导演与分享链接场景导演允许你捕获电影级的相机巡游用于制作剪辑和演示。分享链接功能更实用相机位置、风格、图层、甚至一个被跟踪的目标全部序列化到一个 URL 中。这意味着一个实时目标可以作为一个“交接”传递给别人——不是一个静态书签而是一个活的状态快照。5.5 传感器视觉风格按数字键1到7可以在不同的传感器效果之间切换CRT老式显示器效果、NVG夜视绿、FLIR热成像/热感、Ironbow另一种热成像配色、Noir黑白、Snow雪地效果。这些是通过 GLSL 着色器在正常地球渲染之上叠加实现的整个实时行星会通过不同的“光学传感器”重新渲染。六、API 密钥与成本你需要知道的一切6.1 密钥获取清单密钥用途获取地址费用Google Maps照片级 3D 地球必需Google Cloud Console按会话计费OpenAI语音 AI 摘要platform.openai.com按用量计费AISStream实时船舶aisstream.io免费NASA FIRMS活跃火灾firms.modaps.eosdis.nasa.gov免费TomTom真实交通developer.tomtom.com有免费额度Cesium ionBing 航拍底图cesium.com/ion有免费方案OpenSky更多航班轮询信用opensky-network.org匿名可用Launch Library 2更高的太空任务配额thespacedevs.com不填也可用Google Maps Map Tiles 按会话计费当前价格和免费使用上限因计费地区而异。建议在持续使用前设置好密钥限制、配额和预算警报。OpenAI Realtime 音频按用量计费总费用取决于所选模型、对话长度和音频量。应用内置了实时会话估算在 $2 时发出警告并设置了$5 的应用内会话上限。但供应商侧的使用限制仍然是最终的账单底线。6.2 免费起步策略大部分图层在零密钥的情况下就能运行OpenSky 匿名访问、USGS 地震、CelesTrak 卫星、adsb.lol 军用航班、城市 CCTV、Radio Browser、GBFS 共享单车、Launch Library 2 太空任务、捆绑数据集。唯一必须付费的入口是 Google Maps API Key。它买的是照片级 3D 星球有了它大部分地球就已经“亮起来”了。6.3 安全模型项目的安全设计有几个关键原则本地优先的密钥处理OpenAI、AISStream、OpenSky OAuth、TomTom、FIRMS 等敏感密钥由服务端代理处理不暴露给浏览器代理目标固定或白名单化高风险路径有请求大小限制、超时、响应上限和错误信息脱敏仅 Google Maps 和 Cesium ion 的凭据有意暴露给浏览器两者都应在供应商侧设置限制.env文件不应提交到版本控制项目提供了.env.example作为模板七、进阶技巧与实用场景7.1 军事直升机侦察“问问这个星球”如果你看到一群军用直升机在兜圈子选中一个军用轨迹——它会静默回填约 24 小时的真实追踪历史并以堆叠 3D 循环的方式呈现它一直在做什么。7.2 港口监视在长滩港上空打开船舶图层点击一艘油轮查看它的战术卡片和尾迹然后在 CCTV 面板中点击NEAREST通过公共摄像头看同一片水域。7.3 步行路线可视化告诉世界你想去哪里看着一条真实的沿街路线在 3D 城市中自行描绘——然后说“飞它”相机会像无人机一样带着倾斜转弯和缓入缓出领着你走完这条路径。7.4 距离测量问“LAX 到 DFW 有多远”——一支箭头横跨全国距离出现在字幕中两个端点在你环绕地球时始终锚定在真实世界位置。7.5 发射回放打开Space Missions图层选择过去 30 天内的一次发射跟着 T- 倒计时从上升段一路走到入轨——可以以 0.25 倍到 4 倍速度拖拽回放。这条回放被标注为RECONSTRUCTED ESTIMATE因为它确实是重建估算。八、常见问题与故障排除Q启动后地球是灰色的什么都看不到A99% 的情况是 Google Maps API Key 没有配置或无效。检查.env文件中的GOOGLE_MAPS_API_KEY确认 Key 已启用 Map Tiles API。另外注意 Google Maps 是按会话计费的如果 Key 没有绑定有效的支付方式或已达配额上限底图也不会加载。Q语音按钮点击后提示不可用A语音功能需要 OpenAI API Key。这个设计是刻意的——没有 Key整个应用仍然可以运行只是麦克风按钮会报告语音不可用。Q页面加载很慢或卡顿ACesiumJS 的 3D Tiles 渲染对 GPU 有一定要求。尝试关闭一些数据图层尤其是航班和卫星减少同时渲染的对象数量。项目的性能文档在docs/PERFORMANCE.md中有更详细的说明。Q冷启动时间是多少A项目文档记录的中位数是 1.86 秒M5/Chrome 环境这是一个参考基准不是硬件要求。Q可以在服务器上部署供团队使用吗A可以但需要非常谨慎。默认绑定localhost是为了保护你的 API 密钥。如果要对局域网或公网开放必须在供应商侧设置预算上限并配置好速率限制。项目的SECURITY.md中有完整的威胁模型说明。九、写在最后God‘s Eye View 最让人印象深刻的地方不在于它酷炫的视觉效果而在于一个更深层的理念这些数据一直是公开的只是没有人把它变得可看。航班应答机在广播、船舶信标在发送、卫星轨道参数在更新、地震监测仪在记录——这些信号一直都在那里。项目做的事情是把它们汇聚到一个统一的界面中让你真正“看见”这个世界的运行状态。更重要的是这是一个完全开源的、可检查的、可扩展的工具。项目文档中有一句话说得很好“这个仓库交付的是一个基础你把它融合成什么取决于你自己。”项目的MIT 许可证意味着你可以自由使用、修改和分发。数据图层模块化设计——src/data/目录下每个图层一个模块——让添加新的数据源变得相对简单。最后需要提醒的是项目文档中明确说明这是一个面向探索和学习的开源客户端不是经过加固的生产服务。数据可能有延迟、不完整、被建模、被推断或错误。不要用它来做飞行或海上导航、应急响应、医疗决策、投资决策或其他安全关键用途。“没有地方被落下。”——这是项目的 slogan也是它想做的事情让这个世界的运行状态对每一个人都可见。本文基于 God’s Eye View 开源项目 README 及相关文档撰写。项目地址https://github.com/uhrichsam4/gods-eye-view