1
0
mirror of https://github.com/RSS-Bridge/rss-bridge.git synced 2025-08-17 22:02:09 +02:00

Deploying to gh-pages from @ RSS-Bridge/rss-bridge@9cabf60144 🚀

This commit is contained in:
dvikan
2024-08-30 02:38:07 +00:00
parent 36b3b30972
commit e6c8077888
45 changed files with 111 additions and 226 deletions

View File

@@ -100,7 +100,7 @@
<div class="Page__header">
<h1><a href="../For_Hosts/index.html">For Hosts</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../For_Hosts/Authentication.html">Authentication</a></h1>
<span class="ModifiedDate">
August 29, 2024 at 7:22 PM </span>
August 29, 2024 at 7:37 PM </span>
<span class="EditOn">
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/03_For_Hosts/06_Authentication.md" target="_blank">
Edit on GitHub </a>
@@ -108,91 +108,12 @@
</div>
<div class="s-content">
<p>Depending on your servers abilities you can choose between two types of authentication:</p>
<ul>
<li>
<a href="#htaccess">.htaccess</a>
</li>
<li>
<a href="#rss-bridge-authentication">RSS-Bridge Authentication</a>
</li>
<ul>
<li>http basic auth</li>
<li>token</li>
<li>Access control via webserver (see nginx/caddy/apache docs)</li>
</ul>
<p><strong>General advice</strong>:</p>
<ul>
<li>Make sure to use a strong password, no matter which solution you choose!</li>
<li>Enable HTTPS on your server to ensure your connection is encrypted and secure!</li>
</ul>
<h2><a id="htaccess" href="#htaccess" class="Permalink" aria-hidden="true" title="Permalink">#</a>.htaccess</h2>
<p>.htaccess files are commonly used to restrict access to files on a web server. One of the features of .htaccess files is the ability to password protect specific (or all) directories. If setup correctly, a password is required to access the files.</p>
<p>The usage of .htaccess files requires three basic steps:</p>
<ol>
<li>
<a href="#enable-htaccess">Enable .htaccess</a>
</li>
<li>
<a href="#create-a-htpasswd-file">Create a .htpasswd file</a>
</li>
<li>
<a href="#create-a-htaccess-file">Create a .htaccess file</a>
</li>
</ol>
<h3><a id="enable-htaccess" href="#enable-htaccess" class="Permalink" aria-hidden="true" title="Permalink">#</a>Enable .htaccess</h3>
<p>This process depends on the server you are using. Some providers may require you to change some settings, or place/change some file. Here are some helpful links for your server (please add your own if missing :sparkling_heart:)</p>
<ul>
<li>Apache: <a href="http://ask.xmodulo.com/enable-htaccess-apache.html" class="Link--external" rel="noopener noreferrer">http://ask.xmodulo.com/enable-htaccess-apache.html</a>
</li>
</ul>
<h3><a id="create-a-htpasswd-file" href="#create-a-htpasswd-file" class="Permalink" aria-hidden="true" title="Permalink">#</a>Create a .htpasswd file</h3>
<p>The <code>.htpasswd</code> file contains the user name and password used for login to your web server. Please notice that the password is stored in encrypted form, which requires you to encrypt your password before creating the <code>.htpasswd</code> file!</p>
<p>Here are three ways of creating your own <code>.htpasswd</code> file:</p>
<p><strong>1) Example file</strong></p>
<p>Example <code>.htpasswd</code> file (user name: “test”, password: “test”):</p>
<pre><code class="language-.htpasswd">test:$apr1$a52u9ILP$XTNG8qMJiEXSm1zD0lQcR0
</code></pre>
<p>Just copy and paste the contents to your <code>.htpasswd</code> file.</p>
<p><strong>2) Online generator (read warning!)</strong></p>
<p>You can create your own <code>.htpasswd</code> file online using a <code>.htpasswd</code> generator like this: <a href="https://www.htaccesstools.com/htpasswd-generator/" class="Link--external" rel="noopener noreferrer">https://www.htaccesstools.com/htpasswd-generator/</a></p>
<p><strong>WARNING!</strong></p>
<ul>
<li>Never insert real passwords to an online generator!</li>
</ul>
<p><strong>3) Generate your own password</strong></p>
<p>Another way to create your own <code>.htpasswd</code> file is to run this script on your server (itll output the data for you, you just have to paste it int a <code>.htpasswd</code> file):</p>
<pre><code class="language-PHP">&lt;?php
// Password to be encrypted for a .htpasswd file
$clearTextPassword = 'some password';
// Encrypt password
$password = crypt($clearTextPassword, base64_encode($clearTextPassword));
// Print encrypted password
echo $password;
?&gt;
</code></pre>
<blockquote>
<p>source: <a href="https://www.htaccesstools.com/articles/create-password-for-htpasswd-file-using-php/" class="Link--external" rel="noopener noreferrer">https://www.htaccesstools.com/articles/create-password-for-htpasswd-file-using-php/</a></p>
</blockquote>
<h3><a id="create-a-htaccess-file" href="#create-a-htaccess-file" class="Permalink" aria-hidden="true" title="Permalink">#</a>Create a .htaccess file</h3>
<p>The <code>.htaccess</code> file is used to specify which directories are password protected. For that purpose you should place the file in whatever directory you want to restrict access. If you want to restrict access to RSS-Bridge in general, you should place the file in the root directory (where <code>index.php</code> is located).</p>
<p>Two parameters must be specified in the <code>.htaccess</code> file:</p>
<ul>
<li>AuthName</li>
<li>AuthUserFile</li>
</ul>
<p><code>AuthName</code> specifies the name of the authentication (i.e. “RSS-Bridge”). <code>AuthUserFile</code> defines the <strong>absolute</strong> path to a <code>.htpasswd</code> file.</p>
<p>Here are two ways of creating your own <code>.htaccess</code> file:</p>
<p><strong>1) Example file</strong></p>
<pre><code class="language-.htaccess">AuthType Basic
AuthName &quot;My Protected Area&quot;
AuthUserFile /path/to/.htpasswd
Require valid-user
</code></pre>
<p>Notice: You must change the <code>AuthUserFile</code> location to fit your own server (i.e. <code>/var/www/html/rss-bridge/.htpasswd</code>)</p>
<p><strong>2) Online generator</strong></p>
<p>You can use an online generator to create the file for you and copy-paste it to your <code>.htaccess</code> file: <a href="https://www.htaccesstools.com/htaccess-authentication/" class="Link--external" rel="noopener noreferrer">https://www.htaccesstools.com/htaccess-authentication/</a></p>
<h2><a id="rss-bridge-authentication" href="#rss-bridge-authentication" class="Permalink" aria-hidden="true" title="Permalink">#</a>RSS-Bridge Authentication</h2>
<p>RSS-Bridge ships with an authentication module designed for single user environments. You can enable authentication and specify the username &amp; password in the <a href="Custom_Configuration.html#authentication">configuration file</a>.</p>
<p>Please notice that the password is stored in plain text and thus is readable to anyone who can access the file. Make sure to restrict access to the file, so that it cannot be read remotely!</p>
<p><a href="https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md" class="Link--external" rel="noopener noreferrer">https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md</a></p>
</div>
<nav>

