Web GUI を備えた軽量のネットワーク IP スキャナー。特徴:
新しいホストが見つかったときに通知を送信する
ホストのオンライン/オフライン履歴を監視する
ネットワーク内のすべてのホストのリストを保持する
InfluxDB2
にデータを送信してGrafana
ダッシュボードを作成する
$YOURTIMEZONE
正しいタイムゾーンに置き換え、 $YOURIFACE
スキャンするネットワークインターフェイスに置き換えます。ネットワークモードはhost
でなければなりません。データを保存するコンテナーに$DOCKERDATAPATH
を設定します。
docker run --name wyl -e "IFACES=$YOURIFACE" -e "TZ=$YOURTIMEZONE" --network="ホスト" -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN エースバーグ/ウォッチユアラン
Web GUI は http://localhost:8840 にある必要があります。
WatchYourLAN には組み込みの認証オプションがありません。ただし、Authelia や私のシンプルな認証アプリ ForAuth などの SSO ツールで使用できます。
以下は docker-compose-auth.yml の例です。
⚠️ 警告!
WYL が動作するにはhost
ネットワーク モードが必要であることを忘れないでください。したがって、この設定では WYL ポートが公開されます。ファイアウォールなどの手段でアクセスを制限する必要があります。
すべてのバイナリ パッケージは最新リリースにあります。 .deb
、 .rpm
、 .apk
(Alpine Linux) および.tar.gz
ファイルがあります。
サポートされているアーキテクチャ: amd64
、 i386
、 arm_v5
、 arm_v6
、 arm_v7
、 arm64
。
依存関係: arp-scan
、 tzdata
。
amd64
の場合はdeb
リポジトリが利用可能です
構成は、構成ファイル、GUI、または環境変数を通じて実行できます。変数名はconfig_v2.yaml
ファイルと同じですが、小文字になっています。
変数 | 説明 | デフォルト |
---|---|---|
TZ | タイムゾーンを正しい時刻に設定する | |
ホスト | リッスンアドレス | 0.0.0.0 |
ポート | Web GUI 用のポート | 8840 |
テーマ | https://bootswatch.com からの小文字または追加のテーマ名 | 砂 |
色 | 背景色: 明るいまたは暗い | 暗い |
ノードパス | ローカルノードモジュールへのパス | |
SHOUTRRR_URL | WatchYourLAN は Shoutrrr を使用して通知を送信します。すでに統合されているため、必要なのは正しい URL だけです。 Discord、Email、Gotify、Matrix、Ntfy、Pushover、Slack、Telegram、Generic Webhook などの例はここにあります |
変数 | 説明 | デフォルト |
---|---|---|
IFACES | スキャンするインターフェース。スペースで区切って 1 つ以上指定できます。 docs/VLAN_ARP_SCAN.md を参照してください。 | |
タイムアウト | スキャン間の時間 (秒) | 120 |
ARP_ARGS | arp-scan の引数。 debug ログ レベルを有効にして、結果のコマンドを確認します。 (例: -r 1 )。 docs/VLAN_ARP_SCAN.md を参照してください。 | |
ARP_STRS ARP_STRS_JOINED | docs/VLAN_ARP_SCAN.md を参照してください。 | |
LOG_LEVEL | ログレベル: debug 、 info 、 warn またはerror | 情報 |
TRIM_HIST | (時間)後に履歴を削除します | 48 |
HIST_IN_DB | 履歴を DB に保存 - false の場合、履歴はメモリにのみ保存され、アプリの再起動時に失われます。ただし、アプリ DB は小さくなります (長期の履歴ストレージには InfluxDB が推奨されます)。 | 間違い |
USE_DB | sqlite またはpostgres いずれか | スクライト |
PG_CONNECT | PostgreSQL に接続するためのアドレス。 (例: postgres://username:[email protected]:5432/dbname?sslmode=disable )。 URLパラメータの完全なリストはこちら |
この構成は、InfluxDB データ ソースの Grafana の構成と一致します。
変数 | 説明 | デフォルト | 例 |
---|---|---|---|
INFLUX_ENABLE | InfluxDB2 へのエクスポートを有効にする | 間違い | 真実 |
INFLUX_SKIP_TLS | TLS検証をスキップ | 間違い | 真実 |
INFLUX_ADDR | アドレス:InfluxDB2 サーバーのポート | https://192.168.2.3:8086/ | |
INFLUX_BUCKET | InfluxDB2 バケット | テスト | |
INFLUX_ORG | InfluxDB2 組織 | 家 | |
INFLUX_TOKEN | InfluxDB2 によって生成されたシークレット トークン |
構成ファイル名はconfig_v2.yaml
です。例:
arp_args: ""color: darkhist_in_db: falsehost: 0.0.0.0ifaces: enp4s0influx_addr: ""influx_bucket: ""influx_enable: falseinflux_org: ""influx_skip_tls: falseinflux_token: ""log_level: infonodepath: ""pg_connect: ""port: "8840"shoutrrr_url: "gotify://192.168.0.1:8083/AwQqpAae.rrl5Ob/?title=不明なホストが検出されました&DisableTLS=yes"theme: Sandtimeout: 60trim_hist: 48use_db: sqlite
鍵 | 説明 | デフォルト |
---|---|---|
-d | 構成ディレクトリへのパス | /data/WatchYourLAN |
-n | ノードモジュールへのパス (以下を参照) |
デフォルトでは、このアプリはテーマ、アイコン、フォントをインターネットから取得します。ただし、場合によっては、グローバル ネットワーク設定から独立した方が便利な場合があります。必要なすべてのモジュールとフォントを含む別のイメージを作成しました。 Docker で実行します。
docker run --name ノードブートストラップ -p 8850:8850 aceberg/ノードブートストラップ
docker run --name wyl -e "IFACES=$YOURIFACE" -e "TZ=$YOURTIMEZONE" --network="ホスト" -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN aceberg/watchyourlan -n "http://$YOUR_IP:8850"
または docker-compose を使用します
docs/API.md に移動
drwahl による Python API クライアント
依存関係にリストされているすべての go パッケージ
ファビコンとロゴ: Freepik によって作成されたアクセス ポイントのアイコン - Flaticon
ブートストラップ
テーマ: Bootstrap 用の無料テーマ