SSH 登录服务器触发钉钉机器人

服务器被 SSH 登录时推一条钉钉消息,是运维里非常常见的小需求:谁、从哪、什么时候、登录了哪台机器,出问题时能第一时间看到。实现链路很短:采集登录上下文 → 补全来源 IP 归属地 → 调用钉钉自定义机器人 → 通过 PAM 挂在 SSH 会话上。

一、整体链路

1
2
3
4
5
6
7
8
9
10
11
12
13
14
sshd 认证通过
│
├─ PAM session 阶段(推荐,含非交互登录)
│ pam_exec → /usr/local/bin/ssh-dingtalk-notify
│
└─ 或交互式登录 Shell
/etc/profile.d/99-ssh-notify.sh → 同一个脚本
│
▼
脚本:hostname / 本机 IP / 登录用户 / 来源 IP / 登录时间
│
├─ 归属地查询(ipinfo.io 等,可失败降级为 unknown)
│
└─ 组装 JSON → curl POST 到钉钉 webhook

二、采集登录上下文

原文用 ip addr | grep inet | sed -n 2p 取本机 IP,这很脆:第 2 块网卡可能是 Docker / 虚拟机网桥。优先取出网源 IP:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
host=$(hostname)

# 出网 IP:直接路由和经网关路由都适用
local_ip=$(ip route get 1.1.1.1 2>/dev/null | grep -o 'src [0-9a-f:.]*' | awk '{print $2}')
[[ -z "$local_ip" ]] && local_ip=$(hostname -I 2>/dev/null | awk '{print $1}')

# PAM 注入 PAM_RHOST,交互式登录用 sshd 环境变量(SSH_CLIENT = 来源IP 来源端口 本机端口)
ssh_ip=${PAM_RHOST:-}
[[ -z "$ssh_ip" ]] && ssh_ip=$(printf '%s' "${SSH_CLIENT:-}" | awk '{print $1}')
[[ -z "$ssh_ip" ]] && ssh_ip=$(printf '%s' "${SSH_CONNECTION:-}" | awk '{print $1}')

# PAM 场景用 PAM_USER,Shell 场景才有 $USER
login_user=${PAM_USER:-${USER:-$(id -un)}}
login_time=$(date '+%Y-%m-%d %H:%M:%S %Z')

PAM_RHOST 就是登录来源 IP,比 SSH_CLIENT 覆盖更全(含非交互登录)。

三、查询来源 IP 归属地(别再抓网页)

原文用 curl https://www.36ip.cn/?ip=... 抓 HTML 页面,接口随时变更、还有反爬,不适合做基础设施。用结构化 JSON API,并设置超时与降级:

1
2
3
4
5
6
7
8
9
10
11
12
command -v jq >/dev/null || { echo "请先安装 jq"; exit 1; }

lookup_addr() {
local ip=$1 data addr
# ipinfo.io:免费额度约 5 万次/月;fields/city/region/country 公开可读
data=$(curl -fsS --max-time 5 "https://ipinfo.io/${ip}/geo" 2>/dev/null) || { echo unknown; return; }
addr=$(printf '%s' "$data" \
| jq -r '[.city, .region, .country] | map(select(. != null and . != "")) | join(" ")' 2>/dev/null)
echo "${addr:-unknown}"
}

addr=$(lookup_addr "$ssh_ip")

国内查询更准时可以换 whois.pconline.com.cn(GBK 编码):

1
2
3
4
5
addr=$(curl -fsS --max-time 5 \
"https://whois.pconline.com.cn/ipJson.jsp?ip=${ssh_ip}&json=true" \
| iconv -f GBK -t UTF-8 \
| jq -r '.addr // empty' 2>/dev/null)
addr=${addr:-unknown}

四、调用钉钉自定义机器人

2021 年之后建的自定义机器人,安全设置三选一:自定义关键词 / 加签 / IP 白名单。脚本按「有 Secret 就加签,没有就靠关键词」设计:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
content=$(printf '🔔 SSH 登录提醒\n主机名称:%s\n主机 IP:%s\n登录用户:%s\n来源 IP:%s\nIP 归属地:%s\n登录时间:%s' \
"$host" "$local_ip" "$login_user" "$ssh_ip" "$addr" "$login_time")

# 用 jq 组装 JSON,避免手工拼 JSON 导致的转义错误
payload=$(jq -n --arg c "$content" '{msgtype:"text", text:{content:$c}}')