View File

@@ -100,7 +100,7 @@
<div class="Page__header">
<h1><a href="../For_Hosts/index.html">For Hosts</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../For_Hosts/Custom_Configuration.html">Custom Configuration</a></h1>
<span class="ModifiedDate">
August 29, 2024 at 7:22 PM </span>
August 29, 2024 at 7:37 PM </span>
<span class="EditOn">
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/03_For_Hosts/08_Custom_Configuration.md" target="_blank">
Edit on GitHub </a>
@@ -109,15 +109,20 @@
<div class="s-content">
<p>RSS-Bridge supports custom configurations for common parameters on the server side!</p>
<p>A default configuration file (<code>config.default.ini.php</code>) is shipped with RSS-Bridge. Please do not edit this file, as it gets replaced when upgrading RSS-Bridge!</p>
<p>You should, however, use this file as template to create your own configuration (or leave it as is, to keep the default settings). In order to create your own configuration perform following actions:</p>
<p>A default configuration file (<code>config.default.ini.php</code>) is shipped with RSS-Bridge.
Please do not edit this file, as it gets replaced when upgrading RSS-Bridge!</p>
<p>You should, however, use this file as template to create your own configuration
(or leave it as is, to keep the default settings).
In order to create your own configuration perform following actions:</p>
<ul>
<li>Create the file <code>config.ini.php</code> in the RSS-Bridge root folder (next to <code>config.default.ini.php</code>)</li>
<li>Copy the contents from <code>config.default.ini.php</code> to your configuration file</li>
<li>Change the parameters to satisfy your requirements</li>
</ul>
<p>RSS-Bridge will automatically detect the <code>config.ini.php</code> and use it. If the file doesnt exist it will default to <code>config.default.ini.php</code> automatically.</p>
<p><strong>Notice</strong>: If a parameter is not specified in your <code>config.ini.php</code> RSS-Bridge will automatically use the default settings from <code>config.default.ini.php</code>.</p>
<p>RSS-Bridge will automatically detect the <code>config.ini.php</code> and use it.
If the file doesnt exist it will default to <code>config.default.ini.php</code> automatically.</p>
<p><strong>Notice</strong>: If a parameter is not specified in your <code>config.ini.php</code> RSS-Bridge will
automatically use the default settings from <code>config.default.ini.php</code>.</p>
<h1><a id="available-parameters" href="#available-parameters" class="Permalink" aria-hidden="true" title="Permalink">#</a>Available parameters</h1>
<p>The configuration file is split into sections:</p>
<ul>

