如何用goshs Webhook把上传下载事件推送到Discord、Slack和Mattermost
如何用goshs Webhook把上传下载事件推送到Discord、Slack和Mattermost
goshs 是一个功能强大的单二进制文件服务器,而它的 Webhook 功能可以实时把文件上传、下载、删除、FTP 登录等事件推送到 Discord、Slack 或 Mattermost 频道,让你第一时间掌握服务器上发生了什么。本教程将带你快速完成配置,让文件服务器"开口说话"。
什么是 goshs Webhook?📡
goshs 内置了 Webhook 集成(源码位于 webhook/webhook.go),它的工作方式很简单:
- 文件服务器上发生某个事件(如文件上传);
- goshs 将该事件格式化为一条消息;
- 通过 HTTP POST 以 JSON 形式发送到你的 Webhook URL;
- 对应平台的机器人就会把消息发到你的频道里。
核心判断逻辑在 logger/logger.go 的 HandleWebhookSend 函数中:只有 Webhook 启用、且事件在订阅列表内时才会真正发送。
支持哪些平台?
| 平台 | Provider 取值 | 消息 payload 格式 |
|---|---|---|
| Discord | discord(默认) |
content + 用户名 goshs |
| Slack | slack |
text |
| Mattermost | mattermost |
text + 用户名 goshs |
三家平台的实现分别位于:
- Discord:webhook/discord.go
- Slack:webhook/slack.go
- Mattermost:webhook/mattermost.go
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
消息是怎么发出去的?(原理速览)🔍
整个发送链路非常短:
- 各服务器(HTTP、FTP、DNS 等)在关键节点调用
logger.HandleWebhookSend(消息, 事件, webhook),例如上传事件在 httpserver/updown.go 触发; HandleWebhookSend检查 Webhook 是否启用、事件是否订阅;- 命中后调用 provider 的
Send方法,走统一的 JSON POST 请求函数 webhook/webhook.go; - 非 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方法即可。
现在,让你的文件服务器从此不再"沉默"吧!

