LinkLoom VPN SDK

把「VPN 初始化 + UDP 隧道 + 设备注册」封装为一个 AAR，让任意 Android 项目通过 Builder API 接入虚拟内网。

这是什么

LinkLoom VPN SDK 是一套面向 Android 宿主应用的虚拟内网接入组件。宿主只需注入 token、配置服务器地址，即可让自身业务流量经由 UDP 隧道转发到内网，无需关心 TUN 接口、心跳保活、设备注册等底层细节。

核心能力

• UDP 隧道：注册请求、心跳保活（默认 30s 间隔 / 90s 超时）、原生 IP 包透传
• 设备注册：GET /device/validate/{id} + POST /device/bind
• TUN 双工转发：两个独立线程 + BlockingQueue 解耦，带 IPv4 包校验
• 配置后端下发：服务器 host/port、MTU、socket buffer 全部由后端拉取，Builder 仅作兜底
• 生产级保活：前台服务通知、WakeLock、JobScheduler 守护（默认 60s 巡检）
• 透明授权：自动处理 VpnService.prepare，自动排除宿主自身路由避免 UDP 死循环

接入方式

宿主通过本地 AAR 引入，配合 TokenProvider 注入当前 token 即可：

dependencies {
    implementation files("libs/vpnsdk-release.aar")
    implementation 'com.squareup.okhttp3:okhttp:4.12.0'
    implementation 'com.google.code.gson:gson:2.10.1'
}

下一步

👉 完整的构建、集成、API 参考与协议规范，请阅读 LinkLoom VPN SDK 集成指南。