View File

@@ -100,7 +100,7 @@
<div class="Page__header">
<h1><a href="../For_Hosts/index.html">For Hosts</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../For_Hosts/Customizations.html">Customizations</a></h1>
<span class="ModifiedDate">
August 29, 2024 at 7:22 PM </span>
August 29, 2024 at 7:37 PM </span>
<span class="EditOn">
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/03_For_Hosts/07_Customizations.md" target="_blank">
Edit on GitHub </a>
@@ -108,11 +108,17 @@
</div>
<div class="s-content">
<p>RSS-Bridge ships a few options the host may or may not activate. All options are listed in the <a href="https://github.com/RSS-Bridge/rss-bridge/blob/master/config.default.ini.php" class="Link--external" rel="noopener noreferrer">config.default.ini.php</a> file, see <a href="Custom_Configuration.html">Custom Configuration</a> section for more information.</p>
<p>RSS-Bridge ships a few options the host may or may not activate.
All options are listed in the <a href="https://github.com/RSS-Bridge/rss-bridge/blob/master/config.default.ini.php" class="Link--external" rel="noopener noreferrer">config.default.ini.php</a> file,
see <a href="Custom_Configuration.html">Custom Configuration</a> section for more information.</p>
<h2><a id="customizable-cache-timeout" href="#customizable-cache-timeout" class="Permalink" aria-hidden="true" title="Permalink">#</a>Customizable cache timeout</h2>
<p>Sometimes it is necessary to specify custom timeouts to update contents more frequently than the bridge maintainer intended. In these cases the client may specify a custom cache timeout to prevent loading contents from cache earlier (or later).</p>
<p>This option can be activated by setting the <a href="Custom_Configuration.html#custom_timeout"><code>cache.custom_timeout</code></a> option to <code>true</code>. When enabled each bridge receives an additional parameter <code>Cache timeout in seconds</code> that can be set to any value between 1 and 86400 (24 hours). If the value is not within the limits the default settings apply (as specified by the bridge maintainer).</p>
<p>The cache timeout is send to RSS-Bridge using the <code>_cache_timeout</code> parameter. RSS-Bridge will return an error message if the parameter is received and the option is disabled.</p>
<p>Sometimes it is necessary to specify custom timeouts to update contents more frequently
than the bridge maintainer intended.
In these cases the client may specify a custom cache timeout to prevent loading contents
from cache earlier (or later).</p>
<p>This option can be activated by setting the <a href="Custom_Configuration.html#custom_timeout"><code>cache.custom_timeout</code></a> option to <code>true</code>.
When enabled each bridge receives an additional parameter <code>Cache timeout in seconds</code>
that can be set to any value.</p>
</div>
<nav>

