sing-box 使用教程：各平台客户端导入与配置文件

选梯子编辑部 · 更新于 2026-10-09

使用教程客户端教程难度：高级约 10 分钟读完

sing-box 教程要先讲清一个和其他客户端不同的事实：sing-box 不靠“订阅”工作，而靠一份 JSON 配置文件。官方图形客户端提供“远程配置”，可以从一个链接下载这份文件并定期更新，但前提是链接返回的内容本身就是 sing-box 能读的配置。机场给的是通用格式或 Clash 格式时，需要另寻他路。下面按这个思路，讲各平台怎么导入、配置文件长什么样、怎么检查。

sing-box 教程第一步：分清内核和客户端

sing-box 既是一个通用的代理内核，也有官方提供的图形客户端。再加上一批基于它的第三方应用，搜索资料时很容易混在一起。

客户端的获取渠道和界面会变，请以官方文档里的客户端页面为准。内核与各平台客户端的下载入口，汇总在sing-box 下载页。

另一类是第三方客户端，例如 Hiddify、Karing、NekoBox for Android。它们使用 sing-box 作为内核，但自己做了界面，并且通常能直接解析机场的订阅，对新手门槛低得多。“内核”和“客户端”的分工，见代理内核这条术语。如果你只是想把订阅导入用起来，可以先看Hiddify 使用教程，不必直接面对配置文件。

sing-box 配置文件里有什么：六个顶层区块

打开一份 sing-box 配置，最外层是几个并列的区块。读懂这张表，你就能看出任何一份配置的大致结构。

几点需要注意。

• 节点和策略组都放在出口里。 与 Clash 不同，sing-box 没有单独的策略组区块，而是用特定类型的出口把节点编成组，类型名以官方文档为准。策略组的通用概念见策略组怎么用。
• 字段随版本调整。 旧配置放到新内核上，可能报字段错误或行为变化。官方文档的迁移说明会列出改动，升级前对照看一遍。
• 每个字段的写法，都以官方配置文档对应的版本为准，本文不逐项展开。

配置里包含节点的地址和密码，等同账号凭证。贴到论坛或问题区求助之前，先把这些字段替换成占位内容。

官方图形客户端怎么导入：用“远程配置”

官方图形客户端（安卓、苹果平台，以及桌面端），导入订阅走“配置”页里的远程配置，桌面端的界面以官方文档为准。按钮叫什么随版本而变，但流程是固定的：

1. 打开应用，进入配置相关的页面（常见叫法“配置”或 Profiles），点加号新建。
2. 配置类型选“远程”（Remote），而不是本地。
3. 填名称，在链接栏粘贴 https://example.com/你的订阅链接，要求这个链接返回的是 sing-box 格式。
4. 如果有自动更新的开关或间隔，按需打开。
5. 保存并更新，成功后回到首页选中这份配置，点启动。首次启动时，安卓会弹出系统的 VPN 权限窗口，苹果设备则提示添加 VPN 配置，都点允许。

配置类型大致有这几种，以界面为准：

怎么判断链接返回的是不是 sing-box 格式？在浏览器里直接打开它，看返回内容的开头：

这一步只花几十秒，却能避免很多无谓的排查。

机场没有 sing-box 订阅怎么办：三条路的取舍

这是 sing-box 用户最常遇到的拦路虎。可选的做法如下：

决策可以这样走：

• 你只想用起来，不想研究配置：选第二条，直接换客户端。
• 你喜欢掌控配置、愿意长期维护：先试第一条，没有再考虑第三条。
• 必须转换时：优先在自己掌控的环境里做，并在转换后检查节点数量和关键字段有没有丢失。转换这条路的利弊单独写在订阅转换是什么，地址一旦外泄要怎么补救，看订阅链接泄露了怎么办。

不要为了迁就 sing-box 而把订阅链接交给来路不明的转换网站。通用的订阅知识见订阅链接怎么用。

桌面端用命令行：先校验，再运行

Windows 和 Linux 上，最直接的用法是运行内核。把配置文件放在内核旁边，先校验再启动：

sing-box check -c config.json
sing-box run -c config.json

check 命令只检查配置的语法和字段是否合法，不会真的联网。有报错时，输出会指出出问题的位置，改到不再报错再运行。

几点注意：

• TUN 入口通常需要更高权限。 在 Windows 上用管理员身份运行终端，在 Linux 和 Mac 上用具备相应权限的账户，概念见TUN 模式是什么。
• 本地代理端口以配置为准。 如果你在入口里开了本地代理端口，浏览器和其他程序要指向这个端口，数字以你的配置为准。
• 从最小的配置开始。 先只写一个入口、一个节点和一条路由，确认能通，再逐步添加 DNS 和规则。一次写太多，出错时无从查起。
• 要长期使用的话，想想你是否真需要手写配置。命令行方式灵活，但维护成本由你自己承担。

验证生效与常见卡点

按下面的顺序核对。

1. 校验配置。 命令行用户先跑 check，图形客户端用户看导入后有没有报错提示。
2. 看日志。 把日志级别调到能看到出站信息，访问一个网站后确认请求走了哪个出口。
3. 对比出口 IP。 启动服务前后各查一次出口 IP，与日志里显示的出口互相印证；两边一致，才能说这份配置确实在转发流量。
4. 国内外各试一个。 国内网站应当直连，国外网站应当走代理。国内网站变慢，多半是路由规则没有把它分出去，见开了梯子国内网站变慢。
5. 断开再看。 停止服务，国外网站应当打不开，否则还有别的代理在生效。

卡点汇总：

配置校验通过、日志也没有报错却依然不通，就转去梯子连不上怎么办，从外围网络重新排查。

下一步：按你的目标，选一条最短的路

• 想先用起来： 不必直接面对配置文件，按这篇 sing-box 教程的第一节了解区别后，改用Hiddify 使用教程里的一键导入。
• 想理解配置并长期维护： 读官方文档的配置部分，从一份最小配置开始，每次只加一个功能。
• 关心协议怎么选： 先看机场协议怎么选，再确认套餐支持什么。
• 还没有机场： 从机场推荐开始，买之前确认套餐提供 sing-box 或你所选客户端能解析的订阅格式。

sing-box 的官方客户端只认自家格式，所以买机场前先确认能否拿到 sing-box 格式的地址；下方数据块仅作资料，价格以官方页面为准。

接着读

• 使用教程 · 订阅转换是什么？格式不兼容时的处理与风险
• 使用教程 · TUN 模式是什么？什么时候该开、怎么开
• 使用教程 · Hiddify 使用教程：一键导入订阅与模式选择
• 术语 · 代理内核是什么意思
• 选购指南 · 机场协议怎么选？VLESS、Trojan、Hysteria2 对照
• 使用教程 · 订阅链接怎么用？机场订阅导入各客户端的通用方法

文中出现的术语

• 代理内核
• 落地节点
• 分流
• TUN 模式
• 策略组
• 直连