MonitoRSS完全指南:从安装到自定义订阅的终极教程

【免费下载链接】MonitoRSS MonitoRSS RSS bot (formerly known as Discord.RSS) with customizable feeds. https://monitorss.xyz 【免费下载链接】MonitoRSS 项目地址: https://gitcode.com/gh_mirrors/mo/MonitoRSS

MonitoRSS(前身为Discord.RSS)是一款功能强大的工具,能够将高度自定义的新闻订阅源直接发送到Discord服务器,让你轻松获取感兴趣的内容更新。本教程将从基础安装到高级自定义,带你全面掌握这款工具的使用方法。

快速入门:两种使用方式

使用公共实例

如果你不想自己搭建服务器,最简单的方式是直接使用官方提供的公共实例。只需访问MonitoRSS官方网站,即可免费开始使用,无需复杂的配置过程。

自行托管:完整安装步骤

自行托管需要使用Docker来协调和运行多个服务。以下是详细的安装步骤:

  1. 安装必要工具

  2. 获取项目代码

    git clone https://gitcode.com/gh_mirrors/mo/MonitoRSS
    
  3. 创建Discord应用 访问Discord开发者门户创建一个新的Discord应用,获取必要的令牌和ID。

  4. 配置环境变量

    • 复制.env.example文件并将其重命名为.env
    • 替换文件中的所有占位值:
      • 设置MongoDB连接URI(如果使用自己的MongoDB实例)
      • FEED_REQUESTS_FEED_REQUEST_DEFAULT_USER_AGENT末尾添加你的电子邮件
      • 替换所有"BOT_TOKEN_HERE"、"BOT_CLIENT_ID_HERE"和"BOT_CLIENT_SECRET_HERE"
      • 设置BACKEND_API_SESSION_SECRET为随机的64字符字符串
      • 设置BACKEND_API_SESSION_SALT为随机的16字符字符串
  5. 设置重定向URI 在Discord应用的OAuth2页面中,添加http://localhost:8000/api/v1/discord/callback-v2到重定向URI列表。

  6. 启动服务

    docker compose up -d
    

    如果遇到网络超时问题,可以使用并行标志:

    docker compose --parallel 1 up -d
    
  7. 访问控制面板 打开浏览器,访问http://localhost:8000即可进入MonitoRSS的控制面板。

高级配置:个性化你的MonitoRSS

自定义网站域名

  1. 将你的域名指向运行控制面板的服务器
  2. 更新.env文件中所有http://localhost:8000的引用为你的域名
  3. 在Discord应用的OAuth2页面中添加新的重定向URI:{你的域名}/api/v1/discord/callback-v2

启用电子邮件通知

要接收关于订阅源状态的电子邮件通知,需要配置SMTP设置:

  1. .env文件中设置以下变量:

    • BACKEND_API_SMTP_HOST
    • BACKEND_API_SMTP_USERNAME
    • BACKEND_API_SMTP_PASSWORD
    • BACKEND_API_SMTP_FROM
  2. 在控制面板的用户设置页面中启用电子邮件通知

启用Reddit授权

  1. Reddit应用设置创建一个"web app"类型的应用
  2. 添加重定向URI:{你的域名}/api/v1/reddit/callback
  3. .env文件中设置以下变量:
    • BACKEND_API_REDDIT_REDIRECT_URI
    • BACKEND_API_REDDIT_CLIENT_ID
    • BACKEND_API_REDDIT_CLIENT_SECRET
    • BACKEND_API_ENCRYPTION_KEY_HEX(随机64位十六进制字符串)

保持更新:升级MonitoRSS

MonitoRSS遵循语义化版本控制,定期发布更新。升级步骤如下:

  1. 备份MongoDB数据(建议定期备份)
  2. 停止容器:
    docker compose rm --stop -f
    
  3. .env文件中更新MONITORSS_VERSION(例如MONITORSS_VERSION=7
  4. 拉取最新镜像:
    docker compose pull
    
  5. 启动容器:
    docker compose up -d
    

注意:主版本更新可能包含重大变更,请在升级前查看发布页面的说明。

从v6迁移:平滑过渡到新版本

如果你正在使用MonitoRSS v6,按照以下步骤迁移到最新版本:

  1. 按照上述自行托管的说明设置新环境
  2. .env文件中设置BACKEND_API_MONGODB_URI指向你的MongoDB URI
  3. 启动新容器:
    docker compose --parallel 1 up -d --build
    
  4. 转换旧版订阅源:
    # 进入monolith容器
    docker compose exec monolith sh
    
    # 先进行干运行预览(替换YOUR_DISCORD_USER_ID)
    node dist/scripts/migrate-all-legacy-feeds.js --user YOUR_DISCORD_USER_ID --guild "*" --dry-run
    
    # 执行实际迁移
    node dist/scripts/migrate-all-legacy-feeds.js --user YOUR_DISCORD_USER_ID --guild "*"
    

迁移选项说明:

  • --user <id>: 必需,拥有所有转换后订阅源的Discord用户ID
  • --guild <ids>: 必需,逗号分隔的服务器ID,或*表示所有服务器
  • --dry-run: 可选,预览更改而不实际修改数据库

开始使用:创建你的第一个自定义订阅源

完成安装和配置后,你可以在控制面板中创建和自定义订阅源。MonitoRSS提供了丰富的选项来定制订阅内容、更新频率和通知方式,让你精确获取所需的信息。

无论是跟踪新闻网站、博客更新还是社交媒体动态,MonitoRSS都能帮助你将重要内容直接发送到Discord,让你和你的社区始终保持信息畅通。

通过本教程,你已经掌握了MonitoRSS的安装、配置和基本使用方法。开始探索更多高级功能,打造属于你的个性化信息聚合系统吧!

【免费下载链接】MonitoRSS MonitoRSS RSS bot (formerly known as Discord.RSS) with customizable feeds. https://monitorss.xyz 【免费下载链接】MonitoRSS 项目地址: https://gitcode.com/gh_mirrors/mo/MonitoRSS

Logo

ModelScope旨在打造下一代开源的模型即服务共享平台,为泛AI开发者提供灵活、易用、低成本的一站式模型服务产品,让模型应用更简单!

更多推荐