Coolify 中文文档

中文

English

中文

English

Appearance

通知 ​

Coolify 提供了强大的通知系统，支持多种渠道。您可以在 Coolify 仪表板的 通知 选项卡中配置通知。

通知提供商 ​

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

电子邮件 ​

INFO

电子邮件通知可以使用 SMTP 或 Resend 进行配置。

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

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

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

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

系统级电子邮件设置 ​

  • 启用 使用系统级（事务性）电子邮件设置 复选框
  • 如果您自己设置，请参阅下面的 SMTP 服务器配置 部分了解详细设置。

SMTP 服务器配置 ​

  • 填写以下字段：
    • 发件人名称 - 发件人的显示名称
    • 发件人地址 - 通知将来自的电子邮件地址
    • 主机 - SMTP 服务器主机名（例如，smtp.mail.com）
    • 端口 - SMTP 端口：
      • 端口 587 - StartTLS 端口（最广泛支持）
      • 端口 465 - TLS/SSL 端口（推荐用于最高安全性）
    • 用户名 - SMTP 认证用户名
    • 密码 - SMTP 认证密码
    • 加密 - 选择您的加密方法：
      • StartTLS - 开始不加密，然后通过 StartTLS 升级到 TLS（通常与端口 587 一起使用）
      • TLS/SSL - 从一开始就使用 TLS 加密（通常与端口 465 一起使用 - 自动在主机前面添加 ssl://）
      • 无 - 不加密（不推荐，因为极不安全）
    • 超时 - 连接超时（秒）
  • 通过 启用 复选框启用 SMTP 服务器

提示

我们建议使用 TLS/SSL 加密和端口 465 以获得最安全的连接。这从连接开始就提供了加密。

INFO

一些托管提供商有特定的端口限制。例如，Hetzner 默认阻止端口 465。请与您的托管提供商确认端口可用性和任何必要的配置更改。

Resend 配置 ​

  • 输入您的 Resend API 密钥
  • 启用 Resend 复选框
  1. 点击 发送测试电子邮件 以验证您的设置

Telegram ​

  1. 初始设置（只能在手机上设置）

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

  2. 创建您的机器人

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

INFO

复制机器人令牌后，从 Telegram 中删除包含它的消息。安全存储令牌，因为任何有权访问它的人都可以控制您的机器人。

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

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

  2. 使机器人成为群组管理员

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

  3. 启用主题（可选，只能在手机上设置）

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

  4. 获取所需的 ID

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

  5. 配置 Coolify

    • 转到 通知 → Telegram
    • 输入您的 机器人令牌（来自步骤 2）
    • 输入 聊天 ID（如果存在，请包含 - 减号）
    • 输入 线程/主题 ID（仅当您使用线程时）
    • 保存设置
    • 启用 Telegram 渠道
    • 发送 测试通知

INFO

常见问题：

  • 确保机器人是群组/频道的管理员
  • 如果聊天 ID 中存在减号 (-)，请将其包含在内
  • 如果 getUpdates 返回空响应，请发送另一条消息并重试
  • 如果您无法访问 getUpdates，请确保您有正确的机器人令牌，并且已将 {YOUR_BOT_TOKEN} 替换为您的实际机器人令牌（替换包括引号在内的所有内容）

Discord ​

  1. 创建 Discord 服务器和频道

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

  2. 创建 webhook

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

  3. 在 Coolify 中配置：

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

INFO

有关更详细的设置说明，请参阅 Discord 的 Webhook 指南。

Slack ​

  1. 创建 Slack 应用

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

  2. 启用 webhooks：

    • 转到 传入 Webhooks
    • 切换 激活传入 Webhooks
    • 点击 将新 Webhook 添加到工作区
    • 为 Coolify 通知选择一个频道
    • 复制 webhook URL

  3. 在 Coolify 中配置：

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

Pushover（推送通知） ​

  1. 获取用户密钥

    • 在 Pushover 登录或注册
    • 从页面右上角复制您的 用户密钥

  2. 创建应用程序

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

  3. 在 Coolify 中配置：

    • 转到 通知 → Pushover
    • 输入您的 用户密钥（来自步骤 1）
    • 输入您创建的应用程序的 API 密钥（来自步骤 2）
    • 保存设置
    • 启用 Pushover 渠道
    • 发送 测试通知

INFO

Pushover 允许您在多个设备上接收通知，包括 iOS、Android 和桌面。

通知事件 ​

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

部署 ​

  • 部署成功
  • 部署失败
  • 容器状态变化

备份 ​

  • 备份成功
  • 备份失败

计划任务 ​

  • 任务成功
  • 任务失败

服务器事件 ​

  • Docker 清理成功
  • Docker 清理失败
  • 高磁盘使用率警报
  • 服务器状态更新

多渠道

您可以为每个通知渠道配置不同的事件。例如，您可以将部署失败通知发送到电子邮件，将成功通知发送到 Slack。