Home-Location-Endpoint

Home-Location-Endpoint (HLE) 是一个开源项目，允许用户将一台 Linux 服务器部署为 Apple 设备的网络定位修改端点。通过拦截并改写 Apple 定位服务（WLOC/WifiTile）的响应数据，它能让你的 iPhone、iPad 或 Mac 在连接该代理时，显示为你指定的地理位置坐标。

该项目特别注重隐私安全与自动化体验，提供从“一键新手模式”到“完全自定义高手模式”的三种安装路径，并支持通过 Telegram Bot 进行便捷的地点管理。

核心特性

• 🌍 智能地理模拟
  • 城市级随机坐标：根据服务器公网出口 IP 识别所在城市，并在该城市的 OpenStreetMap 行政边界内随机抽取 WGS84 坐标。
  • 微漂移算法：在选定中心周围进行平滑的 8 米微漂移，保留 Apple 返回批次内的相对几何关系，使定位表现更自然。
  • 热点压缩与补全：将公里级的 Wi-Fi 热点批次等比例压缩到目标周围最大 45 米范围内，并智能补全缺失的 BSSID，避免触发异常检测。
• 🤖 Telegram Bot 集成（进阶模式）
  • 可视化控制：通过 Bot 菜单一键切换、增加或删除地点，支持一键恢复真实定位。
  • 安全交付：Bot 使用独立低权限账号，仅读取节点 URL 副本和 CA 公钥描述文件，无法接触核心配置或私钥。
  • 多地点管理：内置洛杉矶、东京、香港、新加坡、巴黎等全球主要城市及南极昆仑站的随机坐标库。
• 🔒 隐私与安全设计
  • 流量隔离：仅路由 Apple 网络定位域名到本机拦截器，普通代理流量不经过定位修改逻辑，确保上网速度与稳定性。
  • 零日志记录：不记录用户身份、坐标历史或原始 Wi-Fi 身份信息。
  • CA 自动管理：自动生成 iOS CA 描述文件，私钥签发完成后立即删除，降低泄露风险。
  • 防扫描机制：对鉴权失败的 REALITY fallback 使用随机化的双向限速参数，防止被恶意扫描滥用。
• ⚙️ 灵活的部署模式
  • 新手模式：全自动安装定位修改器 + VLESS + REALITY + Vision 节点，适合无基础用户。
  • 进阶模式（推荐）：新增 Telegram Bot 控制，支持 SS2022 等多种代理协议，输出标准 ss:// URL。
  • 高手模式：仅安装定位修改器核心组件，由用户自行搭建和管理代理服务。

系统要求与支持

• 操作系统：Debian 12/13, Ubuntu 22.04/24.04。
• 架构支持：代理模式支持 amd64/arm64；仅定位模式不限制 CPU 架构。
• 网络环境：需要拥有公网 IPv4 或 IPv6 地址的 Linux 服务器。

快速开始

1. 选择安装模式

运行安装脚本后，根据提示选择新手、进阶或高手模式。

2. 客户端配置

• iOS/macOS：安装生成的 CA 描述文件并信任证书。
• 代理设置：使用安装器提供的 VLESS/REALITY 或 Shadowsocks 节点链接配置代理工具。

3. 验证效果

打开地图应用或定位测试网站，确认位置已变更为服务器所在城市的随机坐标。

常用命令

• sudo hle pause：暂停坐标改写，返回 Apple 原始定位响应。
• sudo hle resume：恢复坐标改写功能。
• sudo hle relocate：重新随机选择一个新的定位点。

⚠️ 重要免责声明

• 早期版本：本项目仍处于早期开发阶段，请在非关键设备上测试。
• 非安全工具：不要依赖本项目处理紧急呼叫、Find My 防盗、合规审查或人身安全场景。
• 单用户设计：回环拦截器无法区分不同代理用户，请勿将同一节点凭据分享给互不信任的设备。