服务器被 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)
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')
|
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 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")
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}×tamp=${ts}&sign=${sign}" else 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; }
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 "") ;; 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
set -u
CONF=/etc/dingtalk-notify.env [ -r "$CONF" ] && . "$CONF" : "${DINGTALK_TOKEN:?缺少 DINGTALK_TOKEN}"
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}×tamp=${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
| PAM_RHOST=203.0.113.9 PAM_USER=bubao PAM_TYPE=open_session \ DRY_RUN=1 /usr/local/bin/ssh-dingtalk-notify
ssh localhost
journalctl -u ssh -n 50
|
常见问题:
| 现象 | 原因 / 处理 |
|---|
| 群里没消息 | Token 错、机器人被移出群、网络不通;先 journalctl 看脚本 stderr |
errcode: 300003 | URL 参数错误 / 加签时间戳过期;确认系统时间准确(NTP) |
errcode: 310000 关键词不匹配 | 机器人是关键词模式,正文必须包含后台设置的关键词 |
| 推送内容 JSON 解析失败 | JSON 手拼转义出错;统一改用 jq -n --arg |
| 退出 SSH 也推一条 | PAM 没过滤 PAM_TYPE,或同时挂了 profile.d |
| 本机 IP 显示 Docker 网关 | 别用 ip addr 顺序取值,改用 ip route get ... src |
| 归属地一直 unknown | API 超时 / 限流;换 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
| set -f
setopt no_nomatch
|
但治本的写法是:所有变量展开都加双引号("$ip"、"$user"),优先用 $(...) 而不是反引号,并用 shellcheck 检查。
十、参考资料
- 钉钉开放平台:自定义机器人接入
- 钉钉开放平台:机器人安全设置
- Arch Wiki: PAM(
pam_exec 用法) - ipinfo.io 开发者文档
- ShellCheck —— 排查引号、通配与变量展开问题