辨认配置文本的语法与读取方式
辨认层级文本、编码列表和 JSON 对象,再核对当前软件接受的导入类型。
协议与内核说明按需阅读
连接描述开头的协议标记决定软件采用哪种解析方式。后面的内容可能包括认证信息、目标主机、传输参数和显示备注,也可能先被整体编码。编码只是文本表达方式;完整配置包含使用权限,公开展示前应遮去认证内容与主机信息。
长字符串导入后变成连接条目,是因为软件按协议标记读取其中字段。出错时先判断开头属于哪种语法,再查看认证与传输设置,能避免只在末尾反复修改备注。
阅读字段也有助于保护权限:看似普通的文本可能已经包含完整认证信息。演示时应使用字段名称表达结构,不应把真实配置公开展示。
分隔符前面的 scheme 是解析线索。同样采用网址外观的描述,后续字段也可能因协议不同而变化。
| 标记 | 表示的协议 | 身份字段位置 | 查阅方向 |
|---|---|---|---|
| ss | Shadowsocks | 主机之前的用户信息部分 | 对应的 URI 格式规范 |
| vmess | VMess | 可能整体编码,也可能在主机前写身份字段 | 维护说明与 URL 格式提案 |
| vless | VLESS | 主机前的身份标识 | 相关 URL 格式提案 |
| trojan | Trojan | 主机前的认证内容 | 连接描述工具的格式说明 |
| 项目约定的完整标记或缩写 | Hysteria 协议 | 主机前的认证字符串 | 项目的 URI 说明 |
许多描述按认证、主机、端口、附加参数和备注依次组织。参数之间使用 & 等分隔符;遇到带冒号的主机表示法,还要注意方括号等语法要求。
用户信息可以把算法和密码组合起来,也可能经过编码;插件参数和显示备注则处于其他位置。阅读时先找字段边界,再决定是否解码。
结构示意:协议标记、用户信息、主机与端口、备注
编码可还原为可读内容,因此不能隐藏密码。不同加密系列可能规定不同的字段表示方式,不能把一种写法照搬到所有配置。
某些旧格式解码后是 JSON 对象,可以按字段职责阅读,而不是把整段内容当成密码。
另一些描述直接采用 URL 字段排列,可概括为 协议标记 → 身份字段 → 主机与端口 → 参数 → 备注。相同开头不保证后面的结构相同,需要让软件按其支持的语法读取。
身份字段之外,安全方式、传输方式及对应选项需要相互匹配。手动编辑时,应先确认参数属于哪个功能。
| 字段名 | 表达的设置 | 核对重点 |
|---|---|---|
| encryption | 协议的加密选项 | 查看所用格式的默认处理 |
| flow | 连接采用的流控设置 | 确认远端是否要求启用 |
| type | 底层传输类型 | 不要自行猜测省略时的行为 |
| security | 连接采用的安全方式 | 与远端设置对应 |
| sni、fp、alpn | 握手域名、指纹和应用层协议 | 分别核对所用安全方式的要求 |
| pbk、sid、spx | 相关安全模式使用的公钥、标识及路径 | 检查必要字段是否齐全 |
| path、host、serviceName | 不同传输方式所用的路径、域名或服务名 | 按实际传输类型选择字段 |
参数值中的特殊字符需要正确编码。启用了特定安全方式却遗漏必需字段,可能导致读取成功后仍无法连接。
这类描述的主体可以理解为 认证内容 → 远端位置 → 传输选项。即使握手过程使用哈希,完整描述里保留的认证内容仍然需要保护;外传后不能指望传输中的处理阻止别人使用。
项目文档的连接描述可分成 协议、认证、主机、端口、参数和显示名称。有些协议允许端口跳跃,也带有混淆和证书校验选项;本机代理模式等设置则需另行配置。涉及 UDP 的网络条件,可阅读 UDP 使用说明。
认证信息可能直接可读,也可能藏在能够还原的编码中。拿到完整内容的人可能以相同身份发起请求,因此不能把编码后的文本当成安全截图。
求助时,应遮去认证字段和主机内容;成组配置的权限范围还可能更广,详见配置格式与转换说明。服务方能够接触的信息可另查通信隐私说明。
系统解码工具查看原始内容;不同编码变体的字符与补位规则要分别确认。
导入前先核对使用条件
安装软件与取得可读取的配置是不同步骤。先确认配置类型、账户限制及软件支持,再查看服务说明;访问表现仍取决于具体网络与使用条件。
可以先建立安全传输,再发送用于身份核对的信息与目标内容。部分实现会把认证不符的请求转给预设网页服务,因此错误表现还需结合日志理解。
前者把单条连接的设置放进文本,后者由客户端请求远端取得成组内容。两者都可能携带使用权限,均应避免公开展示。
这可能是文本为适应 URL 语法而采用的编码。先看导入后的显示是否正常;手动编辑时也应遵循对应编码规则,避免破坏字段边界。
别人可能用相同凭证消耗账户资源,也可能触发使用限制。是否允许共享取决于服务条款,公开前应先保护认证内容。
使用前请再次查看参考文本。 界面、条款和规定都可能变化;发现差异可参考纠错说明中的流程说明。
辨认层级文本、编码列表和 JSON 对象,再核对当前软件接受的导入类型。
协议与内核说明按需阅读
区分加密通信内容与连接信息,理解代理服务在转发过程中可能接触的范围。
安全与风险说明按需阅读
先确认应用是否使用 UDP,再核对客户端与出口是否支持相应转发。
协议与内核说明按需阅读