适用范围与准备

适用于由XTLS/Xray-install官方systemd脚本管理的Linux实例。面板、容器、发行版软件包与OpenRC安装另有管理方式,不能照搬。先准备独立于代理的管理通道,以及配置、服务定义和证书的受控备份。

先区分原因

“一键脚本”不是统一产品。本文核对2026年11月8日的官方脚本与README;默认路径、运行用户、权限和删除范围均随实现而定。保留JSON文件不等于保留完整运行环境,脚本退出成功也不能证明业务已恢复。

按顺序操作

  1. 先通过服务定义确认实际二进制、配置路径、运行用户和实例名。默认xray.service与xray@实例可加载不同文件,JSONS_PATH还会影响多文件配置;从实际启动参数确认,不只备份名为config.json的文件。
  2. 为本次操作保存配置、服务文件及覆盖项、外部证书引用、所需资源文件和现有版本信息。把秘密放在受控位置,并确认备份可读;不能仅记住文件路径。若SSH依赖当前Xray连接,先验证备用管理入口。
  3. 更新前读当前README的迁移说明。本次版本提示服务改用专用xray用户并收紧权限,旧配置、证书及父目录可读性需要核对;自定义GeoSite类别也可能依赖原资源。不要用给所有人开放权限来修复服务读取失败。
  4. 明确选择更新、普通卸载还是彻底清除。当前remove保留JSON配置和日志,但会移除程序、服务定义及资源目录等;remove --purge还会清除脚本所指配置目录及日志。不能把彻底清除当作无害的重装准备。
  5. 按照已确认的管理方式安排操作与恢复。更新选项--manually-restart-later用于延后重启;这意味着磁盘文件与当前进程可能不是同一版本。对自定义路径、多实例或第三方脚本,先核对实现,不能假定此表完整覆盖。
操作当前官方脚本的重要边界
更新可能改变服务权限与资源;需读迁移说明
remove保留JSON与日志,不保留完整运行环境
remove --purge还会删除配置目录和日志
延后重启磁盘已更新不代表运行进程已切换
只读检查示例:默认 systemd 实例;输出可能含私有路径,不要原样公开
systemctl cat xray.service
systemctl show xray.service -p FragmentPath -p ExecStart -p User
/usr/local/bin/xray version

怎样确认有效

更新后分别确认文件版本、实际启动的服务及加载配置,再通过原客户端完成原业务请求。卸载后则检查服务状态与计划保留文件是否符合预期。只运行上面的只读命令不能证明更新、卸载或业务检查已经完成。

无效时恢复与下一步

出现问题时停止继续清理,使用备用管理入口恢复与旧版本相匹配的程序、配置、服务定义、资源和权限,并重新验证业务。配置保留不能替代备份;证书续期仍需保证正确权限。本文只核对脚本源码,未执行安装、重启或卸载,示例命令未在读者服务器运行。