基于 Yu9191/wloc 恢复的 Apple 网络定位修改工具。通过 Surge、Quantumult X、Loon、Stash 或 Shadowrocket 拦截 Wi-Fi / 基站网络定位响应，配合网页选点、快捷指令和代理客户端本地持久化存储使用。

本分支保留上游作者及贡献者记录，以 529fcd8（2026-09-04）为恢复基线。它不是原作者官方仓库，也不能修改 GPS 硬件定位。

打开：

设置
→ 通用
→ 关于本机
→ iOS 版本

判断：

flowchart TD
    A[查看 iOS 版本] --> B{当前系统}
    B -->|iOS 27 正式版 / RC| C[❌ 当前传统 WLOC 不支持]
    B -->|iOS 27 beta 6 及以后| D[⚠️ 已知 TLS / MITM 限制]
    B -->|更早且可正常 MITM 的系统| E[✅ 继续安装]
    C --> F[无需反复重装证书或快捷指令]
    D --> F
    E --> G[安装模块 → 信任证书 → 设置位置]

第一次使用建议严格按这个顺序，不要跳步骤：

安装对应客户端模块
→ 开启 WLOC 模块
→ 开启 MITM / HTTPS 解密
→ 安装 CA 描述文件
→ 在“证书信任设置”中开启完全信任
→ 确认代理 / VPN 正常连接
→ 在地图中选择目标位置
→ 分享到「WLOC设置位置 xepes0」
→ 快捷指令保存坐标并跳转到“定位服务”
→ 关闭定位服务
→ 开启飞行模式
→ 确认 Wi-Fi 和蓝牙同时关闭
→ 等待 10 秒
→ 关闭飞行模式
→ 等待网络和 VPN / 代理恢复
→ 最后重新开启定位服务
→ 打开地图验证

WLOC 不是安装一个快捷指令就能直接工作。完整链路至少包含：

flowchart LR
    A[代理客户端] --> B[WLOC 模块]
    B --> C[MITM / HTTPS 解密]
    C --> D[受信任的 CA 证书]
    D --> E[网页选点 / 地图分享快捷指令]
    E --> F[Apple 网络定位返回目标坐标]

缺少任何一项，都可能出现“能打开网页但不能保存”“快捷指令请求失败”“保存成功但地图不变”等问题。

选点页面：https://wloc.xepesw.workers.dev/。

浏览源码 · 部署到 Cloudflare Workers

Egern 沿用上游 Surge 模块兼容说明，尚未单独复核。Stash 使用原生 .stoverride。

选择自己正在使用的代理客户端，导入上表对应模块。

大致路径：

Loon
→ 配置
→ 插件
→ +
→ 添加 URL
→ 粘贴 wloc.lpx 地址
→ 安装
→ 打开插件开关

不同版本菜单名称可能略有不同，一般在：

Shadowrocket
→ 配置 / 模块
→ 添加模块
→ URL
→ 粘贴 wloc.module 地址
→ 保存并启用

Surge
→ 模块
→ 安装新模块
→ 从 URL 安装
→ 粘贴 wloc.sgmodule 地址
→ 启用

Quantumult X、Stash、Egern 同理，在模块 / 重写 / Override 等页面导入对应 URL。

WLOC 需要处理包括以下域名在内的 Apple 网络定位请求：

gs-loc.apple.com
gs-loc-cn.apple.com
gsp-ssl.ls.apple.com

因此必须启用代理客户端的 MITM / HTTPS 解密功能。

在客户端中找到类似：

MITM
HTTPS 解密
HTTPS Decryption
证书
Certificate

的设置页，生成 CA 证书，然后选择“安装证书 / Install Certificate”。

打开：

设置
→ 通用
→ VPN与设备管理

找到刚才下载的证书描述文件，点击安装并按系统提示完成。

这是最容易漏掉的一步。

继续打开：

设置
→ 通用
→ 关于本机
→ 证书信任设置

找到刚才由 Loon / Shadowrocket / Surge / Quantumult X 等客户端生成的 CA，打开：

针对根证书启用完全信任

完成后返回代理客户端，确认 WLOC 模块、MITM、代理 / VPN 都处于启用状态。

“WLOC设置位置 xepes0”基于原作者版本，当前解析服务为：

https://wloc.xepesw.workers.dev/api/parse

维护者已对当前快捷指令的 /api/parse?format=json 解析链路进行过真机测试。这只表示快捷指令解析链路可工作，不代表 iOS 27 正式版支持传统 WLOC。

已安装的旧快捷指令不会自动更新；如果一直使用旧版本，可能出现“获取词典值失败”等错误。更多迁移说明见 快捷指令迁移说明。

打开：

https://wloc.xepesw.workers.dev/

可以在地图上选点、搜索地点、输入经纬度或粘贴地图分享链接。

选择位置后点击：

储存到设备

