The Ultimate Guide to Readarr (2026 Updated)

Readarr – another member of the “arr” download automation software family, is slowly gaining popularity. The software has a lot to offer, especially for book enthusiasts. This software allows you to build an entire personalized book collection automatically.

在这本 Readarr 终极指南中，我们将介绍使用该软件所需的所有知识（基础知识）。您将了解它的工作原理以及 如何下载和安装 Linux 和 Windows 机器。您还将学到一些如何开始配置和使用它的技巧。 

免责声明： 免责声明：本材料仅供参考。它并不构成对任何活动（包括非法活动）、产品或服务的认可。在使用我们的服务或依赖此处的任何信息时，您全权负责遵守适用的法律，包括知识产权法。对于因以任何方式使用我们的服务或此处包含的信息而造成的损害，我们不承担任何责任，除非法律明确要求。

目录 

1. Readarr 简介 
2. Readarr 如何工作？
3. 如何在 Linux 中下载并安装 Readarr。
4. 如何在 Windows 中下载并安装 Readarr。
5. 使用和配置 Readarr。
6. 故障排除。
7. 结语

What is Readarr?

Readarr is an ebook and audiobook automation tool from the Arr family, designed to monitor authors, search indexers, and automatically download and organize books using Usenet or BitTorrent. It works similarly to Sonarr and Radarr but is built specifically for text-based media like ebooks and audiobooks.

Is Readarr still maintained?

As of 2026, the Readarr project is officially retired. The original development team has stopped active maintenance due to long-standing metadata issues, and users are encouraged to look for alternatives or forks that continue development.

1.Readarr 简介

Readarr 是一款电子书（和有声读物）收藏管理器和自动化软件，用于 BitTorrent 和 Usenet 用户。它属于 "arr "系列下载自动化软件。该软件可跟踪您最喜爱的作家新书的 RSS 源（或多个带有网站更新摘要的文件）。它将监控这些 RSS 源（阅读它们并访问链接），并抓取、分类或重命名给定的电子书文件。它也被称为 Sonarr 用于电子书。 

Readarr 支持主要平台（Windows、macOS、Linux 或 Raspberry Pi）。它是 100% 免费软件，以开源的 GPL-3.0 许可. 

特点

• 自动搜索.它可根据 RSS 源检查商店中当前的电子书和有声读物。 
• 提升质量。 它对现有图书质量进行比较，并执行自动升级以提高质量。 
• 扩大你的资料库。 将您当前的图书库与在线图书库进行比较，检测新书并下载丢失的图书。
• 自动重新下载。 如果下载失败，软件会自动重试。 
• 完全集成 Calibre 全自动集成 口径 - 是一款强大的免费开源电子书管理器。通过集成，可以添加到书库并进行转换。 
• 手动搜索。 从图形用户界面手动搜索未下载的版本。
• 创建配置文件。 确保 Readarr 下载的是你想要的确切类型的副本。例如，只下载 EPUB、FLAC、MOBI、PDF、MP3 等。 
• 图书重命名功能。 用新格式自动重命名图书，让你可以按照自己的喜好来组织图书。 
• 集成 Usenet 和 torrent 客户端 与流行的洪流客户端轻松集成，包括 qBittorrent, Deluge, rTorrent, uTorrent，和 变速箱.它还支持 SABnzbd 和 NZBGet 供 Usenet 用户使用。
• 集成指数管理器。 该软件与索引管理器集成 Jackett 和 Prowlarr，以简化索引管理。 

想到 作为瑞士军刀的 Calibre 读取器-一个工具，无限可能！
单击此处获取免费指南

2.Readarr 如何工作？

如前所述，Readarr 是一款电子书/有声读物下载自动化软件，可改善和扩大你的图书库。为了实现这一目标，它需要与其他组件集成，如下载客户端、torrent/usenet 索引器和第三方索引管理器。 

开始使用软件时，您需要配置自己的偏好，如书籍、流派、作者等。在下载之前，Readarr 会扫描你现有的书库（如果你有的话）。然后，它会监控你提供的 RSS 源，下载新书或更新旧书。 

Readarr 集成了 Usenet 或 BitTorrent 下载客户端。它向这些客户端发送下载请求，并将下载与标签或类别（初始配置）关联起来。Readarr 通过客户端的 API 跟踪使用指定类别的特定活动下载的活动。 

如果下载失败，软件会自动寻找另一个下载版本并重新尝试下载。在导入媒体书文件夹之前，所有完成下载的文件都可以在原文件夹位置保留一段时间，以便为文件播种。 

