A lightweight Docker image that builds and runs udpxy, a UDP‑to‑HTTP proxy, on top of Alpine and Debian bookworm‑slim.
This repository provides a multi‑stage Dockerfile that:
udpxy from source (using the pcherenkov/udpxy repository).alpine:latest and debian:bookworm-slim runtime image.The resulting container can be used to forward multicast UDP streams (e.g., IPTV) over HTTP, making them accessible to clients that cannot handle UDP directly.
| Tag | Description |
|---|---|
latest | Image based on alpine:latest |
latest-debian | Image based on debian:bookworm-slim |
udpxy is controlled entirely by command‑line options. Pass them through the UDPXY_OPTS environment variable.
docker run -d \
--name udpxy \
-p 4022:4022/tcp \ # default listening port (change if you use a different one)
-e UDPXY_OPTS="-p 4022 -c 30 -T" \
udpxy:latest
| Variable | Required | Description |
|---|---|---|
UDPXY_OPTS | Yes (at least the listening port) | Full list of command‑line arguments for udpxy. If omitted, the container will exit because no options are supplied. |
udpxy Options| Option | Description |
|---|---|
-v | enable verbose output [default = disabled] |
-S | enable client statistics [default = disabled] |
-T | do NOT run as a daemon [default = daemon if root] |
-a | (IPv4) address/interface to listen on [default = 0.0.0.0] |
-p | port to listen on |
-m | (IPv4) address/interface of (multicast) source [default = 0.0.0.0] |
-c | max clients to serve [default = 3, max = 5000] |
-l | log output to file [default = stderr] |
-B | buffer size (65536, 32Kb, 1Mb) for inbound (multicast) data [default = 2048 bytes] |
-R | maximum messages to store in buffer (-1 = all) [default = 1] |
-H | maximum time (sec) to hold data in buffer (-1 = unlimited) [default = 1] |
-n | nice value increment [default = 0] |
-M | periodically renew multicast subscription (skip if 0 sec) [default = 0 sec] |
All options can be combined, e.g.:
-e UDPXY_OPTS="-p 4022 -c 30 -T"
GitHub Repo: https://github.com/vistalba/udpxy
Content type
Image
Digest
sha256:ef3f1d95e…
Size
3.7 MB
Last updated
5 days ago
docker pull vistalba/udpxy