GFW Status Monitor: Real-time Firewall & Connectivity Watchdog / GFW 实时监测哨兵

📡 The Problem / 问题

If you maintain overseas servers or VPN nodes, you know the pain: Is my server down, or is it blocked by the Great Firewall (GFW)?
如果你维护海外服务器或 VPN 节点，你肯定有过这样的疑惑：是我的服务器挂了，还是被 GFW 墙了？

Manually pinging from different locations is tedious. You need an automated watchdog.
手动从不同地点 Ping 既繁琐又低效。你需要一个自动化的哨兵。

🛠️ What is GFW_status?

GFW_status is a lightweight monitoring suite intended to run on a domestic (Mainland China) server or a Synology NAS.
GFW_status 是一个轻量级的监测套件，设计用于在中国大陆的服务器或群晖 NAS 上运行。

Key Capabilities

ICMP/TCP Check: Verifies if the target IP/Port is reachable from China.
Domain Validation: Checks if DNS is poisoned.
Stability Report: Logs packet loss and latency over time.

🚀 Usage / 使用

Docker (Recommended)

Deploy it on your NAS or local Raspberry Pi.

docker run -d --name gfw-status \
  -e TARGET_IP="1.2.3.4" \
  -e TARGET_PORT="443" \
  yuanweize/gfw-status

Script Mode

Or just add to crontab:

*/10 * * * * /path/to/check_gfw.sh >> /var/log/gfw.log

🧩 Integration / 集成

You can hook this up to ServerChan (Server酱) or Telegram to get instant alerts when your node gets blocked.
你可以将其连接到 Server酱 或 Telegram，以便在节点被墙时立即收到警报。