注意： Readarr 默认使用硬链接。硬链接 是对文件的直接引用（因此不会占用额外的磁盘空间）。硬链接用于更改原始文件的内容或位置。如果由于某种原因无法创建硬链接则会退回并复制原始文件。T软件 也有一个选项："已完成下载处理 - 删除 "可从 torrent 客户端删除 torrent（和数据）。

3.如何在 Linux 中下载和安装 Readarr。

为便于说明，我们将在 Ubuntu 20.04 上安装 Readarr。这个 Ubuntu 实例采用 amd64 架构，在云上运行。我们将通过命令行进行安装，但机器也可以通过网络浏览器访问图形用户界面。 

如何在 Ubuntu 20.04 上安装 Readarr？ 

请记住，在 Ubuntu（Debian 或 Raspbian）上没有 Apt 软件源或 Deb 软件包可以轻松安装 Readarr。 您将有两种选择： 

• 其一，使用维基的 Arr 社区安装脚本.
• 二，安装先决条件和二进制文件。

确保您的软件源是最新的，并安装以下先决条件： 

• $ sudo apt-get update 
• $ sudo apt install curl sqlite3

• 创建 readarr 用户。  请使用以下命令执行：
  • $ sudo adduser readarr

• 让新的 readarr 用户成为组媒体的一部分。 Readarr 将以新用户 "readarr "和组 "media "运行。媒体组是所有 "Arr "应用程序、torrent 和 Usenet 下载客户端以及媒体服务器的推荐组名。
  • $ sudo groupadd media
  • $ sudo usermod -a -G media readarr
• 要确认用户已添加，请使用以下命令：
  • $ 成员媒体

• 创建 /var/lib/readarr 目录。 这是存储 Readarr 配置文件的地方。
  • $ sudo mkdir /var/lib/readarr

• 更改所有权，并确保新用户拥有该目录的读/写权限。
  • $ sudo chown -R readarr:media /var/lib/readarr
  • $ sudo chmod -R 600 /var/lib/readarr
  • $ ls -ld /var/lib/readarr

• 读取输出： "drw--"（或 600）表示所有者、组 "media "中的用户 "readarr "拥有读写目录（/var/lib/readarr）的权限。其他所有人都没有读取、写入或执行的权限。 

• 确保你的下载客户端（即 uTorrent 或 NZBGet）和媒体 "Readarr "服务器属于同一个组 "媒体"。 此外，还要确保 "媒体 "组可以访问（读/写）这些组件使用的路径。 

注 1： 确保以新用户 "readarr "在组 "media "中运行 Readarr。这将避免图书和电子书文件出现任何新的权限问题。 

注 2： 如果将 Calibre 与 Readarr 整合，则需要将其添加到群组媒体中。 此外，Calibre 库还需要媒体组的读/写权限。Readarr 也需要访问 Calibre 目录的权限。 

📂 告别杂乱无章的图书馆！
使用 Calibre for Readarr 以简化您的收藏。 立即获取免费指南

安装 Readarr。

以下步骤将下载并安装到 /opt 目录中 

• 让我们为服务器下载正确的二进制文件。由于我们使用的是 AMD64 架构，因此必须修改以下命令的最后一部分。
  • $ sudo wget --content-disposition 'http://readarr.servarr.com/v1/update/develop/updatefile?os=linux&runtime=netcore&arch=arm64'

• 使用以下命令解压下载的 tar.gz 文件：
  • $ sudo tar -xvzf Readarr*.linux*.tar.gz

• 将所有 Readarr 文件移至 /opt
  • $ sudo mv Readarr /opt/
• 将二进制 readarr 目录的所有权更改为用户 "readarr"
  • $ sudo chown readarr:readarr -R /opt/Readarr

注 1： 更改后，请确保使用 readarr 用户登录。 

注 2： 我们还鼓励让 Readarr 在每次重启后自动重新启动。为此，您可以遵循 维基服务的脚本创建 systemd 并使用 /var/lib/readarr 的数据目录。 

完成配置后，请确保 Readarr 服务已启动并运行。使用以下命令 

• $ sudo systemctl enable --now -q readarr

开幕朗读。 

• 要开始使用它，请访问网络浏览器（在与 Readarr 服务器相同的本地计算机上），然后键入 http://localhost:8787

4.如何在 Windows 上下载和安装 Readarr

出于 "在 Windows 上安装 Readarr "的说明目的，我们将在 Microsoft Windows Server 2022（在 AWS EC2 上运行）上安装。安装非常简单。该软件有一个 Windows 本地应用程序（专为该操作系统开发）。它可以作为 Windows 服务或系统托盘应用程序进行安装。 

