インストール

追加のインストールコマンド

macOS

Homebrew確認済み · 100%

brew install headscale-cli

local Homebrew formula metadata

Linux

Alpine Linux apk確認済み · 92%

sudo apk add headscale

Alpine Linux edge package indexes · headscale · ソース: dl-cdn.alpinelinux.org

Fedora dnf確認済み · 92%

sudo dnf install headscale

Fedora Rawhide package metadata · headscale · ソース: dl.fedoraproject.org

Nix確認済み · 92%

nix profile install nixpkgs#headscale

nixpkgs package indexes · pkgs/by-name/he/headscale/package.nix · ソース: api.github.com

Arch Linux pacman確認済み · 92%

sudo pacman -S headscale

Arch Linux sync databases · headscale · ソース: geo.mirror.pkgbuild.com

openSUSE zypper確認済み · 92%

sudo zypper install headscale

openSUSE Tumbleweed package metadata · headscale · ソース: download.opensuse.org

概要

パッケージ概要

CLI for headscale, an open-source implementation of the Tailscale control server

プロジェクトリンク

コマンドとエイリアス

headscale

履歴

プロジェクトの歴史と使われ方

headscale-cli is the packaged command-line client for Headscale, an open source, self-hosted implementation of the Tailscale control server. The package exists for operators who want the `headscale` executable on a workstation without installing the full server formula.

プロジェクトの歴史

Headscale's repository was created in June 2020, after Tailscale popularized WireGuard-based private overlay networks with a proprietary coordination server. The upstream README states the design goal plainly: implement a self-hosted, open source alternative to the Tailscale control server for self-hosters, hobbyists, personal networks, and small open source organizations.

The CLI is part of the same Go codebase as the server. It manages users, nodes, pre-auth keys, routes, DNS, policies, API keys, and other control-plane state. The remote CLI path became important when operators wanted to administer a server from another machine rather than SSHing into the host.

Headscale 0.13.0 added API key support and remote control of headscale via CLI. The remote CLI documentation requires a server version of 0.13.0 or newer, TLS, an API key, and environment variables for the CLI address and key.

採用の歴史

Headscale adoption is tied to the self-hosted networking community and to users who like Tailscale clients but want to operate their own control plane. The repository's popularity and package spread across Homebrew, Nix, Alpine, Fedora, Arch, and openSUSE ecosystems show that it became a standard item in self-hosting package sets.

The separate Homebrew headscale-cli packaging reflects a practical operator split: servers run on Linux or containers, while administrative workstations may be macOS laptops that only need the client binary.

使われ方

Local usage starts with built-in help and server-side actions such as creating users, registering nodes, and generating pre-auth keys. Remote usage creates an API key on the server, installs the same-version headscale binary on the workstation, sets HEADSCALE_CLI_ADDRESS and HEADSCALE_CLI_API_KEY, and then runs commands such as `headscale nodes list` against the remote instance.

The CLI is also part of automated Headscale operations: scripts can create users, manage registration keys, list or expire nodes, and inspect routes without touching the database directly.

パッケージ好きにとっての重要性

headscale-cli is a package-nerd favorite because it separates admin tooling from daemon deployment. The Homebrew package lets a macOS or Linux workstation manage a Headscale server while the server itself might be installed from a distro package, container image, NixOS module, or source build.

It is also a good example of packaging around a monorepo executable: the upstream project ships one binary, while package managers can expose a CLI-only formula to avoid pulling users into a server service lifecycle they did not ask for.

タイムライン

2020-06: Headscale repository created.
2022-02: 0.13.0 added API key support and remote CLI control.
2022-02: Remote CLI documentation described same-version client and server requirements.
2023-02: Headscale was presented at FOSDEM as an integration-testing driven reimplementation of Tailscale.
2026-02: 0.28.0 continued compatibility work around tags, API shape, and Tailscale semantics.
2026-06: 0.29.0 documented further Tailscale ACL compatibility improvements.

Related projects

Tailscale is the upstream client ecosystem and proprietary hosted control server that Headscale reimplements for self-hosting.
WireGuard is the encrypted tunnel technology used by Tailscale clients.
DERP, MagicDNS, ACLs, routes, and OIDC are related Tailscale/Headscale control-plane concepts managed through Headscale.
NixOS modules, container images, and Linux distro packages are common deployment companions for the server while headscale-cli is used from an admin workstation.

ソース

セキュリティ状態

リスクレベル: blue

broad file, network, media, or database tool signal.

リスク分類器

リスク blue · 信頼度中 · tool

理由

broad file, network, media, or database tool signal

信号

text:server

インストール挙動

formula メタデータに Homebrew post-install フックは記録されていません。
Homebrew bottle メタデータは 6 個のプラットフォームターゲットで利用できます。
ビルドメタデータには 1 件のビルド依存関係があります。

推奨レビュー

エージェントに無人実行させる前に、このツールが平文の認証情報を読むか、リモート状態を書き込むか、成果物を公開するか、プラグインを起動するかを確認してください。

実行可能ファイル

インストールされる実行可能ファイル

コマンド	種類	公開範囲	メモ
`headscale`	cli	グローバル実行可能ファイル

鮮度

バージョンと鮮度

これらの信号は、ページ生成時期、パッケージマネージャの活動、上流リリース比較を分けて示します。バージョン遅れは、証拠 URL と比較可能なバージョンがある場合だけ警告されます。

ページ生成日2026-07-26

マネージャ版0.29.2

マネージャ更新日2026-07-02

