标签 Webhook 下的文章

观测云提供一站式云、云原生、应用及业务的可观测解决方案，日志监控器是其核心功能之一，它不仅仅是一个被动的日志收集和存储工具，更是一个主动、智能的日志分析与监控告警平台。它的设计目标是帮助开发、运维和业务团队从海量的日志数据中快速发现问题、定位根因并及时响应。日志监控器的核心价值在于将非结构化的日志数据转化为可观测的结构化信息，并通过监控和告警机制，使其成为保障系统稳定性和业务连续性的有力工具。

通知对象

观测云支持向钉钉、企业微信、飞书等渠道发送通知，使用时需要先创建通知对象。点击「监控」 -「通知对象管理」-「新建通知对象」。

图片

填写消息推送机器人的 Webhook 地址。

图片

告警策略

点击「监控」 -「告警策略管理」-「新建告警策略」。通过关联监控器与告警策略，系统可在异常发生时即时向指定对象发送通知。策略支持配置名称、描述、时区与操作权限等基础信息，并允许按告警等级、通知对象两个维度灵活定义通知规则。针对高紧急度场景可启用升级通知机制，同时支持自定义通知发送时段，以适配不同时段的业务需求。

图片

日志监控器

「监控」 -「监控器」-「新建监控器」，选择“日志检测”，依次配置“检测配置”、“事件通知”、“告警配置”。

检测配置

如下图是按主机和服务的维度，统计 5 分钟内 mall-admin 服务中状态是 error 的日志条数。

图片

当错误数大于等于 2 条时触发致命告警。

图片

事件内容

支持自定义事件通知的标题与内容。

插入日志变量

点击"变量"选择需要展示的变量名，比如 host、service。

图片

插入链接

点击“链接”插入日志查看地址，实现告警界面一键跳转到观测云。

图片

附加信息

点击"添加附加信息"选择日志字段（如 message），在告警内容中展示。

图片

点击“变量”插入 {{df_related_data.message}}，建议截取前200字符避免超出告警工具长度限制。

图片

告警策略

配置告警策略后，系统将向对应对象发送通知。

图片

恢复事件

连续两个周期无异常触发恢复事件，留空则不发送。

图片

告警通知

告警触发后，事件中心关联事件的“通知”列显示企微图标即表示推送成功。

图片

在企微机器人群收到如下信息。

图片

问题排查

企微未收到告警时，请在“事件中心”查找对应事件：

  • 无事件：检查监控器DQL配置
  • 事件存在但通知列无企微图标：检查通知对象与静默期设置
  • 通知列有企微图标：可能因告警过于频繁触发Webhook限流

无事件排查

打开监控器，复制上方的 DQL。

图片

复制出来的 DQL 如下：

window("L('default')::RE(`.*`):(count(`*`)) { `service` = \"mall-admin\" AND `status` = \"error\" } BY `service`, `host`", '5m')

打开「快捷入口」 -「DQL 查询」，粘贴 DQL，去掉外层的 windows 函数，去掉转义，检测区间选择和监控器相同，点击“执行”。如果无数据则不会触发告警。

图片

原文链接：https://www.nocobase.com/cn/blog/weekly-updates-20260129

汇总一周产品更新日志，最新发布可以前往我们的博客查看。

NocoBase 目前更新包括的版本更新包括三个分支：main ，next和 develop。

version.png

main ：截止目前最稳定的版本，推荐安装此版本。

next：包含即将发布的新功能，经过初步测试的版本，可能存在部分已知或未知问题。主要面向测试用户，用于收集反馈和进一步优化功能。适合愿意提前体验新功能并提供反馈的测试用户。

develop：开发中的版本，包含最新的功能代码，可能尚未完成或存在较多不稳定因素，主要用于内部开发和快速迭代。适合对产品功能前沿发展感兴趣的技术用户，但可能存在较多问题或不完整功能，不建议在生产环境中使用。

main

main.png

v1.9.40

发布时间：2026-01-25