• 从以下网址下载 Windows 软件包 官方网站. 

• Windows 可能会将该软件包识别为未知软件包，因此您必须将其批准为 "安全下载"。点击 "无论如何保留"。

• 打开可执行文件对于 Windows，Readarr 的可执行文件（MSI）看起来像这样："Readarr.develop.0.1.1.1320.windows-core-x64-installer"。
• 按照安装向导进行操作。 建议将软件安装为系统托盘应用程序。请不要选择 "创建桌面快捷方式 "和 "在启动文件夹中创建快捷方式 "选项。 

注意： 您可以 "安装 Windows 服务"，但必须执行额外的步骤。Windows 服务不会访问网络驱动器或共享，因此必须手动配置权限。此外，如果下载客户端要将内容下载到用户的主目录，则需要手动分配权限。像 Readarr 这样的 Windows 服务是在 "本地服务 "账户下运行的，它没有访问主目录的权限。

• 点击 "下一步"。安装将开始。 

• 设置向导完成后，您将看到以下屏幕。确保选择了 "启用从其他设备访问 "和 "开始读取 "选项。 
• 点击 "完成"。

• 接下来，网络用户界面将打开。如果由于某种原因关闭了用户界面，请在网页浏览器中输入： https://localhost:8787

5.使用和配置 Readarr。

在上一节中，我们介绍了下载和配置 Readarr 的几个步骤。在本节中，我们将介绍简单的配置步骤，以便您可以开始使用它。我们将介绍开始使用该软件所需的基础知识，而不涉及高级配置细节。

我们将配置部署在 Windows 上的 Readarr 服务器。 

• 开幕朗读。 如上一节所示，要打开软件，请使用网络浏览器在 URL 栏输入 "https://{your_ip_here}:8787 "地址。如果服务器在同一台本地计算机上，则输入 localhost:8787（或 127.0.0.1:8787）。如果服务器在网络上（远程或本地），请输入正确的 IP 地址。 
• 通过网络控制台导航Readarr 的图形用户界面使用控制台，主菜单位于右侧栏。在这一栏中，你可以访问各种项目，包括 "图书馆"、"日历"、"活动"、"通缉令"、"设置 "和 "系统"。顶部栏可供您访问搜索功能、捐赠（或贡献）以及重启或重新启动服务器的系统菜单。 
• 正如你在欢迎屏幕上看到的，Readarr 一开始会要求你添加一个根文件夹和一个新作者。 根文件夹可能包含一个现有的图书库。 

配置介质管理。 

• 让我们从 "设置 "子菜单开始配置 Readarr。 
• 我们将首先配置首选命名和文件管理设置。转到设置 > 媒体管理。

• 配置根文件夹。 点击 "根文件夹 "下方的 + 按钮。

• 让我们添加一个新的根文件夹。 Readarr 将使用此文件夹导入现有书库。下载客户端下载书籍后，它也会将任何书籍导入此文件夹。
• 为根文件夹命名，并选择路径。 请注意，该文件夹的路径必须与下载客户端（Usenet 或 Torrent）放置文件的目录不同。这是因为下载客户端会将文件放在下载文件夹中，而 Readarr 只会将其导入（硬链接或移动）到媒体文件夹--服务器使用的根文件夹。 

注意： 运行 Readarr 的用户和用户组应有对该文件夹的读写权限。 

• 在介质管理菜单中，您还可以配置图书命名。 您可以启用或禁用书籍重命名功能，也可以让软件删除或替换非法字符。 

在 Readarr 中配置下载和导入。

Readarr 能够与 Usenet 和 BitTorrent 下载客户端让这款软件物有所值。在整个配置过程中，将它与此类下载客户端整合是必不可少的一步。 

Readarr 必须能与支持的下载客户端通信，并能访问下载的文件。请记住，每个下载客户端的集成都是独一无二的。 

为我们的 Readarr 服务器添加一个新的下载客户端。 

1. 转到设置 > 下载客户端 > +

• 您会发现 Readarr 支持各种 Usenet 和 下载 客户 

• 我们将把下载客户端（qBittorrent v4.5.0 64 位）集成到 Readarr 中。幸运的是，Readarr 自带预定义选项，添加下载客户端更容易。从列表中找到支持的下载客户端，点击它，Readarr 就会提示你输入具体信息。 
• 例如，我们将配置 qBittorrent。添加下载客户端 - qBittorrent。输入客户端名称、IP 或主机、端口和证书。 
• 正确输入所有信息后，点击 "测试"。获得绿色复选框（如下图所示） 表示 qBittorrent 成功建立了通信。 
• 点击 "保存"，保留新下载的客户端。

