rss bridge下载 - rss bridge源代码下载

RSS桥

RSS-Bridge 是一个 PHP Web 应用程序。

它为没有网络提要的网站生成网络提要。

官方托管实例：https://rss-bridge.org/bridge01/

IRC 频道 #rssbridge https://libera.chat/

完整文档

或者找到另一个公共实例。

最低要求 PHP 7.4。

桥梁的子集 (16/447)

CssSelectorBridge ：使用 CSS 选择器抓取 feed
FeedMergeBridge ：将多个 feed 合并为一个
FeedReducerBridge ：将嘈杂的 feed 减少一定百分比
FilterBridge ：通过按关键字排除/包含项目来过滤 feed
GettrBridge ：从 GETTR 用户获取最新帖子
MastodonBridge ：从 Mastodon (ActivityPub) 实例获取状态
RedditBridge ：从用户/子编辑中获取帖子（带有过滤选项）
RumbleBridge ：获取频道/用户视频
SoundcloudBridge ：通过用户名获取音乐
TelegramBridge ：从公共频道获取帖子
ThePirateBayBridge:通过搜索/用户/类别获取种子
TikTokBridge ：通过用户名获取帖子
TwitchBridge ：从频道获取视频
VkBridge ：从用户/组获取帖子
XPathBridge ：使用 XPath 表达式抓取提要
YoutubeBridge ：按用户名/频道/播放列表/搜索获取视频
YouTubeCommunityTabBridge ：从频道的社区选项卡中获取帖子

教程

如何在传统共享虚拟主机上安装

RSS-Bridge 基本上可以解压缩到 Web 文件夹中。应该可以立即工作。

最新压缩包：https://github.com/RSS-Bridge/rss-bridge/archive/refs/heads/master.zip (2MB)

如何在 Debian 12 上安装（nginx + php-fpm）

这些说明已在 Digital Ocean 的全新 Debian 12 VM（1vcpu-512mb-10gb，5 美元/月）上进行了测试。

timedatectl set-timezone Europe/Oslo

apt install git nginx php8.2-fpm php-mbstring php-simplexml php-curl php-intl

# Create a user account
useradd --shell /bin/bash --create-home rss-bridge

cd /var/www

# Create folder and change ownership
mkdir rss-bridge && chown rss-bridge:rss-bridge rss-bridge/

# Become user
su rss-bridge

# Fetch latest master
git clone https://github.com/RSS-Bridge/rss-bridge.git rss-bridge/
cd rss-bridge

# Copy over the default config
cp -v config.default.ini.php config.ini.php

# Give full permissions only to owner (rss-bridge)
chmod 700 -R ./

# Give read and execute to others (nginx and php-fpm)
chmod o+rx ./ ./static

# Give read to others (nginx)
chmod o+r -R ./static

Nginx 配置：

 # /etc/nginx/sites-enabled/rss-bridge.conf

server {
    listen 80 ;

    # TODO: change to your own server name
    server_name example.com;

    access_log /var/log/nginx/rss-bridge.access.log;
    error_log /var/log/nginx/rss-bridge.error.log;
    log_not_found off ;

    # Intentionally not setting a root folder here

    # autoindex is off by default but feels good to explicitly turn off
    autoindex off ;

    # Static content only served here
    location /static/ {
        alias /var/www/rss-bridge/static/;
    }

    # Pass off to php-fpm when location is exactly /
    location = / {
        root /var/www/rss-bridge/;
        include snippets/fastcgi-php.conf;
        fastcgi_read_timeout 45s ;
        fastcgi_pass unix:/run/php/rss-bridge.sock;
    }

    # Reduce spam
    location = /favicon.ico {
        access_log off ;
    }

    # Reduce spam
    location = /robots.txt {
        access_log off ;
    }
}

PHP FPM 池配置：

 ; /etc/php/8.2/fpm/pool.d/rss-bridge.conf

[rss-bridge]

user = rss-bridge
group = rss-bridge

