★ FEATURED ARTICLE Gods 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-viewGods 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 及以上。→ 成功标志:应用列表里能看到 Gods Eye View 条目。8.0.40 的 Configure 面板会把密钥写到错误路径并记录提交值,8.2 已修复。打开 Gods 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 newerNode 低于 24.14装 Node 24.14 或 26.x,重跑npm run doctordoctor 提示依赖缺失未装或装不完整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 拉取,无需手写.envPinokio 安装异常旧版 Pinokio(8.0.40)缺陷升 8.2 重试;仍异常用菜单 Repair installationPinokio 内嵌视图卡顿内嵌浏览器渲染路径问题(官方性能文档有记录)用系统浏览器打开同一个本地 URL,不要拿两种渲染口径直接对比帧率 密钥:升级项,不是门槛需要某个付费或注册级能力时,点右下角POWER UP芯片打开 Provider Settings,粘贴密钥后点SAVE KEYS,应用自动重启并启用对应能力;全部配置完成后芯片显示POWERED UP。若紧凑布局把芯片藏住了,访问?setup1可重新打开同一面板。能力费用密钥变量是否必需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;局域网共享(HOST0.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硬上限。数据边界声明:本项目是公开数据的探索性可视化,数据可能存在延迟、缺失或推断成分,请勿用于飞行/航海导航、应急决策或投资判断。【免费下载链接】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），仅供参考
阅读完成 · 觉得有帮助？
