应用管理
应用管理
应用管理功能包括两个方向:
标准参数,适用于大多数面板。
高级参数,需要在订阅中指定 Provider ID。
要启用参数,请传递值 true 或 1;要禁用,请传递任何其他非空值(例如 0 或 false)。
标准参数
订阅自动更新

在系统中创建定时任务。根据系统内部优先级,系统会尝试在设定时间启动订阅更新。如果因任何原因未在指定时间间隔内执行更新,则会在下次启动应用时自动执行。时间间隔以小时为单位,必须是 1 小时的倍数。
该参数配置示例:
profile-update-interval: [int]传递方式:
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…订阅名称

订阅配置文件名称。可以是纯文本或 base64(UTF-8)。限制:最大长度为 25 个字符。
通过订阅内容传递时,在参数前添加 # 符号(例如 #profile-title)
该参数配置示例:
profile-title: [string]传递方式:
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…订阅状态栏(流量、到期日期)

显示订阅的余额、已使用流量和有效期。在应用中,刻度尺左侧显示已使用流量(上传 + 下载),右侧显示“/”符号后的总流量。订阅到期日期在 expire 参数中指定。注意:所有数据在一个标头中传递,并以 ; 符号分隔。
该参数配置示例:
subscription-userinfo: [string]传递方式:
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…支持页面链接

跳转到支持页面的按钮。显示为位于行右侧的蓝色图标。如果链接指向 Telegram,则显示 Telegram 图标;其他情况使用标准链接图标。
该参数配置示例:
support-url: [string]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
support-url: https://t.me/happ_chat#support-url: https://t.me/happ_chat
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…网站页面链接

跳转到订阅网站页面的按钮。显示为位于行左侧的蓝色图标。如果未设置参数,图标将为灰色。
该参数配置示例:
profile-web-page-url: [string]传递方式:
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-web-page-url: https://happ.su#profile-web-page-url: https://happ.su
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…公告

订阅可以包含以 纯文本 或 Base64 格式传递的公告文本。限制:显示文本的最大长度为 200 个字符。
该参数配置示例:
announce: [string]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
announce: base64:SGFwcCB0aGUgYmVzdCE=#announce: base64:SGFwcCB0aGUgYmVzdCE=
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…禁用路由
用于在应用中禁用路由的全局参数。
该参数配置示例:
routing-enable: [string]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
routing-enable: 0#routing-enable: 0
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…隧道配置(仅适用于桌面版)
为 sing-box 核心传递自定义隧道配置。
该参数配置示例:
custom-tunnel-config: [json]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
custom-tunnel-config: {...}#custom-tunnel-config: {...}
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…高级参数
需要 Provider ID 参数!
更改订阅 URL
如果您的域名被提供商屏蔽,而用户只能通过 VPN 连接服务器并更新订阅,则此参数正是为您设计的。在此参数值中设置新的域名,即可确保订阅的所有用户自动替换该域名。
该参数配置示例:
new-url: [url]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
new-url: https://mynew-domain.com/3J3jrb4jfc#new-url https://mynew-domain.com/3J3jrb4jfc
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…更改订阅域名
更改网站域名而不更改完整 URL,保留地址的其余部分。
该参数配置示例:
new-domain: [domain]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
new-domain: mynew-domain.com#new-domain mynew-domain.com
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…订阅中的服务器描述

