最終更新:2026-09-16 (水) 06:17:14 (22d)  

Beszel/エージェント
Top / Beszel / エージェント

https://www.beszel.dev/guide/agent-installation

インストール方法

  • Docker/Podman
  • 単一のバイナリファイル
  • Homebrewパッケージ
  • WinGet/Scoopパッケージ
  • Home Assistantアドオン

必須変数

  • KEY: ハブにシステムを追加する際に表示される公開鍵。
  • TOKEN: エージェントの認証に使用されます (参照/settings/tokens)。
  • HUB_URL: 発信WebSocket接続に使用されます(SSH接続には不要です)。

仕組み

  • Agentのポート45876にHubが接続しに行く

システム追加

  • 管理画面で追加するPCの
    • マシン名
    • ホスト名かIP
    • 待受ポート
    • 公開鍵
    • トークン
  • を入力して、トークンとHUB_URLをagentの方に設定

Windows

  • & iwr -useb https://get.beszel.dev -OutFile "$env:TEMP\install-agent.ps1"; & Powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-agent.ps1"
  • Keyを聞かれる (管理画面のシステムを追加のところに出ている公開鍵)
  • WinGetでbeszel-agent?がインストールされる
  • NSSMでサービスが作成される
  • 確認
    • 別のPowerShellを開く (パスが反映されていないため)
    • nssm status? beszel-agent
    • nssm edit? beszel-agent
      • URLとトークンをEnvironmentタブで編集
        TOKEN=xxxx
        HUB_URL=http://xxxxx.local:8090
  • 管理者権限のPowerShellで再起動: nssm restart? beszel-agent

macOS

GUIのインストーラー

  • Beszel Agent Installer? (archived)
  • BeszelAgentManager 4?