Apple WLOC 定位修改
修改 Apple 网络定位服务 (WiFi/基站) 返回的坐标，实现 iOS 网络定位虚拟定位。打开在线选点页面选位置即可生效，无需手动填经纬度。
订阅地址
Surge: https://raw.githubusercontent.com/Yu9191/wloc/refs/heads/main/modules/wloc.sgmodule
Quantumult X: https://raw.githubusercontent.com/Yu9191/wloc/refs/heads/main/modules/wloc.conf
Loon: https://raw.githubusercontent.com/Yu9191/wloc/refs/heads/main/modules/wloc.lpx
Stash: https://raw.githubusercontent.com/Yu9191/wloc/refs/heads/main/modules/wloc.stoverride
Shadowrocket(小火箭): https://raw.githubusercontent.com/Yu9191/wloc/refs/heads/main/modules/wloc.module
Egern 可直接使用 Surge 模块 Stash 请直接订阅上面的
.stoverride，无需用 Script Hub 转换
快捷指令（推荐，最方便）
直接用快捷指令切换 / 清除定位，无需打开选点页面：
- wloc 设置地理位置：https://www.icloud.com/shortcuts/a82717d8fdad4e6280866fcf911173f7
- wloc 清理恢复位置：https://www.icloud.com/shortcuts/f42632d406504f24a2cd163af4fe012f
用法
- 设置位置： 在地图 App 里选好位置（长按地图选点）→ 共享 → 选「wloc 设置地理位置」即可切换。
- 苹果地图：选点 → 共享 → 「wloc 设置地理位置」
- 高德地图：选点 → 分享 → 更多 → 「wloc 设置地理位置」
- 清理位置： 点「wloc 清理恢复位置」即可恢复真实定位。
支持苹果地图、高德（含短链，自动跟跳转 + GCJ-02→WGS84 坐标换算）。
前提：代理已开 + 模块已启用 + 信任
gs-loc.apple.com。选点页面（Worker / Pages）方案仍保留，见下方。
关于地图链接解析（worker）
为了让苹果地图和高德走同一条流程，链接统一发给 wloc-spoofer.wloc.workers.dev/api/parse 解析：
- 高德：分享出来是短链，真实坐标只藏在 302 跳转的
Location头里，且是 GCJ-02 偏移坐标。快捷指令既读不到跳转头、也难做坐标换算，所以由 worker 跟跳转 → 抠坐标 → GCJ-02→WGS84 → 返回经纬度。 - 苹果地图：链接里直接带
coordinate=纬度,经度，但在中国大陆同样是 GCJ-02 偏移坐标，所以和高德一样由 worker 做 GCJ-02→WGS84 换算后返回；境外坐标会自动跳过换算（out_of_china判断）原样返回。除了统一坐标系，走同一接口也方便统一处理短链、文本夹链接、名称解码等。
隐私： /api/parse 是纯转发解析——收到链接 → 跟跳转 → 解析坐标 → 返回 JSON，全程不写任何存储、不记日志、不缓存，处理完即丢。
不放心可自行部署： worker 源码完全开源，可自己部署一份替换上面的地址：
- 解析逻辑：
worker/src/parse.js，路由：worker/src/index.js - 部署后把快捷指令里的
wloc-spoofer.wloc.workers.dev换成你自己的 worker 域名即可。
使用方法
- 订阅模块并启用 MITM
- 打开在线选点页面（公共 Worker，建议添加到主屏幕）
- 地图选位置 / 搜索地名 / 粘贴地图链接
- 点击「储存到设备」
- 下次 Apple 定位触发时自动生效
支持 Apple Maps / Google Maps / 高德 / 百度 / 坐标文本 链接解析。
iOS 26/27 及更高版本注意： Apple 从 iOS 26 开始大幅强化了
locationd的定位缓存机制，系统会将之前获取的真实定位结果缓存在内存中并长时间复用。这意味着安装模块或切换目标坐标后，即使脚本已成功修改了 WLOC 响应（日志显示"已修改"），系统仍可能继续使用缓存中的旧坐标，导致定位看起来没有变化。解决方法：重启设备。 重启会清空
locationd的内存缓存，系统重新发起 WLOC 请求时会拿到修改后的坐标。飞行模式开关、关闭定位服务等方式在 iOS 26+ 上无法清除此缓存，必须重启。iOS 15~18 通常不需要重启即可生效。
高版本系统推荐操作流程（成功率最高）：
方法一：
- 先在选点页面选好需要修改的定位并储存到设备
- 开飞行模式 → 关闭定位服务 → 重启设备
- 关闭飞行模式（WiFi 也要关）→ 连接代理工具（确认 VPN 图标出现）→ 打开定位服务
- 打开地图验证
方法二：
- 关闭定位服务
- 在选点页面选好位置并储存到设备
- 打开定位服务 → 弹出「允许访问位置信息」时选择**「下次询问或在我共享时」**
- 打开地图验证
工作原理
选点页面 → fetch gs-loc.apple.com/wloc-settings/save?lon=x&lat=y
→ 代理模块拦截 → wloc-settings.js 写入 $persistentStore
→ 下次 WLOC 触发 → wloc.js 读取坐标 → patch protobuf 响应
模块包含两条规则：
wloc.js— 拦截/clls/wloc响应，解析 protobuf 并替换坐标wloc-settings.js— 拦截/wloc-settings/save请求，写入持久化存储
参数配置
| 参数 | 说明 | 默认值 |
|---|---|---|
| longitude | 目标经度(在线选点优先) | null (透传) |
| latitude | 目标纬度(在线选点优先) | null (透传) |
| accuracy | 精度(米) | 25 |
| logLevel | 日志级别 | info |
优先级: 在线选点储存 > 模块参数 > 默认值
取消虚拟定位 / 恢复真实定位
方法一：关闭或删除模块（推荐）
关闭模块后脚本不再拦截 WLOC 请求，系统自动恢复真实定位。iOS 26+ 需要重启设备清除定位缓存。
方法二：清除持久化数据（透传模式）
清除已保存的坐标后，脚本进入透传模式——不修改 WLOC 响应，直接放行原始数据，系统自动恢复真实 GPS 定位。
透传模式触发条件： 持久化数据为空（null）且模块参数为默认值（113.94114, 22.544577）时，脚本判定用户未自定义坐标，自动跳过修改。模块默认参数无需更改，仅清除持久化数据即可触发透传。
在代理工具中删除持久化数据，字段名为 wloc_settings：
- Surge — 脚本编辑器运行:
$persistentStore.write(null, "wloc_settings") - Quantumult X — 运行:
$prefs.removeValueForKey("wloc_settings") - Loon — 运行:
$persistentStore.write(null, "wloc_settings")
清除后重启设备即可恢复真实定位。无需关闭模块，脚本会自动检测到无自定义坐标并跳过修改。
注意： 如果用户在模块参数中手动修改了经纬度（非默认 113.94114, 22.544577），即使清除持久化数据，脚本仍会使用模块参数中的坐标进行修改。只有保持默认参数不变时，清除持久化数据才会进入透传模式。
收藏位置功能
在线选点页面支持收藏多个位置，方便来回切换：
- 添加收藏：选好位置后点击「收藏位置」→ 输入备注名称（支持中文/英文/数字，最多 30 字）→ 保存
- 快速切换：点击收藏列表中的位置 → 地图自动跳转 → 点「储存到设备」即可切换
- 当前生效标记：与设备已保存坐标一致的收藏会显示「✓ 当前生效」
- 删除管理：单个删除（×按钮）或清空全部
- 当前生效坐标：页面显示设备端持久化数据（wloc_settings），支持刷新查询和清除
数据存储说明：
- 收藏列表 → 保存在浏览器
localStorage（仅用于选点页面的 UI 便捷操作） - 生效坐标 → 保存在代理工具持久化存储
$persistentStore（脚本运行时实际读取的数据）
两者独立存储。收藏列表是浏览器端的辅助数据，清除浏览器缓存或换浏览器后需重新收藏，但不影响已储存到设备的生效坐标。
自部署 Worker（推荐）
公共选点页面有请求上限，建议部署自己的实例：
- Workers:
https://wloc-spoofer.wloc.workers.dev/ - Pages:
https://wloc-pages.pages.dev/
一键部署（Workers）：
一键部署仅支持 Workers 模式，点击按钮后按提示授权即可完成部署。
手动部署（Workers）：
# 1. 克隆仓库
git clone https://github.com/Yu9191/wloc.git
cd wloc/worker
# 2. 安装依赖
npm install
# 3. 登录 Cloudflare（首次需要）
npx wrangler login
# 4. 部署
npm run deploy部署成功后会得到你自己的 Worker 地址（如 https://wloc-spoofer.<你的子域名>.workers.dev），用这个地址选点即可。
免费账户每天 10 万次请求，个人使用完全够用。
高级：Pages 部署
Pages 部署不支持一键按钮，需要手动执行：
git clone https://github.com/Yu9191/wloc.git
cd wloc/worker
npm install
npx wrangler pages deploy dist --project-name <自定义项目名>部署时会提示设置 production branch，输入 main 即可。部署成功后得到 https://<项目名>.pages.dev 地址。
Pages 和 Workers 功能完全一致，按需选择即可。
注意事项
- 需要 MITM 证书信任
gs-loc.apple.com和gs-loc-cn.apple.com - 仅修改网络定位(WiFi/基站)，不影响 GPS 硬件定位
- iOS 在 GPS 信号强时可能忽略网络定位结果
- 适用于 WiFi 定位为主的室内场景效果最佳
- 选点页面需在代理模式下使用（Safari 走代理才能拦截储存请求）
致谢
- proxypin-wloc-spoofer - 原始 WLOC 定位修改思路 by FFF686868
- NSNanoCat/Util - 跨平台脚本工具框架
