WatchYourLAN: Quét mạng LAN nhẹ như lông, dashboard đẹp như mơ

TL;DR

Bạn có biết mạng nhà mình đang có bao nhiêu thiết bị kết nối không? WatchYourLAN là một open-source network scanner viết bằng Go - nhẹ, nhanh, có web dashboard đẹp - giúp bạn theo dõi toàn bộ thiết bị trong LAN theo thời gian thực. Từng lên #1 GitHub Trending Repository of the Day, với 6.9k stars và hơn 1 triệu Docker pulls.

Vấn đề bạn đang bỏ qua

Mạng nhà bạn không chỉ có máy tính và điện thoại. Smart TV, camera IP, router phụ, máy in Wi-Fi, thiết bị IoT - chúng âm thầm kết nối mà bạn không hay biết. Mỗi thiết bị là một cửa vào tiềm tàng nếu cấu hình sai hoặc firmware lỗi thời.

Các giải pháp thông thường hoặc quá phức tạp (Nmap yêu cầu command-line thành thạo), hoặc quá nặng (NetAlertX phù hợp cho mạng doanh nghiệp). WatchYourLAN lấp đúng khoảng trống đó: đơn giản, nhẹ, đủ dùng cho home lab và văn phòng nhỏ.

Bên trong hoạt động thế nào

WatchYourLAN dùng arp-scan để quét mạng theo chu kỳ (mặc định 120 giây). Mỗi lần quét, tool so sánh danh sách thiết bị hiện tại với database và:

• Phát hiện thiết bị mới chưa từng thấy - gửi cảnh báo ngay
• Ghi nhận trạng thái online/offline theo timeline
• Lưu thông tin: IP, MAC address, hostname, nhà sản xuất (từ MAC OUI lookup)
• Push metrics sang InfluxDB2 hoặc Prometheus nếu bạn có Grafana dashboard

Backend viết bằng Go, frontend được rewrite hoàn toàn bằng SolidJS + TypeScript từ v2.1.0 (tháng 3/2025), cho trải nghiệm UI mượt mà hơn hẳn. Database: SQLite (mặc định) hoặc PostgreSQL tùy nhu cầu.

Chạy ngay trong 1 lệnh

Cách nhanh nhất là Docker:

docker run --name wyl \
  -e "IFACES=eth0" \
  -e "TZ=Asia/Ho_Chi_Minh" \
  --network="host" \
  -v /opt/wyl:/data/WatchYourLAN \
  aceberg/watchyourlan

Mở browser tại http://localhost:8840 là xong. Tool cần --network=host để có thể quét toàn bộ LAN segment.

Ngoài Docker, bạn cũng có thể cài qua: gói .deb/.rpm/.apk cho Linux, Umbrel app store, YunoHost, hoặc AUR trên ArchLinux. Hỗ trợ đầy đủ 6 kiến trúc: amd64, i386, arm_v5, arm_v6, arm_v7, arm64 - nghĩa là Raspberry Pi mọi đời đều chạy được.

Docker image chỉ nặng 17 MB - nhỏ hơn hầu hết mọi thứ bạn đang chạy trên home lab.

Những tính năng đáng chú y

Phiên bản mới nhất v2.1.4 (tháng 9/2025) bổ sung nhiều thứ hay:

• Wake-on-LAN: bật máy tính từ xa ngay trong dashboard
• Swagger API docs tại /swagger/index.html - tích hợp automation dễ dàng
• Multi-host delete: dọn dẹp danh sách nhanh
• Rescan via API: trigger quét thủ công từ script hoặc webhook

Hệ thống thông báo dùng Shoutrrr, hỗ trợ: Discord, Email, Gotify, Matrix, Ntfy, Pushover, Slack, Telegram, và generic webhook. Cấu hình bằng 1 URL duy nhất theo chuẩn Shoutrrr.

Lịch sử online/offline có thể export sang InfluxDB2 hoặc Prometheus, sau đó dùng Grafana để vẽ biểu đồ uptime, scan frequency, hay thiết bị mới theo thời gian.

WatchYourLAN hay NetAlertX?

Dùng WatchYourLAN khi: bạn là home lab user, self-hoster, hoặc văn phòng nhỏ muốn biết có thiết bị lạ nào trong mạng - không cần setup phức tạp.

Chuyển sang NetAlertX khi: bạn cần monitor multi-VLAN, lưu lịch sử hàng năm, hoặc có yêu cầu compliance.

Giới hạn cần biết

• Không có built-in auth: nếu expose ra internet, phải dùng Authelia, Authentik, hoặc ForAuth để bảo vệ
• Bắt buộc host network mode với Docker - không chạy được trong isolated container network
• Phụ thuộc arp-scan: phải cài trên host hoặc dùng Docker image có sẵn
• Không phù hợp với mạng lớn hoặc multi-segment phức tạp
• History retention mặc định chỉ 48h - cần tự config biến HISTORY_TRIM nếu muốn lưu lâu hơn

Kết luận

WatchYourLAN là câu trả lời cho câu hỏi: "Tôi muốn biết có gì trong mạng nhà mình, nhanh nhất, nhẹ nhất có thể." Docker image 17 MB, 1 lệnh chạy, dashboard đẹp, alert ngay khi có thiết bị lạ - đủ dùng cho 90% trường hợp home lab và văn phòng nhỏ.

Dự án đang được maintain tích cực với 26 releases, code Go sạch, MIT license. Nếu bạn đang tìm một network monitor đơn giản để cài rồi quên - đây chính là nó.

Nguon: github.com/aceberg/WatchYourLAN, DEV Community, ambientnode.uk comparison.