juanfont/headscale

어떤 프로젝트인가요?

핵심 기능

• 01WireGuard 노드를 조정하는 Tailscale 제어 서버를 구현합니다
• 02IP 주소를 할당하고 사용자 간 경계를 관리합니다
• 03노드 간 기기 공유와 경로 광고를 지원합니다
• 04NixOS 모듈과 컨테이너 및 바이너리 빌드를 제공합니다

활용 사례

• 홈랩이나 개인 기기용 프라이빗 메시 네트워크를 운영합니다
• 소규모 오픈 소스 팀을 위해 tailnet을 자체 호스팅합니다
• 호스팅 서비스에 의존하지 않고 조정 서버를 직접 관리합니다

빠른 시작

1. 1

   저장소를 클론합니다

2. 2

   Nix 개발 셸에 진입합니다(권장)

   nix develop
3. 3

   테스트 스위트를 실행합니다

   make test
4. 4

   프로그램을 빌드합니다

   make build

사용 전 알아둘 점

• !README는 리버스 프록시 뒤에서 또는 컨테이너에서 Headscale을 실행하는 방법을 지원하지 않습니다.
• !컨트롤 서버를 운영하려면 Tailscale 호환 클라이언트 설정과 셀프 호스팅 작업이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

headscale은(는) 무엇인가요?

직접 WireGuard 기반 메시 네트워크를 운영할 수 있도록 Tailscale 제어 서버를 오픈 소스로 자체 호스팅 방식으로 구현한 프로젝트입니다. Tailscale은 WireGuard를 기반으로 NAT traversal을 통해 기기들을 오버레이 네트워크로 연결하는 VPN입니다. 제어 서버는 노드 간 WireGuard 공개 키 교환을 처리하고, 클라이언트 IP 주소를 할당하며, 사용자 간 경계를 적용하고, 기기 공유를 지원하며, 광고된 경로를 배포합니다. Headscale은 이 제어 서버를 자체 호스팅 방식으로 다시 구현한 오픈 소스 프로젝트로, Tailscale의 호스팅 서비스를 이용하는 대신 직접 조정 계층을 운영할 수 있습니다.

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

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

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

활발히 유지보수 중. headscale의 마지막 커밋은 2026년 10월 24일입니다.

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

홈랩이나 개인 기기용 프라이빗 메시 네트워크를 운영합니다 소규모 오픈 소스 팀을 위해 tailnet을 자체 호스팅합니다 호스팅 서비스에 의존하지 않고 조정 서버를 직접 관리합니다

headscale는 어떻게 설치하나요?

저장소를 클론합니다 Nix 개발 셸에 진입합니다(권장): nix develop 테스트 스위트를 실행합니다: make test 프로그램을 빌드합니다: make build

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

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