教程

• sing-box 是什么：先分清四个东西

  sing-box 是开源的通用代理平台；客户端、内核、配置、节点是四个不同的东西，混了就会一直装错。

• 新手第一步：先有配置，再装客户端

  顺序反了就会“装好了却连不上”。按这张清单走：配置、安装、导入、选中、启动、验证。

• 通用教程：添加配置、选节点、刷新与停止

  各平台共通的操作主线：远程或本地配置怎么加、分组里的节点怎么选、刷新和停止分别是什么意思。

• Windows 安装：SFW 图形版和命令行内核别装反

  新手优先装 SFW 的 EXE 图形安装程序；ZIP 是命令行内核，没有界面，适合进阶用户。

• Android 安装：SFA 的 APK 怎么选

  官方发行页找 SFA 开头的 APK；不确定架构就选 universal，Google Play 也是官方渠道之一。

• iOS 与 macOS 安装：商店版和 SFM 各走各的路

  iOS 只能走 App Store，商店地区和上架状态会影响下载；macOS 优先用 SFM 官方独立版，升级前先备份。

• macOS 安装：SFM 独立版与升级迁移

  macOS 优先用 SFM 官方独立版；1.14 换了新应用后旧配置不会自动继承，升级前一定要先备份。

• Linux 安装：SFL 图形版和内核包用途不同

  桌面用户优先找 SFL 图形版；服务器或脚本用户用对应发行版与架构的 sing-box 内核包。

• 配置格式：为什么 Clash YAML 不能直接导入

  Clash YAML 和 sing-box JSON 是两种格式，字段和结构都不一样；正确做法是向提供方要 sing-box 格式。

• 连不上的排查：按阶段找原因

  别一上来就重装。先分清卡在下载配置、启动服务还是访问目标，再看那一阶段的常见原因。

• 服务端入门：自己搭一个 sing-box 服务

  面向有 Linux 服务器管理经验的人：用官方安装脚本装内核、写一份 Shadowsocks 2022 入站配置、走 systemd 检查与启动。

• 第三方客户端说明：GUI for SingBox 别和官方版混着用

  GUI for SingBox 是第三方软件，不是官方 sing-box for Desktop；内核要单独装，系统代理要单独开，步骤不能照搬官方版。

• 其他客户端一览：官方版之外的选择

  新手先用官方客户端；需要别的订阅格式或界面时，再看这些基于 sing-box 或多内核的客户端，并注意维护状态。

• 版本与升级：怎么看更新、怎么安全升级

  版本以 GitHub 发行页为准；升级前备份、看变更说明，几个已移除或弃用的旧功能要单独注意。

• 手写本地配置：从最小结构到完整配置

  按官方配置结构一步步加：log、dns、inbounds、outbounds、route；先跑通最小版，再加分组、DNS 与规则。

• DNS 与规则集：解析走哪台服务器，分流靠哪套规则

  DNS 规则管解析、路由规则管出站；规则集分 inline、本地与远程三种，旧 GeoIP 写法要迁到规则集。

• TUN 与系统代理：三种接管方式怎么选

  系统代理只接管走代理设置的流量，TUN 接管整台设备的 IP 流量，VPN 模式是手机上的 TUN 形态；不要同时开两个。

• 日志定位问题：先看第一条错误，再改配置

  日志级别、输出位置、check 与 format 命令怎么用；常见报错按字段、端口、权限、版本四类查。