ローカルデータOK

上流最新

検出された最新v0.29.2

https://github.com/juanfont/headscale

OK鮮度警告は生成されていません。

インストールメタデータ

パッケージメタデータ

パッケージキー	brew:headscale-cli
バージョン	0.29.2
パッケージマネージャ	Homebrew
パッケージマネージャページ	https://formulae.brew.sh/formula/headscale-cli
ホームページ	https://github.com/juanfont/headscale
リポジトリ	https://github.com/juanfont/headscale
上流ドキュメント	https://docs.headscale.org/ref/remote-cli
ライセンス	BSD-3-Clause
ソースアーカイブ	https://github.com/juanfont/headscale/archive/refs/tags/v0.29.2.tar.gz
最終更新	2026-07-02T02:01:09Z
Pulse	updated
ビルド依存関係	go
Bottle	利用可能 (対象 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	未定義
サービス	宣言なし

レジストリ情報

ソースデータベース詳細

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	headscale-cli
Version Scheme	0
Revision	0
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	stable

ソースデータベース一致

他のパッケージマネージャ記録

一致は外部パッケージマネージャインデックスから取得され、ローカルの Automic Vault パッケージリンクとは分けて表示されます。

Nix92%

headscale

nix profile install nixpkgs#headscale

installed executable or alias match
一致条件: Headscale

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/he/headscale/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

apk92%

headscale 0.27.1-r5

Open source, self-hosted implementation of the Tailscale control server

https://github.com/juanfont/headscale

sudo apk add headscale

License: BSD-3-Clause
Architecture: x86_64
Source Package: headscale
1 依存関係
1 提供
installed executable or alias match
一致条件: Headscale

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: headscale from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk92%

headscale-bash-completion 0.27.1-r5

Bash completions for headscale

https://github.com/juanfont/headscale

sudo apk add headscale-bash-completion

License: BSD-3-Clause
Architecture: x86_64
Source Package: headscale
installed executable or alias match
一致条件: Headscale

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: headscale-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk92%

headscale-fish-completion 0.27.1-r5

Fish completions for headscale

https://github.com/juanfont/headscale

sudo apk add headscale-fish-completion

License: BSD-3-Clause
Architecture: x86_64
Source Package: headscale
installed executable or alias match
一致条件: Headscale

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: headscale-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk92%

headscale-openrc 0.27.1-r5

Open source, self-hosted implementation of the Tailscale control server (OpenRC init scripts)

https://github.com/juanfont/headscale

sudo apk add headscale-openrc

License: BSD-3-Clause
Architecture: x86_64
Source Package: headscale
installed executable or alias match
一致条件: Headscale

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: headscale-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

apk92%

headscale-zsh-completion 0.27.1-r5

Zsh completions for headscale

https://github.com/juanfont/headscale

sudo apk add headscale-zsh-completion

License: BSD-3-Clause
Architecture: x86_64
Source Package: headscale
installed executable or alias match
一致条件: Headscale

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: headscale-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

dnf92%

headscale 0.28.0-1.fc45

Self-hosted implementation of the Tailscale control server

https://github.com/juanfont/headscale

sudo dnf install headscale

License: BSD-2-Clause AND MIT AND Apache-2.0 AND MPL-2.0 AND BSD-2-Clause-Views AND ISC AND BSD-3-Clause AND ISC
Category: Unspecified
Architecture: x86_64
Source Package: headscale
6 依存関係
5 提供
installed executable or alias match
一致条件: Headscale

Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: headscale from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

pacman92%

headscale 0.28.0-1

An open source, self-hosted implementation of the Tailscale coordination server.

https://github.com/juanfont/headscale

sudo pacman -S headscale

License: BSD-3-Clause
Architecture: x86_64
1 依存関係
2 任意依存関係
installed executable or alias match
一致条件: Headscale

Arch Linux sync databases · geo.mirror.pkgbuild.com · Arch Linux sync databases: headscale from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

zypper92%

headscale 0.28.0-1.4

An open source, self-hosted implementation of the Tailscale control server

https://headscale.net

sudo zypper install headscale

License: BSD-3-Clause
Category: Unspecified
Architecture: x86_64
Source Package: headscale
3 依存関係
3 提供
installed executable or alias match
一致条件: Headscale

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: headscale from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

パッケージグラフ

リンクは、ローカルのパッケージ関係グラフ、補足データ、依存関係、エコシステム一致、パッケージハブ所属から来ています。

ソース経路

リポジトリデータから生成

このページは scripts/generate-pkg-sqlite.py が生成した非公開のパッケージ SQLite アーティファクトから av-web によって提供されます。

Combined YAML source

View the package source record on GitHub.

combined/headscale-cli.yml

使用ソース

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

headscale-cli を Homebrew, apk, dnf, Nix, pacman, zypper でインストール

追加のインストールコマンド

macOS

Linux

パッケージ概要

プロジェクトリンク

コマンドとエイリアス

プロジェクトの歴史と使われ方

プロジェクトの歴史

採用の歴史

使われ方

パッケージ好きにとっての重要性

タイムライン

Related projects

ソース

リスクレベル: blue

リスク分類器

理由

信号

インストール挙動

推奨レビュー

インストールされる実行可能ファイル

バージョンと鮮度

パッケージメタデータ

ソースデータベース詳細

他のパッケージマネージャ記録

内部パッケージリンク

トピック別ハブ

関連ツール

同じワークフロー

エージェント安全ガイド

リポジトリデータから生成

Combined YAML source

使用ソース