---
title: "headscaleの使い方｜Tailscale互換サーバーの構築手順とOIDC・DERP設定、0.29.7の変更点"
url: "https://www.issoh.co.jp/tech/details/18053/"
published: 2026-10-03
updated: 2026-11-09
categories: ["インフラ・クラウド"]
publisher: "株式会社一創"
---

# headscaleの使い方｜Tailscale互換サーバーの構築手順とOIDC・DERP設定、0.29.7の変更点

headscaleは、Tailscaleの制御サーバーを自社で動かすためのオープンソース実装です。端末には公式のTailscaleクライアントをそのまま入れ、接続先だけを自前のheadscaleに向けます。この記事は2026年11月時点の最新版0.29.7を前提に、debパッケージでの導入、`config.yaml`、端末の登録、OIDCとDERPの設定、Grants形式のポリシー、繋がらないときの切り分け、Tailscale有料プランと比べた採用判断までをコマンド付きで扱います。

## まとめ：数十台規模の自前制御サーバーとして使い、版は0.29.7以上にそろえる

headscaleを入れると、鍵の交換とIPアドレスの割り当てを担う制御サーバーが自社管理になります。端末間の通信は従来どおりWireGuardで暗号化され、制御サーバーを通りません。構築はdebパッケージ1つとsystemdで済みます。

これから入れるなら0.29.7以上を使い、端末のTailscaleクライアントも1.104.4以上にしてください。0.29.7はセキュリティ修正の版で、修正の一部はサーバーではなく端末側の更新でしか入りません。

業務で採用してよいのは、端末が数十台規模で、制御サーバーを外部SaaSに置けない理由があり、更新を追う担当者がいる場合です。IdPのグループで通信を制御したい、ネットワークフローログを監査に出す必要がある、という要件が1つでもあればTailscaleの有料プランを選びます。

## headscaleとは：Tailscaleの制御サーバーだけを置き換えるOSS

