TsDProxy simplifies the process of securely exposing services and Docker containers to your Tailscale network by automatically creating Tailscale machines for each tagged container. This allows services to be accessible via unique, secure URLs without the need for complex configurations or additional Tailscale containers.
This version changes the configuration method. Please read the Documentation for details.
almeidapaulopt/tsdproxy:v1.x.x - Version 1.x.x almeidapaulopt/tsdproxy:latest - Latest stable almeidapaulopt/tsdproxy:next - Latest Release Candidate almeidapaulopt/tsdproxy:dev - Latest Development Build
- Automatic Tailscale Machine Creation: For each Docker container tagged with the appropriate labels, TsDProxy creates a new Tailscale machine.
- Default Serving: By default, each service is accessible via
https://{machine-name}.funny-name.ts.net
, where{machine-name}
is derived from your container name or custom label.
- Simplified Networking: Eliminates the need for a separate Tailscale container for each service.
- Label-Based Configuration: Easy setup using Docker container labels.
- Automatic HTTPS: Leverages Tailscale's built-in LetsEncrypt certificate support.
- Flexible Protocol Support: Handles HTTP and HTTPS traffic (defaulting to HTTPS).
- Lightweight Architecture: Efficient, Docker-based design for minimal overhead.
TsDProxy operates by creating a seamless integration between your Docker containers and Tailscale network:
- Container Scanning: TsDProxy continuously monitors your Docker
environment for containers with the
tsdproxy.enable=true
label. - Tailscale Machine Creation: When a tagged container is detected, TsDProxy automatically creates a new Tailscale machine for that container.
- Hostname Assignment: The Tailscale machine is assigned a hostname based
on the
tsdproxy.name
label or the container's name. - Port Mapping: TsDProxy maps the container's internal port to the Tailscale machine.
- Traffic Routing: Incoming requests to the Tailscale machine are routed to the appropriate Docker container and port.
- Dynamic Management: As containers start and stop, TsDProxy automatically creates and removes the corresponding Tailscale machines and routing configurations.
Before using this application, make sure you have:
This project is licensed under the MIT License. See the LICENSE file for details.
Contributions are welcome! Feel free to open issues or submit pull requests to help improve the app.