Skip to content

通用

描述并解释了 sing-box 图形客户端统一实现的功能。

配置文件

配置文件描述了 sing-box 配置文件及其状态。

本地配置文件

  • 本地配置文件代表具有最小状态的本地 sing-box 配置。
  • 图形客户端必须提供编辑器来修改配置内容。

iCloud(iOS/macOS)

  • iCloud 配置文件代表以 iCloud 为更新源的远程 sing-box 配置。
  • 配置文件存储在 iCloud 下的 sing-box 文件夹中。
  • 图形客户端必须提供编辑器来修改配置内容。

远程配置文件

  • 远程配置文件表示以 URL 作为更新源的远程 sing-box 配置。
  • 图形客户端应提供配置内容查看器。
  • 图形客户端必须实现配置文件自动更新(默认间隔为 60 分钟)和 HTTP Basic 授权。

同时,图形客户端必须支持通过特定的 URL 方案导入远程配置文件。URL 的定义如下:

sing-box://import-remote-profile?url=urlEncodedURL#urlEncodedName

仪表板

当 sing-box 服务运行时,图形客户端应提供一个仪表板界面来管理服务。

状态

仪表板应显示内存、连接和流量等状态信息。

模式

当配置使用至少两个 clash_mode 值时,Dashboard 应提供用于切换的模式选择器。

代理组

当配置包括代理组(特别是 SelectorURLTest)时,仪表板应提供一个用于状态显示或切换的组选择器。

杂项

核心

图形客户端应提供核心区域:

  • 显示当前 sing-box 版本
  • 提供清理工作目录的按钮
  • 提供内存限制开关