允许设置额外的说明文字,该文字显示在服务器名称下方,代替标准文本(例如 "VMess"、"VLESS"、"Trojan")。
最大长度为 30 个字符。
如果无法完整显示在屏幕上,将以省略号截断。
在
title之后通过分隔符?设置。
示例:
vless://[email protected]:443?encryption=none&node_id=482&headerType=none&type=tcp&security=reality&sni=booking.com&fp=chrome&pbk=YqHW8a4iAc1SZYpTrFVoOQg1F3yAdX1tWXuROZUCsEU&sid=6ba85179e30d4fc2&flow=xtls-rprx-vision&xtls=2#title?serverDescription=SGFwcCB0aGUgYmVzdA==vmess://eyJob3N0IjoiZWxhaG9tZWtpdGNoZW4uY29tIiwicGF0aCI6IiIsInRscyI6IiIsImFkZCI6ImVsYWhvbWVraXRjaGVuLmNvbSIsInBvcnQiOjUwMDAsImFpZCI6MCwibmV0IjoidGNwIiwidHlwZSI6Im5vbmUiLCJ2IjoiMiIsInBzIjoi4piB77iPIDogNTMuM0dCIiwiaWQiOiI4N2ZhN2VmMC1jM2ZjLTNiOTAtYTJkOC01OGZjYjhkZmZmMjYiLCJzZXJ2ZXJEZXNjcmlwdGlvbiI6IkhhcHAgdGhlIGJlc3QifQ==trojan://[email protected]:443?security=tls&insecure=1&fragment=3,1,tlshello&type=ws&headerType=&path=%2F&host=quictest.burncommunity.ru&sni=quictest.burncommunity.ru&fp=chrome&alpn=http%2F1.1#title?serverDescription=SGFwcCB0aGUgYmVzdA==socks://pkg-private2-country-us-city-new_york_city:[email protected]:1080#title?serverDescription=SGFwcCB0aGUgYmVzdA==ss://[email protected]:9042#title?serverDescription=SGFwcCB0aGUgYmVzdA==wireguard://[email protected]:10803?publickey=asd33d223d33&address=dom.ru&allowinsecure=1&mtu=1500&reserved=1,22,33#title?serverDescription=SGFwcCB0aGUgYmVzdA=={
"dns": {
...
},
"inbounds": [
...
],
"outbounds": [
...
],
"remarks": "🇭🇰 Hong Kong",
"meta": {
"serverDescription": "Happ the best"
}
}订阅分片与前置域名
某些 CDN 支持域名前置。这允许您通过第三方域名连接到您的网站。例如,将连接地址指定为 visa.com,而 Host 标头为 my-domain.com,提供商将只看到对 visa.com 的请求。
此外,您还可以使用 TLSHello 中的数据包分片访问您的域名以获取服务器列表。
默认情况下,所有订阅都启用了分片。用户只能添加一次订阅;如果账户不是高级账户,则不允许更新。
带参数的 URL 结构
[链接]#标题?[分片参数]&[解析地址]&[主机]&[不安全模式]
前置域名示例:
visa.com/123#MyVPN?resolve-address=visa.com&host=mydomain.com
分片示例:
mydomain.com/123#MyVPN?fragment=80-250,10-100,tlshello分片包含三个参数:[length]、[interval] 和 [packets]。
使用前置域名时,需要首先指定将通过其建立连接的域名 URL。还需要设置 resolve-address —— 可以是域名或 IP 地址 —— 以及 host,其对应于您所选网络中的主机。
不可禁用的 HWID
默认情况下,HWID 在所有 Happ 应用中均为启用状态。但如果您希望用户无法在应用设置中禁用此参数的转发,则可以随订阅一起发送此特殊参数。
该参数配置示例:
subscription-always-hwid-enable: [true / 1]传递方式:
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-always-hwid-enable: 1#subscription-always-hwid-enable: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…订阅到期通知
您可以启用订阅到期的自动通知功能。用户将在订阅到期前 3 天收到提醒:连续三天每天发送一条通知。这有助于用户及时续订订阅。
通知文本:
У вашей подписки [name] скоро истечёт срок действия, не забудьте продлить её.该参数配置示例:
notification-subs-expire: [true / 1]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
notification-subs-expire: 1#notification-subs-expire: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…隐藏订阅中的服务器设置

