OneBox

GitHub Actions build status

基于 sing-box 内核的跨平台 GUI 客户端。

简单高效稳定,不折腾用户,开箱即用。

仅支持 macOS 13.0 及以上版本
OneBox screenshot 1
OneBox screenshot 2
OneBox screenshot 3
OneBox screenshot 4

机场适配指南

订阅链接规范

OneBox 支持标准的 sing-box 订阅格式,并通过特定的 HTTP 响应头获取额外信息。请按照以下规范实现,以确保与 OneBox 客户端完美兼容。

HTTP 响应头

# 服务提供商官网地址
official-website: https://sing-box.net

# 用户流量与到期信息
subscription-userinfo: upload=0; download=58808587680; total=1099511627776; expire=4889654302

subscription-userinfo

遵循 Clash Meta 订阅链接响应头格式,用于显示用户的流量使用情况和到期时间

参数名称数据类型单位说明
upload整数字节用户已上传的流量总量
download整数字节用户已下载的流量总量
total整数字节用户总流量配额
expire整数UNIX 秒订阅到期时间戳

official-website

指向服务提供商的官方网站地址(可选), 默认为:https://sing-box.net

  • 请确保您的网站根目录包含有效的 favicon.ico 文件
  • OneBox 将在客户端界面提供直达官网的快捷入口
  • 用户可通过此链接访问您的控制面板进行续费等操作

客户端 User-Agent

SFM/0.0.26 (macos aarch64 15.5.0; sing-box 1.11.10; language zh-Hans-CN)

User-Agent 包含以下信息:

SFM/0.0.26OneBox 客户端版本
macos aarch64 15.5.0包括系统类型、架构和版本
sing-box 1.11.10当前使用的内核版本号
language zh-Hans-CN当前设置的界面语言
前缀平台标识示例
SFMmacOSSFM/0.0.26 (...)
SFWWindowsSFW/0.0.26 (...)
SFLLinuxSFL/0.0.26 (...)

服务商可根据 User-Agent 识别客户端,提供差异化服务或进行统计分析

一般说明

关于 OneBox 开源客户端的声明

OneBox 开源客户端的宗旨是为用户提供纯净、高效的使用体验。我们承诺:

  • 永远不会内置任何服务商的直接入口和推广
  • 专注于收集用户反馈和建议,持续改进产品体验
  • 我们将用收集的反馈同时改进开源客户端和私有客户端