Whosthere

Goで書かれたインタラクティブなターミナルユーザーインターフェース（TUI）を備えたローカルエリアネットワーク検出ツール。 直感的な方法でLANを検出、探索、理解できます。

WhosthereはmDNSおよびSSDPスキャナーを使用して、非特権で並行スキャンを実行します。さらに、TCP/UDP接続を試みてARP解決をトリガーすることでローカルサブネットをスイープし、その後ARPキャッシュを読み取ってローカルエリアネットワーク上のデバイスを識別します。この手法により、昇格された権限を必要とせずにARPキャッシュが生成されます。検出されたすべてのデバイスはOUIルックアップで拡張され、利用可能な場合は製造元が表示されます。

Whosthereは、すべてのネットワーク管理者が問いかける疑問「私のネットワークに誰がいるのか？」に答えるための、親しみやすく直感的な方法を提供します。

機能

• インタラクティブなTUI: 検出されたデバイスを直感的にナビゲートして探索できます。
• 高速かつ並行: 複数の検出方法を同時に活用します。
• 昇格された権限が不要: 完全にユーザー空間で動作します。
• デバイスの拡張: OUIルックアップを使用してデバイスの製造元を表示します。
• 統合ポートスキャナー: 検出されたホストに対するオプションのサービス検出（許可を得たデバイスのみをスキャンしてください！）。
• HTTP APIを備えたデーモンモード: バックグラウンドで実行し、他のツールと統合できます。
• テーマと設定: YAML設定を通じて外観と動作をカスタマイズできます。

インストール

Homebrewでbrewを使用:

brew install whosthere

NixOSでnixを使用:

nix profile install nixpkgs#whosthere

Arch Linuxでyayを使用:

yay -S whosthere-bin

お使いのパッケージマネージャーがリストにない場合は、いつでもGoでインストールできます:

go install github.com/ramonvermeulen/whosthere@latest

またはソースからビルド:

git clone https://github.com/ramonvermeulen/whosthere.git
cd whosthere
make build

さらに、リリースページからビルド済みバイナリをダウンロードできます。

使用方法

インタラクティブな検出のためにTUIを実行:

whosthere

単一のスキャンを実行して結果を出力するCLIとして実行:

whosthere scan -t 5

結果をJSONファイルに出力:

whosthere scan -t 5 --json --pretty > devices.json

HTTP APIを備えたデーモンとして実行:

whosthere daemon --port=8080

追加のコマンドラインオプションは以下を実行して確認できます:

whosthere --help

キーバインド（TUI）

キー	アクション
/	正規表現検索を開始
k	上
j	下
g	先頭へ移動
G	末尾へ移動
y	選択したデバイスのIPをコピー
Y	選択したデバイスのMACをコピー
enter	デバイスの詳細を表示
CTRL+t	テーマセレクターを切り替え
CTRL+i	インターフェースセレクターを切り替え
CTRL+c/q	アプリケーションを停止
ESC	検索をクリア / 戻る
p (詳細ビュー)	デバイスでポートスキャンを開始
tab (モーダルビュー)	ボタン選択を切り替え

設定

Whosthereは複数の設定方法をサポートしており、以下の優先順位（高い順から低い順）があります:

1. コマンドラインフラグ - 最優先。利用可能なフラグはwhosthere --helpを参照してください。
2. 環境変数 - WHOSTHERE__をプレフィックスとして付けます。環境変数による設定を参照してください。
3. 設定ファイル - YAML設定ファイル。設定ファイルを参照してください。
4. デフォルト値 - フォールバックのデフォルト。config.goのDefaultConfig()を参照してください。

設定ファイル

Whosthereは以下の順序で設定ファイルを探し、最初に見つかったものを使用します:

1. --configフラグまたはWHOSTHERE_CONFIG環境変数で指定されたパス
2. $XDG_CONFIG_HOME/whosthere/config.yaml（XDG_CONFIG_HOMEが設定されている場合）
3. ~/.config/whosthere/config.yaml（デフォルトの場所）

設定例:

# Uncomment the next line to configure a specific network interface - uses OS default if not set
# network_interface: eth0

# When enabled, devices from all network interfaces are shown and persist when switching interfaces
# Note: if two interfaces share the same subnet (e.g. both use 192.168.1.x), devices may get merged
# since they are identified by IP address. Use with caution on overlapping subnets.
all_interfaces: false

# Optional IPv4 CIDR subnets to sweep. When set, the sweeper skips the auto-detected interface subnet unless it is listed here.
# target_subnets: ["10.0.0.0/24", "10.0.1.0/24"]

# WARNING: scanning subnets larger than /16 sends packets to 65535+ IPs per subnet. Enable only if you understand the traffic implications. Consider using smaller /24 subnets for targeted scanning.
# scan_large_subnets: false

# How often to run discovery scans
scan_interval: 20s

# Maximum timeout for each scan, recommended to be less than the scan interval
scan_timeout: 10s

scanners:
  mdns:
    enabled: true
  ssdp:
    enabled: true
  arp:
    enabled: true

sweeper:
  enabled: true
  interval: 5m
  timeout: 20s

port_scanner:
  timeout: 5s
  # List of TCP ports to scan on discovered devices
  tcp: [21, 22, 23, 25, 80, 110, 135, 139, 143, 389, 443, 445, 993, 995, 1433, 1521, 3306, 3389, 5432, 5900, 8080, 8443, 9000, 9090, 9200, 9300, 10000, 27017]

splash:
  enabled: true
  delay: 1s

theme:
  # When disabled, the TUI will use the terminal it's default ANSI colors
  # Also see the NO_COLOR environment variable to completely disable ANSI colors
  enabled: true

  # See the complete list of available themes at https://github.com/ramonvermeulen/whosthere/tree/main/internal/ui/theme/theme.go
  # Set name to "custom" to use the custom colors below
  # For any color that is not configured it will take the default theme value as fallback
  name: default

  # Disable ANSI colors completely, overrides theme.enabled
  # Can also be set via NO_COLOR or WHOSTHERE__THEME__NO_COLOR environment variables
  # no_color: false

  # Custom theme colors (uncomment and set name: custom to use)
  # primitive_background_color: "#000a1a"
  # contrast_background_color: "#001a33"
  # more_contrast_background_color: "#003366"
  # border_color: "#0088ff"
  # title_color: "#00ffff"
  # graphics_color: "#00ffaa"
  # primary_text_color: "#cceeff"
  # secondary_text_color: "#6699ff"
  # tertiary_text_color: "#ffaa00"
  # inverse_text_color: "#000a1a"
  # contrast_secondary_text_color: "#88ddff"

環境変数

一般的な環境変数

変数	説明
WHOSTHERE_CONFIG	設定ファイルへのパス。デフォルトの場所を上書きできます。
WHOSTHERE_LOG	ログレベルを設定します（例: debug、info、warn、error）。デフォルトはinfoです。
NO_COLOR	TUIのANSIカラーを無効にします。

環境変数による設定

YAML設定で利用可能なすべての設定オプションは、WHOSTHERE__プレフィックス（二重アンダースコアに注意）を使用して環境変数で設定できます。ネストされた設定キーは二重アンダースコアで区切られ、キーは大文字と小文字を区別しません。

例: