# 每一次 安全事件 都推送到你的手机。

> SSH 登录、sudo 提权、fail2ban 封禁，第一时间推送到手机。在登录脚本里加一行 curl，就能在一秒内把用户、来源 IP 和触发规则发送到你的手机。

<!-- source: https://pocketalert.app/zh/use-cases/security-alerts -->

最后更新：2026-08-11

服务器上发生任何触碰——SSH 登录、fail2ban 封禁，或 CrowdSec、auditd 规则触发——用户、来源 IP 和规则都会在一秒内送到你的手机上。对方还没输完，你已经知道谁登录了。

## 三步开启登录告警

1. **获取 API 密钥** — 创建一个 API 密钥和每台主机各自的应用，然后将密钥保存在服务器的环境变量中。
2. **接入事件** — 在登录脚本、fail2ban 动作或 IDS 规则中添加一条 curl，用于提交用户和来源 IP。
3. **实时监控服务器** — 登录和封禁会在一秒内到达你的手机。把事件内容放进标题，来自新 IP 的 root 登录就能和日常的 deploy 登录清楚地区分开。

## 从登录到推送

把任意登录、封禁或规则触发器接入一条 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 和规则，写入标题和消息。
- **亚秒级送达** — 推送可在远低于一秒内送达，足够快，能在会话仍然开启时就捕获它。

## 每次登录都发送告警

### 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 设置文档](https://info.pocketalert.app/api/webhooks/settings.html)。

## 常见问题

### 如何在每次 SSH 登录时收到告警？

在 /etc/profile.d 下放一个小脚本，用 $USER 和 $SSH_CONNECTION 中的 IP 调用 curl 请求 Pocket Alert。之后每次交互式登录都会推送到你的手机。

### fail2ban 能给我发推送吗？

fail2ban 可以在 actionban 中运行 curl。把被封禁的 IP 和 jail 名称填入消息正文，每次封禁发生时你都能看到。

### 如何区分紧急登录和日常登录？

把事件内容放进标题，一眼就能看清：来自新 IP 的 root 登录和日常的 deploy 用户登录会显示为明显不同的告警。对于敏感主机，可以为其单独创建一个应用，使其与其他主机分开。

### 这套方案能和 CrowdSec、Wazuh 或 auditd 配合使用吗？

可以。CrowdSec、Wazuh、OSSEC 和 auditd 都能在触发规则时调用 curl。通过 GJSON 字段映射，可以把用户、来源 IP 和规则提取到标题和消息中。

### 如何按服务器区分告警？

为每台主机创建一个应用，例如 prod、bastion、personal。按应用划分的通道能让告警互不混淆，你能知道是哪台服务器发出了警报。Pocket Alert 只负责转发事件，它不是入侵检测系统（IDS）。

### 凌晨 3 点的 root 登录能突破静音模式吗？

可以。在 curl 请求中加入 "level":"critical"，Android 设备会将其发送到专用通知通道，并绕过勿扰模式。你只需授权一次勿扰模式访问权限。在 iPhone 上，high 和 critical 级别的通知会以时效性通知的形式送达，可以突破专注模式。日常的 deploy 用户登录则建议设为 silent 级别：没有声音和震动，但需要审计记录时仍可在历史中查到。免费套餐中，critical 会按 high 级别投递，依然是即时的，只是不会绕过勿扰模式。
