一、准备工作
- 本机系统：Windows 10/11 开启 WSL2（Ubuntu/Debian 系）
- 已获取 Hy2 节点链接：
hysteria2://你的HY2链接 - Windows 浏览器下载 Hysteria2 二进制文件：
https://github.com/apernet/hysteria/releases/download/app/v2.7.1/hysteria-linux-amd64 - 将下载好的文件保存至路径：
C:\Users\Administrator\hysteria-linux-amd64
二、WSL 内安装 Hysteria2
- 打开 WSL 终端，切换至 root（如已为 root 可跳过）
- 将 Windows 下的二进制文件复制到 WSL 系统目录
cp /mnt/c/Users/Administrator/hysteria-linux-amd64 /usr/local/bin/hysteria - 赋予执行权限
chmod +x /usr/local/bin/hysteria - 验证安装是否成功
hysteria version出现版本号、构建信息即安装成功。
三、编写 Hysteria2 客户端配置
- 创建配置文件夹
mkdir -p /etc/hysteria - 新建并编辑配置文件
nano /etc/hysteria/config.yaml - 填入以下完整配置（直接复制，无需修改），如果不知道怎么填可以问豆包让它给你完整配置
server: 服务器地址 auth: 密码 tls: insecure: true socks5: listen: 127.0.0.1:10808 http: listen: 127.0.0.1:10809 bandwidth: up: 50 mbps down: 150 mbps - 保存并退出
- 按
Ctrl+O回车保存 - 按
Ctrl+X退出编辑器
- 按
四、启动 Hysteria2 客户端
hysteria client -c /etc/hysteria/config.yaml
出现以下日志即为启动并连接成功：
INFO connected to server
INFO HTTP proxy server listening
INFO SOCKS5 server listening
五、让 WSL 命令走 Hy2 代理
1. 临时生效（当前终端可用）
export http_proxy=http://127.0.0.1:10809
export https_proxy=http://127.0.0.1:10809
export all_proxy=socks5://127.0.0.1:10808
临时关闭
unset http_proxy https_proxy all_proxy2. 永久生效（每次打开终端自动代理）
echo 'export http_proxy=http://127.0.0.1:10809' >> ~/.bashrc
echo 'export https_proxy=http://127.0.0.1:10809' >> ~/.bashrc
echo 'export all_proxy=socks5://127.0.0.1:10808' >> ~/.bashrc
source ~/.bashrc
彻底关闭（永久取消，下次打开终端也不会自动开启）
sed -i '/export http_proxy/d' ~/.bashrc
sed -i '/export https_proxy/d' ~/.bashrc
sed -i '/export all_proxy/d' ~/.bashrc
source ~/.bashrc六、测试代理是否正常
curl ip.sb
返回结果为代理节点 IP 即配置完成，可正常访问 GitHub 等外部资源。
七、常见问题说明
- 启动报错
no mode specified
原因：配置文件格式不兼容新版 Hy2，使用本文提供的 socks5/http 分段配置即可解决。 - 启动成功但无法走代理
原因：Hy2 仅开启代理端口，不会自动接管系统流量，必须配置all_proxy环境变量。 - 无法下载二进制文件
方案：Windows 下下载后通过/mnt/路径复制进 WSL，实现离线安装。
八、常用命令（运维必备）
启动 hy2 客户端（前台启动，需保持终端打开）：
hysteria client -c /etc/hysteria/config.yaml后台启动 hy2 客户端（无需保持终端打开，后台持续运行）：
nohup hysteria client -c /etc/hysteria/config.yaml 查看后台运行的 hy2 进程（确认后台启动状态）：
ps aux | grep hysteria停止 hy2 客户端（前台启动）：
直接关闭启动 hy2 的终端窗口，或在启动终端按
Ctrl+C 终止进程停止 hy2 客户端（后台启动）：
先通过
ps aux | grep hysteria 找到进程 ID（PID），再执行 kill -9 进程ID（替换「进程ID」为实际查询到的数值）验证 hy2 版本：
hysteria version重新加载 .bashrc（永久代理生效）：
source ~/.bashrc卸载 hy2 客户端（彻底删除）：
rm -rf /usr/local/bin/hysteria /etc/hysteria九、hy2 后台启动一键脚本
在 WSL 终端（root 用户）执行以下操作，完成脚本创建和使用：
创建脚本文件（使用 nano 编辑器）：
nano /usr/local/bin/hy2-start.sh创建脚本文件（命名为 hy2.sh）
nano /usr/local/bin/hy2.sh将下面的脚本内容完整粘贴到编辑器中
#!/bin/bash
# hy2 后台启动一键脚本（适配当前 WSL 环境、节点配置）
# 功能：后台启动 hy2 客户端，无需保持终端打开，启动后自动后台运行
# 1. 后台启动 hy2（指定配置文件，后台运行，日志输出到临时文件，避免占用终端）
nohup hysteria client -c /etc/hysteria/config.yaml > /tmp/hy2.log 2>&1 &
# 2. 等待 2 秒，确认启动状态
sleep 2
# 3. 检查 hy2 进程是否启动成功
if ps aux | grep -q "hysteria client"; then
echo -e "\033[32m✅ hy2 后台启动成功！\033[0m"
echo "📌 进程日志可查看：cat /tmp/hy2.log"
else
echo -e "\033[31m❌ hy2 启动失败！\033[0m"
echo "🔍 请查看日志排查：cat /tmp/hy2.log"
fi赋予脚本执行权限
chmod +x /usr/local/bin/hy2.sh一键后台启动 hy2
hy2.sh脚本相关常用命令
# 一键后台启动 hy2（使用脚本，推荐）
hy2.sh
# 查看脚本启动日志
cat /tmp/hy2.log
# 停止后台运行的 hy2 进程（一键执行）
pkill -9 hysteria
# 重启 hy2 后台服务（一键执行）
pkill -9 hysteria && hy2-start.sh