Notifiarr 客户端

!Notifiarr Logo

这是 Notifiarr.com 的统一客户端。该客户端支持从***服务器中的媒体机器人请求内容，并提供Plex使用报告、系统健康监控等多种功能。

安装

Linux

Linux仓库托管由 ![packagecloud]([***] 提供。

适用于任何使用apt或yum的系统。如果您的系统不使用APT或YUM，请从 Releases 页面下载二进制文件。

在Linux上，Notifiarr以 user:group 为 notifiarr:notifiarr 运行。

安装Go Lift包仓库和Notifiarr，使用以下命令：

bash
curl -s [***] | sudo bash -s - notifiarr

安装后，编辑配置并启动服务：

bash
sudo nano /etc/notifiarr/notifiarr.conf
sudo systemctl restart notifiarr

Arch Linux

• 从 Releases 页面下载 zst 包。
• 安装：pacman -U *.zst
• 编辑配置：nano /etc/notifiarr/notifiarr.conf
• 启动服务：systemctl start notifiarr

上述步骤的Shell示例：

shell
curl [***] | sudo bash

nano /etc/notifiarr/notifiarr.conf
systemctl start notifiarr

FreeBSD

• 从 Releases 页面下载 txz 包。
• 安装、编辑配置并启动服务。

Shell示例：

shell
wget -qO- [***] | sudo bash

vi /usr/local/etc/notifiarr/notifiarr.conf
service notifiarr start

在FreeBSD上，Notifiarr以 user:group 为 notifiarr:notifiarr 运行。

macOS 安装

Homebrew

Homebrew不再是支持的安装方式。请 下载DMG 并将 Notifiarr.app 放入 /Applications。

macOS 应用

• 可使用Releases页面上的Apple签名应用。
• 首次打开时，会创建配置文件和日志文件：
  • ~/.notifiarr/notifiarr.conf
  • ~/.notifiarr/notifiarr.log
• 编辑配置文件后重新加载或重启应用。

Windows

• 从 Releases页面 提取 .exe.zip 文件。
• 运行 notifiarr.amd64.exe 二进制文件，应用将在系统托盘启动。
• 首次打开时，会创建配置文件和日志文件：
  • C:\ProgramData\notifiarr\notifiarr.conf
  • <您的主文件夹>\.notifiarr\notifiarr.log
• 编辑新配置文件以适应您的环境，然后重新加载或重启应用。

Docker

该项目在 Docker Cloud 自动构建，并创建 多架构镜像。latest 标签始终对应GitHub上的标记版本，main 标签对应GitHub的 main 分支，可能不稳定。

示例docker-compose文件可在 Examples 中找到。

Unraid用户 - 必须在Unraid模板中配置Notifiarr API密钥。如果要使用Plex，还需要在模板中设置Plex令牌和Plex URL。

Docker用户 - 注意Docker环境变量（以及Unraid模板）会覆盖配置文件。

Docker配置文件

• 从本仓库复制 示例配置文件。
• 从Docker Hub拉取镜像，并使用配置文件的覆盖方式运行。
• 若要使用 smartctl（monitor_drives）和/或 MegaCli（monitor_raid），必须设置 privileged。
• 若要统计用户，映射 /var/run/utmp 卷。
• 挂载任何要报告存储空间的卷，挂载位置将作为“名称”。
• 必须设置静态主机名，每个客户端通过主机名识别。
• 应挂载 /config - Notifiarr首次运行时会创建配置文件。

shell
docker pull golift/notifiarr
docker run --hostname=$(hostname) -d \
-v /your/appdata/notifiarr/:/config \
-v /var/run/utmp:/var/run/utmp \
golift/notifiarr
docker logs <docker run返回的容器ID>

Docker环境变量

以下是可用环境变量列表。当网站上启用“监控驱动器”时，必须设置 --privileged。

shell
docker pull golift/notifiarr
docker run --hostname $(hostname) -d --privileged \
  -v /var/run/utmp:/var/run/utmp \
  -e "DN_API_KEY=abcdef-***-bcfead-43312-bbbaaa-123" \
  -e "DN_SONARR_0_URL=http://localhost:8989" \
  -e "DN_SONARR_0_API_KEY=kjsdkasjdaksdj" \
  golift/notifiarr
docker logs <docker run返回的容器ID>

配置信息

WebUI

要启用WebUI，在配置文件顶部 quiet 附近添加以下参数，然后重启客户端：

yaml
ui_password = "用户名:9位密码"

密码长度至少为9位。登录Web界面后，可以更改密码，密码将被加密保存（防止窥探）。

也可将 ui_password 设置为 "webauth" 以启用代理认证支持。为此，还需将认证代理的IP或CIDR添加到 upstreams 设置中。代理必须传递 x-webauth-user: username 头部，您将自动登录。

配置设置

• 除配置文件外，还可使用环境变量配置Docker容器。
• 未提供的变量将使用默认值。
• 必须提供Notifiarr.com的API密钥。
  • Notifiarr应用使用API密钥进行双向授权。
• 可使用 DN_SONARR_1_URL、DN_SONARR_2_URL 等环境变量或在配置文件中重复starr块，配置多个Sonarr、Radarr或Readarr实例。

以下所有应用（starr、下载器、tautulli、plex）均有 timeout 设置。若应用配置中缺少timeout，将使用上述全局timeout。

秘密设置

除非另有说明，否则建议不要修改这些设置。

注意： 可通过将环境变量 USEGUI 设置为 false 禁用Windows上的GUI（菜单项）。

系统快照

该应用可按间隔拍摄系统快照并发送通知。快照包括CPU、内存、磁盘、RAID、用户等系统健康信息。快照中还提供MySQL健康、iotop、iostat 和 top 数据。部分功能可能仅在Linux上可用，但其他平台有类似功能。

若要监控驱动器健康，必须安装smartmontools（smartctl）。若在Linux上使用smartctl，必须启用sudo。将以下sudoers条目添加到 /etc/sudoers 或 /etc/sudoers.d/00-notifiarr，并根据实际路径调整 smartctl 路径。若监控RAID并使用MegaCli（LSI卡），也需添加相应的sudoers条目。

Windows上使用smartctl需要以管理员身份运行应用，提升的权限允许smartctl收集驱动器数据。

若要监控应用磁盘I/O，可安装 iotop 并添加相应的sudoers条目，此功能在网站上启用。

快照sudoers条目

以下sudoers条目用于各种快照功能。使用相应功能时添加这些条目。通常可将以下内容放入 /etc/sudoers 或 /etc/sudoers.d/00-notifiarr。

yml
# 允许在macOS、Linux/Docker和FreeBSD上监控驱动器健康。
notifiarr ALL=(root) NOPASSWD:/usr/sbin/smartctl *

# 允许在Linux（非Docker）上监控磁盘利用率。
notifiarr ALL=(root) NOPASSWD:/usr/sbin/iotop *

# 允许在macOS、Linux/Docker和FreeBSD上监控megaraid卷。
# 很少需要，需要时您会知道。
notifiarr ALL=(root) NOPASSWD:/usr/sbin/MegaCli64 -LDInfo -Lall -aALL

这些路径在不同系统上可能不同。为macOS调整用户名。

快照包

• Windows: smartmontools - 从 <[***]> 获取
• macOS: brew install smartmontools
• Linux:
  • Debian/Ubuntu: apt install smartmontools
  • RedHat/CentOS: yum install smartmontools
• Docker: 容器中已包含，只需以 --privileged 模式运行容器。
• Synology: opkg install smartmontools，但需先安装Entware:
  • Entware（Synology）: <[***]>
  • Entware包列表: <[***]>

快照配置

快照配置（除Nvidia和MySQL外）在 网站 上进行。

MySQL快照

可在Notifiarr配置中添加MySQL凭据，以快照MySQL服务健康。此功能快照 SHOW PROCESSLIST 和 SHOW STATUS 数据。

不需要数据库访问权限。授权示例：

mysql
GRANT PROCESS ON *.* to 'notifiarr'@'localhost'

Nvidia快照

可报告Nvidia显卡的GPU和内存利用率。若 PATH 中存在 nvidia-smi，则自动启用。

Lidarr

• BCC = 备份损坏检查

***