协议字段与认证信息阅读指南
从协议标记与字段边界入手,区分显示备注、传输设置和需要保护的认证内容。
协议与内核说明按需阅读
导入前先辨认文件语法,再看软件接受哪一类配置。YAML 能把连接条目、分组与分流安排放在一起;Base64 是编码形式,解开后可能是多行连接描述;JSON 则用对象和字段组织设置。能读懂文本不等于认证成功,格式兼容和访问是否可用需要分别判断。
客户端提示语法错误时,先别急着修改连接参数。管理页面可能为不同软件准备不同配置,复制了不相容的类型,就会出现解析中止或列表为空。浏览器展示出的缩进文本与连续字符,也可能只是不同的文件表达方式。
配置入口交付的是文本,语法决定读取方式。识别时可以参考 配置说明页 ,同时核对所用软件的导入要求,避免把编码形式误认为连接协议。
YAML 用层级组织设置。以兼容这类语法的配置为例,运行选项、连接定义、可选出口和匹配顺序可以放在同一文件;因此导入时带进来的不只是连接列表。
| 配置部分 | 负责的事情 | 阅读时留意的内容 |
|---|---|---|
| 运行选项 | 接收本机请求的入口、处理方式与日志详细程度 | mixed-port: 本机端口;mode: rule |
| proxies | 保存单条连接的协议设置与认证字段 | 逐项核对定义,避免把导入成功当成可用证明 |
| proxy-groups | 把可选出口组织成选择范围 | 确认分组采用手动选择还是自动选择 |
| rules | 按排列次序决定请求去向 | 查看哪些请求直接发出,哪些交给选择组 |
规则与出口同时随文件导入,更新配置也可能改变请求去向。要理解匹配过程,可以继续读 分流模式说明。
缩进承担层级含义,手动编辑时混入制表符或全角空格可能破坏语法。保留原文件后再修改,便于出错时恢复。
连续的字母和符号可能是编码后的多行连接描述。解开编码才看得见原始字段,所以仅凭浏览器里显示的外观,无法判断内容是否有效。
解码后若恢复为逐行的连接描述,可以参照 协议字段阅读指南 继续识别内容。
此类列表与完整配置的职责不同:它提供连接条目,分流安排仍可能由客户端另行决定。导入入口的操作可参照 桌面端配置教程。
同一内核的不同配置位置也可能接受不同文本。代理集合能读取某种编码,并不表示图形界面的主配置入口同样支持;应以对应入口的格式要求为依据,避免把不同语法拼在一起。
JSON 配置可用 log、dns、inbounds、outbounds、route 等字段分别描述日志、解析、接收、转发和路由。连接条目与选择逻辑并非只看文件扩展名就能辨认,还需检查字段内容。
字段语法随软件演进可能改变。遇到配置校验失败,应核对当前内核是否认识文件中的写法,而不是直接删去不认识的部分。
图形界面的远程配置入口也有自己的加载要求;可结合 JSON 客户端说明 核对输入类型,不要把 YAML 或编码列表直接当成 JSON 文件。
| 文本类型 | 包含的设置 | 分流安排 | 导入前确认 |
|---|---|---|---|
| YAML 配置 | 运行参数、连接定义、选择分组与匹配条目 | 可随文件提供 | 读取入口是否兼容对应 YAML 语法 |
| Base64 编码列表 | 解码后才能阅读的连接描述 | 需要另外确认 | 是否接受编码列表或解码后的描述 |
| JSON 配置 | 解析、接收、转发及路由字段 | 可写在路由部分 | 内核支持哪些字段和设置 |
| 支持多种输入的软件 | 先辨认内容,再转换为内部设置 | 取决于实际输入 | 不要把支持多格式理解为参数完全兼容 |
对照 配置说明 时,应分别查看内容来源、语法与客户端要求。即使来自同一组连接定义,不同格式也可能省略不支持的参数。操作入口按设备列在 软件使用目录。
转换服务需要读取原配置,才能输出另一种表达方式。决定使用前,先分别考虑访问权限、后续请求去向和参数保留情况。
先检查原提供方是否已经给出所需类型,再考虑可直接读取现有文本的软件。确有转换需求时,可评估在本机处理的方式;凭证已经外传,应查看账户是否支持重置。
文本编辑器打开配置副本检查开头与字段。例如 proxies:以及mixed-port: 体现键与值的写法;若开头是 { ,并且能找到 "outbounds",可进一步按 JSON 语法核对。连续字符则需要先确认是否经过编码。系统自带的 Base64 解码功能,其他终端环境也可使用 本机的解码工具。得到逐行描述后,再检查协议标记和字段是否完整。管理页面可能依据请求方返回不同文本,因此浏览器显示的内容未必和客户端取得的一样。排查时要确认比较的是相同输入。
其他软件可能采用独立语法,现成配置不能仅改扩展名后使用。软件界面、字段支持和导入行为均可能变化,保存原文件并查阅所用版本的说明,有助于区分格式问题与连接问题。

导入前先核对使用条件
安装软件与取得可读取的配置是不同步骤。先确认配置类型、账户限制及软件支持,再查看服务说明;访问表现仍取决于具体网络与使用条件。
不能据此外观下判断。编码后的文本需要先在本机解码;恢复出的字段还要继续检查,能解码只说明编码可还原,并不证明认证或连接有效。
要看导入入口支持的语法。无法识别时,先在提供配置的页面寻找对应类型,或改用兼容原格式的软件,避免反复修改无关参数。
在软件中找到本地文件导入入口,再选取配置副本。本地副本不会因远端内容变化而自行替换,需要重新取得配置后再加载。
检查目标语法是否接受原有协议与参数,再比较转前转后的条目。被略去的内容不一定是原配置失效,也可能是转换方式的限制。
使用前请再次查看参考文本。 界面、条款和规定都可能变化;发现差异可参考纠错说明中的流程说明。
从协议标记与字段边界入手,区分显示备注、传输设置和需要保护的认证内容。
协议与内核说明按需阅读
比较系统时间、软件支持和所在网络,逐项寻找设备之间的不同条件。
故障排查说明按需阅读
先看请求是否进入内核,再结合匹配条目与选择组,理解实际采用的出口。
协议与内核说明按需阅读