适用范围与准备
适用于自己管理的 Linux systemd 主机,准备启动使用 TLS 的 Xray 入站却失败。安装脚本、面板和容器的路径可能不同;先保留SSH等独立管理通道及原配置,不在仅靠该代理远程管理时直接重启。
先区分原因
同一个地址和TCP端口不能随意被两个普通监听服务同时占用。为了申请证书安装的网页服务可能已监听443;而证书文件存在,也不等于Xray服务身份能够读取。配置语法、端口与运行权限是不同检查层。
按顺序操作
- 读取systemd服务定义,确认启动的是哪个Xray程序、使用哪个配置文件或配置目录,以及是否设置User。不要只因为某个教程写了默认路径,就在另一份config.json里修半天。
- 用ss查看TCP 443的监听进程。若Nginx等服务已占用,先核对原设计是网页服务器终止TLS还是Xray直接监听,不直接杀进程、停网站或随便换端口。
- 按服务中实际路径运行Xray的配置检查模式。示例中的路径必须替换;它只检查配置,不启动监听。多文件配置需按原启动参数一起检查,避免只检查其中一份。
- 对照TLS配置中的证书和私钥路径,检查服务用户是否有必要的目录穿越及文件读取权限。不要用chmod 777或打印私钥解决权限问题;由主机维护者按最小权限调整。
- 检查通过后在维护窗口加载配置,查看服务日志和实际监听,再从获准使用的客户端请求固定目标。证书续期后的路径与权限也需要纳入复核,不能把首次启动成功当成以后永远可用。
systemctl cat xray.service
ss -ltnp 'sport = :443'
xray run -test -config /path/to/config.json
journalctl -u xray.service -n 50 --no-pager怎样确认有效
分别记录配置检查退出结果、监听地址/端口、服务日志和客户端业务请求。配置合法不保证证书可用或防火墙允许访问,进程active也不等于客户端连通;各层未验证时明确留空。
无效时恢复与下一步
若启动失败,恢复原配置及已改动的权限,再按原管理方式恢复服务。保留具体错误阶段,转对应文档处理;本篇未启动真实Xray或签发证书,不提供未经检查的完整服务器配置。