跳到主要内容

精细化通知设置

概述​

从版本 2.3.1 开始，您可以精细调整面板发送到 Telegram 或 Webhook 的通知。此功能允许您为每个通知渠道分别启用或禁用特定事件。

配置​

要配置通知，您需要下载配置文件、修改它并将其挂载到 Docker 容器中。

步骤 1：下载配置文件​

从官方仓库下载通知配置文件：

cd /opt/remnawave && curl -o notifications-config.yml https://raw.githubusercontent.com/remnawave/backend/refs/heads/main/configs/notifications/notifications-config.yml

或使用 wget：

cd /opt/remnawave && wget https://raw.githubusercontent.com/remnawave/backend/refs/heads/main/configs/notifications/notifications-config.yml

步骤 2：配置设置​

在文本编辑器中打开下载的文件：

cd /opt/remnawave && nano notifications-config.yml

文件包含所有可用事件的默认设置。每个事件有两个渠道：

  • telegram: true/false - 向 Telegram 发送通知
  • webhook: true/false - 通过 Webhook 发送通知

配置示例：​

禁用用户创建的 Telegram 通知：

events:
    user.created:
        telegram: false # 禁用 Telegram
        webhook: true # 保持 Webhook 启用

禁用设备连接的所有通知：

events:
    user_hwid_devices.added:
        telegram: false
        webhook: false

使用锚点批量禁用：

events:
  user.expired:
    <<: *bothDisabled  # 禁用两个渠道

步骤 3：挂载到 Docker 容器​

在您的 docker-compose.yml 中添加卷：

cd /opt/remnawave && nano docker-compose.yml
services:
    remnawave:
        image: remnawave/remnawave:2
        volumes:
            - ./notifications-config.yml:/var/lib/remnawave/configs/notifications/notifications-config.yml:ro
        # ... 其他设置

步骤 4：重启容器​

挂载文件后重启容器：

cd /opt/remnawave && docker compose down remnawave && docker compose up -d && docker compose logs -f

可用事件​

配置文件支持按类别组织的众多事件。所有可用事件的完整最新列表可在官方仓库中找到：events.ts。