禁用订阅用户查看和编辑服务器配置的功能。该设置适用于已添加的订阅以及将来要添加的订阅。
该参数配置示例:
hide-settings: [true / 1]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
hide-settings: 1#hide-settings: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…域名解析
应用可以在建立连接之前预先解析服务器的域名。您可以指定任何 DoH 服务器,在连接到 Xray 服务器时,域名将被替换为获取的 IP 地址。
如果域名返回多个 IP 地址,应用将自动选择延迟时间(ping)最低的那个。但需要注意的是:如果 IP 地址数量较多,连接可能需要更长时间,因为所有选项都会提前测试。
该参数配置示例:
server-address-resolve-enable: [true / 1]
server-address-resolve-dns-domain: [url]
server-address-resolve-dns-ip: [ip]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
server-address-resolve-enable: 1
server-address-resolve-dns-domain: https://common.dot.dns.yandex.net/dns-query
server-address-resolve-dns-ip: 77.88.8.8#server-address-resolve-enable: 1
#server-address-resolve-dns-domain: https://common.dot.dns.yandex.net/dns-query
#server-address-resolve-dns-ip: 77.88.8.8
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…应用设置管理
需要 Provider ID 参数!
自动连接
允许在启动应用时自动将用户连接到服务器。此外,可以通过参数 subscription-autoconnect-type 指定连接到特定服务器的条件。
该参数配置示例:
subscription-autoconnect: [true / 1]
subscription-autoconnect-type: [“lastused“/”lowestdelay”]传递方式:
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-autoconnect: 1
subscription-autoconnect-type: lowestdelay#subscription-autoconnect: 1
#subscription-autoconnect-type: lastused
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…自动 Ping
如有必要,在打开应用时自动测试服务器列表。
该参数配置示例:
subscription-ping-onopen-enabled: [true / 1]传递方式:
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-ping-onopen-enabled: 1#subscription-ping-onopen-enabled: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…订阅自动更新
可以在应用中同时启用或禁用所有订阅的自动更新——此设置会同时应用于所有订阅。如果只需要为特定订阅设置自动更新,请使用“订阅自动更新”功能。禁用全局设置后,每个订阅将独立确定其更新时间。
该参数配置示例:
subscription-auto-update-enable: [true / 1] 传递方式:
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-auto-update-enable: 1#new-url: https:/mynew-domain.com/3J3jrb4jfc
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…分片
这是控制所有订阅分片的全局参数。如果只需要为特定订阅或服务器设置分片,请使用免费功能和应用通用文档中的说明。禁用全局设置后,每个订阅将独立确定分片设置。
该参数配置示例:
fragmentation-enable: [true / 1]
fragmentation-packets: [tlshello,1-2,1-3,1-5]
fragmentation-length: [50-100]
fragmentation-interval: [10-20]
fragmentation-maxsplit: [String]
noises-enable: [true / 1]
noises-type: [rand. str, base64]
noises-packet: [String]
noises-delay: [String]
noises-applyto: [ip,ipv4,ipv6]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
fragmentation-enable: 1
fragmentation-packets: tlshello
fragmentation-length: 50-100
fragmentation-interval: 5
fragmentation-maxsplit: 100-200
noises-enable: 1
noises-type: rand
noises-packet: 10-20
noises-delay: 10-16
noises-applyto: ipv4#fragmentation-enable: 1
#fragmentation-packets: tlshello
#fragmentation-length: 50-100
#fragmentation-interval: 5
#fragmentation-maxsplit: 100-200
#noises-enable: 1
#noises-type: rand
#noises-packet: 10-20
#noises-delay: 10-16
#noises-applyto: ipv4
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Ping
此功能允许选择应用中执行 ping 的方式。提供三个选项:"via Proxy"、"TCP" 和 "ICMP"。对于 "via Proxy" 模式,可以额外指定用于 ping 检查的 URL。
该参数配置示例:
ping-type: ["proxy", "proxy-head', "tcp","icmp"]
check-url-via-proxy: [url]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
ping-type: proxy
check-url-via-proxy: https://cp.cloudflare.com/generate_204#ping-type proxy
#check-url-via-proxy: https://cp.cloudflare.com/generate_204
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…User-Agent
此功能允许更改获取订阅时标头中使用的 User-Agent。在提供商屏蔽非标准或不合适标头的请求时非常有用。
该参数配置示例:
change-user-agent: [String] 传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
change-user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36#change-user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…应用自动启动
允许在设备开机时自动启动应用。目前仅在 Android 上可用。
该参数配置示例:
app-auto-start: [String] 传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
app-auto-start: 1#app-auto-start: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…应用启动时更新订阅
此功能会在每次打开应用时自动更新应用中的所有订阅。
该参数配置示例:
subscription-auto-update-open-enable: [String] 传递方式:
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-auto-update-open-enable: 1#subscription-auto-update-open-enable: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…选定应用的代理(Android)
可以在此参数中指定应使用 VPN 或绕过 VPN 的应用列表。如果应用尚未安装在设备上但已在列表中指定,则在首次安装后连接到 VPN 时会自动将其计入。
该参数配置示例:
per-app-proxy-mode: [off/on/bypass] \\请从三个参数中选择一个
per-app-proxy-list: [com.google.chrome,com.meta.instagram] \\以 ',' 分隔的 appID 列表传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
per-app-proxy-mode: on
per-app-proxy-list: com.google.chrome,com.meta.instagram#per-app-proxy-mode: on
#per-app-proxy-list: com.google.chrome,com.meta.instagram
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…数据包分析(Sniffing)
xray-core 中的 sniffing 用于分析连接的前几个数据包,并自动确定协议(HTTP、TLS、BitTorrent 等)和域名(SNI/Host)。可能会影响微信应用中的媒体加载。默认已启用。\
该参数配置示例:
sniffing-enable: [String] 传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
sniffing-enable: 1#sniffing-enable: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…禁止折叠订阅

此功能禁用折叠订阅的能力:服务器列表始终以完全展开的方式显示。\
该参数配置示例:
subscriptions-collapse: [String] 传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscriptions-collapse: 1#subscriptions-collapse: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Ping 显示模式

允许显示图标而不是时间值\
该参数配置示例:
ping-result: [time,icon]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
ping-result: icon#ping-result: icon
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Mux
Mux 在 xray-core 中是多路复用(multiplexing)功能,允许通过单个物理 TCP 连接传输多个虚拟 TCP 连接的数据。旨在降低 TCP 握手的延迟,而不是提高带宽(甚至可能减慢大量下载)。在出站配置中设置,参数包括 enabled 和 concurrency(最小 -1,最大 1024)。
该参数配置示例:
mux-enable: [true / 1]
mux-tcp-connections: [String]
mux-xudp-connections: [String]
mux-quic: [String]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
mux-enable: 1
mux-tcp-connections: 100
mux-xudp-connections: 200
mux-quic: skip#mux-enable: 1
#mux-tcp-connections: 100
#mux-xudp-connections: 200
#mux-quic: skip
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…代理 \ TUN 模式(仅适用于桌面版)
必须仅使用以下两个参数之一!这些参数在添加/更新订阅时确定连接类型。
该参数配置示例:
proxy-enable: [true / 1]
tun-enable: [true / 1]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
proxy-enable: 1#proxy-enable: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…TUN 模式(仅适用于桌面版)
确定 TUN 连接使用的模式。
system— 使用操作系统的系统网络栈。 快速高效,但依赖于路由和防火墙的正确配置。gvisor— 使用 gVisor 的用户空间栈(userspace)。 减少对内核规则及 iptables/nftables/Docker 冲突的依赖,隔离性更好;可能存在轻微的性能损失。
该参数配置示例:
tun-mode: [system,gvisor]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
tun-mode: gvisor#tun-mode: gvisor
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…选择隧道核心(仅适用于桌面版)
确定将用于 TUN 连接的核心。可选择 sing-box、tun2proxy
该参数配置示例:
tun-type: [singbox, tun2proxy]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
tun-type: tun2proxy#tun-type: tun2proxy
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…排除路由
定义不应通过隧道传输流量的子网和 IP 地址列表。地址在同一行中指定,以空格和逗号分隔。
该参数配置示例:
exclude-routes: [String]传递方式:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
exclude-routes: 192.169.1.0/24, 10.0.0.0/8#exclude-routes: 192.169.1.0/24, 10.0.0.0/8
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Last updated