listen = /run/php/rss-bridge.sock

listen.owner = www-data
listen.group = www-data

# Create 10 workers standing by to serve requests
pm = static
pm.max_children = 10

# Respawn worker after 500 requests (workaround for memory leaks etc.) 
pm.max_requests = 500

PHP ini 配置：

 ; /etc/php/8.2/fpm/conf.d/30-rss-bridge.ini

max_execution_time = 15
memory_limit = 64M

重新启动 fpm 和 nginx：

 # Lint and restart php-fpm
php-fpm8.2 -t && systemctl restart php8.2-fpm

# Lint and restart nginx
nginx -t && systemctl restart nginx

如何从 Composer 安装

安装最新版本。

 cd /var/www
composer create-project -v --no-dev --no-scripts rss-bridge/rss-bridge

如何使用 Caddy 安装

待办事项。参见#3785

从 Docker Hub 安装：

通过从 Docker Hub 下载 docker 镜像进行安装：

 # Create container
docker create --name=rss-bridge --publish 3000:80 --volume $( pwd ) /config:/config rssbridge/rss-bridge

您可以将自定义config.ini.php和桥放入./config 。

您必须重新启动容器才能使自定义更改生效。

有关详细信息，请参阅docker-entrypoint.sh 。

 # Start container
docker start rss-bridge

浏览http://localhost:3000/

通过 Dockerfile 本地构建进行安装

 # Build image from Dockerfile
docker build -t rss-bridge .

# Create container
docker create --name rss-bridge --publish 3000:80 --volume $( pwd ) /config:/config rss-bridge

您可以将自定义config.ini.php和桥放入./config 。

您必须重新启动容器才能使自定义更改生效。

有关详细信息，请参阅docker-entrypoint.sh 。

 # Start container
docker start rss-bridge

浏览http://localhost:3000/

使用 docker-compose 安装（使用 Docker Hub）

您可以将自定义config.ini.php和桥放入./config 。

您必须重新启动容器才能使自定义更改生效。

有关详细信息，请参阅docker-entrypoint.sh 。

docker-compose up

浏览http://localhost:3000/

其他安装方式

Heroku 快速部署目前不起作用。如果您分叉此存储库并修改scalingo.json中的repository ，它可能会起作用。参见#2688

在安装中了解更多信息。

操作方法

如何解决“访问被拒绝”的问题。

输出来自 php-fpm。它无法读取index.php。

 chown rss-bridge:rss-bridge /var/www/rss-bridge/index.php

如何使用密码保护实例（令牌）

修改config.ini.php ：

 [authentication]

token = "hunter2"

如何删除所有缓存项

作为当前用户：

 bin/cache-clear

作为用户 rss-bridge：

 sudo -u rss-bridge bin/cache-clear

作为根用户：

 sudo bin/cache-clear

如何删除所有过期的缓存项

 bin/cache-prune

如何修复“PHP 致命错误：未捕获的异常：FileCache 路径不可写”

 # Give rss-bridge ownership
chown rss-bridge:rss-bridge -R /var/www/rss-bridge/cache

# Or, give www-data ownership
chown www-data:www-data -R /var/www/rss-bridge/cache

# Or, give everyone write permission
chmod 777 -R /var/www/rss-bridge/cache

# Or last ditch effort (CAREFUL)
rm -rf /var/www/rss-bridge/cache/ && mkdir /var/www/rss-bridge/cache/

如何修复“尝试写入只读数据库”

