เครื่องสแกน IP เครือข่ายน้ำหนักเบาพร้อมเว็บ GUI คุณสมบัติ:
ส่งการแจ้งเตือนเมื่อพบโฮสต์ใหม่
ตรวจสอบโฮสต์ประวัติออนไลน์/ออฟไลน์
เก็บรายชื่อโฮสต์ทั้งหมดในเครือข่าย
ส่งข้อมูลไปยัง InfluxDB2
เพื่อสร้างแดชบอร์ด Grafana
แทนที่ $YOURTIMEZONE
ด้วยเขตเวลาที่ถูกต้อง และ $YOURIFACE
ด้วยอินเทอร์เฟซเครือข่ายที่คุณต้องการสแกน โหมดเครือข่ายจะต้องเป็น host
ตั้งค่า $DOCKERDATAPATH
สำหรับคอนเทนเนอร์เพื่อบันทึกข้อมูล:
นักเทียบท่าวิ่ง -- ชื่อ wyl -e "IFACES=$ของคุณ" -e "TZ=$เขตเวลาของคุณ" --เครือข่าย = "โฮสต์" -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN เอซเบิร์ก/วอทช์ยัวร์แลน
เว็บ GUI ควรอยู่ที่ http://localhost:8840
WatchYourLAN ไม่มีตัวเลือกการตรวจสอบสิทธิ์ในตัว แต่คุณสามารถใช้กับเครื่องมือ SSO เช่น Authelia หรือแอปตรวจสอบสิทธิ์แบบธรรมดาของฉัน ForAuth ได้
นี่คือตัวอย่าง 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
repo ให้ใช้งาน
การกำหนดค่าสามารถทำได้ผ่านไฟล์กำหนดค่า GUI หรือตัวแปรสภาพแวดล้อม ชื่อตัวแปรคือไฟล์ config_v2.yaml
เหมือนกัน แต่ใช้ตัวพิมพ์เล็ก
ตัวแปร | คำอธิบาย | ค่าเริ่มต้น |
---|---|---|
ทซ | ตั้งค่าเขตเวลาของคุณให้เป็นเวลาที่ถูกต้อง | |
เจ้าภาพ | ที่อยู่ฟัง | 0.0.0.0 |
ท่าเรือ | พอร์ตสำหรับเว็บ GUI | 8840 |
ธีม | ชื่อธีมใดๆ จาก https://bootswatch.com เป็นตัวพิมพ์เล็กหรือเพิ่มเติม | ทราย |
สี | สีพื้นหลัง: สว่างหรือมืด | มืด |
นพพาธ | พาธไปยังโมดูลโหนดโลคัล | |
SHOUTRRR_URL | WatchYourLAN ใช้ Shoutrrr เพื่อส่งการแจ้งเตือน มีการผสานรวมแล้ว เพียงต้องการ URL ที่ถูกต้อง ตัวอย่าง Discord, Email, Gotify, Matrix, Ntfy, Pushover, Slack, Telegram, Generic Webhook และอื่นๆ อยู่ที่นี่ |
ตัวแปร | คำอธิบาย | ค่าเริ่มต้น |
---|---|---|
ไอเฟซ | อินเทอร์เฟซในการสแกน อาจเป็นอย่างน้อยหนึ่งรายการ โดยคั่นด้วยช่องว่าง ดูเอกสาร/VLAN_ARP_SCAN.md | |
หมดเวลา | เวลาระหว่างการสแกน (วินาที) | 120 |
ARP_ARGS | อาร์กิวเมนต์สำหรับ arp-scan เปิดใช้งานระดับบันทึก debug เพื่อดูคำสั่งผลลัพธ์ (ตัวอย่าง: -r 1 ) ดูเอกสาร/VLAN_ARP_SCAN.md | |
ARP_STRS ARP_STRS_เข้าร่วม | ดูเอกสาร/VLAN_ARP_SCAN.md | |
LOG_LEVEL | ระดับการบันทึก: debug , info , warn หรือ error | ข้อมูล |
TRIM_HIST | ลบประวัติหลังจาก (ชั่วโมง) | 48 |
HIST_IN_DB | ประวัติร้านค้าในฐานข้อมูล - หากเป็น false ประวัติจะถูกจัดเก็บไว้ในหน่วยความจำเท่านั้น และจะหายไปเมื่อรีสตาร์ทแอป แม้ว่ามันจะทำให้ฐานข้อมูลแอปมีขนาดเล็กลง (และแนะนำให้ใช้ InfluxDB สำหรับการจัดเก็บประวัติในระยะยาว) | เท็จ |
USE_DB | sqlite หรือ postgres ก็ได้ | ตร.ม |
PG_CONNECT | ที่อยู่สำหรับเชื่อมต่อกับ PostgreSQL (ตัวอย่าง: postgres://username:[email protected]:5432/dbname?sslmode=disable ) รายการพารามิเตอร์ URL ทั้งหมดที่นี่ |
การกำหนดค่านี้ตรงกับการกำหนดค่าของ Grafana สำหรับแหล่งข้อมูล InfluxDB
ตัวแปร | คำอธิบาย | ค่าเริ่มต้น | ตัวอย่าง |
---|---|---|---|
ไหลเข้า_เปิดใช้งาน | เปิดใช้งานการส่งออกไปยัง 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: ""สี: 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: ""พอร์ต: "8840" ตะโกนrrr_url: "gotify://192.168.0.1:8083/AwQqpAae.rrl5Ob/?title=ตรวจพบโฮสต์ที่ไม่รู้จัก&ปิดการใช้งานTLS=yes"ธีม: sandtimeout: 60trim_hist: 48use_db: sqlite
สำคัญ | คำอธิบาย | ค่าเริ่มต้น |
---|---|---|
-d | เส้นทางในการกำหนดค่า dir | /data/WatchYourLAN |
-n | เส้นทางไปยังโมดูลโหนด (ดูด้านล่าง) |
ตามค่าเริ่มต้น แอปนี้จะดึงธีม ไอคอน และแบบอักษรจากอินเทอร์เน็ต แต่ในบางกรณี การมีความเป็นอิสระจากการตั้งค่าเครือข่ายทั่วโลกอาจเป็นประโยชน์ ฉันสร้างอิมเมจแยกต่างหากพร้อมโมดูลและแบบอักษรที่จำเป็นทั้งหมด รันด้วยนักเทียบท่า:
นักเทียบท่ารัน --name node-bootstrap -หน้า 8850:8850 aceberg/โหนด-bootstrap
นักเทียบท่าวิ่ง -- ชื่อ wyl -e "IFACES=$ของคุณ" -e "TZ=$เขตเวลาของคุณ" --เครือข่าย = "โฮสต์" -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN aceberg/watchyourlan -n "http://$YOUR_IP:8850"
หรือใช้นักเทียบท่าเขียน
ย้ายไปที่ docs/API.md
ไคลเอ็นต์ Python API โดย drwahl
แพ็คเกจ go ทั้งหมดแสดงรายการอยู่ในการอ้างอิง
Favicon และโลโก้: ไอคอนจุดเข้าใช้งานที่สร้างโดย Freepik - Flaticon
บูทสแตรป
ธีม: ธีมฟรีสำหรับ Bootstrap