现急需Mac系统做兼容性测试，如你有Mac电脑，请联系：
开发者：https://t.me/wloc8

OpenHRTT WLoc

支持iOS27.0，在线体验：https://wloc8.com/，TG群：https://t.me/wloc88

点击图片可查看最新使用教程

面向 iOS 和 macOS 的实验性定位响应研究工具

English | 贡献指南 | 安全说明

项目介绍

OpenHRTT WLoc 是一个完全开源、使用 Swift 编写的 iOS/macOS 实验性工具。iOS 使用 Packet Tunnel；macOS 的验证版本使用系统 PAC，只把指定 Apple 定位域名交给主应用内的本地 HTTPS 代理。

工作原理

flowchart LR
    A["地图选择位置"] --> B{"平台"}
    B -->|"iOS"| C["Packet Tunnel Extension"]
    B -->|"macOS"| D["系统 PAC"]
    C --> E["本地 HTTPS 代理"]
    D --> E
    E --> F["仅处理目标定位域名"]

Loading

代理目前只针对 gs-loc.apple.com 和 gs-loc-cn.apple.com，不应被当作通用 VPN 或通用 HTTPS 抓包工具。

环境要求

• macOS 开发环境。
• Xcode 16 或更高版本；当前已在 Xcode 26.6 下检查。
• CocoaPods 1.16 或更高版本。
• OpenSSL 3.x。
• iOS Tunnel 需要 Network Extensions 权限；macOS 使用嵌入式 Privileged Helper 修改 PAC。
• 真机运行才能完整验证证书信任、VPN 和系统定位行为。

工程声明的最低版本为 iOS 12.0 和 macOS 13.0。

快速开始

1. 获取代码并安装依赖

git clone https://github.com/OpenHRTT/wloc.git
cd wloc
pod install

后续请始终打开 WLocApp.xcworkspace，不要直接打开 WLocApp.xcodeproj。

使用 WLocApp-macOS Scheme 执行 Debug Run 时，Scheme 会在构建完成后自动把已签名 App 安装到 /Applications/WLoc8.com.app，并从该路径启动调试。当前 Xcode 用户需要有 /Applications 写权限；如只想构建而不安装，可在环境中设置 WLOC_SKIP_DEBUG_INSTALL=1。

2. 生成你自己的本地证书

仓库不包含任何可重用的根证书私钥或 .p12 文件。每个开发者都必须在本机生成独立证书：

chmod +x generate_apple_wloc_p12.sh
./generate_apple_wloc_p12.sh

脚本会生成证书并自动同步到 App/Extension 资源目录。默认 .p12 密码为 app-wloc，与 AppWLocConfig.proxyIdentityPassword 一致。如果你修改脚本密码，也必须同步修改应用配置。

Important

app_wloc_certs/、*.key、*.p12 和生成到 Resources 中的证书文件已被 .gitignore 排除。不要使用 git add -f 强制提交它们。

3. 配置签名和唯一标识

用 Xcode 打开 WLocApp.xcworkspace，对以下四个 Target 选择同一个 Team：

• WLocApp-iOS
• WLocTunnel-iOS
• WLocApp-macOS
• WLocPrivilegedHelper

然后修改 Bundle Identifier，并保证 Tunnel 的标识为应用标识加 .tunnel。例如：

com.example.wloc
com.example.wloc.tunnel

App Group 只用于 iOS 主应用和 Tunnel 共享状态。请将下列文件中的 group.com.wlocapp.shared 统一替换为你的 App Group：

• Resources/iOS/WLocApp-iOS.entitlements
• Resources/Tunnel/WLocTunnel-iOS.entitlements
• WLocApp/WLocCore/AppWLocConfig.swift

在 iOS Target 的 Signing & Capabilities 中确认 App Groups 和 Network Extensions 已正确启用。macOS 主应用与 Helper 必须使用同一 Team 签名；应用会在运行时从当前签名读取 Team ID。运行正式版本前请将完整应用拖到 /Applications。

外部链接（待开发）

应用支持通过 wlocapp:// 导入位置。载荷是 URL 编码后的 JSON：

{
  "type": "location",
  "data": {
    "name": "Tiananmen Square",
    "detail": "Beijing",
    "latitude": 39.9087,
    "longitude": 116.3975,
    "coordinateSystem": "wgs84"
  }
}

支持的 coordinateSystem 值包括 wgs84、gcj02、bd09 和 apple。完整 URL 可以使用两种格式：

wlocapp://<percent-encoded-json>
wlocapp://?payload=<percent-encoded-json>

常见问题

构建时提示找不到 AppWLocProxy.p12 或 AppWLocRootCA.cer？

在项目根目录运行 ./generate_apple_wloc_p12.sh。

Signing 或 App Group 报错？

确认四个 Target 都选择了正确的 Team，并且 iOS App 与 Tunnel 使用同一个 App Group。

点击锁定后没有生效？

检查根证书是否已安装且完全信任。iOS 还需确认 VPN 已连接；macOS 需确认系统“自动代理配置”已指向本机 PAC，然后按 App 提示刷新定位服务。

更多排查步骤见 docs/TROUBLESHOOTING.md。

贡献

欢迎提交 Issue 和 Pull Request。请先阅读 CONTRIBUTING.md 和 CODE_OF_CONDUCT.md。

第三方依赖

项目使用 SwiftProtobuf、SnapKit、IQKeyboardManagerSwift 和 GCDWebServer。详细版本、来源与授权状态见 THIRD_PARTY_NOTICES.md。

许可证

本项目自有代码使用 MIT License。第三方代码不受本项目 MIT License 覆盖，具体见 NOTICE 和 THIRD_PARTY_NOTICES.md。