路由

该应用内置了预装的 Geo 文件,确保安装后即可立即使用。Geo 文件的有效性通过更新应用内的核心版本来保持。

添加路由规则

应用支持通过专用链接自动添加路由规则,这些链接可在 https://routing.happ.su 网站上生成。链接可以通过以下任一方式传递:

  • 通过剪贴板

  • 使用深度链接

  • 扫描二维码

  • 作为 HTTP 头或订阅正文的一部分

对于 HTTP 头,将使用路由参数;而在订阅正文中,只需包含链接即可。

处理下载错误

应用使用一个在后台运行的 Geo 文件下载管理器:

  • 如果 Geo 文件下载在 3 分钟内未完成,则下载过程会被终止。

  • 主屏幕上会显示一条错误信息。

  • 配置列表中有问题的配置旁边会显示一个红色感叹号。

故障排除

有问题的配置状态将在以下情况下自动恢复:

  • 文件下载成功完成。

  • 删除有问题的配置。

当配置列表中不再存在有问题的配置时,错误通知将被移除。

链接类型

  • happ://routing/add/{base64}: 向配置列表中添加一个配置文件。首次添加的配置在 Geo 文件成功下载后才会激活。如果已存在同名配置,则会被覆盖。

  • happ://routing/onadd/{base64}: 添加并自动激活配置文件,即使其他配置已处于激活状态。如果已存在同名配置,则会被覆盖。

  • happ://routing/off: 禁用路由功能

其中,{base64} 是将 JSON 格式的配置文件转换为 Base64 编码文本后的结果。

配置文件结构

应用使用通过 JSON 配置的路由配置文件。默认配置文件包含用于补全缺失或不正确参数的基本设置。

示例默认配置文件:

示例自定义配置文件:

配置文件管理功能

  • 如果已存在同名配置文件,则其数据将被更新。

  • 即使配置文件每小时更新一次,Geo 文件每周最多只更新一次。

  • 如果配置文件中包含 "LastUpdated": "" 参数,并且新值(unix 时间格式)高于之前的值,则更新生效。

示例 HTTP 头信息:

示例订阅正文:

Last updated