核心概念：配置文件 (config.json)

Sing-box 的所有行为都由一个 JSON 格式的配置文件控制（通常命名为 `config.json`）。您需要编辑这个文件来定义入站连接（监听端口和协议）、出站协议（连接到服务器的方式）、路由规则（决定流量走向）等。这是最基础也是最灵活的方式。

以下是一个极简的配置文件示例结构：

{
  "log": { // 日志配置
    "level": "info", // 日志级别: debug, info, warn, error, none
    "output": "box.log", // 日志输出文件 (可选)
    "timestamp": true // 是否添加时间戳
  },
  "inbounds": [ // 入站连接配置 (如何接收来自本地应用的连接)
    {
      "type": "mixed", // 混合端口，可同时处理 SOCKS 和 HTTP
      "listen": "127.0.0.1", // 监听地址 (127.0.0.1 表示仅本地)
      "listen_port": 1080, // 监听端口 (常用 SOCKS 端口)
      "sniff": true // 流量嗅探，用于更精确的规则匹配
    }
  ],
  "outbounds": [ // 出站连接配置 (如何连接到代理服务器)
    // --- 在这里添加您的服务器配置 ---
    // 示例: VLESS over TCP with TLS
    // {
    //   "type": "vless",
    //   "tag": "proxy-server-1", // 给这个出站起个名字
    //   "server": "your_server_address",
    //   "server_port": 443,
    //   "uuid": "your_uuid",
    //   "network": "tcp",
    //   "tls": {
    //     "enabled": true,
    //     "server_name": "your_server_domain", // SNI
    //     "insecure": false // 是否验证证书
    //     // "utls": { "enabled": true, "fingerprint": "chrome" } // 可选: uTLS 指纹模拟
    //   },
    //   "flow": "xtls-rprx-vision" // 如果服务器支持 Vision流控
    // },
    // ---------------------------------
    {
      "type": "direct", // 默认直连出站 (必须有)
      "tag": "direct"
    },
    {
      "type": "block", // 默认阻止连接出站 (必须有)
      "tag": "block"
    }
  ],
  "route": { // 路由规则配置
    "rules": [
      // --- 在这里添加您的路由规则 ---
      // 示例: 域名匹配规则 (将 example.com 流量走代理)
      // {
      //   "domain_suffix": [".example.com", "example.org"],
      //   "outbound": "proxy-server-1" // 匹配则使用名为 'proxy-server-1' 的出站
      // },
      // 示例: GeoIP 规则 (将中国大陆 IP 流量直连)
      // {
      //   "geoip": ["cn"],
      //   "outbound": "direct" // 匹配则使用名为 'direct' 的出站
      // }
      // ------------------------------
    ],
    "final": "proxy-server-1" // 默认规则 (未匹配任何规则的流量走向, 通常设为代理)
    // "auto_detect_interface": true // 自动检测出口网络接口
  }
}

注意：这是一个基础模板，您需要根据您的服务器信息填充 `outbounds` 部分，并根据需求配置 `route` 规则。详细配置项请参考 Sing-Box 官方文档。

核心概念：订阅链接

许多代理服务提供商会提供一个“订阅链接”（通常是一个 URL）。这个链接包含了多个服务器的配置信息，通常是 Base64 编码的。

• **GUI 客户端:** 大多数图形界面客户端 (如 SagerNet, Stash, Clash Verge 等) 支持直接导入订阅链接。客户端会自动下载链接内容，解析服务器信息，并可能将其转换为内部配置格式或直接生成 `config.json` 的一部分。这是最方便的方式。
• **命令行核心:** Sing-box 核心本身不直接处理订阅链接。您需要：
  • 手动访问订阅链接，获取其内容（通常是一长串 Base64 编码的文本）。
  • 使用在线或本地的“订阅转换”工具，将订阅内容转换为 Sing-box 支持的 `outbounds` JSON 片段。
  • 将转换后的 JSON 片段手动粘贴到您的 `config.json` 文件的 `outbounds` 数组中。
• 一些第三方工具或脚本可以帮助自动化这个过程。

分平台简明指南 (重点与常用工具)

常见错误排查

• 无法连接/超时:
  • 检查服务器地址、端口、UUID/密码等配置是否准确无误。
  • 确认服务器本身是否在线、可用。
  • 检查本地防火墙或杀毒软件是否阻止了 sing-box 或其连接。
  • 确认本地网络环境是否正常。
  • (TLS 相关) 检查域名、SNI 是否正确，证书是否有效 (如果 `insecure` 为 false)。
  • (TLS 相关) 尝试更换 uTLS 指纹 (如 "chrome", "firefox", "randomized")。
• 配置加载失败/启动错误:
  • 仔细检查 `config.json` 的语法。JSON 要求严格的逗号、括号、引号匹配。使用 JSON 校验工具检查。
  • 查看 sing-box 启动时的日志输出 (`log` 配置项)，通常会提示具体的错误信息。
• 可以连接但无法上网:
  • 检查系统代理设置是否正确指向 sing-box 的入站监听地址和端口。
  • 检查路由规则 (`route` 配置) 是否合理，是否将需要的流量导向了代理出站 (`outbound`)。检查 `final` 默认规则。
  • 检查 DNS 配置（可在 `config.json` 中指定 DNS 服务器）。
• 端口冲突:
  • 错误日志通常会提示 "address already in use"。
  • 修改 `config.json` 中 `inbounds` 的 `listen_port` 为一个未被占用的端口。
• 订阅更新失败 (GUI):
  • 确认订阅链接是否仍然有效、未过期。
  • 检查网络连接是否能访问该订阅链接。