OneBox
基于 sing-box 内核的跨平台 GUI 客户端。
简单高效稳定,不折腾用户,开箱即用。
仅支持 macOS 13.0 及以上版本
提示当前为公测版本,只支持 sing-box 的机场订阅链接。




机场适配指南
订阅链接规范
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.26 | OneBox 客户端版本 |
macos aarch64 15.5.0 | 包括系统类型、架构和版本 |
sing-box 1.11.10 | 当前使用的内核版本号 |
language zh-Hans-CN | 当前设置的界面语言 |
前缀 | 平台标识 | 示例 |
---|---|---|
SFM | macOS | SFM/0.0.26 (...) |
SFW | Windows | SFW/0.0.26 (...) |
SFL | Linux | SFL/0.0.26 (...) |
服务商可根据 User-Agent 识别客户端,提供差异化服务或进行统计分析
一般说明
关于 OneBox 开源客户端的声明
OneBox 开源客户端的宗旨是为用户提供纯净、高效的使用体验。我们承诺:
- 永远不会内置任何服务商的直接入口和推广
- 专注于收集用户反馈和建议,持续改进产品体验
- 我们将用收集的反馈同时改进开源客户端和私有客户端