View File

@@ -100,7 +100,7 @@
<div class="Page__header">
<h1><a href="../For_Hosts/index.html">For Hosts</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../For_Hosts/Heroku_Installation.html">Heroku Installation</a></h1>
<span class="ModifiedDate">
August 29, 2024 at 7:22 PM </span>
August 29, 2024 at 7:37 PM </span>
<span class="EditOn">
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/03_For_Hosts/04_Heroku_Installation.md" target="_blank">
Edit on GitHub </a>

View File

@@ -100,7 +100,7 @@
<div class="Page__header">
<h1><a href="../For_Hosts/index.html">For Hosts</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../For_Hosts/Installation.html">Installation</a></h1>
<span class="ModifiedDate">
August 29, 2024 at 7:22 PM </span>
August 29, 2024 at 7:37 PM </span>
<span class="EditOn">
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/03_For_Hosts/01_Installation.md" target="_blank">
Edit on GitHub </a>
@@ -108,19 +108,7 @@
</div>
<div class="s-content">
<p>In order to install RSS-Bridge on your own web server* do as follows:</p>
<ul>
<li>Make sure your web server meets all <a href="../General/Requirements.html">requirements</a>
</li>
<li>Download the ZIP file of the <a href="https://github.com/RSS-Bridge/rss-bridge/releases" class="Link--external" rel="noopener noreferrer">last stable release</a>
</li>
<li>Place all files on your web server</li>
</ul>
<p>For linux hosts:</p>
<ul>
<li>Grant read-write-access for <code>www-data</code> to the <code>./cache</code> directory (<code>chown -R www-data ./cache</code>)</li>
</ul>
<p>You have successfully installed RSS-Bridge.</p>
<p><a href="https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md" class="Link--external" rel="noopener noreferrer">https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md</a></p>
</div>
<nav>

View File

@@ -100,7 +100,7 @@
<div class="Page__header">
<h1><a href="../For_Hosts/index.html">For Hosts</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../For_Hosts/Updating.html">Updating</a></h1>
<span class="ModifiedDate">
August 29, 2024 at 7:22 PM </span>
August 29, 2024 at 7:37 PM </span>
<span class="EditOn">
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/03_For_Hosts/02_Updating.md" target="_blank">
Edit on GitHub </a>
@@ -108,30 +108,7 @@
</div>
<div class="s-content">
<p>Updating an existing installation is very simple, depending on your type of installation.</p>
<h2><a id="release-build" href="#release-build" class="Permalink" aria-hidden="true" title="Permalink">#</a>Release Build</h2>
<ul>
<li>Download latest version</li>
<li>Extract all files</li>
<li>Replace existing files</li>
</ul>
<p>This will update all core files to the latest version. Your custom configuration and bridges are left untouched. Keep in mind that changes to any core file of RSS-Bridge will be replaced.</p>
<h2><a id="heroku" href="#heroku" class="Permalink" aria-hidden="true" title="Permalink">#</a>Heroku</h2>
<h3><a id="if-you-didn-t-fork-the-repo-before" href="#if-you-didn-t-fork-the-repo-before" class="Permalink" aria-hidden="true" title="Permalink">#</a>If you didnt fork the repo before</h3>
<p>Fork the repo by clicking the <code>Fork</code> button at the top right of this page (must be on desktop site). Then on your Heroku account, go to the application. Click on the <code>Deploy</code> tab and connect the repo named <code>yourusername/rss-bridge</code>. Do a manual deploy of the <code>master</code> branch.</p>
<h3><a id="if-you-forked-the-repo-before" href="#if-you-forked-the-repo-before" class="Permalink" aria-hidden="true" title="Permalink">#</a>If you forked the repo before</h3>
<p><a href="https://github.com/RSS-Bridge/rss-bridge/pull/new/master" class="Link--external" rel="noopener noreferrer">Click here to create a new pull request to your fork</a>. Select <code>compare across forks</code>, make the base repository <code>yourusername/rss-bridge</code> and ensure the branch is set to master. Put any title you want and create the pull request. On the page that comes after this, merge the pull request.</p>
<p>You then want to go to your application in Heroku, connect your fork via the <code>Deploy</code> tab and deploy the <code>master</code> branch.</p>
<p>You can turn on auto-deploy for the master branch if you dont want to go through the process of logging into Heroku and deploying the branch every time changes to the repo are made in the future.</p>
<h2><a id="git" href="#git" class="Permalink" aria-hidden="true" title="Permalink">#</a>Git</h2>
<p>To get the latest changes from the master branch</p>
<pre><code>git pull
</code></pre>
<p>To use a specific tag</p>
<pre><code>git fetch --all
git checkout tags/&lt;tag-name&gt;
</code></pre>
</div>
</div>
<nav>
<ul class="Pager">