if [[ -n "${DINGTALK_SECRET:-}" ]]; then
# 加签:string_to_sign = timestamp \n secret;HMAC-SHA256;结果 base64 + URL 编码
ts=$(date +%s000)
sign=$(printf '%s\n%s' "$ts" "$DINGTALK_SECRET" \
| openssl dgst -sha256 -hmac "${DINGTALK_SECRET}" -binary \
| openssl base64 -A)
sign=$(jq -rn --arg s "$sign" '$s | @uri')
url="https://oapi.dingtalk.com/robot/send?access_token=${DINGTALK_TOKEN}&timestamp=${ts}&sign=${sign}"
else
# 关键词模式:正文必须包含机器人后台设置的关键词(这里是 SSH)
url="https://oapi.dingtalk.com/robot/send?access_token=${DINGTALK_TOKEN}"
fi

resp=$(curl -sS --max-time 10 \
-H 'Content-Type: application/json; charset=utf-8' \
-d "$payload" "$url") || { echo "请求失败:$resp" >&2; exit 1; }

# 钉钉即使参数错误也返回 200,必须检查 errcode
if [[ $(jq -r '.errcode // -1' <<<"$resp") -ne 0 ]]; then
echo "推送失败:$resp" >&2
exit 1
fi

Token 不要写死在脚本里。存到 /etc/dingtalk-notify.env(权限 600)或 systemd 环境变量:

1
2
DINGTALK_TOKEN=你机器人的 access_token
DINGTALK_SECRET=SECxxxxxxxx # 仅“加签”模式需要

脚本头部加载:

1
2
3
CONF=/etc/dingtalk-notify.env
[ -r "$CONF" ] && . "$CONF"
: "${DINGTALK_TOKEN:?缺少 DINGTALK_TOKEN}"

五、挂到 SSH 登录上

方案 A:PAM(推荐)

/etc/pam.d/sshd 末尾追加:

1
session    optional    pam_exec.so    /usr/local/bin/ssh-dingtalk-notify

在通知脚本开头处理 PAM_TYPE,避免退出登录也推送:

1
2
3
4
5
case "${PAM_TYPE:-}" in
"") ;; # 非 PAM 调用(如手动测试)
open_session) ;; # 只通知登录
*) exit 0 ;;
esac

PAM 版能看到所有成功建立会话的登录,包括 ssh host command 这种非交互登录;默认以 root 运行,无需 seteuid,方便读取 600 的 Token 文件。

方案 B:profile.d

新建 /etc/profile.d/99-ssh-notify.sh:

1
2
3
4
#!/bin/sh
if [ -n "${SSH_CLIENT:-}" ] && [ -n "${SSH_TTY:-}" ]; then
/usr/local/bin/ssh-dingtalk-notify
fi

只对交互式登录生效;两套方案不要同时开,否则会收到重复通知。

六、完整脚本

保存为 /usr/local/bin/ssh-dingtalk-notify(root 属主,700):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
#!/usr/bin/env bash
# SSH 登录推送钉钉通知;可通过 PAM 或 profile.d 调用
set -u

CONF=/etc/dingtalk-notify.env
[ -r "$CONF" ] && . "$CONF"
: "${DINGTALK_TOKEN:?缺少 DINGTALK_TOKEN}"

# PAM 调用时只在会话打开时推送
case "${PAM_TYPE:-}" in
"") ;;
open_session) ;;
*) exit 0 ;;
esac

command -v jq >/dev/null || { echo "缺少 jq" >&2; exit 1; }

host=$(hostname)
local_ip=$(ip route get 1.1.1.1 2>/dev/null | grep -o 'src [0-9a-f:.]*' | awk '{print $2}')
[[ -z "$local_ip" ]] && local_ip=$(hostname -I 2>/dev/null | awk '{print $1}')

ssh_ip=${PAM_RHOST:-}
[[ -z "$ssh_ip" ]] && ssh_ip=$(printf '%s' "${SSH_CLIENT:-}" | awk '{print $1}')
[[ -z "$ssh_ip" ]] && ssh_ip=$(printf '%s' "${SSH_CONNECTION:-}" | awk '{print $1}')

login_user=${PAM_USER:-${USER:-$(id -un)}}
login_time=$(date '+%Y-%m-%d %H:%M:%S %Z')

lookup_addr() {
local ip=$1 data
data=$(curl -fsS --max-time 5 "https://ipinfo.io/${ip}/geo" 2>/dev/null) || { echo unknown; return; }
printf '%s' "$data" \
| jq -r '[.city, .region, .country] | map(select(. != null and . != "")) | join(" ")' 2>/dev/null || echo unknown
}
addr=$(lookup_addr "$ssh_ip")
addr=${addr:-unknown}