flowchart LR
    A[网页选点] --> B[点击“储存到设备”]
    B --> C[请求 wloc-settings/save]
    C --> D[WLOC 模块在本机拦截]
    D --> E[保存目标经纬度]

打开 Apple 地图，搜索目标地点，或者在目标位置 长按地图 创建标记。

点击 / 上滑底部地点卡片，找到：

共享

WLOC设置位置 xepes0

流程：

flowchart LR
    A[Apple 地图] --> B[搜索 / 长按选点]
    B --> C[共享]
    C --> D[WLOC设置位置 xepes0]
    D --> E[解析分享链接]
    E --> F[得到经纬度]
    F --> G[保存到 WLOC]

先打开“快捷指令”App，手动运行一次“WLOC设置位置 xepes0”，完成系统要求的权限询问。

然后重新：

Apple 地图
→ 选择地点
→ 共享
→ 更多

检查“WLOC设置位置 xepes0”是否出现在系统分享菜单中。

高德地图通常需要先进入系统分享菜单：

高德地图
→ 搜索 / 选择地点
→ 分享
→ 更多
→ iOS 系统分享菜单
→ WLOC设置位置 xepes0

不要只复制地点名称。快捷指令需要地图分享产生的 URL / 文本，再交给解析接口转换成经纬度。

“WLOC设置位置 xepes0”保存坐标后，会跳转到：

设置
→ 隐私与安全性
→ 定位服务

接下来按以下顺序操作。

在“定位服务”页面关闭总开关。

打开飞行模式以后，确认 Wi-Fi 和蓝牙也已经关闭。

保持上面的状态约 10 秒。

10 秒后关闭飞行模式。

不要马上开启定位服务。先确认：

• Wi-Fi 或蜂窝数据已经重新联网；
• Loon / Surge / Shadowrocket / Quantumult X 等代理客户端已恢复；
• VPN 状态已经重新连接；
• WLOC 模块仍处于启用状态。

确认网络和 VPN / 代理恢复以后，再回到：

设置
→ 隐私与安全性
→ 定位服务

重新打开定位服务。

完整顺序：

flowchart TD
    A[地图分享给 WLOC 快捷指令] --> B[快捷指令保存目标坐标]
    B --> C[跳转“定位服务”]
    C --> D[关闭定位服务]
    D --> E[开启飞行模式]
    E --> F[确认 Wi-Fi / 蓝牙关闭]
    F --> G[等待 10 秒]
    G --> H[关闭飞行模式]
    H --> I[等待网络恢复]
    I --> J[确认 VPN / 代理重新连接]
    J --> K[重新开启定位服务]
    K --> L[打开地图验证]

完成上面的刷新流程后：

1. 确认 VPN / 代理已经连接；
2. 确认 WLOC 模块仍然启用；
3. 确认定位服务已经重新开启；
4. 完全退出 Apple 地图；
5. 重新打开地图；
6. 等待几秒观察蓝点位置。

运行：

wloc 清理恢复位置

也可以通过网页清除已经保存的坐标。

清除后建议：

1. 完全退出地图 App；
2. 等待系统重新获取定位；
3. 必要时重启设备。

如果清除后仍然处于虚拟位置，请检查模块参数中是否另外填写了固定的：

longitude
latitude

如果模块本身配置了固定经纬度，仅清除网页 / 快捷指令保存的数据仍可能继续使用模块参数。此时关闭 WLOC 模块或恢复默认参数后再测试。

当前传统 WLOC 不支持 iOS 27 正式版。不要把主要精力放在重复安装证书、模块和快捷指令上。

如果不是 iOS 27 正式版，请依次检查：

1. WLOC 模块是否启用；
2. 代理 / VPN 是否正在运行；
3. MITM / HTTPS 解密是否启用；
4. CA 描述文件是否安装；
5. CA 是否在“证书信任设置”中开启完全信任；
6. 快捷指令和 Safari 请求是否经过当前代理客户端。

通常表示快捷指令原本期望获得 JSON，但实际拿到了普通文本、旧接口结果或错误页面。

当前解析接口使用：

https://wloc.xepesw.workers.dev/api/parse?format=json&u=...

如果仍在使用旧快捷指令，请改用 README 当前提供的版本。

不要把：

https://gs-loc.apple.com/wloc-settings/save

替换成 Worker 地址；这个 Apple 地址就是由本机 WLOC 模块拦截的保存路径。

先重新打开 README 当前提供的 iCloud 快捷指令链接。如果 iCloud 分享服务暂时异常，也可以直接使用网页选点：

https://wloc.xepesw.workers.dev/

常见原因：

• 当前 iOS 版本已不支持这条 MITM 链路；
• MITM 或 CA 完整信任未配置正确；
• Safari 没有经过当前代理客户端；
• GPS 正在提供真实位置；
• Apple 定位缓存尚未刷新；
• WLOC 模块没有实际拦截到定位响应；
• 同时启用了多个旧 / 新 WLOC 模块。

