snell-server-docker

Docker image for snell-server

Multi-arch images are available for linux/amd64 and linux/arm64. Docker pulls the matching architecture automatically.

Usage

Available versions

Note

Version 4 isn't compatible with version 3 clients

All available versions are listed in tags.

Run

Environment variable PORT is optional, port number 9102 will be used if PORT is absent.

docker run -e PSK=<your_psk_here> -e PORT=9102 -p <your_host_port_here>:9102 --restart unless-stopped -d geekdada/snell-server:latest

If you want to use the service as a Surge Ponte relay server, exposing all ports is recommended:

docker run -e PSK=<your_psk_here> --name snell --restart unless-stopped --network host -d geekdada/snell-server:latest

Run with shadow-tls

Use docker-compose.yml to run snell-server with shadow-tls. Please change the environment variables in docker-compose.yml to your own.

Build

Multi-arch builds require Docker Buildx and QEMU for cross-platform emulation:

docker buildx create --name snell-builder --driver docker-container --use
docker run --privileged --rm tonistiigi/binfmt --install all
docker login
./build.sh 5.0.1

Publish via GitHub Actions

1. Add repository secrets:
   • DOCKERHUB_USERNAME
   • DOCKERHUB_TOKEN (Docker Hub access token)
2. Open Actions → Publish → Run workflow
3. Enter the Snell server version and choose stable or beta

The workflow builds and pushes linux/amd64 and linux/arm64 images to Docker Hub.