sqlite 文件（db、wal 和 shm）不可写。

 chown -v rss-bridge:rss-bridge cache/*

如何修复“无法准备语句：1，没有这样的表：存储”

 rm cache/*

如何从头开始创建一座新桥

在例如bridges/BearBlogBridge.php中创建新桥：

 <?php

class BearBlogBridge extends BridgeAbstract
{
    const NAME = ' BearBlog (bearblog.dev) ' ;

    public function collectData ()
    {
        $ dom = getSimpleHTMLDOM ( ' https://herman.bearblog.dev/blog/ ' );
        foreach ( $ dom -> find ( ' .blog-posts li ' ) as $ li ) {
            $ a = $ li -> find ( ' a ' , 0 );
            $ this -> items [] = [
                ' title ' => $ a -> plaintext ,
                ' uri ' => ' https://herman.bearblog.dev ' . $ a -> href ,
            ];
        }
    }
}

在桥接 API 中了解更多信息。

如何启用所有网桥

 enabled_bridges[] = *

如何启用一些网桥

 enabled_bridges[] = TwitchBridge
enabled_bridges[] = GettrBridge

如何启用调试模式

调试模式禁用大多数缓存操作。

 enable_debug_mode = true

如何切换到 memcached 作为缓存后端

 [cache]

; Cache backend: file (default), sqlite, memcached, null
type = "memcached"

如何切换到 sqlite3 作为缓存后端

 type = "sqlite"

如何禁用桥接错误（作为提要项目）

当桥发生故障时，RSS-Bridge 将生成一个提要，其中包含描述错误的单个项目。

这样，提要读者就会收到它并通知您。

如果您不希望出现此行为，请将错误输出切换为http ：

 [error]

; Defines how error messages are returned by RSS-Bridge
;
; "feed" = As part of the feed (default)
; "http" = As HTTP error message
; "none" = No errors are reported
output = "http"

如何在最终报告错误之前累积错误

修改report_limit ，使得错误必须出现3次才报告。

 ; Defines how often an error must occur before it is reported to the user
report_limit = 3

每天报告计数重置为 0。

如何使用密码保护实例（HTTP 基本身份验证）

 [authentication]

enable = true
username = "alice"
password = "cat"

通常需要使用凭据配置提要阅读器。

也可以手动将凭据包含在 URL 中：

https://alice:[email protected]/bridge01/?action=display&bridge=FabriceBellardBridge&format=Html

如何创建新的输出格式

有关示例，请参阅formats/PlaintextFormat.php 。

如何运行单元测试和 linter

这些命令要求您已在composer.json中安装了开发依赖项。

运行所有测试：

 ./vendor/bin/phpunit

运行单个测试类：

 ./vendor/bin/phpunit --filter UrlTest

运行短绒检查：

 ./vendor/bin/phpcs --standard=phpcs.xml --warning-severity=0 --extensions=php -p ./

https://github.com/squizlabs/PHP_CodeSniffer/wiki

如何生成最小的开发环境

 php -S 127.0.0.1:9001

http://127.0.0.1:9001/

解释

我们是 RSS-Bridge 社区，一群开发人员继续由 sebsauvage 发起的项目，sebsauvage.net 的网站管理员、Shaarli 和 ZeroBin 的作者。

请参阅 CONTRIBUTORS.md

RSS-Bridge 使用缓存来防止服务禁止您的服务器重复更新源。桥之间的具体缓存持续时间可能不同。缓存的文件将在 24 小时后自动删除。

RSS-Bridge 允许您完全控制向用户显示哪些桥。这样您就可以使用您最喜欢的桥集来托管您自己的 RSS-Bridge 服务！

当前维护者（截至 2024 年）：@dvikan 和 @Mynacol #2519

参考

饲料项目结构

这是桥梁预计会产生的饲料项目结构。

    $ item = [
        ' uri ' => ' https://example.com/blog/hello ' ,
        ' title ' => ' Hello world ' ,
        // Publication date in unix timestamp
        ' timestamp ' => 1668706254 ,
        ' author ' => ' Alice ' ,
        ' content ' => ' Here be item content ' ,
        ' enclosures ' => [
            ' https://example.com/foo.png ' ,
            ' https://example.com/bar.png '
        ],
        ' categories ' => [
            ' news ' ,
            ' tech ' ,
        ],
        // Globally unique id
        ' uid ' => ' e7147580c8747aad ' ,
    ]