# Headlamp

拡張可能なKubernetesデスクトップインターフェースです。既存の認証情報とRBAC権限を使って、複数のクラスターを閲覧・管理できます。

> これは OpenNavo の Headlamp ページの Markdown 版で、内容はウェブページと同じです： <https://opennavo.com/ja/apps/headlamp>

- **最新バージョン**: `0.46.0`
- **開発元**: Kubernetes SIG UI
- **ホームページ**: <https://headlamp.dev/>
- **カテゴリ**: [仮想化とコンテナ](https://opennavo.com/ja/categories/virtualization)
- **インストール**: `brew install --cask headlamp`
- **過去 30 日間のインストール数**: 1,207
- **Homebrew**: インストール可能、Homebrew で更新
- **ダウンロードURL**: <https://github.com/headlamp-k8s/headlamp/releases/download/v0.46.0/Headlamp-0.46.0-mac-arm64.dmg>
- **SHA-256**: `20294a2f1e92aa98c2a90aa0717b6b8e730ed55a0300c03db18c2f779ed7b564`

SHA-256 はダウンロードしたファイルが完全かを確かめるためのもので、安全性の認証ではありません。

## インストールとアンインストールの内容

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "quit": "com.kinvolk.headlamp"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "Headlamp.app"
      ],
      "target": "/Applications/Headlamp.app"
    },
    "phase": "install",
    "sources": [
      "Headlamp.app"
    ],
    "target": "/Applications/Headlamp.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/Headlamp",
            "~/Library/Logs/Headlamp",
            "~/Library/Preferences/com.kinvolk.headlamp.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 紹介

Headlampは、開発者、プラットフォームエンジニア、クラスター管理者向けのオープンソースのKubernetesインターフェースです。ワークロード、ノード、ストレージ、ネットワークの閲覧、リソースの詳細やログの確認、Podターミナルの起動ができます。また、クラスターの権限で許可されていれば、リソースの作成や編集もできます。

### デスクトップ版とクラスター内版
このパッケージはMacにHeadlamp.appをインストールします。kubeconfigと各サーバーの認証方式を使って、既存のKubernetes APIサーバーに接続します。Kubernetesのインストールやクラスターの作成は行いません。Headlampはクラスター内のWebアプリケーションとしてもデプロイできますが、これは別のデプロイ方式であり、このデスクトップアプリの利用要件ではありません。1つのインターフェースから複数のクラスターを選択できます。

### インストールと要件
Mac用パッケージは、個別のDMGダウンロードでApple SiliconとIntelに対応しています。caskにはmacOS 12以降が必要です。DMGからアプリケーションをApplicationsにコピーしてください。0.45.0のApple Silicon用DMGは143,705,681バイトです。Intel用のダウンロードサイズとインストール後のサイズは異なります。直接ダウンロードした場合は、新しいアプリをダウンロードして置き換えることで更新します。Homebrewではcaskのアップグレードを管理できます。

有効なkubeconfigを通常はKubernetesのデフォルト設定場所に配置し、APIサーバーへのネットワークアクセスを確保してください。証明書、トークン、クラウド認証ヘルパー、およびクラスターで必要なVPNやプロキシは引き続き必要です。このcaskには、追加パッケージの依存関係や競合は宣言されていません。kubectlはクラスターへのアクセスの準備や診断に役立ちますが、caskの依存関係としては宣言されていません。kubeconfigで参照する認証用の実行ファイルは、別途利用できる状態にする必要があります。

### 権限と拡張機能
閲覧、編集、スケーリング、削除が可能な対象はKubernetes RBACによって決まります。名前空間の権限が制限されている場合は、アクセス可能な名前空間の設定が必要になることがあります。Headlampは対話型の管理ツールであり、読み取り専用の監視ツールではありません。権限に基づく編集、Pod内での実行、削除は、実際のワークロードやデータに影響を与える可能性があります。kubeconfigの認証情報を保護し、適切に制限されたアクセス権限を使用してください。

プラグインカタログでは、インストール可能な拡張機能を提供しています。一部の拡張機能には、Fluxなど、クラスター内の追加ソフトウェアが必要です。プラグイン発行者のバッジは出所を示すものであり、セキュリティ監査を示すものではありません。インストール前に、プラグインのコード、権限、メンテナンス状況を確認してください。拡張機能はクラスターの機能やデスクトップのコマンド実行機能にアクセスできるため、信頼できるコードのみをインストールしてください。デスクトップでのコマンド実行への同意やその他の保護機能があっても、任意のプラグインが無害になるわけではありません。

