Introduction
OpenWrt Notification Plugin – Send Alerts to WeChat or Telegram
This OpenWrt plugin delivers real-time router notifications to your mobile device via WeChat or Telegram or Mail. Monitor your network with alerts for:
- IP changes (IPv4/IPv6)
- Device connections (online/offline)
- Online client list & traffic usage
- CPU load & temperature (including virtualized hosts like PVE)
- Router status reports
- Security alerts (failed web/SSH logins with auto blacklist)
- Port knocking & automated tasks
Auto-banning blocks blacklisted IPs from accessing the router. Optionally block all forwarded traffic from blacklisted IPs, including access to port-forwarded downstream devices and Internet access by LAN clients. With forwarded-traffic blocking enabled and conntrack installed, banning also attempts to clear that IP's existing connection-tracking entries to interrupt offloaded flows; without conntrack, this step is skipped while new connections remain blocked by the blacklist rules. Turning the option off, or turning auto-ban off, removes the forwarded-traffic drop rules on the next detection cycle; like the router-access drop rules, they are not removed by stopping the service, disappear after a firewall reload or reboot, and are restored on the plugin's next detection cycle while it runs. fw4 timed bans are restored with their last recorded remaining duration. Set the blacklist duration to 0 for permanent bans; remove the IP from the blacklist to lift the ban.
Supported services:
| Push application | Method | description |
|---|---|---|
| Server Chan | https://sct.ftqq.com/ | |
| PushPlus | http://www.pushplus.plus/ | |
| WeChat etc. | WPUSH | https://wpush.cn/ |
| WxPusher | https://wxpusher.zjiecode.com/docs | |
| WeChat for Enterprise | Application Push | https://work.weixin.qq.com/api/doc/90000/90135/90248 |
| Telegram | bot | https://t.me/BotFather |
| msmtp | https://marlam.de/msmtp/ |
Limited resources are available. If you need services such as DingTalk push, Feishu push, Bark push, etc., please try another branch at https://github.com/zzsj0928/luci-app-pushbot, or use custom API settings.
Instructions
Regarding Installation:
The plugin requires dependencies on iputils-arping + curl + jq + bash. For routers with limited memory, please consider the installation carefully. Before installing, please run the opkg update command to install dependencies during the installation process.
Developed based on X86 OpenWrt v23.05.0, different systems and devices may encounter various issues. If you encounter errors in temperature information retrieval, display errors, or other issues, please adapt accordingly.
Regarding Hostnames:
For devices that do not declare hostnames, devices connected via optical modem dial-up, OpenWrt used as a bypass gateway, and other scenarios where hostname retrieval fails, you can set the hostname using the following methods:
- Use device name remarks.
- Configure to obtain the hostname from the optical modem in advanced settings.
- Enable MAC device database.
- Install samba*-server or samba*-client to enable the program to query hostnames via NetBIOS.
Regarding Device Online Status:
By default, ping/arping is used to actively detect device online status to counter Wi-Fi sleep mechanism. Active detection takes more time but provides more accurate device online status.
- If devices frequently go into sleep mode, please adjust the timeout settings in advanced settings.
- If you don't require highly precise device online information and only need other features, you can disable active detection in advanced settings.
Regarding Traffic Statistics:
Traffic statistics functionality depends on wrtbwmon. Please install or compile it yourself. Enabling this plugin will conflict with Routing/NAT, Flow Offloading, proxy internet access, and other plugins, resulting in the inability to obtain traffic statistics. Please choose accordingly.
About Hard Drive Information:
When the OpenWrt system or remote host (PVE) does not have lsblk installed, the hard drive capacity information may be inconsistent with the actual capacity.
When the OpenWrt system or remote host (PVE) does not have smartctl installed, information such as hard drive temperature, uptime, and health status will not be available.
Regarding Bug Submissions:
When submitting a bug, please provide the following information if possible:
- Device information and plugin version number.
- Prompt information after executing
/usr/share/wechatpush/wechatpush. - Log information and file information in the
/tmp/wechatpush/directory after encountering an error. - Detailed execution information of
bash -x /usr/share/wechatpush/wechatpush t1.
DownLoad
| Supported OpenWrt Versions | Download Link |
|---|---|
| openwrt-19.07.0 ... latest | |
| openwrt-18.06 |  |
Donate
If you feel that this project is helpful to you, please donate to us so that the project can continue to develop and be more perfect.
