SVN需通过post-commit钩子脚本触发飞书机器人通知。步骤为:1. 创建飞书自定义机器人并获取Webhook地址;2. 编写Python脚本用svnlook提取提交信息并构造interactive卡片格式发送;3. 配置SVN仓库post-commit钩子调用该脚本。

SVN服务端本身不内置WebHook功能,需通过提交钩子(post-commit)脚本主动触发HTTP请求,将变更信息推送到飞书群机器人。整个过程分三步:创建飞书机器人、编写推送脚本、配置SVN钩子。
1. 创建飞书群机器人并获取Webhook地址
登录飞书,进入目标群组 → 右上角「群设置」→「群机器人」→「添加机器人」→ 选择「自定义机器人」→ 填写名称和描述 → 点击「添加」→ 复制生成的Webhook URL(形如 https://open.feishu.cn/open-apis/bot/v2/hook/xxx)。
注意:该URL含敏感凭证,不可对外泄露;建议开启IP白名单或签名验证增强安全性。
2. 编写Python推送脚本
在SVN服务器上新建一个Python脚本(如 /home/svn/pub.py),用于构造飞书消息并发送:
- 使用 svnlook 命令提取本次提交的作者、时间、日志、变更文件列表
- 组装为飞书支持的 interactive 卡片格式(比纯文本更清晰易读)
- 设置请求头 Content-Type: application/json
- 用 requests.post() 发送POST请求到飞书Webhook地址
示例关键字段结构:
{"msg_type":"interactive","card":{"elements":[{"fields":[{"text":{"content":"**提交人:** xxx\n**版本号:** r123","tag":"lark_md"}]}]}}
3. 配置SVN post-commit钩子
编辑仓库目录下的 chmod +x),内容如下:
#!/bin/bash REPOS="$1" REV="$2" export LANG=zh_CN.UTF-8 export LC_ALL=zh_CN.UTF-8 /usr/bin/python3 /home/svn/pub.py "$REV" "$REPOS"
脚本中需显式指定Python3路径(避免环境变量缺失导致失败),并确保 pub.py 有足够权限读取SVN仓库数据。
4. 验证与调试
提交一次测试变更后,检查以下几项:
- 飞书群是否收到格式化消息(含提交人、版本、日志、文件列表)
- 若无响应,查看SVN服务器系统日志(/var/log/messages 或脚本中的错误输出重定向)
- 确认飞书Webhook地址未过期、机器人仍在群内、网络可访问 open.feishu.cn
- 对长日志或大量文件变更做截断处理,避免超出飞书单条消息10KB限制