content=$(printf '🔔 SSH 登录提醒\n主机名称:%s\n主机 IP:%s\n登录用户:%s\n来源 IP:%s\nIP 归属地:%s\n登录时间:%s' \
"$host" "$local_ip" "$login_user" "$ssh_ip" "$addr" "$login_time")

payload=$(jq -n --arg c "$content" '{msgtype:"text", text:{content:$c}}')

if [[ -n "${DINGTALK_SECRET:-}" ]]; then
ts=$(date +%s000)
sign=$(printf '%s\n%s' "$ts" "$DINGTALK_SECRET" \
| openssl dgst -sha256 -hmac "${DINGTALK_SECRET}" -binary \
| openssl base64 -A)
sign=$(jq -rn --arg s "$sign" '$s | @uri')
url="https://oapi.dingtalk.com/robot/send?access_token=${DINGTALK_TOKEN}&timestamp=${ts}&sign=${sign}"
else
url="https://oapi.dingtalk.com/robot/send?access_token=${DINGTALK_TOKEN}"
fi

if [[ "${DRY_RUN:-0}" == "1" ]]; then
jq .
exit 0
fi

resp=$(curl -sS --max-time 10 \
-H 'Content-Type: application/json; charset=utf-8' \
-d "$payload" "$url") || { echo "请求失败:$resp" >&2; exit 1; }

if [[ $(jq -r '.errcode // -1' <<<"$resp") -ne 0 ]]; then
echo "推送失败:$resp" >&2
exit 1
fi
exit 0

七、验证与排查

1
2
3
4
5
6
7
8
9
# 1. 不真正登录,直接模拟 PAM 上下文
PAM_RHOST=203.0.113.9 PAM_USER=bubao PAM_TYPE=open_session \
DRY_RUN=1 /usr/local/bin/ssh-dingtalk-notify

# 2. 真实触发一次
ssh localhost

# 3. 看 pam_exec 的报错(脚本内部 echo 的内容会进系统日志)
journalctl -u ssh -n 50

常见问题:

现象原因 / 处理
群里没消息Token 错、机器人被移出群、网络不通;先 journalctl 看脚本 stderr
errcode: 300003URL 参数错误 / 加签时间戳过期;确认系统时间准确(NTP)
errcode: 310000 关键词不匹配机器人是关键词模式,正文必须包含后台设置的关键词
推送内容 JSON 解析失败JSON 手拼转义出错;统一改用 jq -n --arg
退出 SSH 也推一条PAM 没过滤 PAM_TYPE,或同时挂了 profile.d
本机 IP 显示 Docker 网关别用 ip addr 顺序取值,改用 ip route get ... src
归属地一直 unknownAPI 超时 / 限流;换 API 或加长 --max-time,不要让它阻塞通知

八、安全与加固建议

  • Token / Secret 视为密码:放 600 文件或密钥管理;不要进 Git;泄露后立即重置;
  • 加签优于关键词:关键词可被猜测,签名 + 1 小时时间窗更难伪造;
  • 通知里只放主机与来源元数据,不要带密码、Token、私钥路径;
  • 归属地 API 会把来源 IP 发往第三方,注意合规;内网来源(如 10.x)识别不出归属地是正常的;
  • 脚本被篡改风险低(root 700),但建议 shellcheck 过一遍;
  • 登录频率高时,考虑在脚本里按「用户 + 来源 IP」做短时间去重,避免刷屏。

九、附:zsh 报 no matches found

原文提到把脚本场景放进 .zshrc 时出现 no matches found:。根因是 zsh 对未加引号的参数展开会做通配匹配,变量为空时更容易触发;不只是脚本,任何 echo $var 都该加引号。

1
2
3
4
5
# 脚本里(bash 等效)
set -f # 关闭 pathname expansion,等价于 bash 的 set -o noglob

# zsh 会话 / .zshrc 里
setopt no_nomatch # 或 setopt no_glob

但治本的写法是:所有变量展开都加双引号("$ip"、"$user"),优先用 $(...) 而不是反引号,并用 shellcheck 检查。

十、参考资料

  1. 钉钉开放平台:自定义机器人接入
  2. 钉钉开放平台:机器人安全设置
  3. Arch Wiki: PAM(pam_exec 用法)
  4. ipinfo.io 开发者文档
  5. ShellCheck —— 排查引号、通配与变量展开问题

SSH 登录服务器触发钉钉机器人
https://bubao.github.io/posts/ca75751e.html
作者
一念
发布于
2021年3月11日
许可协议