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をベースにしたVPNで、NATトラバーサルを使ってデバイスをオーバーレイネットワークに接続します。コントロールサーバーは、ノード間で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