应用管理

应用管理

应用管理功能包括两个方向:

要启用参数,请传递值 true1;要禁用,请传递任何其他非空值(例如 0false)。

标准参数

chevron-right订阅自动更新hashtag

在系统中创建定时任务。根据系统内部优先级,系统会尝试在设定时间启动订阅更新。如果因任何原因未在指定时间间隔内执行更新,则会在下次启动应用时自动执行。时间间隔以小时为单位,必须是 1 小时的倍数。

该参数配置示例:

profile-update-interval: [int]

传递方式:

通过 HTTP 标头:
HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
profile-update-interval: 1
通过订阅内容:
#profile-update-interval: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…
chevron-right订阅名称hashtag

订阅配置文件名称。可以是纯文本或 base64(UTF-8)。限制:最大长度为 25 个字符。

通过订阅内容传递时,在参数前添加 # 符号(例如 #profile-title)

该参数配置示例:

profile-title: [string]

传递方式:

通过 HTTP 标头:
HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
profile-title: Name VPN
通过订阅内容:
#profile-title: Name VPN
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…
chevron-right订阅状态栏(流量、到期日期)hashtag

显示订阅的余额、已使用流量和有效期。在应用中,刻度尺左侧显示已使用流量(上传 + 下载),右侧显示“/”符号后的总流量。订阅到期日期在 expire 参数中指定。注意:所有数据在一个标头中传递,并以 ; 符号分隔。

该参数配置示例:

subscription-userinfo: [string]

传递方式:

通过 HTTP 标头:
HTTP/2 200 
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscription-userinfo: upload=0; download=2153701362; total=0; expire=1790951622
通过订阅内容:
№subscription-userinfo: upload=0; download=2153701362; total=0; expire=1790951622
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…
chevron-right支持页面链接hashtag

跳转到支持页面的按钮。显示为位于行右侧的蓝色图标。如果链接指向 Telegram,则显示 Telegram 图标;其他情况使用标准链接图标。

该参数配置示例:

传递方式:

chevron-right网站页面链接hashtag

跳转到订阅网站页面的按钮。显示为位于行左侧的蓝色图标。如果未设置参数,图标将为灰色。

该参数配置示例:

传递方式:

chevron-right公告hashtag

订阅可以包含以 纯文本Base64 格式传递的公告文本。限制:显示文本的最大长度为 200 个字符

该参数配置示例:

传递方式:

chevron-right禁用路由hashtag

用于在应用中禁用路由的全局参数。

该参数配置示例:

传递方式:

chevron-right隧道配置(仅适用于桌面版)hashtag

为 sing-box 核心传递自定义隧道配置。

该参数配置示例:

传递方式:

高级参数

circle-exclamation
chevron-right更改订阅 URLhashtag

如果您的域名被提供商屏蔽,而用户只能通过 VPN 连接服务器并更新订阅,则此参数正是为您设计的。在此参数值中设置新的域名,即可确保订阅的所有用户自动替换该域名。

该参数配置示例:

传递方式:

chevron-right更改订阅域名hashtag

更改网站域名而不更改完整 URL,保留地址的其余部分。

该参数配置示例:

传递方式:

chevron-right订阅中的服务器描述hashtag

允许设置额外的说明文字,该文字显示在服务器名称下方,代替标准文本(例如 "VMess"、"VLESS"、"Trojan")。

  • 最大长度为 30 个字符。

  • 如果无法完整显示在屏幕上,将以省略号截断。

  • title 之后通过分隔符 ? 设置。

示例:

chevron-right订阅分片与前置域名hashtag

某些 CDN 支持域名前置。这允许您通过第三方域名连接到您的网站。例如,将连接地址指定为 visa.com,而 Host 标头为 my-domain.com,提供商将只看到对 visa.com 的请求。

此外,您还可以使用 TLSHello 中的数据包分片访问您的域名以获取服务器列表。

默认情况下,所有订阅都启用了分片。用户只能添加一次订阅;如果账户不是高级账户,则不允许更新。

带参数的 URL 结构

分片包含三个参数:[length][interval][packets]

使用前置域名时,需要首先指定将通过其建立连接的域名 URL。还需要设置 resolve-address —— 可以是域名或 IP 地址 —— 以及 host,其对应于您所选网络中的主机。

chevron-right高级分片hashtag

此功能目前正在进行封闭测试,即将推出...

chevron-right不可禁用的 HWIDhashtag

默认情况下,HWID 在所有 Happ 应用中均为启用状态。但如果您希望用户无法在应用设置中禁用此参数的转发,则可以随订阅一起发送此特殊参数。

该参数配置示例:

传递方式:

chevron-right订阅到期通知hashtag

您可以启用订阅到期的自动通知功能。用户将在订阅到期前 3 天收到提醒:连续三天每天发送一条通知。这有助于用户及时续订订阅。

通知文本:

该参数配置示例:

传递方式:

chevron-right隐藏订阅中的服务器设置hashtag

禁用订阅用户查看和编辑服务器配置的功能。该设置适用于已添加的订阅以及将来要添加的订阅。