View File

@@ -100,7 +100,7 @@
<div class="Page__header">
<h1><a href="../For_Hosts/index.html">For Hosts</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../For_Hosts/Whitelisting.html">Whitelisting</a></h1>
<span class="ModifiedDate">
August 29, 2024 at 7:22 PM </span>
August 29, 2024 at 7:37 PM </span>
<span class="EditOn">
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/03_For_Hosts/05_Whitelisting.md" target="_blank">
Edit on GitHub </a>

View File

@@ -100,7 +100,7 @@
<div class="Page__header">
<h1><a href="../For_Hosts/index.html">For Hosts</a></h1>
<span class="ModifiedDate">
August 29, 2024 at 7:22 PM </span>
August 29, 2024 at 7:37 PM </span>
<span class="EditOn">
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/03_For_Hosts/index.md" target="_blank">
Edit on GitHub </a>
@@ -109,8 +109,6 @@
<div class="s-content">
<p>This section is directed at <strong>hosts</strong> and <strong>server administrators</strong>.</p>
<p>To install RSS-Bridge, please follow the <a href="Installation.html">installation instructions</a>.
You must have access to a web server with a working PHP environment!</p>
<p>RSS-Bridge comes with a large amount of bridges.</p>
<p>Some bridges could be implemented more efficiently by actually using proprietary APIs,
but there are reasons against it:</p>
@@ -122,7 +120,10 @@ but there are reasons against it:</p>
<p>See <a href="https://github.com/RSS-Bridge/rss-bridge/blob/master/README.md#Rant" class="Link--external" rel="noopener noreferrer">the rant</a></p>
</li>
<li>
<p>APIs require private keys that could be stored on servers running RSS-Bridge,which is a security concern, involves complex authorizations for inexperienced users and could cause harm (when using paid services for example). In a closed environment (a server only you use for yourself) however you might be interested in using them anyway. So, check <a href="https://github.com/RSS-Bridge/rss-bridge/pull/478/files" class="Link--external" rel="noopener noreferrer">this</a> possible implementation of an anti-captcha solution.</p>
<p>APIs require private keys that could be stored on servers running RSS-Bridge,</p>
</li>
<li>
<p>which is a security concern, involves complex authorizations for inexperienced users and could cause harm (when using paid services for example). In a closed environment (a server only you use for yourself) however you might be interested in using them anyway. So, check <a href="https://github.com/RSS-Bridge/rss-bridge/pull/478/files" class="Link--external" rel="noopener noreferrer">this</a> possible implementation of an anti-captcha solution.</p>
</li>
</ul>
</div>