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

阅读顺序

先装好对应平台的图形客户端，再按这篇走：判断配置类型 → 添加配置 → 选中并启动 → 验证访问 → 需要时选节点、刷新或停止。平台安装和权限差异见各平台篇，本篇不重复讲安装包。

1. 先判断手里是哪种配置

• 远程配置：一个 URL，客户端每次刷新都会重新下载它返回的完整 sing-box 配置。适合配置会定期变动的场景，前提是提供方明确支持 sing-box。
• 本地配置：一份已经保存在设备上的完整 JSON，客户端通过本地配置功能录入或编辑。远程源变了，本地这份不会跟着变。
• 不能直接用的三种：Clash YAML、Base64 节点列表、单条分享链接。它们都不是完整的 sing-box JSON，导进去只会报格式错。优先向提供方要 sing-box 格式；实在要转换，也要转换后逐项核对节点、DNS、路由和内核版本，并且不要把带账号凭据的订阅地址随便提交给不熟悉的在线转换站。

另外注意：不要把“下载软件的网页地址”填进配置 URL，那个地址返回的是网页，不是配置。

2. 添加远程配置或本地配置

不同平台的入口名字不一样，有的叫 Profiles，有的叫配置、配置列表或新建配置，位置也不完全相同，但要填的东西是一样的：

• 起一个自己能认出来的名字，名字不决定格式，只是方便区分多份配置。
• 有配置 URL 时，把类型选为“远程”，填完整地址；需要认证时，按提供方要求填认证信息，不要猜。
• 需要自动更新时，再开自动更新并设一个间隔；不开，客户端就不会主动去拉新配置。
• 保存后，先确认这条配置出现在列表里。保存成功不等于能运行，下载失败要先看下载错误，不要跳到连接排查。

本地配置则按客户端提供的录入或编辑功能，把完整 JSON 保存下来；不要只粘贴一半，也不要把服务端那份入站配置直接当客户端配置导入，两边字段用途不同。

3. 选中、启动，再验证

回到主界面或仪表盘，选中刚保存的那一份，点启动。首次启动弹出的 VPN 或系统权限要点允许，拒绝必要权限，服务就建不起来。

只看“运行中”“有计时”“有流量面板”还不够，那只能说明服务在跑。还要做一次真实验证：打开浏览器或目标应用，访问一个需要走代理的目标，看能不能打开、流量有没有变化。能打开普通网页，也不单独证明走了你预期的出站，还要结合当前选中的出站、路由或连接记录一起看。

4. 分组里怎么选节点

如果配置里定义了 Selector 或 URLTest 分组，客户端会给出组列表：

• Selector 是手动选：你点哪个出站，就走哪个。
• URLTest 是按配置里的测试规则自动选：它会测延迟再决定，不用你一个个点。

没有组列表，不一定是导入失败。单一出站的配置本来就没有可切换的列表。同样，模式开关也不是每份配置都有：只有配置用了两个以上的 clash_mode 值时，才会出现对应的模式选择。先确认自己的配置应不应该有这些入口，再判断是不是出问题。

5. 刷新配置、更新客户端、停止服务

这三件事要分开：

• 刷新配置：重新下载远程 URL 返回的内容。刷新成功不保证新配置兼容、节点在线，刷新完还要重新选中、启动、验证。
• 更新客户端：换一个新版本的客户端。升级前备份配置，并看版本变更说明；旧字段在新版本里报错时，按目标版本调整，不要只删掉报错字段硬启动，删 DNS 或路由字段会改变流量处理方式。
• 停止服务：不用时点停止，再确认需要直连的访问恢复了。桌面端只关窗口不一定等于停止，有的客户端还会留在托盘里继续运行，留意托盘图标。

求助时，准备好系统、客户端与内核版本、失败步骤和脱敏后的错误提示；远程地址里的令牌、节点密码不要公开。