# almeidapaulopt/tsdproxy

Automatic Tailscale reverse proxy for Docker containers. Zero sidecars. Label-based config. Automatic HTTPS.

Repository: https://github.com/almeidapaulopt/tsdproxy
Canonical: https://ross.abutalabs.com/products/tsdproxy
Homepage: https://almeidapaulopt.github.io/tsdproxy/
Language: Go
License: MIT
License Family: permissive
Topics: docker, go, self-hosted, tailscale, proxy, vpn, containers, docker-compose, homelab, https, networking, reverse-proxy, tsnet, wireguard, automatic, sidecar, ssl, traefik-alternative
Last push: 2026-08-19T04:04:38+00:00

## Health v2 (maintenance only)
Score: 85/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 90, longevity 49
- inputs: {"age_days": 695, "days_push": 14, "days_rel": 68, "gap_med": 2.0, "n_releases_24m": 41}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1690, forks 78 (observed 2026-08-28T04:05:22.417026+00:00)

## What it is
TSDProxy is a self-hosted service that automatically exposes Docker containers on a Tailscale network via a single reverse proxy. Containers are configured with Docker labels, require no per-service sidecars, and get automatic HTTPS certificates from Tailscale.

## Use cases
- expose docker containers on tailscale network
- automatic https reverse proxy for homelab services
- replace traefik with simpler tailscale proxy
- proxy tcp and udp services like ssh or databases over tailscale
- publish a service publicly with tailscale funnel
- expose multiple ports of a container with one label
- manage self-hosted apps behind headscale control server

## When to choose
- you run docker containers and want them reachable on your tailnet with zero per-container sidecars
- you want label-based configuration and automatic HTTPS without managing certificates
- you need TCP/UDP proxying alongside HTTP services
- you use Tailscale or Headscale in a homelab or self-hosted setup

## When to avoid
- you need a general-purpose reverse proxy for public traffic without Tailscale
- your containers are not on Docker or a supported provider
- you require advanced routing features like path-based routing or middleware chains typical of Traefik or nginx

## Facets
- artifact type: service
- maturity: active
- function: proxy, networking, deployment, self-hosted
- domain: networking, self-hosted, security
- platform: go, self-hosted
- tags: tailscale, reverse-proxy, wireguard, docker-labels, automatic-https, homelab, tsnet, traefik-alternative, funnel, tcp-proxy, containers, devops, docker, linux

## Member repositories
- almeidapaulopt/tsdproxy (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:22.417026+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:38:21.286720+00:00, confidence not recorded.
  - readme: https://github.com/almeidapaulopt/tsdproxy (fetched 2026-08-28T04:05:22.417026+00:00, sha d744e6d2483f)
  - homepage: https://almeidapaulopt.github.io/tsdproxy/ (fetched 2026-08-29T11:13:17.860705+00:00, sha ee5f276ad233)
- Data as of 2026-08-30T08:39:29.467469+00:00.