注意： 如果您不知道下载客户端的凭据，则必须在下载客户端本身进行检查。如果是 qBittorrent（安装在同一本地服务器上），请转到设置 > Web UI > 身份验证 > 检查用户名和密码。请注意，某些下载客户端（如 qBittorrent）也允许你绕过在同一本地主机上运行的客户端（或 Readarr 等应用程序）的身份验证。 

• 返回 Readarr 并检查您的新下载客户端配置文件。确保已启用。 

配置您的资料库。

• 让我们添加一本新书。开始 到资料库 > 添加新内容。 
• 使用搜索栏查找您想要的书名，然后点击它。 

• 将其保存在正确的根文件夹中，其他文件夹保持默认。点击 "添加[图书作者姓名]"。 

• 转到图书馆。在这里，您将看到所有已添加和 "监控 "的图书。您可以按作者、书籍版本等进行排序。 

• 通缉名单 如果您已经添加了一些书籍和作者，Readarr 会根据您之前添加的内容 "推荐 "一些缺失的书籍。 
• 转到 "通缉">"失踪"。选中您想包括的任何书籍，然后点击每个复选框。 

配置 Readarr 的索引器。

• Readarr 支持索引器，可帮助您找到 "几乎 "任何可能要找的图书（Readarr 自己的索引器中没有）。 
• 要添加新的 Usenet 或 torrent 索引器，请转到设置 > 索引器 > +。

• 添加新的索引器。 如下图所示，Readarr 预装了一些索引器选项。它支持任何使用 Newznab 协议的索引器（无论是公共索引器还是私有索引器）。从列表中选择任何索引器，即可进行更直接的配置。 

注意： 您会发现 Readarr 中的大多数洪流索引器都是私人跟踪器，只有当您是会员时才会有所帮助。使用第三方程序，如 Prowlarr 或 Jackett 建议用作辅助搜索索引器。这些工具可无缝集成到 Readarr 中，使内容搜索变得更加容易。 配置 Prowlarr 或 Jackett 超出了本指南的范围。 

专业提示 要将 Readarr 提升到一个新的水平，我们建议将下载自动导入种子箱服务器。基于云的 VPS 种子箱例如，Rapidseedbox 提供 Readarr、NZBGet 和 uTorrent 等预装应用程序，并提供充足的存储空间来保存所有书籍。此外，您还可以通过任何设备随时随地访问您的图书图书馆。

6.故障排除 

以下是用户在安装、打开、使用或配置 Readarr 时遇到困难的几种常见情况。 

a. 在 Linux 服务器上打开 Readarr 的网络用户界面有问题？ 

• 确保使用正确的用户访问 Readarr。在 Linux 安装示例中，我们在 /var/lib/readarr 目录下创建了一个 "Readarr "用户。
• 如果从远程（非本地）机器访问 Readarr，请确保键入 Readarr 服务器的正确 IP 地址。在同样情况下，确保满足防火墙或代理条件。 

b. 出现 "访问路径 C:\ProgramData\Readarr\config.xml 被拒绝 "的访问错误。 

• 安装 Readarr 并尝试访问 Readarr 服务器网页用户界面后，您会收到此信息。 
• 要解决这个问题，请以管理员身份运行（拥有全部权限）。 

故障排除工具。

Readarr 自带的一些工具可以让你更轻松地排除故障。例如，"系统 > 日志 "中的 "日志记录 "就是一个非常有用的故障排除工具。它能让你看到各种日志信息，从信息和调试到详细跟踪。

另一个有价值的故障排除工具是状态更新。通过该页面可以检查当前服务器的警报和信息。例如，如下截图所示，Readarr 报告会显示一些警告信息和关键信息。 

What are the best Readarr alternatives?

The most common Readarr alternatives are LazyLibrarian, Chaptarr, and Calibre combined with automation tools. These options replace Readarr’s book-tracking and downloading features while offering more reliable metadata or active development.

最后的想法

总之，Readarr 是一款管理电子书库的强大工具。它能让你快速搜索、下载和整理电子书，并自动下载新发布的电子书。

安装过程简单明了，可在 Linux 和 Windows 操作系统上完成。安装完成后，Readarr 很容易使用，可以根据需要进行配置。不过，如果你遇到任何问题，本博文的故障排除部分应该能帮你解决。

总之，Readarr 是电子书爱好者整理和更新电子书库的必备工具。