### ライセンスと費用
HeadlampはKubernetes SIG UIコミュニティによって保守され、Apache License 2.0の下で配布されています。個人利用も商用利用も無料です。デスクトップアプリには、別途Headlampのサブスクリプションや必須のHeadlampアカウントはありません。クラスターの認証情報は引き続き必要です。また、ホスト型Kubernetes、クラウドサービス、サードパーティー連携には、それぞれ独自のアカウントや料金が必要になる場合があります。

## システム要件

- macOS 12 以降 · アプリのバージョン: 0.46.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · 2026-11-22 に確認
  - <https://github.com/headlamp-k8s/headlamp/releases/download/v0.46.0/Headlamp-0.46.0-mac-x64.dmg>
  - SHA-256: `946c72185732295fefe48e52efdb210a029eaa3fc443813bc8cbbb81b05f87ac`
- macOS 12 以降 · アプリのバージョン: 0.46.0 · Apple シリコン · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · 2026-11-22 に確認
  - <https://github.com/headlamp-k8s/headlamp/releases/download/v0.46.0/Headlamp-0.46.0-mac-arm64.dmg>
  - SHA-256: `20294a2f1e92aa98c2a90aa0717b6b8e730ed55a0300c03db18c2f779ed7b564`

## Headlamp のセキュリティ情報

ここでは確認できる事実だけを、出典と日付を添えて掲載しています。安全性を認証するものではありません。ダウンロードしたファイルを確かめるには、OpenNavo を使ってお使いの Mac 上でスキャンできます。

- <https://github.com/kubernetes-sigs/headlamp> · オープンソース: はい — <https://github.com/kubernetes-sigs/headlamp> · 2026-11-13 に確認

## アンインストール

- `brew uninstall --cask headlamp`

通常のアンインストールではアプリ本体だけを削除し、設定とキャッシュは残ります。

### 完全な削除（任意）

- `brew uninstall --zap --cask headlamp`

`--zap` は Homebrew の定義に記載された設定やキャッシュなどのファイルも削除します。ほかのアプリと共有しているデータが含まれる場合があり、削除すると元に戻せません。何も残らないことを保証するものでもありません。残しておきたいデータは先にバックアップしてください。設定とキャッシュを残す場合は、`--zap` を付けないでください。

通常のアンインストールではアプリ本体だけを削除し、設定とキャッシュは残ります。

- ファイルとフォルダ: `~/Library/Application Support/Headlamp` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · 以上の項目は Homebrew の定義に基づくもので、2026-11-22 に確認しました。定義で削除対象と宣言されている内容を示すだけで、お使いの Mac にすべてがあるとは限りません。
- ファイルとフォルダ: `~/Library/Logs/Headlamp` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · 以上の項目は Homebrew の定義に基づくもので、2026-11-22 に確認しました。定義で削除対象と宣言されている内容を示すだけで、お使いの Mac にすべてがあるとは限りません。
- ファイルとフォルダ: `~/Library/Preferences/com.kinvolk.headlamp.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · 以上の項目は Homebrew の定義に基づくもので、2026-11-22 に確認しました。定義で削除対象と宣言されている内容を示すだけで、お使いの Mac にすべてがあるとは限りません。

## 最新バージョンのリリースノート

### 0.46.0 (2026-10-15)

Kubernetes DRA のアルファ表示、階層ワークロード、Job 停止・再開、詳細パネル設定を追加。Pod 再起動後の転送再接続、OIDC、プラグイン認証情報分離などを改善。

Kubernetes DRA のアルファ表示、階層ワークロード、Job 停止・再開、詳細パネル設定を追加。Pod 再起動後の転送再接続、OIDC、プラグイン認証情報分離などを改善。

https://github.com/kubernetes-sigs/headlamp/releases/tag/v0.46.0

## 情報と出典

- <https://opennavo.com/ja/apps/headlamp>
- <https://opennavo.com/ja/apps/headlamp/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/headlamp.rb> · 2026-11-22 に確認
- <https://formulae.brew.sh/cask/headlamp>
- <https://github.com/kubernetes-sigs/headlamp> · 2026-11-13 に確認
