arsfeld/yarr

yarr

镜像概述和主要用途

yarr（yet another rss reader）是一个基于Web的feed聚合器，支持两种使用模式：桌面应用和个人自托管服务器。后端采用Go语言开发，前端使用Vue.js构建，存储依赖SQLite数据库，提供轻量级的RSS订阅管理解决方案。

核心功能和特性

• 基于Web的用户界面，操作简洁直观
• 双模式支持：可作为本地桌面应用或远程自托管服务
• 轻量级架构：SQLite嵌入式数据库，无需额外数据库服务
• 跨平台兼容：提供Linux、macOS和Windows预构建版本
• 开源免费：无需依赖第三方服务，数据完全自主管理

使用场景和适用范围

• 个人RSS订阅管理，集中阅读各类资讯源
• 本地桌面RSS阅读，适合注重隐私的用户
• 自托管部署，实现多设备同步访问个人RSS收藏
• 适合对RSS聚合有需求的个人用户，无需复杂配置即可使用

使用方法和配置说明

预构建二进制文件

最新预构建二进制文件（支持Linux/MacOS/Windows）可从https://github.com/nkanaev/yarr/releases/latest%E8%8E%B7%E5%8F%96%E3%80%82

macOS

1. 下载 yarr-*-macos64.zip 压缩包
2. 解压后将 yarr.app 移动到 /Applications 文件夹

由于未签名，macOS可能阻止运行，可通过以下命令解决：

bash
xattr -d com.apple.quarantine /Applications/yarr.app

Windows

1. 下载 yarr-*-windows32.zip 压缩包
2. 解压后可放置在任意位置（如 C:\Program Files）
3. 根据需要手动创建快捷方式

Windows可能会显示安全警告，可忽略并继续执行。

Linux

Linux版本需手动配置桌面集成，建议创建桌面菜单条目：

bash
unzip -x yarr*.zip
sudo mv yarr /usr/local/bin/yarr
sudo nano /usr/local/share/applications/yarr.desktop

在文件中粘贴以下内容：

ini
[Desktop Entry]
Name=yarr
Exec=/usr/local/bin/yarr -open
Icon=rss
Type=Application
Categories=Internet;

自托管配置

作为服务器运行时，可通过命令行参数配置认证、TLS和服务器设置，具体选项可通过以下命令查看：

bash
yarr -h

构建方法

环境要求

• Go >= 1.16
• gcc
• Git

构建步骤

1. 获取源代码：

   bash
   git clone https://github.com/nkanaev/yarr.git
   cd yarr
   

2. 构建可执行文件：

   bash
   # 构建macOS版本
   make build_macos    # 输出至 _output/macos/yarr.app
   
   # 构建Linux版本
   make build_linux    # 输出至 _output/linux/yarr
   
   # 构建Windows版本
   make build_windows  # 输出至 _output/windows/yarr.exe
   

3. 启动本地开发服务器：

   bash
   make serve  # 服务将运行在 http://localhost:7070
   

4. 构建Docker镜像：

   bash
   docker build -t yarr .
   

第三方资源

图标使用 Feather 图标库。