sing-box 常见问题

sing-box 是一款开源的通用代理平台，支持多种代理协议、流量分流和 DNS 配置，可用于搭建代理客户端或服务端。

sing-box 项目本身免费开源。如果使用第三方提供的节点或订阅服务，可能需要另外付费，费用和服务规则由对应服务商决定。

不自带。使用代理功能时，需要自行配置服务器，或从服务提供方获取兼容的节点信息、订阅链接或配置文件。

sing-box 可以在 Android、iOS、macOS、Windows、Linux 等平台使用。不同平台的安装方式、客户端界面和可用功能有所差异，请通过官方文档选择对应版本。客户端下载与说明

sing-box 核心负责处理代理连接、路由和 DNS 等功能；图形客户端提供配置导入、服务启停和节点选择等操作界面。第三方客户端支持哪些功能，还取决于其自身实现和内置核心版本。

不能直接将 Clash 的 YAML 配置作为 sing-box 原生配置使用。sing-box 使用 JSON 配置格式，应获取适配 sing-box 的配置，或通过可信工具转换并检查兼容性。仅修改文件后缀无法完成转换。配置文件说明

常见支持的协议包括 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 和 TUIC 等。具体可用协议及参数以客户端内置的 sing-box 版本和构建选项为准。查看最新版sing-box下载。

节点是一组服务器连接信息；订阅链接用于获取和更新节点信息或完整配置；配置文件则描述客户端如何运行，通常还包含 DNS、分流规则和节点选择方式。订阅链接返回的内容不一定能被所有客户端直接识别。

通常可在客户端的配置管理页面导入本地文件，或添加远程配置链接。单节点分享链接、二维码和批量订阅的导入能力取决于客户端，请优先使用服务提供方给出的 sing-box 专用配置。配置管理说明

常见原因包括链接失效、访问验证失败、当前网络无法访问订阅地址，或返回内容与客户端不兼容。请确认链接完整有效，并检查是否误用了其他客户端的订阅格式；仍然失败时，可查看错误提示并联系服务提供方。

可能是服务器离线、连接参数错误、当前网络限制，或服务套餐已到期。建议先更新订阅，再切换其他节点，并分别尝试 Wi-Fi 和移动网络，以判断问题来自单个节点还是当前网络环境。

不一定。延迟主要反映响应时间，下载速度还受带宽、线路拥堵、丢包和服务器负载影响。选择节点时，应结合网页打开速度、视频播放和实际下载表现判断。

可以通过 URLTest 策略组定期测试候选节点，并依据测试结果自动选择。该功能需要配置中包含对应策略组；测试主要反映指定测试地址的连接表现，不代表所有网站的访问速度。自动测试说明

目标网站可能仍通过直连或其他策略组访问，也可能继续使用已有连接。请确认该网站对应的分流规则，再重新建立连接。网站显示的地区还可能受账号资料、定位权限和 IP 数据库影响。

安装适合设备的客户端，导入兼容配置，选中需要使用的配置并启动服务。若系统提示添加 VPN 配置，请按提示授权；随后根据配置选择节点，并打开目标网站检查连接是否正常。对于刚接触的用户而言，推荐查看本站使用教程快速入门篇，快速上手使用。

在 Go 1.17 之前, Go 编译器总是生成任何 64 位 x86 处理器都可以执行的 x86 二进制文件.
Go 1.18 引入了 AMD64 的 4 个架构级别. 每个级别都有不同的x86指令集, 编译器可以在生成的二进制文件中包含这些指令:
GOAMD64=v1 (默认) : 基线. 仅生成所有 64 位 x86 处理器都可以执行的指令.
GOAMD64=v2: 所有 v1 指令, 加上 CMPXCHG16B、LAHF、SAHF、POPCNT、SSE3、SSE4.1、SSE4.2、SSSE3.
GOAMD64=v3: 所有 v2 指令, 加上 AVX、AVX2、BMI1、BMI2、F16C、FMA、LZCNT、MOVBE、OSXSAVE.
GOAMD64=v4: 所有 v3 指令, 加上 AVX512F、AVX512BW、AVX512CD、AVX512DQ、AVX512VL.
例如, 设置 GOAMD64=v3 将允许 Go 编译器在生成的二进制文件中使用 AVX2 指令 (这可能会在某些情况下提高性能) ；但是这些二进制文件将无法在不支持 AVX2 的旧 x86 处理器上运行.
Go工具链也可能生成较新的指令, 但会存在动态检查保护, 确保它们只在有能力的处理器上执行. 例如在 GOAMD64=v1 的情况下, 如果 CPUID 报告说 POPCNT 指令可用, math/bits.OnesCount 仍将使用该指令. 否则, 它就会退回到一个通用的实现.
Go 工具链目前不会生成任何 AVX512 指令.
请注意, 在这种情况下, 处理器是一个简化. 实际上, 整个系统 (固件、hypervisor、内核) 都需要支持.

部分平台通过系统的 VPN 接口接管设备流量，这是实现 TUN 代理的方式。是否通过远程节点访问，仍由配置中的分流规则决定；出现 VPN 标识并不代表所有流量都会走代理。TUN 配置说明

规则模式按配置决定哪些连接走代理、哪些直连；全局模式通常将接管的流量交给代理；直连模式通常让其直接连接。模式入口及实际行为由客户端和配置共同决定，并非所有配置都提供这三种模式。模式与面板说明

系统代理主要影响遵循系统代理设置的应用；TUN 模式通过虚拟网络接口接管流量，通常能覆盖更多应用。若某个应用不遵循系统代理设置，可检查客户端是否支持 TUN 模式，并确认相关路由配置正确。客户端代理说明

“已连接”通常只表示本地服务已启动，不代表节点和 DNS 都正常。建议依次检查基础网络、节点可用性、DNS 和分流规则，并查看日志中的具体错误。也可以先换一个节点，判断是否为单节点故障。

可能是分流规则不匹配、DNS 解析异常、目标服务限制当前出口 IP，或应用流量没有被接管。可先切换节点测试，再检查对应连接使用了哪条规则；若网页正常而语音、游戏异常，还需检查 UDP 支持情况。

锁屏后的断连可能与省电策略、后台限制有关；切换 Wi-Fi 和移动网络时，已有连接也可能需要重新建立。可检查客户端的后台运行权限和电池设置；若未自动恢复，尝试重新连接并查看日志。

能否共存取决于操作系统和连接方式。多个应用同时接管 VPN 接口、系统代理或路由，可能造成冲突。遇到无法连接或网络异常时，建议先关闭其他 VPN 或代理应用，再单独测试 sing-box。

新版本可能调整、弃用或移除旧配置字段。升级前建议备份配置；出现错误时，应根据日志和官方迁移文档修改配置，或向服务提供方获取适配当前版本的配置。配置迁移指南

请提供设备系统、客户端名称、核心版本、错误提示、问题发生时间和复现步骤，必要时附上相关日志。分享前请隐藏订阅链接中的令牌、密码、UUID、私钥等敏感信息，以免他人使用你的服务。