marvinvr/docktail

어떤 프로젝트인가요?

핵심 기능

• 01docktail.* 레이블을 통해 컨테이너를 자동으로 검색합니다.
• 02OAuth 또는 API key 인증 정보로 Tailscale 서비스를 생성합니다.
• 03HTTP, HTTPS, TCP 및 TLS로 종료되는 TCP를 지원합니다.
• 04선택적 PROXY protocol을 제공해 백엔드에서 tailnet 클라이언트 IP를 확인할 수 있습니다.
• 05공개 인터넷 액세스를 위해 Tailscale Funnel을 제공합니다.
• 06컨테이너 하나에서 여러 서비스를 노출하고 재시작 시 상태를 조정합니다.

활용 사례

• 호스트 포트를 열지 않고 Tailscale HTTPS로 홈랩 웹 앱을 게시합니다.
• tailnet 클라이언트에 TCP로 데이터베이스를 노출합니다.
• PROXY protocol을 통해 실제 tailnet 클라이언트 IP가 필요한 리버스 프록시를 실행합니다.
• Tailscale Funnel을 통해 웹훅 엔드포인트를 공개적으로 연결할 수 있게 합니다.

빠른 시작

1. 1

   Docker 소켓과 Tailscale OAuth 변수를 설정한 docktail Compose 서비스를 추가하고 앱 컨테이너에 라벨을 지정합니다

2. 2

   스택을 시작합니다

   docker compose up -d
3. 3

   tailnet에서 앱을 엽니다

   curl http://myapp.your-tailnet.ts.net

사용 전 알아둘 점

• !AGPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스이므로 네트워크 서비스가 수정된 경우 소스 공개가 필요합니다.
• !Docker 호스트가 Tailscale에 연결되어 있고 서비스를 광고할 수 있도록 허용되어야 합니다.
• !서비스를 자동으로 생성하려면 Tailscale OAuth 또는 API 키 인증 정보가 필요합니다.
• !Docker 소켓을 마운트하면 컨테이너가 호스트의 Docker 데몬에 접근할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

docktail은(는) 무엇인가요?

docktail.* 레이블을 사용해 Docker 컨테이너를 Tailscale Services로 노출하며, 컨테이너별 Tailscale 디바이스나 포트 공개가 필요 없습니다. DockTail은 Docker 컨테이너를 감시하고 docktail.* 레이블을 읽어 해당 컨테이너를 네이티브 Tailscale Services로 게시합니다. 기본적으로 Docker 포트를 공개할 필요가 없습니다. DockTail이 Docker 네트워크 IP로 직접 프록시하기 때문입니다.

docktail은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

docktail은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

docktail은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. docktail의 마지막 커밋은 2026년 11월 5일입니다.

docktail은(는) 어디에 사용할 수 있나요?

호스트 포트를 열지 않고 Tailscale HTTPS로 홈랩 웹 앱을 게시합니다. tailnet 클라이언트에 TCP로 데이터베이스를 노출합니다. PROXY protocol을 통해 실제 tailnet 클라이언트 IP가 필요한 리버스 프록시를 실행합니다. Tailscale Funnel을 통해 웹훅 엔드포인트를 공개적으로 연결할 수 있게 합니다.

docktail는 어떻게 설치하나요?

Docker 소켓과 Tailscale OAuth 변수를 설정한 docktail Compose 서비스를 추가하고 앱 컨테이너에 라벨을 지정합니다 스택을 시작합니다: docker compose up -d tailnet에서 앱을 엽니다: curl http://myapp.your-tailnet.ts.net

docktail은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/marvinvr/docktail