teddysun/hysteria repository overview

⁠Hysteria Docker Image by Teddysun

Hysteria⁠ is a feature-packed proxy & relay utility optimized for lossy, unstable connections, powered by a customized QUIC protocol.

Docker images are built for quick deployment in various computing cloud providers.

For more information on docker and containerization technologies, refer to official document⁠.

⁠Supported tags and respective Dockerfile links

• latest, 2.9.3 (Dockerfile)⁠
• 2.9.2, 2.9.1, 2.9.0
• 2.8.2, 2.8.1
• 2.7.1, 2.7.0
• 2.6.4, 2.6.3, 2.6.2, 2.6.1, 2.6.0
• 2.5.2, 2.5.1, 2.5.0
• 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.0, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.1, 2.1.0
• 2.0.4, 2.0.3, 2.0.2
• 1.3.5, 1.3.4, 1.3.3, 1.3.2, 1.3.1.1, 1.3.1, 1.3.0
• 1.2.2, 1.2.1, 1.2.0
• 1.1.0, 1.0.5

⁠Reference

• Supported architectures (more info⁠): amd64, arm32v6, arm32v7, arm64v8, i386, ppc64le, s390x

⁠Prepare the host

If you need to install docker by yourself, follow the official installation guide⁠.

⁠Pull the image

$ docker pull teddysun/hysteria

This pulls the latest release of Hysteria.

It can be found at Docker Hub⁠.

⁠Start a container

You must create a configuration file /etc/hysteria/server.yaml in host at first:

$ mkdir -p /etc/hysteria

And put the cert.crt, private.key to the /etc/hysteria/.

Or download it from here⁠

A sample in yaml like below:

listen: :8998

tls:
  cert: /etc/hysteria/cert.crt
  key: /etc/hysteria/private.key

auth:
  type: password
  password: your_password

resolver:
  type: https
  https:
    addr: 8.8.8.8:443
    timeout: 10s

There is an example to start a container that listen on port 8998, run as a Hysteria server like below:

$ docker run -d -p 8998:8998/udp --name hysteria --restart=always -v /etc/hysteria:/etc/hysteria teddysun/hysteria

Warning: The port number must be same as configuration and opened in firewall.