# 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/parse.js)，路由：[`worker/src/index.js`](worker/src/index.js) - 部署后把快捷指令里的 `wloc-spoofer.wloc.workers.dev` 换成你自己的 worker 域名即可。 ---

使用方法

1. 订阅模块并启用 MITM 2. 打开在线选点页面（公共 Worker，建议添加到主屏幕） 3. 地图选位置 / 搜索地名 / 粘贴地图链接 4. 点击「储存到设备」 5. 下次 Apple 定位触发时自动生效 支持 Apple Maps / Google Maps / 高德 / 百度 / 坐标文本 链接解析。 > **iOS 26/27 及更高版本注意：** Apple 从 iOS 26 开始大幅强化了 `locationd` 的定位缓存机制，系统会将之前获取的真实定位结果缓存在内存中并长时间复用。这意味着安装模块或切换目标坐标后，即使脚本已成功修改了 WLOC 响应（日志显示"已修改"），系统仍可能继续使用缓存中的旧坐标，导致定位看起来没有变化。 > > **解决方法：重启设备。** 重启会清空 `locationd` 的内存缓存，系统重新发起 WLOC 请求时会拿到修改后的坐标。飞行模式开关、关闭定位服务等方式在 iOS 26+ 上**无法**清除此缓存，必须重启。iOS 15~18 通常不需要重启即可生效。 **高版本系统推荐操作流程（成功率最高）：** 方法一： 1. 先在选点页面选好需要修改的定位并储存到设备 2. 开飞行模式 → 关闭定位服务 → 重启设备 3. 关闭飞行模式（WiFi 也要关）→ 连接代理工具（确认 VPN 图标出现）→ 打开定位服务 4. 打开地图验证 方法二： 1. 关闭定位服务 2. 在选点页面选好位置并储存到设备 3. 打开定位服务 → 弹出「允许访问位置信息」时选择**「下次询问或在我共享时」** 4. 打开地图验证

工作原理

``` 选点页面 → 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）：** [](https://deploy.workers.cloudflare.com/?url=https://github.com/Yu9191/wloc/tree/main/worker) > 一键部署仅支持 Workers 模式，点击按钮后按提示授权即可完成部署。 **手动部署（Workers）：** ```bash # 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 部署不支持一键按钮，需要手动执行： ```bash 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](https://github.com/FFF686868/proxypin-wloc-spoofer) - 原始 WLOC 定位修改思路 by FFF686868 - [NSNanoCat/Util](https://github.com/NSNanoCat/util) - 跨平台脚本工具框架