20
0
0

Hysteria2 服务端 Docker 安装指南

2026-10-12
2026-10-19
文章摘要
|

本文整理一套适用于 Linux 服务器的 Hysteria2 Docker 部署流程,包含自签证书、服务端配置、容器启动和防火墙放行。

官方资源

安全提示:配置中的密码属于敏感凭据,本文不展示真实密码。请在部署前将示例值替换为随机生成的强密码,并妥善保存。

一、创建配置目录并生成自签证书

先创建 Hysteria2 配置目录,再生成一组有效期 10 年的自签名证书:

mkdir -p /etc/hysteria
cd /etc/hysteria

# 生成自签证书,有效期 10 年
openssl req -x509 -nodes -newkey ec:<(openssl ecparam -name prime256v1) -keyout server.key -out server.crt -days 3650 -subj "/CN=www.bing.com"

如果客户端对证书校验有更高要求,建议改用受信任的域名证书,并同步调整客户端配置。

二、编写服务端配置

使用下面的 Linux 命令创建并写入 /etc/hysteria/server.yaml:

cat > /etc/hysteria/server.yaml <<'EOF'
listen: ":8443"
tls:
  cert: /etc/hysteria/server.crt
  key: /etc/hysteria/server.key
auth:
  type: password
  password: "CHANGE_ME_TO_A_RANDOM_STRONG_PASSWORD"
masquerade:
  type: proxy
  proxy:
    url: https://www.bing.com
    rewriteHost: true
bandwidth:
  up: 100 mbps
  down: 100 mbps
echo "配置文件已写入:/etc/hysteria/server.yaml"
EOF

其中 password 必须替换为你自己的强密码;不要直接复用公开文章、截图或聊天记录中的密码。

三、使用 Docker 启动 Hysteria2

docker run -dt --network=host --cap-add NET_ADMIN \
  --name hysteria \
  --restart always \
  -v /etc/hysteria:/etc/hysteria \
  tobyxdd/hysteria server -c /etc/hysteria/server.yaml
  • --network=host:使用宿主机网络,直接占用宿主机端口。

  • --cap-add NET_ADMIN:为网络相关能力提供权限;即使暂时不使用 TUN,也可以保留。

  • --restart always:容器异常退出或服务器重启后自动拉起。

四、查看日志确认启动状态

docker logs hysteria

如果需要持续观察日志,可以使用:

docker logs -f hysteria

五、放行服务器防火墙

Hysteria2 使用 UDP 端口,以下命令适用于启用 UFW 的 Ubuntu/Debian 系统:

sudo ufw allow 8443/udp
sudo ufw reload
sudo ufw status

六、部署检查清单

  1. 确认 /etc/hysteria/server.crt 和 server.key 已生成。

  2. 确认配置文件中的密码已替换为随机强密码。

  3. 确认容器状态为运行中:docker ps。

  4. 确认服务器安全组和 UFW 都放行了 8443/udp。

  5. 使用客户端连接测试,并根据日志排查握手或认证错误。

提示:请根据你的发行版、云厂商安全组和实际网络环境调整端口及防火墙规则。部署完成后建议及时更新镜像并定期轮换认证密码。

文章声明
本文章只探讨技术交流,所分享的资源来自网上,用户的任何行为与本站无关,若涉及侵权问题其联系 982031261@qq.com 删除,感谢理解!!

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

评论