链接和参数示例

此信息不是 VPN 配置指南，也不用于绕过封锁、访问违反您所在国家法律的禁止网站或应用程序。

1. 概述

HAPP 应用程序支持多种旨在保障安全和绕过网络审查的现代协议：VLESS、VMess、Shadowsocks、Socks5、Trojan 以及 Hysteria2（包括 hy2 方案）。

---

2. 添加配置的方式

• 手动输入： 通过主屏幕上的 “+” 按钮进行添加。允许对协议的每个参数进行细粒度配置。

• URL/二维码导入： 自动识别剪贴板或通过摄像头扫描的方案链接（如 vless://、vmess:// 等）。

• 订阅：

  • 标准订阅： 指向文本格式服务器列表的 URL 链接。

  • JSON 数组： 包含预设密钥、路由规则和 Reality 参数的高级数据集。

---

3. JSON 配置文件的处理特性

当以 JSON 格式将服务器配置导入 HAPP 应用程序时，程序在与 XRAY 内核 交互时会采用特殊的处理机制。

3.1 直接透传原则 (1:1)

启动 XRAY 内核时，此类 JSON 配置将以原始状态直接传递。

重要提示： 在此模式下，HAPP 的标准路由规则和界面设置不会应用到该 JSON 文件上。配置将完全按照其源代码逻辑运行。

3.2 通过 HAPP 进行间接管理

尽管采用直接透传模式，应用程序仍可以通过路由方案控制内核的运行环境：

• GEO 文件管理： 您可以控制传递给内核执行的地理数据（Geo-data）文件。

• 优化（裁剪版 GEO 文件）： 启用此功能后，内核仅接收数据库的必要片段（带有选定标签的部分），从而节省系统资源。

• DNS 隧道： 远程 DNS 设置继承自应用程序当前的活动路由方案，用户可根据需要调整系统行为。

---

4. 高级参数 (URI Scheme)

4.1 Hysteria 2 (hy2://)

参数	说明
auth	认证数据（userpass 格式为 用户名:密码）。
port	支持多端口：例如 1234,5000-6000,7044。
obfs	混淆类型（例如 salamander）。
mportHopInt	端口跳跃间隔（秒）。

4.2 分片与噪声 (Fragmentation & Noises)

用于绕过深度包检测 (DPI) 的工具。仅当应用程序的全局设置关闭时，单个服务器的本地设置才会生效。

• 分片 (Fragmentation)： fragment=length,interval,packets[,maxSplit]

  • 示例： fragment=1-10,5-20,tlshello

• 噪声 (Noises)：（必须配合分片使用）noises=type,packet,delay[,applyTo]

  • 示例： noises=rand,50-150,10-50,ip

---

5. 可视化与元数据

为了方便管理服务器列表，可以在 URL 末尾的 # 符号后添加标签：

1. 标题 (title)： #我的服务器（最多 30 个字符）。

2. 服务器描述 (serverDescription)： 将技术性副标题（如 "VMess"）替换为自定义文本。

   • 格式： #标题?serverDescription=<base64编码文本>

   • JSON 格式： 使用字段 "meta": {"serverDescription": "您的文本"}。

---

6. Socks5 代理示例

应用程序支持解析以下三种记录格式：

• 明文格式： socks://user:[email protected]:443

• 部分 Base64： socks://<base64编码的用户密码>@1.2.3.4:443#名称

• 全 Base64： socks://<完整字符串的base64编码>