Nextcloud + Server酱：私有云盘事件推送到微信

效果：Nextcloud 中的文件变更、分享等事件实时推送到微信

前置条件

获取 Server酱 SendKey（参考 30 秒获取 SendKey 教程）
Nextcloud 30+ 环境（支持 Webhook listeners）

配置步骤

方法一：Webhook listeners（固定标题通知）

在 Nextcloud 的 Webhook listeners 设置中（具体入口以应用内实际显示为准），将目标 URL 填写为：

https://sctapi.ftqq.com/你的SENDKEY.send?title=Nextcloud%E4%BA%8B%E4%BB%B6

此方法会将所有触发事件推送为标题为「Nextcloud事件」的消息。Nextcloud 推送的 JSON 详情无法直接显示在微信通知中。

如果你使用的是 Server酱³，端点请替换为 https://你的UID.push.ft07.com/send/你的SENDKEY.send。

方法二：Flow + curl（自定义内容）

也可使用 Nextcloud 的 workflow/Flow 配合外部脚本触发 curl，向 Server酱发送请求：

curl -X POST "https://sctapi.ftqq.com/你的SENDKEY.send" \
  --data-urlencode "title=Nextcloud文件变更" \
  --data-urlencode "desp=检测到文件被修改或分享"

方法三：中转解析（推送详细事件内容）

若需将 Nextcloud 推送的固定 JSON 内容解析后送入 desp 正文，需部署一层中转（如 Cloudflare Workers 或云函数），接收 Nextcloud 的 POST 请求，解析 JSON 后再向 Server酱 API 发起请求。

完整示例

以下是一个 Cloudflare Worker 中转脚本示例，接收 Nextcloud 的 Webhook 请求，将 JSON 详情推送到 Server酱：

export default {
  async fetch(request) {
    const payload = await request.json();
    const title = "Nextcloud事件";
    const desp = JSON.stringify(payload, null, 2);
    const sendkey = "你的SENDKEY";
    const url = `https://sctapi.ftqq.com/${sendkey}.send`;

    await fetch(url, {
      method: "POST",
      headers: { "Content-Type": "application/x-www-form-urlencoded" },
      body: `title=${encodeURIComponent(title)}&desp=${encodeURIComponent(desp)}`
    });

    return new Response("ok");
  }
}

将此 Worker 部署后，把 Worker 的 URL 填入 Nextcloud 的 Webhook listeners 即可。

常见问题

Server酱的发送额度是多少？

免费用户每日可发送 5 条，每分钟上限 50 条。订阅会员目前特价最低 3 元/月，一天最多可发 1000 条（价格详情）。

配置后没收到消息？

检查 SendKey 是否正确，网络是否通畅。更多排查步骤见常见问题与排查。

Webhook 推送的内容为什么是空的？

Nextcloud Webhook listeners 发送的是固定结构的 JSON 事件体，其字段名与 Server酱的 title/desp 并不对应。方法一用 URL query 传的是固定标题；若想把事件详情写进 desp，需用方法三的中转脚本解析 Nextcloud 的 JSON 后再映射到 title/desp。

如何推送到企业微信、钉钉或飞书群？

消息默认推送到你 SendKey 所绑定的通道；如需调整推送到微信/企业微信/钉钉等，详见通道配置说明。