PuppyIP 资源中心
网络与连接排错 9 分钟 发布于 2026-11-17

Realm systemd 服务读取了错误配置:核对 ExecStart、工作目录与格式

Realm 服务单元能启动并不代表加载了预期配置;将 ExecStart、工作目录、配置文件内容和版本逐项对照。

Realm systemd ExecStart TOML JSON TCP 中继

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • systemd unit 的 ExecStart 和 WorkingDirectory 决定服务运行哪个二进制、使用哪份配置及其相对路径解释。
  • 文件扩展名不证明内容格式,当前 Realm 二进制的版本/帮助和对应文档才是判断依据。
  • 修改 unit 或配置前备份并确认维护入口;daemon-reload 与服务 restart 会改变运行中的转发。
  • TCP 监听成功不证明 VLESS 客户端、认证、加密层或 UDP 转发已通过端到端验收。

先判断服务加载的是哪份配置

Realm 服务若显示 active 但没有预期端口监听,或端口监听与配置不一致,先检查 systemd 的实际执行命令。ExecStart 可能指向另一份 Realm 二进制或旧配置路径;WorkingDirectory 则会影响相对路径解析。服务状态为 active 只说明进程状态,不证明进程读取了期望文件或成功建立所有转发规则。

不要仅根据 config.toml、config.json 或文件名推断解析格式。不同 Realm 分支、版本和打包方式可能有不同的命令行选项与配置语法。需要以正在运行的二进制版本、其帮助信息和该版本对应文档为准;如果 unit 指向 fork 二进制,不能默认套用上游示例。

只读检查 unit、进程和当前监听

先用 systemd 查看 unit 内容、ExecStart、WorkingDirectory、用户和启动结果,再查看运行进程与预期 TCP 端口监听者。将 unit 名和端口占位符替换为实际值。systemctl cat 可能包含路径或参数,journal 也可能包含域名与上游地址,分享前应脱敏。

同时从命令行调用当前 Realm 二进制的版本和帮助信息,确认它实际支持哪些参数与配置入口。不要同时检查多个可能混淆的二进制,也不要在排查时执行安装脚本或重新下载安装器。

读取 Realm unit、进程和端口状态

sh
UNIT='REPLACE_WITH_REALM_SYSTEMD_UNIT'
systemctl cat "$UNIT"
systemctl show "$UNIT" -p ExecStart -p WorkingDirectory -p User -p ActiveState -p SubState
systemctl status "$UNIT" --no-pager
ss -ltnp | grep -E ':(REPLACE_WITH_CONFIGURED_PORT)([[:space:]]|$)'
在服务器上只读检查已确认的 systemd unit 和 TCP 端口;将占位符替换为实际值,分享输出前遮盖私有路径、域名和上游地址。

核对二进制版本、配置路径和实际格式

确认 unit 的 ExecStart 指向当前安装的 Realm 二进制,再读取它报告的版本与帮助。用绝对路径打开 unit 指定的配置文件,检查文件是否存在、非空且内容确实符合该版本支持的 TOML 或 JSON 语法。扩展名和 YAML/TOML/JSON 文件内容不能互相替代;不要把某一格式文件重命名后就认定已经转换。

若服务工作目录与预期不同,相对路径可能指向别处。将配置路径改为 unit 明确引用的绝对路径,或在配置和 unit 中一致地设置工作目录;修改前先确认目标文件和服务账户读权限。不要打印或粘贴包含代理用户名、密码、私钥、节点地址或 UUID 的整份配置。

用备份修正最小的不一致项

如果已确认 unit 引用错配置文件,只修正该路径;如果实际配置语法不被该二进制支持,使用匹配版本的文档将配置转换为该版本认可的结构。不要同时升级二进制、重写全部转发规则并改变端口。保存 unit 与配置文件的可恢复副本,确保当前入口可以本地管理后再应用。

systemd unit 编辑后需要 daemon-reload 才会重新读取;随后 restart 会短暂中断服务连接。若配置检查或重启失败,立即恢复 unit 和配置备份,再 daemon-reload 并启动原服务。不要用手工启动另一个 Realm 进程掩盖 systemd 单元配置错误。

检查配置文件存在和格式线索

sh
CONFIG='/ABSOLUTE/PATH/REFERENCED/BY/EXECSTART'
test -s "$CONFIG" && stat -c '%s %n' -- "$CONFIG"
head -n 20 "$CONFIG"
仅在已确认路径后读取文件元数据和开头内容;确认不是含凭据的配置后再看正文。不要把完整输出贴到公开工单。

重启后分开验证监听和应用协议

服务恢复后确认 systemd unit active、进程命令行对应预期二进制和配置、目标 TCP 端口由正确进程监听。随后从获准的客户端建立实际应用协议会话并发送授权测试请求。端口能接受 TCP 握手只能证明传输层监听,不证明 VLESS 客户端协议、账户参数或加密设置匹配。

如果需要 UDP 中继,使用能产生 UDP 流量的实际客户端和目标服务单独测试;TCP 监听和 HTTP 响应不能证明 UDP 可用。未做 VLESS 客户端、UDP 或长时间运行验证时,应明确记录这些范围尚未验收。

适用版本、回滚与敏感配置边界

Realm 上游版本、第三方 fork 和本地打包的命令行可能不同。记录准确二进制版本、来源、systemd unit 目标和配置格式后,再使用对应版本文档;不要将旧版本的 TOML 示例或 fork 参数扩写成当前 Realm 通用语法。

若无法确定运行的是哪个二进制、unit 被谁管理、相对路径如何解析或配置含哪些敏感字段,停止变更并请维护者核对。回滚应恢复保存的 unit 与配置文件,并通过 systemd 正常启动。保护中继地址、用户凭据、隧道配置和真实服务器路径,不要将它们写入公开教程或日志。

资料来源

常见问题

systemd 显示 active 是否证明 Realm 配置正确?

不证明。要核对 ExecStart、WorkingDirectory、进程参数和预期监听端口,并确认实际配置被成功读取。

config.toml 改名成 config.json 就能解决格式问题吗?

不能。扩展名不会转换内容。先确认当前二进制支持的格式和文档,再转换为该版本认可的结构。

TCP 端口监听正常是否证明 VLESS 客户端能用?

不能。还需使用真实客户端验证协议握手、参数和目标请求;UDP 必须另行测试。

修改 unit 后为什么要执行 daemon-reload?

systemd 需要重新读取 unit 文件。之后重启服务会中断连接,修改前备份并准备恢复原 unit 和配置。