适用范围与准备

适用于由Hysteria官方systemd安装脚本管理的Linux服务端,安装完成却启动失败。先核对安装方式与程序版本;面板、容器和其他系统路径不同,不把脚本安装路径当所有部署的统一标准。

先区分原因

当前官方脚本说明使用/etc/hysteria/config.yaml。旧示例中把obfs写成字符串、把obfs-password放到服务端顶层,或把auth留空,都不能当作当前Hysteria 2的可用模板。服务端结构和Mihomo客户端字段也不能直接互换。

按顺序操作

  1. 读取hysteria-server.service的实际启动参数,确认加载文件。若路径与脚本文档不同,以本机服务定义和安装来源核对;先保留现有文件,不在两个路径之间复制覆盖碰运气。
  2. 按官方完整服务端文档核对结构。混淆采用类型及对应子项,认证独立配置;使用密码认证时要有明确的认证类型与密码。不要把混淆密码自动当作用户认证密码。
  3. 继续核对TLS证书或ACME设置、监听地址与伪装配置。示例中的域名、邮箱、密码是占位值;未经自己填写和核对的配置不能直接运行,带注释的伪JSON也不是可靠部署文件。
  4. 保存前检查缩进和字段层级,在维护窗口按原安装方式加载服务。启动失败查看最近日志,先分清文件读取、解析、证书和监听错误;不能用关防火墙代替查清配置报错。
  5. 服务启动后再确认实际UDP监听和获准客户端连接。把“服务进程运行”“认证成功”“目标请求完成”分开记录;测试TCP端口不能验证Hysteria外层UDP路径。
结构示例:仅认证与混淆片段,不是可启动的完整服务端配置;须替换密码
auth:
  type: password
  password: "REPLACE_AUTH_PASSWORD"
obfs:
  type: salamander
  salamander:
    password: "REPLACE_OBFS_PASSWORD"
官方脚本管理的Linux服务:只读查看,其他安装方式需改服务名
systemctl cat hysteria-server.service
journalctl -u hysteria-server.service -n 50 --no-pager

怎样确认有效

验收包含实际加载路径、无配置错误的日志、预期监听及客户端真实请求。YAML解析成功只证明语法层,不能证明字段语义、证书权限或链路可用;本文示例只做本地结构核对,没有启动服务器。

无效时恢复与下一步

无法恢复时换回原可用配置并保留错误日志。不要清空认证、随便设置insecure或把控制接口暴露出去。客户端超时与认证/TLS的进一步对照,可转文末对应教程。