这通常需要判断是否被真实 GPS 覆盖。WLOC 不是 GPS 硬件模拟，室外或 GPS 信号较强时更容易发生。

为了避免只能收到“不能用”“失效了”但无法判断原因的反馈，提交 Issue 时请尽量填写：

iPhone 型号：
iOS 完整版本：
代理客户端：
代理客户端版本：
WLOC 模块是否启用：
MITM 是否开启：
CA 是否已在“证书信任设置”开启完全信任：
使用网页还是快捷指令：
使用 Apple 地图 / 高德地图 / 百度地图：
具体错误提示：

如果是地图分享 / 解析问题，再提供：

分享出来的原始地图链接：

如果方便，可附错误截图、快捷指令报错位置和相关代理日志。请先删除节点密码、Token、证书私钥以及其他敏感信息。

只在自己拥有或获授权的设备上进行定位测试。更多快捷指令迁移和故障分层见 使用、迁移与排障。

推荐自行部署 Worker。进入本仓库的 worker 目录运行：

npm ci
npm run build:check
npx wrangler login
npm run deploy

本项目使用 Node.js 22 或更新版本；Wrangler 已固定到锁文件。部署不需要 KV 或数据库。Cloudflare Pages 配置也保留，见部署说明。

原作者的公共 Worker 和 Pages 不再作为默认选点服务；上方设置位置快捷指令已使用本仓库的新解析服务，自行部署时可按实际地址迁移。新维护者在 project.config.json 中填写仓库、发布分支及可选的选点站点，再运行：

npm run configure
npm run check:release

该命令会统一更新五种模块的脚本、图标和主页地址，以及本页订阅地址和网页源码入口。

选点网页 → gs-loc.apple.com/wloc-settings/save
         → 客户端模块拦截并写入 wloc_settings
WLOC 响应 → dist/wloc.js 读取配置并修改返回坐标

• worker/src/：网页、地图链接解析、GCJ-02/BD-09/WGS84 转换与 HTTP 路由。
• dist/：上游已打包的两个代理脚本；当前恢复版本缺少完整的原始脚本构建工程，不能声称已实现可复现重建。
• modules/：五种客户端订阅文件，由 templates/modules/ 和项目配置生成。
• worker/test/：解析、Stash 输出及 HTTP 行为的自动测试。

生效坐标保存在代理客户端的 wloc_settings；收藏保存在浏览器 localStorage，两者独立。Worker 的解析接口不主动写数据库或应用日志，并返回 Cache-Control: no-store。但地图、搜索、CDN 和托管平台会接收相应网络请求，不能将其理解为整个链路不产生记录。详见安全与隐私说明。

页面内部使用 WGS84。中国大陆的苹果地图/高德、百度链接按上游逻辑进行坐标转换；港澳台及境外存在不同规则，已用回归用例覆盖部分边界。外部地图链接格式变化仍可能影响解析。

优先级：页面保存的坐标 > 模块参数 > 默认值。QX 可在网页设置扰动半径，其余客户端也可修改模块参数。保留上游协议路径、域名匹配和持久化键，便于旧用户迁移。

npm --prefix worker ci
npm run check
npm test
npm run build:check
npm run pages:build

npm test 同时执行 .test.mjs 和 .test.js，包括上游曾被默认命令漏掉的 Stash 测试。构建检查仅产出本地文件，不会部署。

提交方式见 CONTRIBUTING.md；恢复来源和缺失内容见来源记录；待处理问题、发布步骤及真机验证清单见维护说明。

• proxypin-wloc-spoofer - 原始 WLOC 定位修改思路 by FFF686868
• NSNanoCat/Util - 跨平台脚本工具框架

• @YmlyZA - 百度地图支持、港澳台边界处理、GCJ 换算优化、回归测试覆盖 (#83)
• @YeTianXingShi - randomRadius 随机坐标扰动功能原始实现 (#70)
• @SajoLuo - Stash 响应格式修复 (#66)
• @SkywardLab - 扩展 WLOC 备用域名拦截 (#90)
• @beiming0000 - 逗号小数格式坐标丢失问题报告 (#96)

保留上游 AGPL-3.0 许可证、作者署名及贡献记录。原 README 还包含关于商业产品和应用商店的额外声明，原文及其与标准许可证的区别见 NOTICE.md。本次整理未改写 LICENSE，也未完成第三方打包组件的完整许可证审计。

本项目仅用于授权测试、安全研究和 QA 场景复现。

使用本项目即表示你理解并同意：

• 只能测试你自己拥有，或已获得明确授权的设备、应用、账号和网络。
• 你需要自行遵守所在地法律法规、平台规则和服务条款。
• 作者不对任何滥用行为、服务违规、账号封禁、数据损失、法律后果或其他损害负责。
• 本项目按“原样”提供，不提供任何形式的担保。

不要使用本项目欺骗服务、绕过规则、伪造生产环境定位数据，或在未经授权的设备和网络上使用。