Chandra实战教程为Chandra添加Webhook通知能力对接飞书/钉钉/企业微信消息推送1. 为什么需要给Chandra加Webhook通知你有没有遇到过这样的场景团队正在用Chandra做内部AI知识问答但每次模型出错、服务重启或用户提交了重要咨询请求时没人能第一时间知道或者你想把用户在Chandra里提出的高频问题自动同步到飞书群让运营同事快速响应又或者希望当有人连续三次提问失败时系统自动发一条告警消息到钉钉运维群这些需求原生Chandra并不支持——它专注做好一件事提供一个轻量、私有、流畅的本地聊天界面。但它本身不带通知能力也不连接外部消息通道。好消息是Chandra基于Ollama运行所有对话请求都通过标准API/api/chat流转而Ollama的调用链路完全可控。这意味着我们不需要修改Chandra前端也不用动Ollama核心只需在请求入口层加一层轻量级代理就能实现对飞书、钉钉、企业微信等主流IM平台的Webhook全兼容通知。这不是“魔改”而是典型的“能力外挂”保持原有系统纯净用最小侵入方式扩展价值。本教程将手把手带你完成三件事搭建一个可拦截并转发Chandra请求的中间服务配置飞书/钉钉/企业微信的Webhook地址与消息模板实现「用户提问触发→记录日志→条件判断→推送消息」的完整闭环整个过程无需Python高级知识不依赖Docker Compose编排所有代码可直接复制运行5分钟内即可看到第一条飞书通知弹出。2. 理解Chandra的通信结构与拦截点2.1 Chandra如何与Ollama协作Chandra本质是一个静态Web应用HTMLJS它不处理模型推理只负责把用户输入打包成JSON发给后端代理接口。这个代理接口默认指向Ollama的/api/chat路径通常是POST http://localhost:11434/api/chat而Chandra前端实际调用的是镜像内置的反向代理服务比如Nginx或Caddy该服务把/api/chat请求转发给本地Ollama。关键在于这个代理层是可替换、可增强的。我们不碰Ollama也不改Chandra源码而是把原代理服务替换成一个“智能中继”——它既能原样转发请求给Ollama又能在转发前后执行自定义逻辑比如记录日志、提取关键词、触发Webhook。2.2 为什么选HTTP中间件而非修改前端你可能会想直接在Chandra的JS里加个fetch()调用飞书Webhook不就行了不行。原因有三跨域限制浏览器禁止前端JS直连飞书/钉钉Webhook它们要求Content-Type: application/json且无CORS头会报CORS policy blocked错误密钥暴露风险Webhook地址含secret或token若写在前端JS里任何人打开开发者工具都能看到等于公开告警通道不可靠性用户可能关掉页面、网络中断、JS加载失败导致通知永远发不出。真正可靠的方式是把通知逻辑放在服务端——也就是和Ollama同机部署的代理层。这里既可访问本地Ollama又能安全持有Webhook密钥还能捕获每一次成功/失败的请求。2.3 我们的方案架构图用户浏览器 ↓ HTTPS Chandra前端/chat.html ↓ AJAX POST /api/chat [智能代理服务] ←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←......# Chandra实战教程为Chandra添加Webhook通知能力对接飞书/钉钉/企业微信消息推送 ## 1. 为什么需要给Chandra加Webhook通知 你有没有遇到过这样的场景团队正在用Chandra做内部AI知识问答但每次模型出错、服务重启或用户提交了重要咨询请求时没人能第一时间知道或者你想把用户在Chandra里提出的高频问题自动同步到飞书群让运营同事快速响应又或者希望当有人连续三次提问失败时系统自动发一条告警消息到钉钉运维群 这些需求原生Chandra并不支持——它专注做好一件事提供一个轻量、私有、流畅的本地聊天界面。但它本身不带通知能力也不连接外部消息通道。 好消息是Chandra基于Ollama运行所有对话请求都通过标准API/api/chat流转而Ollama的调用链路完全可控。这意味着我们不需要修改Chandra前端也不用动Ollama核心只需在**请求入口层**加一层轻量级代理就能实现对飞书、钉钉、企业微信等主流IM平台的Webhook全兼容通知。 这不是“魔改”而是典型的“能力外挂”保持原有系统纯净用最小侵入方式扩展价值。本教程将手把手带你完成三件事 - 搭建一个可拦截并转发Chandra请求的中间服务 - 配置飞书/钉钉/企业微信的Webhook地址与消息模板 - 实现「用户提问触发→记录日志→条件判断→推送消息」的完整闭环 整个过程无需Python高级知识不依赖Docker Compose编排所有代码可直接复制运行5分钟内即可看到第一条飞书通知弹出。 ## 2. 理解Chandra的通信结构与拦截点 ### 2.1 Chandra如何与Ollama协作 Chandra本质是一个静态Web应用HTMLJS它不处理模型推理只负责把用户输入打包成JSON发给后端代理接口。这个代理接口默认指向Ollama的/api/chat路径通常是POST http://localhost:11434/api/chat而Chandra前端实际调用的是镜像内置的反向代理服务比如Nginx或Caddy该服务把/api/chat请求转发给本地Ollama。关键在于**这个代理层是可替换、可增强的**。 我们不碰Ollama也不改Chandra源码而是把原代理服务替换成一个“智能中继”——它既能原样转发请求给Ollama又能在转发前后执行自定义逻辑比如记录日志、提取关键词、触发Webhook。 ### 2.2 为什么选HTTP中间件而非修改前端 你可能会想直接在Chandra的JS里加个fetch()调用飞书Webhook不就行了 不行。原因有三 - **跨域限制**浏览器禁止前端JS直连飞书/钉钉Webhook它们要求Content-Type: application/json且无CORS头会报CORS policy blocked错误 - **密钥暴露风险**Webhook地址含secret或token若写在前端JS里任何人打开开发者工具都能看到等于公开告警通道 - **不可靠性**用户可能关掉页面、网络中断、JS加载失败导致通知永远发不出。 真正可靠的方式是把通知逻辑放在服务端——也就是和Ollama同机部署的代理层。这里既可访问本地Ollama又能安全持有Webhook密钥还能捕获每一次成功/失败的请求。 ### 2.3 我们的方案架构图用户浏览器 ↓ HTTPS Chandra前端/chat.html ↓ AJAX POST /api/chat [智能代理服务] ←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←...... ├─→ 记录请求时间、用户IP、提问内容、模型名gemma:2b ├─→ 判断是否需通知如含“紧急”、“报错”、“help”等关键词 ├─→ 调用飞书/钉钉/企微Webhook API └─→ 原样转发请求给 http://localhost:11434/api/chat ↓ Ollama本地推理 ↓ 智能代理服务 ←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←............ ↓ 返回响应 Chandra前端渲染AI回复这个架构干净、安全、可维护。接下来我们用一个不到100行的Python脚本实现它。 ## 3. 搭建智能代理服务5分钟完成部署 ### 3.1 准备工作确认运行环境 Chandra镜像基于Linux容器已预装Python 3.9和pip。你无需额外安装Python——只需进入容器执行命令即可。 打开终端进入Chandra容器若使用CSDN星图平台点击镜像右侧“终端”按钮 bash # 进入容器后先确认Python版本 python3 --version # 应输出类似Python 3.9.18 # 安装必要依赖requests用于调用Webhookflask作为轻量Web服务器 pip install flask requests注意所有操作都在容器内进行不影响宿主机。如提示Permission denied请在命令前加sudo或联系平台管理员确认权限。3.2 创建代理服务脚本新建文件webhook-proxy.py# webhook-proxy.py from flask import Flask, request, jsonify, Response import requests import json import time import logging # 配置日志输出到控制台方便调试 logging.basicConfig(levellogging.INFO, format%(asctime)s - %(levelname)s - %(message)s) logger logging.getLogger(__name__) app Flask(__name__) # 请在此处配置你的Webhook地址 # 飞书Webhook示例替换为你自己的地址 FEISHU_WEBHOOK https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxx # 钉钉Webhook示例替换为你自己的地址含access_token DINGTALK_WEBHOOK https://oapi.dingtalk.com/robot/send?access_tokenyyyyyy # 企业微信Webhook示例替换为你自己的key WEWORK_WEBHOOK https://qyapi.weixin.qq.com/cgi-bin/webhook/send?keyzzzzzz # Ollama服务地址默认不变 OLLAMA_URL http://localhost:11434/api/chat # 通知触发条件关键词匹配 ALERT_KEYWORDS [紧急, 报错, error, help, 崩溃, 无法响应, timeout] def send_feishu_message(content): 发送消息到飞书群 payload { msg_type: text, content: {text: content} } try: resp requests.post(FEISHU_WEBHOOK, jsonpayload, timeout5) if resp.status_code 200: logger.info( 飞书通知发送成功) else: logger.warning(f 飞书通知失败状态码{resp.status_code}) except Exception as e: logger.error(f 飞书通知异常{e}) def send_dingtalk_message(content): 发送消息到钉钉群 payload { msgtype: text, text: {content: content} } try: resp requests.post(DINGTALK_WEBHOOK, jsonpayload, timeout5) if resp.status_code 200: logger.info( 钉钉通知发送成功) else: logger.warning(f 钉钉通知失败状态码{resp.status_code}) except Exception as e: logger.error(f 钉钉通知异常{e}) def send_wework_message(content): 发送消息到企业微信群 payload { msgtype: text, text: {content: content} } try: resp requests.post(WEWORK_WEBHOOK, jsonpayload, timeout5) if resp.status_code 200: logger.info( 企业微信通知发送成功) else: logger.warning(f 企业微信通知失败状态码{resp.status_code}) except Exception as e: logger.error(f 企业微信通知异常{e}) app.route(/api/chat, methods[POST]) def proxy_chat(): # 1. 记录原始请求 start_time time.time() try: req_data request.get_json() user_message req_data.get(messages, [{}])[-1].get(content, 未知内容) model_name req_data.get(model, unknown) logger.info(f 收到提问{user_message} | 模型{model_name}) # 2. 判断是否触发通知简单关键词匹配 should_alert any(kw in user_message for kw in ALERT_KEYWORDS) if should_alert: alert_text f[Chandra告警] 用户提问触发关键词\n模型{model_name}\n提问{user_message}\n时间{time.strftime(%H:%M:%S)} # 同时发三端可按需注释掉不需要的 send_feishu_message(alert_text) send_dingtalk_message(alert_text) send_wework_message(alert_text) except Exception as e: logger.error(f 解析请求失败{e}) # 3. 原样转发请求给Ollama try: ollama_resp requests.post( OLLAMA_URL, jsonreq_data, streamTrue, timeout300 # Ollama推理可能较长设为5分钟 ) # 4. 将Ollama响应流式返回给Chandra前端 def generate(): for chunk in ollama_resp.iter_content(chunk_size1024): if chunk: yield chunk return Response(generate(), content_typeollama_resp.headers.get(content-type)) except Exception as e: logger.error(f 转发至Ollama失败{e}) return jsonify({error: 服务暂时不可用请稍后重试}), 502 if __name__ __main__: logger.info( Webhook代理服务已启动监听端口 5000) app.run(host0.0.0.0, port5000, debugFalse)3.3 获取并配置Webhook地址飞书在飞书群 → 群设置 → 机器人 → 添加机器人 → 选择“自定义机器人” → 复制Webhook地址形如https://open.feishu.cn/...钉钉在钉钉群 → 群设置 → 智能助手 → 添加机器人 → 选择“自定义” → 复制Webhook地址含access_token参数企业微信在管理后台 → 应用管理 → 自建应用 → 创建「群机器人」→ 复制Key将三个地址分别填入脚本中对应变量FEISHU_WEBHOOK、DINGTALK_WEBHOOK、WEWORK_WEBHOOK保存文件。3.4 启动代理服务在容器内执行# 后台启动不阻塞终端 nohup python3 webhook-proxy.py proxy.log 21 # 查看是否启动成功 ps aux | grep webhook-proxy # 应看到类似python3 webhook-proxy.py # 查看实时日志按 CtrlC 退出 tail -f proxy.log此时代理服务已在http://localhost:5000/api/chat监听。4. 修改Chandra前端指向新代理Chandra前端默认调用/api/chat该路径由镜像内置的Nginx反向代理指向Ollama。我们需要把它重新指向我们的新代理。进入容器编辑Nginx配置# 编辑Nginx配置文件路径因镜像而异常见位置如下 nano /etc/nginx/conf.d/default.conf # 或 nano /usr/share/nginx/html/config.js找到类似以下的代理配置通常在location /api/chat块中location /api/chat { proxy_pass http://localhost:11434/api/chat; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }将其改为location /api/chat { proxy_pass http://localhost:5000/api/chat; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; # 保持长连接支持流式响应 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; }保存后重启Nginxnginx -s reload验证刷新Chandra页面输入问题观察proxy.log是否有收到提问日志。若有说明代理已生效。5. 实战测试从提问到收到飞书通知现在我们来一次完整验证。5.1 测试关键词触发在Chandra聊天框中输入紧急我的模型突然无法响应了怎么办按下回车。几秒后你应该在飞书群中看到类似消息[Chandra告警] 用户提问触发关键词 模型gemma:2b 提问紧急我的模型突然无法响应了怎么办 时间14:22:07同时终端日志会显示2024-06-15 14:22:07 - INFO - 收到提问紧急我的模型突然无法响应了怎么办 | 模型gemma:2b 2024-06-15 14:22:08 - INFO - 飞书通知发送成功 2024-06-15 14:22:08 - INFO - 钉钉通知发送成功 2024-06-15 14:22:08 - INFO - 企业微信通知发送成功5.2 测试非关键词提问不触发输入普通问题例如你好介绍一下你自己。日志中只会显示收到提问但不会出现飞书通知发送成功证明条件判断准确。5.3 扩展建议让通知更智能当前是关键词匹配你还可以轻松升级添加频率限制同一IP 5分钟内只发1条防刷屏区分通知等级error发钉钉飞书help只发飞书附带上下文把用户历史对话片段也发过去方便快速定位对接数据库把每次提问存入SQLite供后续分析高频问题这些都只需在proxy_chat()函数中增加几行代码完全不改变架构。6. 总结一条轻量路径解锁无限可能我们没有修改一行Chandra前端代码没有动Ollama核心甚至没重启整个镜像——只是加了一个5000端口的代理服务就让原本“安静”的本地AI聊天工具拥有了主动触达团队的能力。这背后体现的是一种务实的工程思维不追求大而全的重构而专注小而准的增强。Webhook不是炫技它是让AI真正融入工作流的“神经末梢”。你学到的不仅是三行Webhook调用更是一种可复用的方法论找到系统通信的“咽喉点”这里是/api/chat用轻量中间件做“流量镜像”记录转发扩展把密钥、逻辑、策略全部收束在可信服务端用最简代码解决最痛的问题下次当你想给任何本地AI工具加告警、审计、统计、审批能力时这套模式依然适用。现在去你的飞书群里看看那条刚刚弹出的告警消息吧——那是你亲手赋予Chandra的第一声“心跳”。7. 常见问题与避坑指南7.1 为什么改了Nginx配置后Chandra打不开检查proxy_pass地址是否拼写错误注意末尾斜杠http://localhost:5000/api/chat不能写成.../chat/查看Nginx错误日志tail -n 20 /var/log/nginx/error.log确认代理服务确实在运行ps aux | grep webhook-proxy7.2 发送Webhook时提示400或403错误飞书/钉钉/企微Webhook地址是否复制完整尤其注意飞书地址末尾是否有空格钉钉地址必须含access_token企微必须含key缺一不可检查代理服务日志中的具体错误信息如Connection refused说明端口未监听7.3 想只对接其中一种IM怎么关闭其他直接注释掉对应send_xxx_message()三行调用即可例如只留飞书# send_dingtalk_message(alert_text) # ← 注释掉 # send_wework_message(alert_text) # ← 注释掉 send_feishu_message(alert_text) # ← 保留7.4 如何让通知包含更多上下文比如用户IP、时间戳在alert_text变量中直接拼接user_ip request.headers.get(X-Real-IP, request.remote_addr) alert_text f[Chandra告警] {user_ip} 提问触发关键词\n模型{model_name}\n提问{user_message}\n时间{time.strftime(%Y-%m-%d %H:%M:%S)}获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。