🚀 优化

  • [Office 文件预览] 支持更多文件类型在微软在线预览工具中预览 (#8500) by @mytharcher

🐛 修复

  • [client]

    • 修复 nanoid 字段在表单提交后不重新生成数据的问题 (#8491) by @katherinehhh
    • 修复级联组件必填校验重复提示的问题 (#8476) by @katherinehhh

  • [database]

    • 修复数据表重载后使用 empty 操作符筛选报错的问题 (#8496) by @2013xile
    • 修复嵌套关联的深度更新问题 (#8492) by @chenos
  • [文件管理器] 修复上传文件时请求中的文件名被重复解码产生的乱码问题 (#8481) by @mytharcher
  • [数据源：主数据库] 修复在多对多关系表格区块中删除数据时，未遵循关系字段 onDelete: 'restrict' 约束的问题 (#8493) by @2013xile
  • [区块：iframe] 修复 Iframe 添加聚合变量报错的问题 (#8482) by @zhangzhonghe
  • [工作流：Webhook 触发器] 修复未配置请求体解析时触发器数据中该数据缺失的问题 by @mytharcher
  • [模板打印] 复了联合角色时打印按钮权限逻辑错误 by @jiannx

  • [工作流：审批]

    • 修复并发提交导致流程被重复恢复执行的问题 by @mytharcher
    • 修复分支模式的审批未能正确退回至指定节点的问题 by @mytharcher
  • [迁移管理] 修复迁移异常后打印异常对象所包含 SQL 过大容易卡死进程的问题 by @cgyrock

next

next.png

v2.0.0-beta.17

发布时间：2026-01-29

🐛 修复

  • [client] 修复筛选相关的已知问题 (#8514) by @zhangzhonghe
  • [AI 员工] 修复构建后系统无法启动问题 (#8523) by @cgyrock
  • [AI: 知识库] 修复构建后系统无法启动问题 by @cgyrock

v2.0.0-beta.16

发布时间：2026-01-27

🎉 新特性

  • [client] 新增子表格（弹窗编辑）字段组件 (#8280) by @katherinehhh
  • [工作流] 为移动节点增加 API (#8507) by @mytharcher

🚀 优化

  • [client]

    • 修复单元格更新导致表格整体重渲染 (#8349) by @katherinehhh
    • 改进对多子表单默认包含一个对象，无需点击 Add New，未填写时不创建记录 (#8458) by @katherinehhh
  • [文件管理器] 为文件管理器增加可扩展的预览组件 (#8501) by @mytharcher
  • [工作流] 修改工作流子页面的路由路径，将工作流页面都统一在 /admin/settings/workflow 路径之下 (#8519) by @mytharcher

🐛 修复

  • [client]

    • 修复筛选区块日期带时间时时间格式重复的问题 (#8506) by @zhangzhonghe
    • 修复多层级对多字段子表单字段联动规则无法使用表单变量赋值的问题。 (#8518) by @gchust
    • 修复多级弹窗及跨区块数据变更后不刷新问题。 (#8471) by @gchust
    • 修复编辑表单中配置阅读态子详情数据不能正常显示问题 (#8469) by @katherinehhh
    • 修复targetKey 可选字段的处理逻辑 (#8333) by @katherinehhh
    • 修复编辑态子表格中关系字段 Select 的 filter 参数错误问题 (#8335) by @katherinehhh
  • [flow-engine] 修复外部数据源 filterTargetKey 为单元素数组时 FilterByTK 处理错误 (#8522) by @katherinehhh
  • [AI 员工] 修复 AI 建模与数据源管理模块中可选字段配置不一致的问题 (#8488) by @cgyrock
  • [邮件管理] 选中文本时正文不折叠。修复附件下载失败 by @jiannx

v2.0.0-beta.15

发布时间：2026-01-25

🚀 优化

  • [Office 文件预览] 支持更多文件类型在微软在线预览工具中预览 (#8500) by @mytharcher

🐛 修复

  • [database] 修复数据表重载后使用 empty 操作符筛选报错的问题 (#8496) by @2013xile
  • [模板打印] 复了联合角色时打印按钮权限逻辑错误 by @jiannx
  • [工作流：审批] 修复 1.x 审批记录弹窗报错的问题 by @mytharcher
  • [迁移管理] 修复迁移异常后打印异常对象所包含sql过大容易卡死进程的问题 by @cgyrock

v2.0.0-beta.14

发布时间：2026-01-23

🎉 新特性

  • [AI 员工] AI 对话支持复制粘贴文件 (#8487) by @heziqiang

🚀 优化

  • [client]

    • 改进对多子表单默认包含一个对象，无需点击 Add New，未填写时不创建记录 (#8473) by @katherinehhh
    • 改进子表格中附件字段的上传与编辑按钮，引导用户点击上传 (#8474) by @katherinehhh
  • [flow-engine] 优化 runjs 的 ctx.libs, 使其支持按需加载，并新增 lodash, math, formula 预定义库。 (#8468) by @gchust
  • [错误处理器] 避免 SQL 引用错误直接暴露 (#8464) by @2013xile
  • [工作流：审批] 增加对 API 的访问控制，以避免通过 API 越权操作数据 by @mytharcher

🐛 修复

  • [client]

    • 修复富文本编辑器的弹出层被遮挡的问题 (#8443) by @zhangzhonghe
    • 修复筛选区块日期带时间时时间格式重复的问题 (#8484) by @zhangzhonghe
    • 修复 nanoid 字段在表单提交后不重新生成数据的问题 (#8491) by @katherinehhh
    • 修复级联组件必填校验重复提示的问题 (#8476) by @katherinehhh
    • filter列表去重 (#8431) by @jiannx
    • 修复在 Chrome 144 版本中不显示配置菜单的问题 (#8470) by @zhangzhonghe

  • [database]

    • 修复嵌套关联的深度更新问题 (#8492) by @chenos
  • [server] 修复通用依赖中 mathjs 包的版本 (#8475) by @mytharcher
  • [flow-engine] 修复内嵌弹窗页面连续打开联动规则配置和事件流配置后关闭弹窗报错的问题。 (#8368) by @gchust
  • [数据源：主数据库] 修复在多对多关系表格区块中删除数据时，未遵循关系字段 onDelete: 'restrict' 约束的问题 (#8493) by @2013xile
  • [异步任务管理器] 修复异步导入触发的工作流事件延迟执行的问题 (#8478) by @mytharcher
  • [区块：iframe] 修复 Iframe 添加聚合变量报错的问题 (#8482) by @zhangzhonghe
  • [UI 模板] 修复引用模板区块无法通过事件流设置数据范围的问题。 (#8472) by @gchust
  • [文件管理器] 修复上传文件时请求中的文件名被重复解码产生的乱码问题 (#8481) by @mytharcher
  • [操作：导入记录 Pro] 修复异步导入触发的工作流事件延迟执行的问题 by @mytharcher
  • [工作流：Webhook 触发器] 修复未配置请求体解析时触发器数据中该数据缺失的问题 by @mytharcher
  • [模板打印] 模板打印的配置模板弹窗移除底部按钮 by @katherinehhh

  • [工作流：审批]

    • 修复分支模式的审批未能正确退回至指定节点的问题 by @mytharcher
    • 修复并发提交导致流程被重复恢复执行的问题 by @mytharcher
    • 修复审批任务卡片字段不显示的问题 by @zhangzhonghe

develop

develop.png

v2.0.0-alpha.68

发布时间：2026-01-27

🎉 新特性

  • [工作流] 为移动节点增加 API (#8507) by @mytharcher

v2.0.0-alpha.67

发布时间：2026-01-26

🎉 新特性

  • [server] 重构应用监管器以适配不同场景下的多应用管理需求 (#8043) by @2013xile
  • [client] 新增子表格（弹窗编辑）字段组件 (#8280) by @katherinehhh
  • [AI 员工] AI 对话支持复制粘贴文件 (#8487) by @heziqiang

🚀 优化

  • [client]

    • 改进子表格中附件字段的上传与编辑按钮，引导用户点击上传 (#8474) by @katherinehhh
    • 改进对多子表单默认包含一个对象，无需点击 Add New，未填写时不创建记录 (#8473) by @katherinehhh
  • [flow-engine] 优化 runjs 的 ctx.libs, 使其支持按需加载，并新增 lodash, math, formula 预定义库。 (#8468) by @gchust
  • [server] 支持配置跨域 Origin 白名单 (#8454) by @2013xile
  • [文件管理器] 为文件管理器增加可扩展的预览组件 (#8501) by @mytharcher
  • [Office 文件预览] 支持更多文件类型在微软在线预览工具中预览 (#8500) by @mytharcher
  • [错误处理器] 避免 SQL 引用错误直接暴露 (#8464) by @2013xile
  • [操作：导出记录] 改进导出按钮数据范围：优先按选中记录，其次按前端筛选范围 (#8442) by @katherinehhh
  • [操作：导出记录 Pro] 改进导出按钮数据范围：优先按选中记录，其次按前端筛选范围 by @katherinehhh
  • [工作流：审批] 增加对 API 的访问控制，以避免通过 API 越权操作数据 by @mytharcher

🐛 修复

  • [client]

    • 修复筛选区块日期带时间时时间格式重复的问题 (#8484) by @zhangzhonghe
    • 修复 nanoid 字段在表单提交后不重新生成数据的问题 (#8491) by @katherinehhh
    • 修复富文本编辑器的弹出层被遮挡的问题 (#8443) by @zhangzhonghe
    • filter列表去重 (#8431) by @jiannx
    • 修复级联组件必填校验重复提示的问题 (#8476) by @katherinehhh
    • 修复在 Chrome 144 版本中不显示配置菜单的问题 (#8470) by @zhangzhonghe
    • 修复编辑表单中配置阅读态子详情数据不能正常显示问题 (#8469) by @katherinehhh
    • 修复自定义变量弹窗被遮挡的问题 (#8463) by @zhangzhonghe
    • 修复数据表字段分组排序设置不生效问题 (#8453) by @katherinehhh
    • 修复表格“列设置”按钮无效的问题 (#8441) by @zhangzhonghe
    • 修复关系文件快速编辑，选择文件的弹窗层级错误，无法保存弹窗配置的问题。 (#8446) by @gchust
    • 修复数据表图形界面编辑数据表报错问题 (#8451) by @katherinehhh

  • [database]

    • 修复数据表重载后使用 empty 操作符筛选报错的问题 (#8496) by @2013xile
    • 修复嵌套关联的深度更新问题 (#8492) by @chenos
  • [server] 修复通用依赖中 mathjs 包的版本 (#8475) by @mytharcher

  • [flow-engine]

    • 修复内嵌弹窗页面连续打开联动规则配置和事件流配置后关闭弹窗报错的问题。 (#8368) by @gchust
    • 修复能够重复点击配置菜单打开多个配置弹窗的问题。 (#8448) by @gchust
    • 修复 runjs 相关代码在运行前变量就被解析的问题。 (#8445) by @gchust
    • 修复数据选择器快速新增弹窗中无法选择弹窗变量的问题。 (#8450) by @gchust
  • [AI 员工] 修复 AI 建模与数据源管理模块中可选字段配置不一致的问题 (#8488) by @cgyrock
  • [数据源：主数据库] 修复在多对多关系表格区块中删除数据时，未遵循关系字段 onDelete: 'restrict' 约束的问题 (#8493) by @2013xile
  • [区块：iframe] 修复 Iframe 添加聚合变量报错的问题 (#8482) by @zhangzhonghe
  • [异步任务管理器] 修复异步导入触发的工作流事件延迟执行的问题 (#8478) by @mytharcher
  • [文件管理器] 修复上传文件时请求中的文件名被重复解码产生的乱码问题 (#8481) by @mytharcher
  • [UI 模板] 修复引用模板区块无法通过事件流设置数据范围的问题。 (#8472) by @gchust
  • [移动端（已废弃）] 弃用移动端插件（2.0 后将使用 ui-layout 插件代替） (#8456) by @chenos
  • [操作：导入记录 Pro] 修复异步导入触发的工作流事件延迟执行的问题 by @mytharcher
  • [工作流：Webhook 触发器] 修复未配置请求体解析时触发器数据中该数据缺失的问题 by @mytharcher

  • [模板打印]

    • 复了联合角色时打印按钮权限逻辑错误 by @jiannx
    • 模板打印的配置模板弹窗移除底部按钮 by @katherinehhh

  • [工作流：审批]

    • 修复审批任务卡片字段不显示的问题 by @zhangzhonghe
    • 修复分支模式的审批未能正确退回至指定节点的问题 by @mytharcher
    • 修复并发提交导致流程被重复恢复执行的问题 by @mytharcher
    • 修复 1.x 审批记录弹窗报错的问题 by @mytharcher

  • [邮件管理]

    • 修复邮箱配置弹窗被遮挡的问题 by @zhangzhonghe
    • 修复多个用户间相同邮箱邮件问题，性能优化 by @jiannx
  • [迁移管理] 修复迁移异常后打印异常对象所包含 SQL 过大容易卡死进程的问题 by @cgyrock

完全掌控，无限扩展，AI 协同。NocoBase 让你的团队快速响应变化，大幅降低成本。无需多年研发，无需数百万投入。花几分钟部署 NocoBase，立即拥有一切。

访问 NocoBase 官网

https://www.nocobase.com/cn

您可以在官网申请 Demo 演示，体验站点将在 1 分钟内创建完毕自动发送到您的邮箱。

访问 NocoBase GitHub 和 Gitee

https://github.com/nocobase/nocobase

https://gitee.com/nocobase/nocobase

下载 NocoBase 源码并安装。支持 Docker 安装、create-nocobase-app 安装和 Git 源码安装。

官方文档持续更新中

https://docs-cn.nocobase.com/

个体工商户的微信收款码如何实时获取收款信息？
比如某个商业街有个商店，每天店员卖零食杂货，然后他入了我们商会后，怎么设置一下，以后他的每次线下卖出的商品的收款，我有个小程序，打开可以查询到历史收款几率？

我问的几个 AI 都是如此回复，看起来很正规啊，为啥都说实现不了
一、微信支付商户平台（推荐商家使用）
适用对象：有营业执照的正式商户
功能特点：
提供官方支付 API ，可实时获取交易数据
支持回调通知（ Webhook ），收款即时推送到你的系统
可查询订单状态、退款管理、对账等功能
实现步骤：
注册微信支付商户平台
完成商户认证，获取商户号（ MCH_ID ）和 API 密钥
配置 APIv3 密钥和证书
在"产品中心"开通"Native 支付"或"JSAPI 支付"
设置支付结果回调 URL ，微信会在收款时主动推送通知到该地址
技术文档：微信支付开发文档 → "支付通知"部分

原来使用 qq 邮箱+微信的 QQ 邮箱提醒通知,给自己发邮件微信会有通知.

后来改成 server 酱 我以为是免费的 后来才发现要会员.

最后切换到飞书和钉钉,创建一个群聊 开通机器人 群聊就自己,利用 webhook 进行通知.钉钉和微信应该一样的保活 目前没漏消息...

试过企业微信 QQ, 都要备案消息主动推送的主体,放弃....

Go-WXPush - 微信消息推送服务 (基于 golang)

这是一个基于 golang 开发的微信测试公众号模板消息推送服务。它提供了一个简单的 API 接口，让您可以轻松地通过 HTTP 请求将消息推送到指定的微信用户。 github 地址 https://github.com/hezhizheng/go-wxpush

✨ 特性

✅ 完全免费，下载即使用
✅ 支持 Docker 一键部署（镜像容器大小仅 2MB）
✅ 每天 10 万次额度，个人用不完
✅ 真正的微信原生弹窗 + 声音提醒
✅ 支持多用户
✅ 提供免费服务 https://push.hzz.cool （请勿滥用）
✅ 跳转稳定，自带消息详情页面 (默认使用 https://push.hzz.cool/detail , 可自己部署后使用参数替换)

⚠️ 部署条件 (具体可查看 github )

🚀 部署指南

下载编译好的文件启动

  • 启动参数
    • 命令行启动参数(可不加，启动之后直接在 url 上拼接参数也可) ./go-wxpush_windows_amd64.exe -port "5566" -title "测试标题" -content "测试内容" -appid "xxx" -secret "xxx" -userid "xxx-k08" -template_id "xxx-Ks_PwGm--GSzllU" -base_url "https://push.hzz.cool"
    • url 请求参数(get) 与命令行参数名称一致 /wxsend?appid=xxx&secret=xxx&userid=xxx-k08&template_id=xxx-Ks_PwGm--GSzllU&base_url=https://push.hzz.cool&content=保持微笑，代码无 bug！

自行编译可执行文件(跨平台)

复制
# 用法参考 https://github.com/mitchellh/gox
# 生成文件可直接执行 
gox -osarch="windows/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
gox -osarch="darwin/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
gox -osarch="linux/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
gox -osarch="linux/arm64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"

🐳 Docker 启动

  • 将编译好的文件放在与 Dockerfile 同目录
  • 构建镜像
复制
docker build -t go-wxpush:v2 .
  • 启动镜像，参数与命令行保持一致
复制
docker run -d -p 5566:5566 --name go-wxpush0 go-wxpush:v2 \
-port "5566" \
-title "测试标题" \
-content "测试内容" \
-appid "xxx" \
-secret "xxx" \
-userid "xxx-k08" \
-template_id "xxx-Ks_PwGm--GSzllU"

🐳 Docker 一键部署

复制
# 重新部署请先拉一遍最新的镜像
docker pull hezhizheng/go-wxpush:v4
# 参数格式与终端启动保持一致, 替换成实际值即可
docker run -it -d -p 5566:5566 --init --name go-wxpush4 hezhizheng/go-wxpush:v4 \
-port "5566" \
-title "测试标题 5566" \
-content "测试内容 5566" \
-appid "xxx" \
-secret "xxx" \
-userid "xxx-k08" \
-template_id "xxx-Ks_PwGm--GSzllU" \
-tz "Asia/Shanghai"

⚙️ API 使用方法

服务部署成功后，您可以通过构造 URL 发起 GET 请求来推送消息。

请求地址

复制
http://127.0.0.1:5566/wxsend

请求参数

参数名类型是否必填描述
portString否指定启动端口(仅针对命令行)
titleString是消息的标题。
contentString是消息的具体内容。
appidString是临时覆盖默认的微信 AppID。
secretString是临时覆盖默认的微信 AppSecret。
useridString是临时覆盖默认的接收用户 OpenID。
template_idString是临时覆盖默认的模板消息 ID。
base_urlString否临时覆盖默认的跳转 URL。
tzString否时区(默认东八区)

使用示例

基础推送

向默认配置的所有用户推送一条消息：

复制
http://127.0.0.1:5566/wxsend?title=服务器通知&content=服务已于北京时间%2022:00%20 重启

临时覆盖用户

向一个临时指定的用户推送消息：

复制
http://127.0.0.1:5566/wxsend?title=私人提醒&content=记得带钥匙&userid=temporary_openid_here

Webhook / POST 请求

除了 GET 请求，服务也支持 POST 方法，更适合用于自动化的 Webhook 集成。

请求地址

复制
http://127.0.0.1:5566/wxsend

请求方法

复制
POST

请求头 (Headers)

复制
{
  "Content-Type": "application/json"
}

请求体 (Body)

请求体需要是一个 JSON 对象，包含与 GET 请求相同的参数。

复制
{
  "title": "Webhook 通知",
  "content": "这是一个通过 POST 请求发送的 Webhook 消息。"
}

使用示例 (cURL)

复制
curl --location --request POST 'http://127.0.0.1:5566/wxsend' \
--data-raw '{
    "title": "来自 cURL 的消息",
    "content": "自动化任务已完成。"
  }'

成功响应

如果消息成功发送给至少一个用户，服务会返回 "errcode": 0 状态码。

失败响应

如果发生错误（如 token 错误、缺少参数、微信接口调用失败等），服务会返回相应的状态码和错误信息。

Go-WXPush - 微信消息推送服务 (基于 golang)

这是一个基于 golang 开发的微信测试公众号模板消息推送服务。它提供了一个简单的 API 接口，让您可以轻松地通过 HTTP 请求将消息推送到指定的微信用户。 github 地址 https://github.com/hezhizheng/go-wxpush

✨ 特性

✅ 完全免费，下载即使用
✅ 支持 Docker 一键部署（镜像容器大小仅 2MB）
✅ 每天 10 万次额度，个人用不完
✅ 真正的微信原生弹窗 + 声音提醒
✅ 支持多用户
✅ 提供免费服务 https://push.hzz.cool （请勿滥用）
✅ 跳转稳定，自带消息详情页面 (默认使用 https://push.hzz.cool/detail , 可自己部署后使用参数替换)

⚠️ 部署条件 (具体可查看 github )

🚀 部署指南

下载编译好的文件启动

  • 启动参数
    • 命令行启动参数(可不加，启动之后直接在 url 上拼接参数也可) ./go-wxpush_windows_amd64.exe -port "5566" -title "测试标题" -content "测试内容" -appid "xxx" -secret "xxx" -userid "xxx-k08" -template_id "xxx-Ks_PwGm--GSzllU" -base_url "https://push.hzz.cool"
    • url 请求参数(get) 与命令行参数名称一致 /wxsend?appid=xxx&secret=xxx&userid=xxx-k08&template_id=xxx-Ks_PwGm--GSzllU&base_url=https://push.hzz.cool&content=保持微笑，代码无 bug！

自行编译可执行文件(跨平台)

复制
# 用法参考 https://github.com/mitchellh/gox
# 生成文件可直接执行 
gox -osarch="windows/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
gox -osarch="darwin/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
gox -osarch="linux/amd64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"
gox -osarch="linux/arm64" -ldflags "-s -w" -gcflags="all=-trimpath=${PWD}" -asmflags="all=-trimpath=${PWD}"

🐳 Docker 启动

  • 将编译好的文件放在与 Dockerfile 同目录
  • 构建镜像
复制
docker build -t go-wxpush:v2 .
  • 启动镜像，参数与命令行保持一致
复制
docker run -d -p 5566:5566 --name go-wxpush0 go-wxpush:v2 \
-port "5566" \
-title "测试标题" \
-content "测试内容" \
-appid "xxx" \
-secret "xxx" \
-userid "xxx-k08" \
-template_id "xxx-Ks_PwGm--GSzllU"

🐳 Docker 一键部署

复制
# 重新部署请先拉一遍最新的镜像
docker pull hezhizheng/go-wxpush:v4
# 参数格式与终端启动保持一致, 替换成实际值即可
docker run -it -d -p 5566:5566 --init --name go-wxpush4 hezhizheng/go-wxpush:v4 \
-port "5566" \
-title "测试标题 5566" \
-content "测试内容 5566" \
-appid "xxx" \
-secret "xxx" \
-userid "xxx-k08" \
-template_id "xxx-Ks_PwGm--GSzllU" \
-tz "Asia/Shanghai"

⚙️ API 使用方法

服务部署成功后，您可以通过构造 URL 发起 GET 请求来推送消息。

请求地址

复制
http://127.0.0.1:5566/wxsend

请求参数

参数名类型是否必填描述
portString否指定启动端口(仅针对命令行)
titleString是消息的标题。
contentString是消息的具体内容。
appidString是临时覆盖默认的微信 AppID。
secretString是临时覆盖默认的微信 AppSecret。
useridString是临时覆盖默认的接收用户 OpenID。
template_idString是临时覆盖默认的模板消息 ID。
base_urlString否临时覆盖默认的跳转 URL。
tzString否时区(默认东八区)

使用示例

基础推送

向默认配置的所有用户推送一条消息：

复制
http://127.0.0.1:5566/wxsend?title=服务器通知&content=服务已于北京时间%2022:00%20 重启

临时覆盖用户

向一个临时指定的用户推送消息：

复制
http://127.0.0.1:5566/wxsend?title=私人提醒&content=记得带钥匙&userid=temporary_openid_here

Webhook / POST 请求

除了 GET 请求，服务也支持 POST 方法，更适合用于自动化的 Webhook 集成。

请求地址

复制
http://127.0.0.1:5566/wxsend

请求方法

复制
POST

请求头 (Headers)

复制
{
  "Content-Type": "application/json"
}

请求体 (Body)

请求体需要是一个 JSON 对象，包含与 GET 请求相同的参数。

复制
{
  "title": "Webhook 通知",
  "content": "这是一个通过 POST 请求发送的 Webhook 消息。"
}

使用示例 (cURL)

复制
curl --location --request POST 'http://127.0.0.1:5566/wxsend' \
--data-raw '{
    "title": "来自 cURL 的消息",
    "content": "自动化任务已完成。"
  }'

成功响应

如果消息成功发送给至少一个用户，服务会返回 "errcode": 0 状态码。

失败响应

如果发生错误（如 token 错误、缺少参数、微信接口调用失败等），服务会返回相应的状态码和错误信息。