mekos2772/ios-location-spoofer

欢迎测过的佬友在 Issue 区报实测结果；不通的地方欢迎直接提 PR 改 —— 至少写明哪个软件、哪个版本、什么系统、报错的日志原文。

怎么用

1. 软件里打开 HTTPS 解密 / MITM 开关
2. 安装并信任 CA 证书（设置 → 通用 → VPN 与设备管理 → 安装 → 证书信任设置 → 启用）
3. 导入模块文件，勾上启用
4. 断开重连 VPN，开关定位服务
5. 打开地图 App 验证

Loon 额外说明

1. 导入 ios-location-spoofer.lnplugin 后，在 设置 → 插件 里打开插件配置页
2. 可直接填 纬度 / 经度；地址搜索 由每 15 分钟的定时任务联网解析并缓存（首次请直接填经纬度，或保存地址后等一轮 cron）
3. 必须开启 Loon 的 MITM 并信任证书，且插件内 [mitm] 四个域名生效
4. 插件含 Prepare 请求脚本（设置 Accept-Encoding: identity，避免 gzip 引发 zip decompress error / 脚本超时）
5. 改坐标后关开定位；调试打开 调试日志，在 Loon 日志搜 Location spoofer

日志若出现 Evaluate script timeout 或 zip decompress error:-3：更新插件并重载 Loon，确认三条脚本（Prepare / Response / Geocode cron）均已启用。

改坐标

默认 Apple Park（37.3349, -122.00902）。在模块参数里改：

latitude=39.9042&longitude=116.4074

参数：

文件清单

ios-location-spoofer.sgmodule    # Shadowrocket / Surge
ios-location-spoofer.lnplugin    # Loon
ios-location-spoofer.snippet     # Quantumult X
ios-location-spoofer.stoverride  # Stash
location-spoofer.js              # 核心脚本（四平台共用）
location-spoofer-qx.js           # QX 专用
location-spoofer-config.json     # 配置样板
使用教程.md                       # 小白保姆级图文教程
location-picker/                 # 进阶（可选）：网页地图选点（Node 或 Cloudflare Worker）
location-picker/worker/          # Cloudflare Worker 版（免 VPS，支持 Loon configUrl）

进阶：网页地图选点工具

经常换定位、懒得手动查坐标改参数？项目自带 location-picker/ 地图选点工具：点地图即定位、海拔自动、精度可调，Loon / Shadowrocket 通过 configUrl 读取。

两种部署方式：

Loon 插件 远程配置 URL 示例：

https://你的worker.workers.dev/loc.json?token=你的TOKEN

友情链接

本项目接受 LINUX DO 社区佬友监督与反馈：LINUX DO

location-picker 服务端配置

location-picker/server.js 通过环境变量控制，TOKEN 不设进程会直接退出，不会用弱口令兜底。

启动示例：

# http（最简，先跑通流程再用 https）
TOKEN=$(openssl rand -hex 24) PORT=8080 node server.js

# https（复用 acme.sh 证书；续期无需重启，进程每 12 小时自动热加载）
TOKEN=$(openssl rand -hex 24) PORT=8443 \
CERT=/root/cert/example.com/fullchain.pem \
KEY=/root/cert/example.com/privkey.pem \
node server.js

数据文件 loc.json 自动落在 server.js 同目录，记录当前坐标 / 海拔 / 精度；已在 .gitignore 中忽略，不会被误提交进仓库。

⚠️ 不要把 TOKEN 写在命令行历史里——推荐用 systemd 的 Environment= 或 .env + direnv，避免 history / ps aux 泄露。