Docker Deployment¶

The published image includes a working example config from example/conf. You can use it directly or mount your own configuration.

Docker run¶

docker run --rm -p 25500:25500 ghcr.io/yoolc/subcon:latest

docker run --rm -p 25500:25500 \
  -v "$PWD/example/conf:/app/conf" \
  ghcr.io/yoolc/subcon:latest

docker run --rm -p 25500:25500 \
  -v "/path/to/conf:/app/conf" \
  -v "/path/to/schema:/app/schema" \
  ghcr.io/yoolc/subcon:latest

Docker Compose¶

The repository includes an example compose file:

docker compose -f example/docker-compose.yaml up -d

This mounts example/conf into /app/conf and exposes port 25500. Adjust the volume path if you use your own config directory.

Verify¶

curl "http://127.0.0.1:25500/sub?target=clash"

Security checklist¶

• Keep network.allowed_domain minimal.
• Rotate common.api_access_token if it leaks.
• Avoid binding to public interfaces without access controls.