mirror of
https://github.com/Colin-XKL/Colinx-Blog.git
synced 2026-01-11 02:01:29 +08:00
new post
This commit is contained in:
Colin
189
content/posts/RSSManX.md
Normal file
189
content/posts/RSSManX.md
Normal file
@@ -0,0 +1,189 @@
|
||||
---
|
||||
title: RSSManX - 一套RSS综合解决方案
|
||||
date: 2021-05-08
|
||||
lastmod: 2021-05-08
|
||||
description: 网站没有源，海外站的源看不了？这也许是第一个自带海外加速的RSS解决方案
|
||||
categories:
|
||||
- 教程
|
||||
- 指南
|
||||
tags:
|
||||
- RSS
|
||||
- Docker
|
||||
- Github
|
||||
- 代理
|
||||
---
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
[中文说明](https://github.com/Colin-XKL/RSSmanX/blob/master/README-zh_cn.md) ｜ [English](https://github.com/Colin-XKL/RSSmanX/)
|
||||
|
||||
**RSSman X is a project that composed several useful services to help you build an excellent RSS experience.**
|
||||
|
||||
[RSSman X](https://github.com/Colin-XKL/RSSmanX) 基于 docker-compsoe 提供容器化 TTRSS 与 RSSHUB 等组件的一键部署，整合实用组件为你带来最佳 RSS 体验
|
||||
|
||||
**Feature： 简单一键部署，常用组件支持，自动更新支持，服务健康自检支持，海外站点 RSS 解锁**
|
||||
|
||||
## 快速开始
|
||||
|
||||
(若已安装 `docker` 和 `docker-compose`)
|
||||
|
||||
```bash
|
||||
mkdir RSSmanX && cd $_ && wget https://cdn.jsdelivr.net/gh/Colin-XKL/RSSmanX/docker-compose.yml && sudo docker-compose up -d
|
||||
```
|
||||
|
||||
# 说明
|
||||
|
||||
本项目旨在为 RSS 的同好提供一个方便地搭建自己的 RSS 服务的捷径。毕竟不是所有 RSS 爱好者都懂代码 😂。如果你想快速地搭建自己的 RSS 服务，能够有 RSS 订阅管理、RSS 在线阅读界面，进阶功能包括服务健康自检、海外站点 RSS 解锁等。希望订阅国内外的各大网站的 RSS 信息源又不想跟着网上漫天飞的教程瞎折腾的话，那么你可以使用本仓库的脚本快速完成安装部署。
|
||||
|
||||
### 不同版本中包含的组件说明
|
||||
|
||||
三个版本的`docker-compose`文件对应不同的需求，包含的组件和服务有差异。
|
||||
|
||||
| 组件/服务/功能名称 | 标准版 | Lite 版 | Ultimate 版 ✨ |
|
||||
| ------------------ | ------ | ------- | -------------- |
|
||||
| TTRSS | ✅ | ✅ | ✅ |
|
||||
| RSSHub | ✅ | ✅ | ✅ |
|
||||
| Huginn | | | ✅ |
|
||||
| Mercury | ✅ | | ✅ |
|
||||
| OpenCC | | | ✅ |
|
||||
| Redis | ✅ | | ✅ |
|
||||
| Browserless | | | ✅ |
|
||||
| 数据持久化保存 | ✅ | ✅ | ✅ |
|
||||
| 容器自动更新 | ✅ | | ✅ |
|
||||
| 容器健康检查 | ✅ | | ✅ |
|
||||
| 海外站点加速 | | | ✅ |
|
||||
| 智能路由 | | | ✅ |
|
||||
| | | | |
|
||||
|
||||
不同组件的功能描述见文末。不同版本对应的配置文件如下：
|
||||
|
||||
**标准版：**`docker-compose.yml`
|
||||
|
||||
**Lite 版：**`docker-compose-lite.yml`
|
||||
|
||||
**Ultimate 版：**`docker-compose-ultimate.yml`和`config.yaml`
|
||||
|
||||
选择对应版本下载到本地后都 compose 文件需要重命名为标准的`docker-compose.yml`才可使用
|
||||
|
||||
# 安装说明
|
||||
|
||||
## 需求
|
||||
|
||||
- 一台 Linux 系统的服务器
|
||||
|
||||
> 本文以腾讯云 Ubuntu 18.04 系统的服务器为例，其他云服务商的没差，系统为 CentOS 的会有点差异
|
||||
|
||||
## 依赖项
|
||||
|
||||
- docker
|
||||
- docker-compose
|
||||
|
||||
**安装 Docker**
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
|
||||
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
|
||||
|
||||
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo
|
||||
sudo add-apt-repository \
|
||||
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
|
||||
$(lsb_release -cs) \
|
||||
stable"
|
||||
sudo apt-get update
|
||||
sudo apt-get install docker-ce docker-ce-cli containerd.io
|
||||
```
|
||||
|
||||
**安装 docker-compose**
|
||||
|
||||
```bash
|
||||
sudo apt install docker-compose
|
||||
```
|
||||
|
||||
完整文档参见 📕
|
||||
|
||||
- https://docs.docker.com/engine/install/
|
||||
- https://docs.docker.com/compose/install/
|
||||
|
||||
## 如何安装
|
||||
|
||||
安装好了 `docker` 和 `docker-compose` 后可以执行文章开头的快速开始的指令。或者可以按照下面的步骤手动操作：
|
||||
|
||||
1. 确定安装好了 `docker` 和 `docker-compose`
|
||||
2. 克隆本仓库/下载你所需要的版本的 compose 文件，注意修改文件名
|
||||
3. cd 进入文件夹，编辑`docker-compose`文件，修改密码及 ttrss 的`SELF_URL`处的值
|
||||
4. 运行 `sudo docker-compose up -d`
|
||||
5. 等待程序跑完
|
||||
6. 安装完成 ✅
|
||||
|
||||
#### 使用相关事宜：
|
||||
|
||||
1. 访问你设置的`SELF_URL`即可看到 Tiny Tiny RSS 的登陆页面，使用默认账户`admin`，密码`password`登陆即可开始使用。
|
||||
2. 如开启海外站点解锁支持，第一次冷启动需要等待 3-5 分钟才能完全启动所有组件。
|
||||
3. 数据保存位置 ~/.dockerData/Database/
|
||||
|
||||
详细配置和使用事宜请参考对应应用的文档说明。
|
||||
|
||||
- TTRSS 相关文档 [https://ttrss.henry.wang/](https://ttrss.henry.wang/)
|
||||
- RSSHub 相关文档 [https://docs.rsshub.app/](https://docs.rsshub.app/)
|
||||
|
||||
## 功能模块介绍
|
||||
|
||||
**Tiny Tiny RSS**
|
||||
RSS 订阅管理与在线阅读工具
|
||||
|
||||
**RSShub**
|
||||
生成国内大部分网站的 RSS 信息源，同时自部署可以访问到那些严格防爬的站点的源（知乎、微博等）
|
||||
|
||||
**Huginn**
|
||||
高级 IFTTT 工具，你可以用生成任何 RSS 源，但使用门槛略高
|
||||
|
||||
**Postgres**
|
||||
数据库，用于存储 RSS 文章数据等。比 MySQL 更轻，性能更好
|
||||
|
||||
**OpenCC**
|
||||
简繁体转换，如果你订阅了一些繁体的 RSS 源，可以用它来将文章转为简体
|
||||
|
||||
**Mercury**
|
||||
用于获取 RSS 全文
|
||||
|
||||
**Browserless**
|
||||
用于获取常规方式无法获取的网站 RSS，为 RSSHub 的可选组件
|
||||
|
||||
**Redis**
|
||||
提供缓存，提升性能，为 RSSHub 的可选组件
|
||||
|
||||
**WatchTower**
|
||||
用于自动更新 RSShub 等组件，可以更好地支持新添加的源以及更快的获得 bug 修复
|
||||
|
||||
**Clash**
|
||||
智能路由与正向代理工具，用于解锁海外站点及提供海外 RSS 源的加速
|
||||
|
||||
# Acknowledgement
|
||||
|
||||
- [Tiny tiny RSS](https://tt-rss.org/)
|
||||
- [OpenCC](https://github.com/BYVoid/OpenCC)
|
||||
- [Mercury](https://github.com/postlight/mercury-parser)
|
||||
- [Huginn](https://github.com/huginn/huginn)
|
||||
- [RSShub](https://github.com/DIYgod/RSSHub)
|
||||
- [Awesome TTRSS](https://github.com/HenryQW/Awesome-TTRSS)
|
||||
|
||||
# License
|
||||
|
||||
GPL-3.0
|
||||
|
||||
# Changelogs
|
||||
|
||||
- 2020-07-07 v1.0 First release
|
||||
- 2020-07-14 v1.1 Update quick start shell script
|
||||
- 2020-10-05 v1.2 Fix wrong environment variable.
|
||||
- 2020-11-08 v1.3 TTRSS now can update feeds with ports except 80/443, and our self-hosted rsshub works again.
|
||||
- 2020-11-13 v1.4 Several updates includes security and performance enhancements.
|
||||
- 2020-11-24 v1.5 Lock the docker image version of some services to avoid unexpected errors.
|
||||
- 2021-05-08 v2.0 Add container network isolation, health check, global proxy, smart routing etc.
|
||||
Reference in New Issue
Block a user