从登录到推送
把任意登录、封禁或规则触发器接入一条 curl,事件就会以推送通知的形式送达你的手机。
SSH 登录推送
在 /etc/profile.d 中放置登录脚本,或使用 sshrc,每次交互式会话都会用用户和来源 IP 调用 curl 请求 Pocket Alert。
fail2ban 封禁通知
fail2ban 在 actionban 中运行 curl,每次封禁的 IP 都会连同触发它的 jail 一起显示在你的手机上。
sudo 与管理员登录
当有人提权时,PAM 钩子或 sudo 触发器会被激活;新的管理员登录也会以同样方式送达。
IDS 与审计触发
CrowdSec、Wazuh、OSSEC 和 auditd 在规则匹配时调用 curl。
字段映射
通过 GJSON 字段映射,从 SIEM 载荷中提取用户、来源 IP 和规则,写入标题和消息。
亚秒级送达
推送可在远低于一秒内送达,足够快,能在会话仍然开启时就捕获它。
三步开启登录告警
获取 API 密钥
创建一个 API 密钥和每台主机各自的应用,然后将密钥保存在服务器的环境变量中。
接入事件
在登录脚本、fail2ban 动作或 IDS 规则中添加一条 curl,用于提交用户和来源 IP。
实时监控服务器
登录和封禁会在一秒内到达你的手机。把事件内容放进标题,来自新 IP 的 root 登录就能和日常的 deploy 登录清楚地区分开。
每次登录都发送告警
1. 获取 API 密钥
在 Pocket Alert 中创建一个应用,并复制你的 API 密钥。将其放在 Token 请求头中发送。为每台主机分别创建应用,使生产、堡垒机和个人服务器的通道互相独立。
2. SSH 登录(sshrc 或 /etc/profile.d)
在 /etc/profile.d 中放置一个脚本,使每次交互式登录都用 $SSH_CONNECTION 中的用户和来源 IP 调用消息 API:
# /etc/profile.d/pocketalert-login.sh
[ -n "$SSH_CONNECTION" ] && curl -s -X POST "https://api.pocketalert.app/v1/messages" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"title\":\"SSH login\",\"message\":\"$USER from ${SSH_CONNECTION%% *} on $(hostname)\"}"
3. fail2ban 封禁(自定义动作)
在 /etc/fail2ban/action.d/pocketalert.conf 中添加一个动作,并在 jail 中引用它。每次封禁时,fail2ban 会替换 <ip> 和 <name>:
[Definition]
actionban = curl -s -X POST "https://api.pocketalert.app/v1/messages" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"fail2ban: banned <ip>","level":"critical","message":"jail <name> banned <ip>"}'
4. SIEM(Webhook)
对于输出 JSON 的 SIEM 或 IDS(如 Wazuh、CrowdSec),创建一个带有 GJSON message 模板的 Webhook 来映射其载荷,然后将该工具指向接收 URL:
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Wazuh alerts","message":"%rule.description% from %data.srcip%","application_id":"qm47b9pzxzxg"}'
将 https://p4a.me/wh/1234abcd 粘贴到该工具的集成设置中即可。
有关消息 API 和 GJSON 字段映射,请参阅 Webhook 设置文档。
常见问题解答
在 /etc/profile.d 下放一个小脚本,用 $USER 和 $SSH_CONNECTION 中的 IP 调用 curl 请求 Pocket Alert。之后每次交互式登录都会推送到你的手机。
fail2ban 可以在 actionban 中运行 curl。把被封禁的 IP 和 jail 名称填入消息正文,每次封禁发生时你都能看到。
把事件内容放进标题,一眼就能看清:来自新 IP 的 root 登录和日常的 deploy 用户登录会显示为明显不同的告警。对于敏感主机,可以为其单独创建一个应用,使其与其他主机分开。
可以。CrowdSec、Wazuh、OSSEC 和 auditd 都能在触发规则时调用 curl。通过 GJSON 字段映射,可以把用户、来源 IP 和规则提取到标题和消息中。
为每台主机创建一个应用,例如 prod、bastion、personal。按应用划分的通道能让告警互不混淆,你能知道是哪台服务器发出了警报。Pocket Alert 只负责转发事件,它不是入侵检测系统(IDS)。
可以。在 curl 请求中加入 "level":"critical",Android 设备会将其发送到专用通知通道,并绕过勿扰模式。你只需授权一次勿扰模式访问权限。在 iPhone 上,high 和 critical 级别的通知会以时效性通知的形式送达,可以突破专注模式。日常的 deploy 用户登录则建议设为 silent 级别:没有声音和震动,但需要审计记录时仍可在历史中查到。免费套餐中,critical 会按 high 级别投递,依然是即时的,只是不会绕过勿扰模式。