zydou/hysteria repository overview

⁠Hysteria with GeoIP embedded

• hysteria⁠
• GeoIP⁠

Note: We only support hysteria v2.

⁠Container Registry

• Docker Hub⁠
• GitHub⁠

⁠What's the difference from the official docker image⁠?

1. The binary is compressed using upx, so the image size is much smaller (~50%).

2. Hysteria will automatically download the ACL resources from the Loyalsoldier/v2ray-rules-dat⁠ repository, there will be no problem deploying hysteria on overseas VPS. However, when deployed as a client in China, downloading the geosite and geoip database from GitHub can be very slow or even impossible. Therefore, this image embeds the geosite.dat and a lite version of the GeoIP database that only contains: geoip:cn and geoip:private, which can meet the needs of most Chinese users.

⁠Docker CLI

docker run -d -restart=always \
    --name hysteria \
    -e TZ=Asia/Shanghai \  # set desired timezone
    --network host \
    -v $(pwd)/hysteria.yaml:/etc/hysteria.yaml:ro \
    zydou/hysteria:latest

⁠Docker Compose

version: "3.9"
services:
  service.hysteria:
    image: zydou/hysteria:latest
    container_name: hysteria
    environment:
      - TZ=Asia/Shanghai  # set desired timezone
    network_mode: host
    volumes:
      - ./hysteria.yaml:/etc/hysteria.yaml:ro
    restart: always

Please see the official docs⁠ to write your own hysteria.yaml.

⁠Source code

GitHub⁠ (Also contains other tools to bypass the GFW)

⁠LICENSE

MIT⁠