如何用goshs Webhook把上传下载事件推送到Discord、Slack和Mattermost

原创2026-10-22 16:22:431,652 阅读

如何用goshs Webhook把上传下载事件推送到Discord、Slack和Mattermost

goshs 是一个功能强大的单二进制文件服务器,而它的 Webhook 功能可以实时把文件上传、下载、删除、FTP 登录等事件推送到 Discord、Slack 或 Mattermost 频道,让你第一时间掌握服务器上发生了什么。本教程将带你快速完成配置,让文件服务器"开口说话"。

goshs Webhook 文件服务器事件推送横幅

什么是 goshs Webhook?📡

goshs 内置了 Webhook 集成(源码位于 webhook/webhook.go),它的工作方式很简单:

  1. 文件服务器上发生某个事件(如文件上传);
  2. goshs 将该事件格式化为一条消息;
  3. 通过 HTTP POST 以 JSON 形式发送到你的 Webhook URL;
  4. 对应平台的机器人就会把消息发到你的频道里。

核心判断逻辑在 logger/logger.go 的 HandleWebhookSend 函数中:只有 Webhook 启用、且事件在订阅列表内时才会真正发送。

支持哪些平台?

平台 Provider 取值 消息 payload 格式
Discord discord(默认) content + 用户名 goshs
Slack slack text
Mattermost mattermost text + 用户名 goshs

三家平台的实现分别位于:

provider 的注册与分发逻辑见 webhook/webhook.go 的 Register 函数。

获取 Webhook URL(3 个平台各 30 秒)⏱️

1️⃣ Discord

在你的 Discord 服务器中,进入 服务器设置 → 整合(Integrations)→ Webhooks → 新建 Webhook,选择频道,点击复制 Webhook URL。

2️⃣ Slack

打开你的 Slack 工作区,进入 应用/集成管理页面 → Incoming Webhooks → 为团队开启,为某个频道生成 URL 并复制。

3️⃣ Mattermost

进入你的 Mattermost 实例,头像 → 个人设置 → Webhooks → 新建 Incoming Webhook,选择频道后复制 URL。

💡 Webhook URL 等同于向频道发消息的钥匙,请妥善保管,不要泄露给不信任的人。

快速开始:命令行一键配置 🚀

goshs 提供了 4 个命令行参数来控制 Webhook(定义于 options/options.go):

参数 短选项 说明 默认值
--webhook -W 启用 Webhook false
--webhook-url -Wu Webhook 目标 URL 空
--webhook-provider -Wp 平台:discord / slack / mattermost Discord
--webhook-events -We 事件列表,逗号分隔 all

以推送到 Discord 为例:

goshs -W -Wu "https://discord.com/api/webhooks/你的令牌/你的URL" -Wp discord

推送到 Slack 或 Mattermost,只需更换 provider 和 URL:

# Slack
goshs -W -Wu "https://hooks.slack.com/services/你的URL" -Wp slack

# Mattermost
goshs -W -Wu "https://你的实例.example.com/hooks/你的令牌" -Wp mattermost

启动成功后,频道里会立刻收到一条服务启动通知:

[CORE] goshs started on 0.0.0.0:8000

事件过滤:只推送你关心的事件 ✂️

--webhook-events 参数支持用逗号分隔的事件名进行精确订阅。goshs 会监控的事件包括:

事件名 触发场景
started 服务启动完成
upload 文件被上传(HTTP 或聊天上传)
download 文件被下载
view 文件被在线预览
delete 文件被删除
redirect 客户端跟随了重定向
webdav WebDAV 请求
verbose 详细请求日志(需额外开启)
ftp / tftp FTP/TFTP 访问与认证
smb / ldap / dns / smtp 对应协议服务器的访问事件

只关注上传和下载?一条命令搞定:

goshs -W -Wu "你的WebhookURL" -We "upload,download"

事件匹配逻辑见 logger/logger.go:事件名在列表中即发送;all 会覆盖除 verbose 外的所有事件(verbose 信息量太大,需显式指定才会推送)。

不同事件的典型消息格式(源码中的示例):

[WEB] File uploaded: /uploads/20260101/report.pdf
[WEB] File downloaded: /downloads/payload.sh
[WEB] File deleted: /tmp/old.txt
[WEBDAV] 192.168.1.5 - - "GET /share.zip HTTP/1.1"
[DNS] - Source: 10.0.0.8 - Type: A - Query: example.com

使用配置文件(推荐给长期部署)📝

如果习惯用配置文件(-C 指定路径),goshs 支持在 JSON 配置中声明 Webhook,示例见 example/goshs.json.example:

{
  "webhook_enabled": true,
  "webhook_url": "https://discord.com/api/webhooks/你的令牌/你的URL",
  "webhook_provider": "discord",
  "webhook_events": [
    "upload",
    "download",
    "delete"
  ]
}

然后启动:

goshs -C /path/to/goshs.json

消息是怎么发出去的?(原理速览)🔍

goshs 项目标志

整个发送链路非常短:

  1. 各服务器(HTTP、FTP、DNS 等)在关键节点调用 logger.HandleWebhookSend(消息, 事件, webhook),例如上传事件在 httpserver/updown.go 触发;
  2. HandleWebhookSend 检查 Webhook 是否启用、事件是否订阅;
  3. 命中后调用 provider 的 Send 方法,走统一的 JSON POST 请求函数 webhook/webhook.go;
  4. 非 2xx 响应会返回错误并记录日志,不会中断文件服务本身。

也就是说:Webhook 推送失败不会影响文件服务的正常运行,只是会在 goshs 日志中记一条错误。

常见问题 FAQ ❓

Q:为什么设置了 Webhook 却收不到消息?

  • 检查 -W 是否加了(不启用时一切都不发送);
  • 检查 -Wp 与 URL 是否匹配(Slack 的 URL 配到 discord 虽然能发出去,但格式不对会被平台拒绝);
  • 查看事件是否被 -We 过滤掉了,例如只订阅了 upload 却想收 download 通知。

Q:一个 goshs 能同时推送到多个平台吗? 不能,一次运行只支持一个 provider。如需多平台,可以启动多个实例指向不同目录,或在平台侧做转发。

Q:Webhook 消息会泄露敏感信息吗? 消息中只包含 IP、事件名和文件路径,不包含文件内容;如果你开启了 -We verbose,详细日志可能包含请求头等敏感字段,生产环境建议按需订阅。

小结 🎯

  • 用 -W -Wu <URL> -Wp <provider> 三个参数即可把 goshs 的上传/下载等事件推送到 Discord、Slack 或 Mattermost;
  • 用 --webhook-events 精确订阅你关心的事件,避免消息轰炸;
  • 长期部署建议写入 JSON 配置文件,参考 example/goshs.json.example;
  • 核心源码集中在 webhook/ 目录,想扩展新的推送平台(如企业微信、钉钉),照着 Webhook 接口实现一个 Send 方法即可。

现在,让你的文件服务器从此不再"沉默"吧!

登录后查看全文
goshs