该参数配置示例:

传递方式:

chevron-right域名解析hashtag

应用可以在建立连接之前预先解析服务器的域名。您可以指定任何 DoH 服务器,在连接到 Xray 服务器时,域名将被替换为获取的 IP 地址。

如果域名返回多个 IP 地址,应用将自动选择延迟时间(ping)最低的那个。但需要注意的是:如果 IP 地址数量较多,连接可能需要更长时间,因为所有选项都会提前测试。

该参数配置示例:

传递方式:

应用设置管理

circle-exclamation
chevron-right自动连接hashtag

允许在启动应用时自动将用户连接到服务器。此外,可以通过参数 subscription-autoconnect-type 指定连接到特定服务器的条件。

该参数配置示例:

传递方式:

chevron-right自动 Pinghashtag

如有必要,在打开应用时自动测试服务器列表。

该参数配置示例:

传递方式:

chevron-right订阅自动更新hashtag

可以在应用中同时启用或禁用所有订阅的自动更新——此设置会同时应用于所有订阅。如果只需要为特定订阅设置自动更新,请使用“订阅自动更新”功能。禁用全局设置后,每个订阅将独立确定其更新时间。

该参数配置示例:

传递方式:

chevron-right分片hashtag

这是控制所有订阅分片的全局参数。如果只需要为特定订阅或服务器设置分片,请使用免费功能和应用通用文档中的说明。禁用全局设置后,每个订阅将独立确定分片设置。

该参数配置示例:

传递方式:

chevron-rightPinghashtag

此功能允许选择应用中执行 ping 的方式。提供三个选项:"via Proxy"、"TCP" 和 "ICMP"。对于 "via Proxy" 模式,可以额外指定用于 ping 检查的 URL。

该参数配置示例:

传递方式:

chevron-rightUser-Agenthashtag

此功能允许更改获取订阅时标头中使用的 User-Agent。在提供商屏蔽非标准或不合适标头的请求时非常有用。

该参数配置示例:

传递方式:

chevron-right应用自动启动hashtag

允许在设备开机时自动启动应用。目前仅在 Android 上可用。

该参数配置示例:

传递方式:

chevron-right应用启动时更新订阅hashtag

此功能会在每次打开应用时自动更新应用中的所有订阅。

该参数配置示例:

传递方式:

chevron-right选定应用的代理(Android)hashtag

可以在此参数中指定应使用 VPN 或绕过 VPN 的应用列表。如果应用尚未安装在设备上但已在列表中指定,则在首次安装后连接到 VPN 时会自动将其计入。

该参数配置示例:

传递方式:

chevron-right数据包分析(Sniffing)hashtag

xray-core 中的 sniffing 用于分析连接的前几个数据包,并自动确定协议(HTTP、TLS、BitTorrent 等)和域名(SNI/Host)。可能会影响微信应用中的媒体加载。默认已启用。\

该参数配置示例:

传递方式:

chevron-right禁止折叠订阅hashtag

此功能禁用折叠订阅的能力:服务器列表始终以完全展开的方式显示。\

该参数配置示例:

传递方式:

chevron-rightPing 显示模式hashtag

允许显示图标而不是时间值\

该参数配置示例:

传递方式:

chevron-rightMuxhashtag

Mux 在 xray-core 中是多路复用(multiplexing)功能,允许通过单个物理 TCP 连接传输多个虚拟 TCP 连接的数据。旨在降低 TCP 握手的延迟,而不是提高带宽(甚至可能减慢大量下载)。在出站配置中设置,参数包括 enabled 和 concurrency(最小 -1,最大 1024)。

该参数配置示例:

传递方式:

chevron-right代理 \ TUN 模式(仅适用于桌面版)hashtag

必须仅使用以下两个参数之一!这些参数在添加/更新订阅时确定连接类型。

该参数配置示例:

传递方式:

chevron-rightTUN 模式(仅适用于桌面版)hashtag

确定 TUN 连接使用的模式。

  • system — 使用操作系统的系统网络栈。 快速高效,但依赖于路由和防火墙的正确配置。

  • gvisor — 使用 gVisor 的用户空间栈(userspace)。 减少对内核规则及 iptables/nftables/Docker 冲突的依赖,隔离性更好;可能存在轻微的性能损失。

该参数配置示例:

传递方式:

chevron-right选择隧道核心(仅适用于桌面版)hashtag

确定将用于 TUN 连接的核心。可选择 sing-boxarrow-up-righttun2proxyarrow-up-right

该参数配置示例:

传递方式:

chevron-right排除路由hashtag

定义不应通过隧道传输流量的子网和 IP 地址列表。地址在同一行中指定,以空格和逗号分隔。

该参数配置示例:

传递方式:

chevron-right主题(仅限 iOS)hashtag

允许您将配色主题自定义为个人风格。您可以在编辑器中创建自己的主题——长按“外观主题”标签即可打开菜单。创建的主题可以导出到剪贴板,也可以从剪贴板、.happ 文件中导入,或通过订阅进行分享。

该参数配置示例:

传递方式:

Last updated