[公式FAQ](https://headscale.net/stable/about/faq/)は、headscaleの目標を「単一のtailnetを実装し、個人や小規模なオープンソース組織の利用に適した範囲に絞る」と説明しています。ライセンスはBSD 3-Clauseです。[READMEの免責事項](https://github.com/juanfont/headscale)によるとTailscale社とは無関係のプロジェクトですが、メンテナーの1人はTailscale社に雇用され、業務時間での貢献が認められています。

### headscaleの担当範囲：鍵交換・IP割り当てとデータ通信経路

Tailscaleの端末同士はWireGuardで直接つながります。[Tailscale公式の仕組み解説](https://tailscale.com/blog/how-tailscale-works)のとおり、制御サーバーが配るのは公開鍵と接続先の情報で、データ通信は中継しません。NAT越えできない環境だけ、DERPという中継サーバーが暗号化されたままのパケットを運びます。

headscaleが受け持つのはこの制御サーバーの部分です。WireGuard自体の仕組みは[WireGuardの仕組みと設定手順](/tech/details/7696/)で、SaaS版の安全性と既定設定は[Tailscaleの安全性と料金の解説](/tech/details/5403/)で整理しています。

### Tailscale SaaSとの機能差：Funnel・Serve・フローログは未対応

[機能一覧](https://headscale.net/stable/about/features/)では、MagicDNS、サブネットルーター、Exit Node、Tailscale SSH、Taildrop、ACLとGrantsに対応しています。業務で差が出るのは次の項目です。Tailscale SSHのポリシーは[Tailscale SSHの設定手順](/tech/details/18058/)で解説しています。

| 機能            | headscale 0.29.7   | Tailscale SaaS       |
| ------------- | ------------------ | -------------------- |
| ACL・Grants・タグ | 対応                 | 対応                   |
| Tailscale SSH | 対応（checkモード含む）     | 全プランで利用可             |
| OIDCでの端末登録    | 対応（IdPグループはポリシー不可） | 対応                   |
| 端末の状態検査       | 未対応                | Standard以上でMDM・EDR連携 |
| ネットワークフローログ   | 未対応                | Premium以上            |
| Funnel・Serve  | 未対応                | 対応                   |
| Web管理画面       | 本体に無し（コミュニティ製）     | 標準提供                 |

提供プランは[Tailscaleの料金ページ](https://tailscale.com/pricing)の2026年11月9日時点の比較表によります。[ポリシーの公式解説](https://headscale.net/stable/ref/policy/)は、デバイスポスチャとIPセットを使えないと明記しています。端末の状態で社外アクセスを絞る設計は、headscaleでは組めません。

## 構築前に決めるサーバー要件：公開ポート・TLSの終端・データベース

headscaleは、インターネットから到達できる場所に置きます。社内LANの中に置くと、社外の端末が登録できません。

### 公開するのはtcp/443が基本、80番と3478番は使う機能次第

[公式の要件ページ](https://headscale.net/stable/setup/requirements/)は、公開IPを持つサーバーとHTTPSの443番を求めています。他のポートでも動きますが、Tailscaleクライアントは場面によって443番を前提にするため、本番では443番を強く勧めています。

| ポート       | 公開   | 用途                         |
| --------- | ---- | -------------------------- |
| tcp/443   | 必要   | クライアント接続・組み込みDERP          |
| tcp/80    | 条件付き | Let’s EncryptのHTTP-01を使うとき |
| udp/3478  | 条件付き | 組み込みDERPのSTUN              |
| tcp/50443 | 条件付き | gRPCでのリモート操作               |
| tcp/9090  | しない  | メトリクス・デバッグ                 |

9090番は外に出さないでください。debパッケージのsystemdユニットには`CAP_NET_BIND_SERVICE`が付いているので、専用ユーザーのまま443番で待ち受けられます。

### TLSは組み込みのLet’s Encryptが第一候補、リバースプロキシは自己責任

同じサーバーで他のWebサービスを動かさないなら、headscale自身に証明書を取らせる構成が単純です。[TLSの公式解説](https://headscale.net/stable/ref/tls/)にあるとおり、HTTP-01なら80番も開け、443番だけで済ませたいなら`TLS-ALPN-01`を選びます。

リバースプロキシの前段配置は多くの解説記事が採用していますが、READMEは「リバースプロキシとコンテナの利用をサポートも推奨もしない」と書いています。FAQでもメンテナー自身は使っていないとしており、[リバースプロキシのページ](https://headscale.net/stable/ref/integration/reverse-proxy/)はコミュニティ文書の扱いです。それでも置く場合は、制御接続がPOSTで始まるWebSocketで`Upgrade`ヘッダーの値が`tailscale-control-protocol`である点を、プロキシが通せるか確認します。

```
# config.yaml：TLSをプロキシに任せ、実クライアントIPを受け取る
server_url: https://headscale.example.com
listen_addr: 127.0.0.1:8080
tls_cert_path: ""
tls_key_path: ""
trusted_proxies:
  - 127.0.0.1/32

# Caddyfile
headscale.example.com {
  reverse_proxy 127.0.0.1:8080 {
    header_up True-Client-IP {remote_host}
    header_up X-Real-IP {remote_host}
  }
}
```

`server_url`が`https`で待ち受けがTLSなしだと起動時に警告が出ますが、この構成では想定どおりです。STUNのudp/3478はプロキシを通らず、直接公開が必要です。

### データベースはSQLite、運用形態はdebかバイナリ

公式FAQが推奨するのはSQLiteです。PostgreSQLは「保守モード」の扱いで、DBの選択は性能にほとんど影響しないと書かれています。コンテナイメージは配布されていますが、Dockerでの運用は公式サポートの対象外です。業務で使うなら、公式がサポートするdebパッケージかバイナリを専用のVMに直接入れる構成にします。

## Debian・Ubuntuにdebパッケージでheadscale 0.29.7を入れる手順

[公式のインストール手順](https://headscale.net/stable/setup/install/official/)の対象はUbuntu 22.04以降とDebian 12以降です。debパッケージに実行ユーザー、既定の設定ファイル、systemdのユニットが含まれます。

### debの取得からsystemdでの起動確認まで

版番号は[GitHub Releasesの0.29.7](https://github.com/juanfont/headscale/releases/tag/v0.29.7)（2026年10月30日公開）に合わせています。新しいパッチ版を使う場合も、リリースノートと同じタグの設定例を確認してから変数を差し替えてください。

```
HEADSCALE_VERSION="0.29.7"
HEADSCALE_ARCH="amd64"
wget --output-document=headscale.deb \
  "https://github.com/juanfont/headscale/releases/download/v${HEADSCALE_VERSION}/headscale_${HEADSCALE_VERSION}_linux_${HEADSCALE_ARCH}.deb"
sudo apt install ./headscale.deb

# 設定と初期ポリシーを用意してから再起動する
sudo nano /etc/headscale/config.yaml
# 後述のpolicy.path用に、初期状態は全遮断とする
printf '%s\n' '{"grants": []}' | sudo tee /etc/headscale/policy.hujson
sudo headscale configtest
sudo systemctl enable headscale
sudo systemctl restart headscale
sudo systemctl status headscale

# 外部からの到達確認
curl https://headscale.example.com/health
```

`policy.path`に指定したファイルが無いとheadscaleは起動できないため、ここでは全遮断のポリシーを先に作っています。必要な通信は後述のGrantsで許可します。正常なら`/health`は`{"status":"pass"}`を返します。CLIはUNIXソケット経由でサーバーと通信するため、以降のコマンドは`sudo`を付けるか、作業ユーザーを`headscale`グループに加えて実行します。

### config.yamlで最初に決める公開URL・待受先・DNSドメイン

[0.29.7の設定例](https://github.com/juanfont/headscale/blob/v0.29.7/config-example.yaml)は、そのままだと`127.0.0.1:8080`で待ち受ける開発用の値です。READMEは、使う版と同じタグの設定例を見るよう注意しています。

```
server_url: https://headscale.example.com
listen_addr: 0.0.0.0:443

# Let's Encryptで証明書を自動取得する場合
tls_letsencrypt_hostname: "headscale.example.com"
tls_letsencrypt_challenge_type: HTTP-01

prefixes:
  v4: 100.64.0.0/10
  v6: fd7a:115c:a1e0::/48

dns:
  magic_dns: true
  base_domain: tailnet.example.internal   # server_urlと別のドメインにする

policy:
  mode: file
  path: /etc/headscale/policy.hujson
```

`base_domain`は`server_url`と同じドメインにも、その親ドメインにもできません。端末の鍵の有効期限`node.expiry`は既定で0（期限なし）です。[SaaS版の既定は180日](https://tailscale.com/docs/features/access-control/key-expiry)なので、合わせたい場合は`180d`を指定します。

## ユーザー作成とノード登録：auth registerと事前認証キーで端末をつなぐ

人が使う端末は「headscaleユーザー」に属し、サーバーはタグに属します。[登録方法の公式解説](https://headscale.net/stable/ref/registration/)は、この区別をTailscaleと同じ識別モデルとして説明しています。

### Web認証とheadscale auth registerで個人の端末を承認する

ノートPCのように人が操作する端末はWeb認証で登録します。端末側で`--login-server`を指定すると、`/register/hskey-authreq-…`という形式のURLが表示され、その末尾がAuth IDです。

```
# サーバー側：ユーザーを作る
sudo headscale users create alice
sudo headscale users list

# 端末側：接続先を自前のheadscaleに向ける
sudo tailscale up --login-server https://headscale.example.com

# サーバー側：表示されたAuth IDで承認する
sudo headscale auth register --user alice --auth-id <AUTH_ID>
sudo headscale nodes list
```

### 事前認証キーとタグでサーバーを非対話で登録する

ブラウザを開けないサーバーやCIの実行環境は、事前認証キーで登録します。キーは既定で1時間有効・1回限りで、使い回すと`authkey already used`で失敗します。

```
# 個人端末用：ユーザーIDを確認してからキーを作る
sudo headscale users list
sudo headscale preauthkeys create --user 1

# サーバー用：タグを付けたキーを作る（ユーザー指定は不要）
sudo headscale preauthkeys create --tags tag:server

# 登録される側
sudo tailscale up --login-server https://headscale.example.com --authkey <YOUR_AUTH_KEY>
```

タグ付きキーで登録した端末の所有者は特別なユーザー`tagged-devices`になり、鍵の期限切れの対象外です。サーバーを個人ユーザーに属させると担当者の退職時に扱いが宙に浮くため、サーバーは最初からタグで登録します。

注意点が1つあります。CLIで作るキーは、ポリシーに定義していないタグ名でも発行と登録が通りました（後述の実測）。タグ名の打ち間違いはその場で検出されないので、登録後に`headscale nodes list`のTags列を確認してください。

### Windows・macOS・iPhone・Androidの公式アプリから接続する

[クライアント対応表](https://headscale.net/stable/about/clients/)によれば、Linux、Windows、macOS、iOS、Android、tvOSなどが対応済みです。対応するのはTailscaleクライアントの直近10リリースで、0.29系の最小対応版はv1.80.0です。接続先の変更手順はOSごとに違います。

- Windows：コマンドプロンプトかPowerShellで`tailscale login --login-server <URL>`を実行
- macOS：同じコマンドか、Optionを押しながらメニューのTailscaleアイコンをクリックし、DebugのCustom Login Serverから追加
- iOS：アカウントアイコンのLog in…を開き、右上のメニューからUse custom coordination serverを選んでURLを入力
- Android：設定のAccountsを開き、右上のメニューからUse an alternate serverを選んでURLを入力

各OSの案内は、自分のheadscaleの`/windows`と`/apple`でも読めます。Windowsはログオン中しか動かない既定なので、常時接続が要る端末では公式の案内どおりUnattended modeを有効にします。

## OIDCでのログイン設定：Google Workspace・Authentikと2要素認証

ユーザーを手作業で作らずIdPに任せるなら、[OIDCの公式解説](https://headscale.net/stable/ref/oidc/)どおり`oidc`節を足します。IdP側には`https://headscale.example.com/oidc/callback`をリダイレクトURIとして登録します。

```
oidc:
  issuer: "https://accounts.google.com"
  client_id: "<CLIENT_ID>"
  client_secret: "<CLIENT_SECRET>"
  pkce:
    enabled: true
  allowed_domains:
    - "example.com"
```

フィルターは既定で無効で、何も書かないとIdPで認証に成功した全員が参加できます。社内のドメインに絞る`allowed_domains`は実質的に必須と考えてください。`allowed_groups`でログインできる人をグループで絞ることはできますが、機能一覧のとおりOIDCグループをポリシーの条件には使えません。Googleは`preferred_username`を返さないため、headscale上のユーザー名は空になります。

2要素認証の設定項目はheadscaleにありません。Google WorkspaceやAuthentikなどIdP側で強制します。Authentikは公式解説で「完全にサポート」と記載されています。

## Grants形式のポリシーで端末間の通信を絞る

ポリシーに`acls`も`grants`も無いと、全端末間の通信が許可されます。上の手順では全遮断から始めているので、必要な通信だけを足していきます。

### policy.pathにHuJSONを置きsystemctl reloadで反映する

公式は新しく書くならGrantsを勧めています。ACLはTailscale側で新機能が追加されない旧形式の扱いです。書式は[TailscaleのGrants解説](https://tailscale.com/docs/features/access-control/grants)と共通で、コメントを書けるHuJSONを使います。

```
{
  "groups": {
    "group:dev": ["alice@", "bob@"]
  },
  "tagOwners": {
    "tag:server": ["alice@"]
  },
  "grants": [
    // 開発者はサーバーのSSHとHTTPSにだけ届く
    { "src": ["group:dev"], "dst": ["tag:server"], "ip": ["tcp:22", "tcp:443"] }
  ],
  // 適用前に到達性を検査する（ベータ）
  "tests": [
    { "src": "alice@", "accept": ["tag:server:443"] }
  ]
}
```

```
# 書式とテストを検査してから反映する
sudo headscale policy check --file /etc/headscale/policy.hujson
sudo systemctl reload headscale
```

ユーザー名の末尾の`@`はポリシー内でユーザーを指す書き方です。`"grants": []`と空配列にすれば全遮断になります。ポリシーで使うタグは`tagOwners`に定義します。

### 0.29.0で意味が変わったワイルドカードとautogroup:danger-all

[CHANGELOG](https://github.com/juanfont/headscale/blob/v0.29.7/CHANGELOG.md)によると、0.29.0からACLの`*`はtailnet内の範囲（`100.64.0.0/10`と`fd7a:115c:a1e0::/48`）だけを指します。Exit Node経由のインターネット通信や、サブネットルーター配下の社内ネットワークを`*`に頼って許可していた場合、更新後に通信が止まります。

全IPを送信元にしたいときは`autogroup:danger-all`を使いますが、送信元にしか書けません。宛先に社内のセグメントを指定するならCIDRで明示します。

## DERPを自前で持つ設定と、残すべきTailscaleの公開DERP

既定のheadscaleは組み込みDERPが無効で、Tailscale社の公開DERPを端末に配ります。中継まで自社で持つ必要がある場合だけ、[DERPの公式解説](https://headscale.net/stable/ref/derp/)どおり有効にします。

```
derp:
  server:
    enabled: true
    stun_listen_addr: "0.0.0.0:3478"
    ipv4: 198.51.100.1
    ipv6: 2001:db8::1
  # urls: []  を足すとTailscaleの公開DERPを配らなくなる
```

上は既定の`config.yaml`にある`derp`節への変更分で、`private_key_path`など他の項目は既定のまま残します。組み込みDERPにはTLSが必要で、`server_url`は`https`でなければなりません。`urls: []`で公開DERPを外すと中継が1台だけになり、公式解説も単一障害点になると警告しています。閉域要件が無いなら公開DERPは残します。確認は端末で`tailscale debug derp-map`と`tailscale debug derp headscale`を実行します。

## Web管理画面のHeadplaneと、公式が保守しないという前提

headscale本体にWeb画面はありません。[公式のWeb UI一覧](https://headscale.net/stable/ref/integration/web-ui/)には11件が載っていますが、いずれもコミュニティ製で、headscaleの作者は保守していません。一覧の中で国内の構築記事にもよく登場するのが[Headplane](https://github.com/tale/headplane)で、2026年11月9日時点の最新版はv0.8.2、ライセンスはMITです。

Web画面を入れると、headscaleのAPIキーを持つ管理コンポーネントが1つ増えます。v0.8.2のリリースノートにも、ログイン済みの全員が端末ページを開けた問題の修正が含まれていました。業務で使うならインターネットに公開せず、管理用のネットワークからだけ開ける形にしてください。

## 0.29.7とTailscale 1.104.5で確かめたコマンドの挙動

手順が現行版で通るかを、2026年11月9日に確かめました。条件は、headscale 0.29.7をソースからビルドし、Tailscale 1.104.5のノード5台をmacOSのユーザー空間モード（`--tun=userspace-networking`）で同じマシンに起動した構成です。TLSなしの`127.0.0.1`で動かしたので、証明書やNAT越えの挙動はこの結果に含まれません。

| 操作                     | 結果                   |
| ---------------------- | -------------------- |
| 許可したポートへの接続            | 到達（HTTP 200）         |
| 許可していないポートへの接続         | 遮断（no rules matched） |
| 逆方向（タグ端末から個人端末）        | 遮断                   |
| 許可の無い組のtailscale ping  | 応答あり                 |
| “grants”: \[\] で再読み込み  | 全遮断                  |
| {} で再読み込み              | 全許可                  |
| 使用済みキーでの登録             | authkey already used |
| 未定義タグのキーで登録            | 成功（Tagsに表示）          |
| headscale nodes expire | 端末側がLogged out.に変化   |
| 期限切れ後に新しいキーで再登録        | 成功                   |
| 同じ操作に–force-reauthを付加  | authkey already used |

ポリシーの反映は`SIGHUP`（`systemctl reload`と同じ）で、再接続なしに効きました。注意したいのは`tailscale ping`です。公式FAQのとおりポリシーと無関係に通るので、疎通確認に使うと「通信が許可されている」と誤認します。確認は実際のポートへの接続で行ってください。

旧記事の書式は次のように失敗します。設定ファイルのエラーは起動前に`headscale configtest`で拾えます。

```
# 事前認証キーにユーザー名を渡す
Error: invalid argument "alice" for "-u, --user" flag: strconv.ParseUint: parsing "alice": invalid syntax

# randomize_client_port が設定に残っている
FATAL: The "randomize_client_port" configuration key has been removed.

# base_domain を server_url の親ドメインにした
Error: configuration error: loading configuration: server_url cannot be part of base_domain ...

# policy check で tests が失敗した
Error: rpc error: code = InvalidArgument desc = test(s) failed:
alice@ -> tag:server:18982: expected ALLOWED, got DENIED
```

一方、`prefixes`を`192.168.50.0/24`にした場合は、大きな警告バナーが出るだけで起動を止めません。範囲外の値はクライアントの予測できない不具合につながると設定例が警告しており、見落とすと原因の特定が難しくなります。起動ログの`WRN`は必ず読んでください。5台を登録した時点のheadscaleのメモリ使用量は約48MB（3回計測の中央値・48,752KB）で、データディレクトリは約700KBでした。

## 繋がらないときの切り分け：オフライン表示・期限切れ・再認証

症状から当たる順に並べます。表ではプロキシ、接続先URL、鍵の期限、ポリシー、クライアントの版を確認します。

| 症状                  | 疑う箇所             | 確認・対処              |
| ------------------- | ---------------- | ------------------ |
| healthは200でも登録失敗    | プロキシのUpgrade転送   | プロキシなしで再現を確認       |
| server\_url変更後に全台切断 | 端末の接続先が旧URL      | –force-reauth で再登録 |
| Logged out.と表示      | 端末の鍵の期限切れ        | tailscale up で再認証  |
| キーが拒否される            | 1時間の期限か使用済み      | キーを発行し直す           |
| 登録済みだが届かない          | ポリシーで不許可         | 実ポートで接続を試す         |
| 端末が接続できない           | クライアントがv1.80.0未満 | クライアントを更新          |
| headscaleが起動しない     | 不正なポリシー          | 下記の手順で修正           |

Web認証での再登録は`sudo tailscale up --login-server https://headscale.example.com --force-reauth`です。事前認証キーで入れ直すときは`--force-reauth`を付けないでください。手元の検証では、発行したばかりのキーでも付けると`authkey already used`で失敗し、外すか`tailscale logout`を挟むと成功しました。`server_url`を変えても端末の設定は自動で変わらないため、URLは運用開始前に確定させます。紛失した端末は`headscale nodes expire -i <ID>`でログアウトさせ、`headscale nodes delete -i <ID>`で削除します。

データベースに保存したポリシーが不正で起動できないときは、[公式FAQ](https://headscale.net/stable/about/faq/)の手順で、サーバーを止めたまま`headscale policy get --bypass-grpc-and-access-database-directly`で取り出して直し、同じフラグの`policy set`で戻します。

## 0.29系の破壊的変更と更新手順：古い構築記事のコマンドが動かない理由

headscaleは1.0未満で、マイナー版ごとにCLIと設定の互換性が崩れます。検索上位の構築記事にも0.28以前の手順が残っています。

### 旧手順の読み替え表：nodes register・–user・ワイルドカード

| 項目                      | 旧記事に多い書き方                | 0.29系                    |
| ----------------------- | ------------------------ | ------------------------ |
| Web認証の承認                | headscale nodes register | headscale auth register  |
| 事前認証キー                  | –user にユーザー名             | –user にID                |
| ACLの \*                 | 全IPアドレス                  | tailnet内の範囲のみ            |
| proto:icmp              | ICMPv4とICMPv6            | ICMPv4のみ                 |
| randomize\_client\_port | サーバー設定                   | ポリシーのrandomizeClientPort |

`headscale nodes register`は0.29.7でも動き、`Command "register" is deprecated`と表示したうえで登録を完了します。ただし将来の版で削除される予定なので、手順書は今のうちに書き換えます。ICMPv6は`proto:ipv6-icmp`で指定します。ホスト名が重複したときの付番も乱数の接尾辞から`laptop-1`のような連番に変わり、MagicDNS名が変わる端末が出ます。

### 0.29.5〜0.29.7の更新内容：セキュリティ修正は端末側の更新も必要

0.29.7（2026年10月30日）はセキュリティリリースで、[CHANGELOG](https://github.com/juanfont/headscale/blob/v0.29.7/CHANGELOG.md)はheadscale 0.29.7とTailscale v1.104.4以上への更新を勧めています。SSH転送やServeの脆弱性（[TS-2026-014](https://tailscale.com/security-bulletins#ts-2026-014)など）の修正は端末の`tailscaled`側にあり、サーバーだけ上げても入りません。

過去の版には運用に関わる修正も含まれます。0.29.5では、`logtail.enabled`が`false`でもクライアントがTailscale社へログを送っていた問題と、ポリシーから消したSSH規則が端末に残り続ける問題が直りました。0.29.6はGo 1.27.3でのビルドに更新され、自前でビルドする場合はGo 1.27.3以上が必要です。社外へのログ送信を前提に監査を受けている環境では、0.29.5未満を使っていないか確認してください。

### マイナー版の飛ばし更新はブロックされる：更新前のバックアップ手順

[公式のアップグレード手順](https://headscale.net/stable/setup/upgrade/)は、0.26.0から0.27.1、0.28.0のようにマイナー版を1つずつ上げるよう求めています。0.29.0からはこれが強制され、0.27から0.29への直接更新や、前のマイナー版へのダウングレードはブロックされます。

```
sudo systemctl stop headscale
TIMESTAMP=$(date +%Y%m%d%H%M%S)
sudo cp -aR /etc/headscale /etc/headscale.backup-$TIMESTAMP
sudo cp -aR /var/lib/headscale /var/lib/headscale.backup-$TIMESTAMP
# 新しいdebを入れ、設定例との差分を確認してから起動する
sudo apt install ./headscale.deb
sudo systemctl start headscale
```

更新時にはDBのマイグレーションが走るので、バックアップなしでは戻せません。0.29.0の公開（2026年6月17日）から0.29.7までの約4か月半で、パッチ版は7回出ています。月に一度はRelease一覧を確認する運用を最初に決めておきます。

## headscaleを業務で採用する条件とTailscale有料プランを選ぶ場面

判断の軸は、制御サーバーを自社で持つ理由があるか、そしてその運用を誰が引き受けるかです。費用が安いという理由だけで選ぶと、運用の人件費で逆転します。

### headscaleの負荷特性：端末数とネットワーク変更頻度

公式FAQは、headscaleを「エンタープライズ向けソフトウェアではない」と明言しています。ネットワークの変化に伴うマップ更新が負荷要因になります。ただし0.29.4以降には、通常のマップ要求でピアマップを再構築しない改善などが入っています。変化が少なければ数百台以上を扱える可能性がある一方、端末が多く変化も多い環境では負荷が下がらなくなる、と説明しています。

当社の判断としては、社員のノートPCとスマートフォンで数十台、固定のサーバーを含めても100台前後までを無理のない範囲とします。公式が保証する上限はありません。超える見込みがあるなら、最初からSaaSを選びます。

### 費用の比較：Standardの月額8ドルと自前運用の人件費

[Tailscaleの料金ページ](https://tailscale.com/pricing)では、2026年11月9日時点でPersonalが6ユーザーまで0ドル、Standardが1ユーザーあたり月8ドル、Premiumが月18ドルです。社員20人でStandardを使うと月160ドルになります。

headscale側は小さなVM1台の費用に加え、更新とポリシー変更の作業が毎月発生します。20人規模では、VM費用と「月間運用時間×時間単価」の合計を、Standardの月160ドルと比較します。headscaleが費用面で有利になるのは、ユーザー数が多いのに要件が単純な場合か、既存のLinux運用体制で追加作業を吸収できる場合などです。

### headscaleを採用しない場面：IdPグループ制御・端末検査・通信ログ

次の要件が1つでもあれば、headscaleは選びません。OIDCのグループをポリシーに使えないので、Entra IDやGoogle Workspaceのグループ変更を通信制御へ自動反映できません。端末の状態検査とネットワークフローログも未対応で、ISMSなどの監査でアクセス記録の提出を求められると説明がつきにくくなります。

逆に、閉域網の制御を外部SaaSに預けられない取引先要件がある、検証環境や工場の固定端末をつなぎたい、といった用途には合います。headscale、SaaS、従来型VPNのどれで組むかはネットワーク設計とサーバー構築を合わせて判断する必要があり、[クラウドとネットワークのインフラ構築支援](/service/system/aws/)では閉域網の方式選定から構築までを請け負っています。VPN全体の比較は[VPNの種類と企業導入の判断基準](/column/details/13215/)が出発点になります。

## headscaleの商用利用・端末接続・移行についてよくある質問

### headscaleは無料で商用利用できますか？

できます。BSD 3-Clauseライセンスで配布されており、著作権表示などの条件を守れば商用環境でも無償で使えます。ただし公式FAQのとおり開発の主眼は個人や小規模組織で、性能は優先事項ではありません。有償サポートの窓口も無いため、障害時は自社で切り分ける前提になります。

### WindowsやiPhoneのTailscaleアプリからheadscaleに接続できますか？

接続できます。公式アプリのまま、接続先のサーバーだけを変更します。手順はOSごとに異なり、本文の「公式アプリから接続する」の節で整理しました。クライアントはv1.80.0以上が条件ですが、セキュリティ修正を含めるならv1.104.4以上にしてください。

### headscaleで2要素認証は使えますか？

headscale自体に2要素認証の機能はありません。OIDCでログインする構成にして、Google WorkspaceやAuthentikなどIdP側で強制します。Web認証や事前認証キーで登録した端末には、IdP側の2要素認証は掛かりません。

### TailscaleのSaaSからheadscaleへ移行できますか？

0.29.7の公式ドキュメントに、SaaSからの移行手順の章はありません。端末ごとに接続先を変えて登録し直す作業になります。割り当てIPとMagicDNSのドメインは変わるので、IPアドレスや`ts.net`の名前を直書きした設定は事前に洗い出してください。ポリシーは書式が共通でも、デバイスポスチャなど未対応の項目は移せません。

### headscaleを使うとTailscale社にログが送られますか？

0.29.5以上なら既定では送られません。headscaleは接続した端末にログ送信を止めるよう指示し、設定項目`logtail.enabled`の既定値は`false`です。ただし0.29.5未満には、無効でも送信される不具合がありました。接続前の起動時から止めたい場合は、端末側で環境変数`TS_NO_LOGS_NO_SUPPORT=true`を設定します。

## 関連記事

- [Tailscaleの安全性は大丈夫？暗号化の仕組み・脆弱性・既定設定の落とし穴と料金【2026年10月】](/tech/details/5403/)
- [WireGuardとは？仕組み・使い方と設定手順、繋がらない時の切り分け【2026年10月】](/tech/details/7696/)
- [Tailscale SSHの設定手順：鍵配布なしで使うポリシー・チェックモード・録画と採用判断](/tech/details/18058/)
- [ゼロトラストネットワーク（ZTNA）とは？VPNとの違いと製品選定・導入判断を解説](/column/details/13099/)
- [VPNとは？仕組み・種類・メリットとデメリット、企業導入の判断基準を解説](/column/details/13215/)

---

出典: [headscaleの使い方｜Tailscale互換サーバーの構築手順とOIDC・DERP設定、0.29.7の変更点](<https://www.issoh.co.jp/tech/details/18053/>)（株式会社一創）
