WhiteDNS：Android DNS 隧道客户端

项目简介

WhiteDNS 是一款 Android 应用，在手机本地运行 DNS 隧道客户端，提供代理（Proxy）与 VPN 两种工作模式。它由 MasterDNS Client 项目提供支持，并集成 StormDNS、CottenDns 与 Lantern Soar 等客户端引擎，界面基于 Jetpack Compose 和 Material 3 构建。

主要功能

• 支持 StormDNS、CottenDns、Soar 引擎的 DNS 隧道客户端。
• 代理模式：本地 SOCKS5，可选 HTTP 代理桥接。
• VPN 模式：基于 Android VpnService 与内置 tun2proxy 原生库。
• 内置与自定义服务器配置。
• stormdns:// 和 soar:// 配置导入导出；点击连接卡片即可选中该连接。
• HTTP/HTTPS 订阅导入与刷新，显示配额与到期快照，断连时会自动刷新到期来源。
• 解析器（Resolver）配置管理，带校验与默认解析器资源。
• VPN 分流（Split tunnel）选项。
• 运行日志、解析器状态、连接进度与流量统计。
• 长时间运行的代理与 VPN 会话提供前台服务通知。
• CottenMax（beta）选项：在 CottenDNS 配置中可选择 Normal / Max 模式，Max 服务器同时兼容 Normal。

安装与使用

APK 请从官方仓库的 Releases 页面下载并安装到 Android 设备。

导入订阅：在 Profiles → Connection → Import 中粘贴 HTTPS 订阅链接或扫描其二维码并确认；刷新订阅请在断开连接时进行。

本地调试构建（仅用于本地审查、测试和向官方项目提交贡献）：

./gradlew testDebugUnitTest
make debug

需要 JDK 17、Go 1.26.1、Android SDK（compileSdk = 36）与对应的 Android NDK 等环境。debug 包使用 shop.whitedns.client.debug 包名和 WhiteDNS Debug 名称，可与正式版并存。

注意事项

• WhiteDNS 是 source-available 的专有软件，并非开源软件：可以查看代码并提交贡献，但不得将其复制进其他产品、发布修改版、重新打包 APK、转售，或复用 WhiteDNS 的名称、Logo、图标、设计和视觉识别。
• 官方声明没有在 Google Play 上架，Google Play 或其他应用市场中的同名 APK、列表或包均非官方发布，可能已被修改、过期或不安全。
• 订阅链接属于凭证，建议使用 HTTPS；使用 HTTP 源需要显式确认，因为其地址和密钥不加密。
• 官方更新渠道为 Telegram 频道：https://t.me/whitedns。

本作品整理自 GitHub 开源项目 WhiteDNS/WhiteDNS-Android，原作者 @WhiteDNS。中文介绍由 AI 根据项目 README 整理，以原仓库为准。