OPNsense クライアント概要プラグイン (opnsense-topo-map)

Web
OPNsense クライアント概要プラグイン (opnsense-topo-map)

OPNsense クライアント概要プラグイン (opnsense-topo-map)

OPNsense向けの「UniFi Network風」クライアントダッシュボードプラグインです。接続中デバイスを左側のリスト、右側の詳細パネルで表示し、デバイスごとのカスタムアイコンやMACアドレス単位のエイリアス保存、デバイスタイプの上書きなどの機能を備えます。Voltテンプレートを中心に軽量に実装され、アイコン取得用スクリプトやMakefileでのパッケージ化補助が含まれます。

https://github.com/flaviuvlaicu/opnsense-topo-map

概要

OPNsense向けのクライアント表示プラグイン「OPNsense Client Overview Plugin v2（opnsense-topo-map）」は、UniFiのダッシュボードのようなレイアウトで接続中デバイスを見やすく一覧表示します。左にデバイスリスト、右に選択デバイスの詳細パネルを置き、デバイスごとのカスタムアイコンアップロード（PNG/SVG/JPG対応）、MACアドレス単位でのエイリアス保存、デバイスタイプの手動上書きなど、運用者が視覚的に管理しやすいUIを提供します。軽量なVoltテンプレート群と補助スクリプトで構成され、OPNsense環境に馴染むプラグイン設計です。

GitHub

リポジトリの統計情報

  • スター数: 18
  • フォーク数: 0
  • ウォッチャー数: 18
  • コミット数: 3
  • ファイル数: 9
  • メインの言語: Volt

主な特徴

  • UniFi風の二ペインレイアウト（左：デバイスリスト、右：詳細パネル）
  • デバイスごとのカスタムアイコン（PNG/SVG/JPG）をアップロード可能
  • MACアドレス単位でのエイリアス保存により機器名を一元管理
  • デバイスタイプを手動で編集して分類を上書き可能

技術的なポイント

本プロジェクトはOPNsenseのプラグインUIを想定した軽量フロントエンドコンポーネントで、主要なテンプレートはVolt（OPNsenseでよく使われるテンプレート言語）で記述されています。UI構成は典型的なリスト＋詳細ビューで、クライアント情報の取得はOPNsenseの内部APIや設定情報を参照する想定です（READMEでの機能説明から推測）。アイコン管理はリポジトリ付属のdownload_icons.shによる外部アイコン取得をサポートし、ユーザーが個別にアップロードしたアイコンも利用できます。Makefileが用意されているため、パッケージングやデプロイの一部自動化が可能です。開発履歴は軽量でコミット数は少なく、導入前にOPNsenseのバージョン互換性や、アップロードアイコンの保存先（構成保存やファイルストア）など運用面の確認が必要です。プラグイン側でのクライアント分類やエイリアス保存はMACアドレスをキーにした永続化設計が見られ、ネットワーク運用時の可視化・管理負担を軽減します。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .DS_Store: file（macOSのメタファイル。リポジトリに含まれているが無視推奨）
  • .gitignore: file（無視するファイル／ディレクトリ定義）
  • Makefile: file（パッケージ化やインストール用のルールを収める補助ファイル）
  • README.md: file（機能説明、使い方や要件の紹介）
  • download_icons.sh: file（アイコンを外部から取得するためのシェルスクリプト。アイコンセットの補充や初期配置を想定）
  • 他 4 ファイル（Voltテンプレート、静的資産、JavaScript/CSSなどが含まれている想定。OPNsense用のビューやコントローラ配置に合わせた構成）

リポジトリ規模は小さく、テンプレートやスクリプト中心で実装されているため、OPNsenseのプラグイン開発経験があれば読み解きやすい構成です。Makefileとアイコン取得スクリプトがあるため、導入前にそれらを使って必要資産を揃え、OPNsense上の配置先へデプロイする手順を確認すると良いでしょう。

まとめ

シンプルで視認性重視のOPNsenseクライアント可視化プラグイン。カスタムアイコンとエイリアス管理が魅力。

リポジトリ情報：

READMEの抜粋：

OPNsense Client Overview Plugin v2

A UniFi Network-style client dashboard for OPNsense. Shows all connected devices in a clean list with a detail panel, custom icons, and device classification.

Features

  • UniFi-style layout — device list on the left, detail panel on the right
  • Custom icons per device — click the device icon to upload your own PNG/SVG/JPG
  • Custom device names — set an alias for any device (saved per MAC address)
  • Editable device type — override the …