通知

Coolify 提供了一个强大的多通道通知系统。您可以在 Coolify 仪表板的 通知 选项卡中配置通知。

通知提供商

以下是 Coolify 中支持的通知提供商的设置指南。

电子邮件

1. 导航至 通知 → 电子邮件

2. 选择您的电子邮件提供商：

   • 使用系统级（事务性）电子邮件设置（如果您自行托管 Coolify，可以在实例设置中配置此选项；如果您使用 Coolify Cloud，则已为您配置好）。
   • SMTP 服务器
   • Resend

3. 配置您选择的提供商：

系统级电子邮件设置

• 勾选“使用系统级（事务性）电子邮件设置”复选框
• 如果您自行配置，请参阅下面的 SMTP 服务器配置 部分以获取详细设置。

SMTP 服务器配置

• 填写以下字段：
  • From Name - 发件人的显示名称
  • From Address - 通知邮件的发件地址
  • Host - SMTP 服务器主机名（例如 smtp.mail.com）
  • Port - SMTP 端口：
    • 端口 587 - StartTLS 端口（支持最广泛）
    • 端口 465 - TLS/SSL 端口（推荐用于最高安全性）
  • Username - SMTP 认证用户名
  • Password - SMTP 认证密码
  • Encryption - 选择您的加密方法：
    • StartTLS - 初始不加密，然后通过 StartTLS 升级为 TLS（通常与端口 587 配合使用）
    • TLS/SSL - 从连接开始即使用 TLS 加密（通常与端口 465 配合使用 - 会自动在主机名前添加 ssl://）
    • None - 不加密（不推荐，因为安全性极低）
  • Timeout - 连接超时时间（秒）
• 通过 Enabled 复选框启用 SMTP 服务器

Resend 配置

• 输入您的 Resend API Key
• 勾选 Resend 复选框

1. 点击 Send Test Email 以验证您的配置

Telegram

1. 初始设置（仅限手机操作）

   • 使用您的手机号码创建 Telegram 账户
   • 在手机上打开 Telegram 应用
   • 进入 设置 → 个人资料
   • 设置用户名（推荐）

2. 创建您的机器人

   • 向 @BotFather 发送消息
   • 发送 /newbot 命令
   • 按照 BotFather 的提示创建您的机器人
   • 显示时复制 Bot Token

1. 创建并将机器人添加到群组

   • 在 Telegram 中创建一个新群组
   • 将您的机器人添加到群组（您可以在创建机器人时选择的名字来添加它）

2. 将机器人设为群组管理员

   • 点击群组名称
   • 找到成员列表
   • 点击机器人名称
   • 点击 添加到群组或频道
   • 选择该群组
   • 开启 管理员 开关
   • 点击 添加机器人作为管理员

3. 启用主题（可选，仅限手机操作）

   • 在手机上打开该群组
   • 点击群组名称
   • 点击铅笔图标（编辑）
   • 找到并启用 主题（这将为该群组启用线程功能）
   • 现在您可以使用群组中的三点菜单创建主题（桌面端同样适用）

4. 获取所需 ID

   • 访问：https://api.telegram.org/bot{YOUR_BOT_TOKEN}/getUpdates（将 {YOUR_BOT_TOKEN} 替换为您的实际机器人令牌）
   • 在您的群组或线程/主题中发送一条测试消息
   • 在响应中查找以下值：
     • Chat ID：查找 "chat": {"id": -100XXXXXXXXX,（对于群组/频道，聊天 ID 通常以 -100 开头）
     • Thread/Topic ID（如果使用线程）：查找 "message_thread_id":XXXXX,

5. 配置 Coolify

   • 进入 通知 → Telegram
   • 输入您的 bot token（来自第 2 步）
   • 输入 chat ID（如果存在请包含 - 减号）
   • 输入 thread/topic ID（仅在使用线程时填写）
   • 保存设置
   • 启用 Telegram 通道
   • 发送 测试通知

Discord

1. 创建 Discord 服务器和频道

   • 创建新服务器或使用现有服务器
   • 为 Coolify 通知创建一个新文本频道

2. 创建 Webhook

   • 打开 Discord 服务器设置
   • 进入 集成 → Webhooks
   • 点击 新建 Webhook
   • 选择您为 Coolify 通知创建的频道
   • 复制 webhook URL

3. 在 Coolify 中配置：

   • 进入 通知 → Discord
   • 将 webhook URL 粘贴到 Webhook URL 字段中
   • 保存设置
   • 启用 Discord 通道
   • 发送 测试通知

Slack / Mattermost

使用 Slack

1. 创建 Slack 应用

   • 访问 Slack API
   • 点击 创建新应用 → 从零开始
   • 选择您的工作区

2. 启用 Webhooks：

   • 进入 Incoming Webhooks
   • 开启 Activate Incoming Webhooks
   • 点击 Add New Webhook to Workspace
   • 选择用于 Coolify 通知的频道
   • 复制 webhook URL

3. 在 Coolify 中配置：

   • 进入 通知 → Slack
   • 将 webhook URL 粘贴到 Webhook URL 字段中
   • 保存设置
   • 启用 Slack 通道
   • 发送 测试通知

在 Mattermost 中使用 Slack 通知

Coolify 中的 Slack Webhooks 与 Mattermost 完全兼容。

1. 在 Mattermost 中创建传入 Webhook：

   • 进入 产品菜单 → 集成 → 传入 Webhooks
   • 点击 添加传入 Webhook
   • 配置 Webhook（名称、频道等）并保存
   • 复制生成的 Webhook 地址（格式：https://your-mattermost-server.com/hooks/xxx-key-xxx）

2. 在 Coolify 中配置：

   • 进入 通知 → Slack
   • 将 Mattermost webhook URL 粘贴到 Webhook URL 字段中
   • 保存设置
   • 启用 Slack 通道
   • 发送 测试通知

Pushover（推送通知）

1. 获取用户密钥

   • 在 Pushover 登录或注册
   • 从页面右上角复制您的 User Key

2. 创建应用程序

   • 访问 创建应用程序
   • 填写应用程序详细信息
   • 创建应用程序
   • 从页面左上角复制 API Token/Key

3. 在 Coolify 中配置：

   • 进入 通知 → Pushover
   • 输入您的 User Key（来自第 1 步）
   • 输入您创建的应用程序的 API Key（来自第 2 步）
   • 保存设置
   • 启用 Pushover 通道
   • 发送 测试通知

Webhook

Webhook 通知允许您将通知发送到任何接受 HTTP 请求的自定义端点。

1. 在 Coolify 中配置：
   • 进入 通知 → Webhook
   • 在 Webhook URL 字段中输入 HTTP 或 HTTPS 地址
   • 保存设置
   • 启用 Webhook 通道
   • 发送 测试通知

当发生事件时，Coolify 会向您的指定端点发送 POST 请求。您可以将其用于与自定义应用程序、自动化工具或任何接受 Webhook 的服务进行集成。

有关每个事件的完整 JSON 负载结构，请参阅 Webhook 负载 参考文档。

通知事件

您可以在通知设置中配置触发通知的事件：

部署

• 部署成功
• 部署失败
• 容器状态更改

备份

• 备份成功
• 备份失败

计划任务

• 计划任务成功
• 计划任务失败

服务器

• Docker 清理成功
• Docker 清理失败
• 服务器磁盘使用情况
• 服务器可达
• 服务器不可达
• 服务器打补丁
• Traefik 代理版本过旧