Proxy-Tools/s-hy2

Fork 0

Files

T

sindricn 7e3be618bb 添加本地项目文件

2025-08-05 14:11:40 +08:00

7.8 KiB

Raw Blame History

Hysteria2 配置管理脚本部署指南

快速部署

方法一：一键安装（推荐）

# 一键安装到服务器
curl -fsSL https://raw.githubusercontent.com/sindricn/s-hy2/main/quick-install.sh | sudo bash

# 运行脚本
sudo s-hy2

方法二：GitHub 克隆安装

# 克隆仓库
git clone https://github.com/sindricn/s-hy2.git
cd s-hy2

# 运行安装脚本
sudo ./install.sh

# 或直接运行主脚本
sudo ./hy2-manager.sh

方法二：手动部署

# 1. 克隆仓库
git clone https://github.com/your-repo/hy2-manager.git
cd hy2-manager

# 2. 设置权限
chmod +x hy2-manager.sh
chmod +x scripts/*.sh

# 3. 创建符号链接（可选）
sudo ln -sf $(pwd)/hy2-manager.sh /usr/local/bin/hy2-manager

# 4. 运行脚本
sudo ./hy2-manager.sh

使用流程

新手推荐流程（一键快速配置）

运行管理脚本
```
sudo s-hy2
```
安装 Hysteria2
- 选择菜单选项 1. 安装 Hysteria2
- 脚本会自动检测系统环境并安装
一键快速配置
- 选择菜单选项 2. 一键快速配置
- 脚本会自动完成所有配置并启动服务
查看节点信息
- 选择菜单选项 8. 节点信息
- 获取节点链接和客户端配置

高级用户流程（手动配置）

运行管理脚本
```
sudo s-hy2
```
安装 Hysteria2
- 选择菜单选项 1. 安装 Hysteria2
手动配置
- 选择菜单选项 3. 手动配置
- 选择配置模式（ACME 或自签名证书）
- 按提示输入相关信息
启动服务
- 选择菜单选项 4. 管理服务
- 选择 1. 启动服务
- 选择 4. 启用开机自启

配置模式选择

ACME 自动证书模式（推荐生产环境）

优点：

自动申请和续期 SSL 证书
高安全性，证书被广泛信任
无需手动管理证书

要求：

拥有有效域名
域名已解析到服务器 IP
服务器可访问互联网
有效的邮箱地址

配置步骤：

确保域名解析正确
输入域名（如：example.com）
输入邮箱地址
设置认证密码
选择伪装网站

自签名证书模式（适合测试环境）

优点：

无需域名，快速部署
适合内网或测试环境
配置简单

缺点：

证书不被信任
客户端需要忽略证书错误

配置步骤：

选择伪装域名
设置认证密码
自动生成证书

进阶配置

域名优化

使用脚本的域名测试功能选择最优伪装域名：

选择菜单选项 5. 测试伪装域名
选择 2. 交互式选择域名
等待测试完成，选择延迟最低的域名

端口配置

如果默认 443 端口被占用：

选择菜单选项 6. 进阶配置
选择 1. 修改监听端口
输入新端口号
确保防火墙允许新端口

混淆配置

在网络环境较差时启用混淆：

选择菜单选项 6. 进阶配置
选择 2. 添加混淆配置
设置混淆密码
客户端需要配置相同密码

端口跳跃

提高连接稳定性：

选择菜单选项 6. 进阶配置
选择 4. 配置端口跳跃
选择网络接口
设置端口范围

客户端配置

基本配置

server: your.server.com:443
auth: your_password
tls:
  sni: your.server.com
  insecure: false  # ACME 证书设为 false，自签名设为 true
socks5:
  listen: 127.0.0.1:1080
http:
  listen: 127.0.0.1:8080

混淆配置（如果服务器启用）

obfs:
  type: salamander
  salamander:
    password: your_obfs_password

防火墙配置

Ubuntu/Debian (UFW)

# 允许 Hysteria2 端口
sudo ufw allow 443/udp

# 如果使用自定义端口
sudo ufw allow YOUR_PORT/udp

# 启用防火墙
sudo ufw enable

CentOS/RHEL (firewalld)

# 允许 Hysteria2 端口
sudo firewall-cmd --permanent --add-port=443/udp

# 如果使用自定义端口
sudo firewall-cmd --permanent --add-port=YOUR_PORT/udp

# 重载配置
sudo firewall-cmd --reload

监控和维护

查看服务状态

# 使用脚本查看
sudo hy2-manager
# 选择 "3. 管理服务"

# 或直接使用系统命令
sudo systemctl status hysteria-server

查看日志

# 实时日志
sudo journalctl -f -u hysteria-server

# 历史日志
sudo journalctl -u hysteria-server --since "1 hour ago"

配置备份

脚本会自动备份配置文件，手动备份：

sudo cp /etc/hysteria/config.yaml /etc/hysteria/config.yaml.backup.$(date +%Y%m%d_%H%M%S)

故障排除

常见问题

服务启动失败

# 检查配置文件
sudo hysteria server --config /etc/hysteria/config.yaml --check

# 查看详细日志
sudo journalctl -u hysteria-server -n 50

证书申请失败
- 检查域名解析：nslookup your.domain.com
- 检查端口开放：sudo netstat -tulnp | grep :80
- 检查防火墙设置
连接失败
- 检查服务状态：sudo systemctl status hysteria-server
- 检查端口监听：sudo netstat -tulnp | grep :443
- 验证客户端配置

重新配置

如果需要重新配置：

停止服务：选择 "管理服务" -> "停止服务"
重新生成配置：选择 "生成配置文件"
启动服务：选择 "管理服务" -> "启动服务"

卸载

卸载 Hysteria2

脚本提供两种卸载方式，根据需要选择：

方式一：仅卸载程序 (推荐)

适用于：

临时卸载，可能重新安装
保留配置以备后用
升级或重装系统前备份

操作步骤：

运行 sudo hy2-manager
选择 7. 卸载服务
选择 1. 仅卸载程序 (保留配置文件和证书)
确认卸载

保留内容：

配置文件：/etc/hysteria/config.yaml
SSL 证书文件
hysteria 用户账户
自定义配置和备份

手动清理命令：

# 如需完全清理，可执行以下命令
sudo rm -rf /etc/hysteria
sudo userdel -r hysteria
sudo rm -f /etc/systemd/system/multi-user.target.wants/hysteria-server.service
sudo rm -f /etc/systemd/system/multi-user.target.wants/hysteria-server@*.service
sudo systemctl daemon-reload

方式二：完全卸载