Sådan installeres Selfoss RSS Reader på en FreeBSD 11 FAMP VPS

Selfoss RSS Reader er en gratis og open source selv-hostet webbaseret multifunktionel, live stream, mashup, nyhedsfeed (RSS/Atom)-læser og universel aggregator. Selfoss RSS Reader har OPML-import, en afslappende JSON API og dens åbne plug-in-system giver dig mulighed for nemt at udvide standardfunktionaliteten ved at skrive dine egne brugerdefinerede dataforbindelser. Du kan bruge Selfoss til at livestreame og samle alle dine indlæg, tweets, podcasts og feeds på ét centralt sted, som du nemt kan få adgang til fra enhver desktop eller mobilenhed.

I denne vejledning skal vi installere Selfoss RSS Reader 2.17 på en FreeBSD 11 FAMP VPS ved hjælp af Apache-webserver, PHP 7.1 og en MariaDB-database.

Forudsætninger

• En ren Vultr FreeBSD 11-serverinstans med SSH-adgang

Trin 1: Tilføj en Sudo-bruger

Vi starter med at tilføje en ny sudobruger.

Først skal du logge ind på din server som root:

ssh root@YOUR_VULTR_IP_ADDRESS

Den sudoKommandoen er ikke installeret som standard i Vultr FreeBSD 11 serversubsystem, så vil vi først installere sudo:

pkg install sudo

Tilføj nu en ny bruger kaldet user1(eller dit foretrukne brugernavn):

adduser user1

Den adduserkommando vil bede dig for masser af oplysninger om brugerens konto, så skal du blot vælge standarderne for de fleste af dem, når det giver mening at gøre det. Når du bliver spurgt, om Invite user1 into any other groups?du skal , skal du indtaste for wheelat tilføje user1til wheelgruppen.

Tjek nu /etc/sudoersfilen for at sikre, at sudoersgruppen er aktiveret:

visudo

Se efter et afsnit som dette:

# %wheel        ALL=(ALL)       ALL

Denne linje fortæller os, at brugere, der er medlemmer af wheelgruppen, kan bruge sudokommandoen til at opnå rootprivilegier. Det vil blive kommenteret ud som standard, så du bliver nødt til at fjerne kommentaren og derefter gemme og afslutte filen.

Vi kan bekræfte user1gruppemedlemskabet med groupskommandoen:

groups user1

Hvis du user1ikke er medlem af wheelgruppen, kan du bruge denne kommando til at opdatere user1gruppemedlemskabet:

pw group mod wheel -m user1 

Brug nu sukommandoen til at skifte til den nye sudo-brugerkonto user1:

su - user1

Kommandoprompten opdateres for at angive, at du nu er logget ind på user1kontoen. Du kan bekræfte dette med whoamikommandoen:

whoami

Genstart nu sshdtjenesten, så du kan logge på sshmed den nye ikke-root sudo-brugerkonto, du lige har oprettet:

sudo /etc/rc.d/sshd restart

Afslut user1kontoen:

exit

Afslut rootkontoen (hvilket vil afbryde forbindelsen til din sshsession):

exit

Du kan nu gå sshind i serverforekomsten fra din lokale vært ved at bruge den nye ikke-root sudo-brugerkonto user1:

ssh user1@YOUR_VULTR_IP_ADDRESS

Hvis du vil udføre sudo uden at skulle indtaste en adgangskode hver gang, skal du åbne /etc/sudoersfilen igen ved at bruge visudo:

sudo visudo

Rediger sektionen for wheelgruppen, så den ser sådan ud:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Bemærk venligst: Deaktivering af adgangskodekravet for sudo-brugeren er ikke en anbefalet praksis, men det er inkluderet her, da det kan gøre serverkonfigurationen meget mere bekvem og mindre frustrerende, især under længere systemadministrationssessioner. Hvis du er bekymret over sikkerhedskonsekvenserne, kan du altid gendanne konfigurationsændringen til den oprindelige, når du er færdig med dine administrationsopgaver.

Når du vil logge ind på rootbrugerkontoen fra sudobrugerkontoen, kan du bruge en af ​​følgende kommandoer:

sudo -i
sudo su -

Du kan til enhver tid forlade rootkontoen og vende tilbage til din sudobrugerkonto:

exit

Trin 2: Opdater FreeBSD 11 System

Før vi installerer nogen pakker på FreeBSD-serverinstansen, vil vi først opdatere systemet.

Sørg for, at du er logget ind på serveren med en ikke-root sudo-bruger, og kør følgende kommandoer:

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

Trin 3: Installer Apache Web Server

Installer Apache-webserveren:

sudo pkg install apache24

Indtast, ynår du bliver bedt om det.

Brug nu sysrckommandoen til at aktivere Apache-tjenesten til at køre automatisk ved opstart:

sudo sysrc apache24_enable=yes

Den sysrckommando opdaterer /etc/rc.confkonfigurationsfil, så hvis du ønsker at kontrollere konfigurationen opdateringen manuelt kan du blot åbne /etc/rc.conffilen med din favorit terminal redaktør:

vi /etc/rc.conf

Start nu Apache-tjenesten:

sudo service apache24 start

Du kan hurtigt kontrollere, at apache kører, ved at besøge IP-adressen eller domænet for serverforekomsten i din browser:

http://YOUR_VULTR_IP_ADDRESS/

Du vil se standard FreeBSD Apache-siden, der viser teksten:

It works!

Tjek din Apache-standardkonfigurationsfil for at sikre, at DocumentRootdirektivet peger på den korrekte mappe:

sudo vi /usr/local/etc/apache24/httpd.conf

Den DocumentRootkonfiguration mulighed vil se sådan ud:

DocumentRoot "/usr/local/www/apache24/data"

Vi skal nu aktivere mod_rewriteApache-modulet. Vi kan gøre dette ved at søge i standard Apache-konfigurationsfilen for udtrykket mod_rewrite.

Som standard vil mod_rewriteApache-modulet blive kommenteret ud (hvilket betyder, at det er deaktiveret). Konfigurationslinjen på en ren Vultr FreeBSD 11-instans vil se sådan ud:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Du skal blot fjerne hash-symbolet for at fjerne kommentarer til linjen og indlæse modulet. Dette gælder selvfølgelig også for alle andre påkrævede Apache-moduler:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Vi er også nødt til at gøre det muligt for mod_authz_codeog mod_headersmoduler, så sørg for at de er begge uncommented også:

LoadModule authz_core_module libexec/apache24/mod_authz_core.so
LoadModule headers_module libexec/apache24/mod_headers.so

Vi skal nu redigere DirectoryApache-direktivet i den samme konfigurationsfil, så det mod_rewritevil fungere korrekt med Selfoss RSS Reader.

Find den del af konfigurationsfilen, der starter med, <Directory "/usr/local/www/apache24/data">og skift AllowOverride nonetil AllowOverride All. Slutresultatet (med alle kommentarer fjernet) vil se nogenlunde således ud:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Gem og afslut nu Apache-konfigurationsfilen.

Vi genstarter Apache i slutningen af ​​denne vejledning, men at genstarte Apache regelmæssigt under installation og konfiguration er bestemt en god vane, så lad os gøre det nu:

sudo service apache24 restart

Trin 4: Installer PHP 7.1

Vi kan nu installere PHP 7.1 sammen med alle de nødvendige PHP-moduler, der kræves af Selfoss RSS Reader:

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib php71-openssl php71-zip php71-phar

FreeBSD 11 gives us the option to use a development php.ini or a production php.ini. Since we are going to install Selfoss on a public web server, we'll use the production version. First, back up php.ini-production:

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup

Then soft-link php.ini-production to php.ini:

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

We need to configure Apache to actually use PHP, so let's create a new file called php.conf in the Apache Includes directory:

sudo vi /usr/local/etc/apache24/Includes/php.conf

Enter the following text into the newly created file:

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

Save and exit the file.

Now let's restart Apache so that it can reload the configuration changes:

sudo service apache24 restart

Step 5: Install MariaDB (MySQL) Server

FreeBSD 11 defaults to using MariaDB database server, which is an enhanced, fully open source, community developed, drop-in replacement for MySQL server.

Install the latest version of MariaDB database server:

sudo pkg install mariadb102-server mariadb102-client

Start and enable MariaDB server to execute automatically at boot time:

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

Secure your MariaDB server installation:

sudo mysql_secure_installation

When prompted to create a MariaDB/MySQL root user, select "Y" (for yes) and then enter a secure root password. Simply answer "Y" to all of the other yes/no questions as the default suggestions are the most secure options.

Step 6: Create Database for Selfoss RSS Reader

Log into the MariaDB shell as the MariaDB root user by running the following command:

sudo mysql -u root -p

To access the MariaDB command prompt, simply enter the MariaDB root password when prompted.

Run the following queries to create a MariaDB database and database user for Selfoss RSS Reader:

CREATE DATABASE selfoss_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'selfoss_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON selfoss_db.* TO 'selfoss_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

You can replace the database name selfoss_db and username selfoss_user with something more to your liking, if you prefer. Also, make sure that you replace "UltraSecurePassword" with an actually secure password.

Step 7: Install Selfoss RSS Reader Files

Change your current working directory to the default web directory:

cd /usr/local/www/apache24/data

Your current working directory will now be: /usr/local/www/apache24/data. You can check this with the pwd (print working directory) command:

pwd

Now use wget to download the Selfoss RSS Reader installation package:

sudo wget --content-disposition https://github.com/SSilence/selfoss/archive/2.17.zip

Please note: You should definitely check for the most recent version by visiting the Selfoss RSS Reader download page.

List the current directory to check that you have successfully downloaded the file:

ls -la

Remove index.html:

sudo rm index.html

Udkomprimer nu zip-arkivet:

sudo unzip selfoss-2.17.zip

Flyt alle installationsfilerne til web-rodmappen:

sudo mv -v selfoss-2.17/* selfoss-2.17/.* /usr/local/www/apache24/data 2>/dev/null

Skift ejerskab af webfilerne for at undgå problemer med tilladelser:

sudo chown -R www:www * ./

Genstart Apache igen:

sudo service apache24 restart

Trin 8: Installer og kør Composer

Selfoss RSS Reader kræver, at vi bruger composertil at downloade nogle plugins, så lad os installere composer. Desværre er versionen af ​​den forudbyggede binære version af composer i FreeBSD-pakkedepoterne ikke kompatibel med PHP 7.1. Så i stedet for at installere composermed pkgkommandoen, kompilerer vi den fra kilden.

Lad os først konfigurere FreeBSD 11-systemet til at kompilere PHP-software ved hjælp af PHP version 7.1 i stedet for standard 5.6.

Opret en ny fil i /etc/mappen kaldet make.conf:

sudo vi /etc/make.conf

Indtast følgende tekst i filen:

DEFAULT_VERSIONS+= php=7.1

Gem og luk nu filen.

Dernæst skal vi downloade FreeBSD-portsamlingen ved hjælp af portsnapkommandoen:

sudo portsnap fetch extract update

Når portsnapkommandoen er fuldført, skal du skifte til php-composerkildekodemappen:

cd /usr/ports/devel/php-composer/

Start nu php-composerkompileringen og installationen ved hjælp af makekommandoen:

sudo make install clean BATCH=yes

Når kompileringen er færdig, skal du skifte til webroot-mappen:

cd /usr/local/www/apache24/data

Kør komponist ved hjælp af wwwbrugeren:

sudo -u www composer install

Du vil se nogle advarselsmeddelelser fra composerom ikke at kunne skrive til cachen, men du skal ikke bekymre dig for meget om det, da alt stadig vil installere fint.

Vi er nu klar til at gå videre til det sidste trin.

Trin 9: Fuldfør installationen af ​​Selfoss RSS Reader

1. Vi skal først opdatere Selfoss RSS Reader-konfigurationsfilen config.inimed de korrekte databaseindstillinger, så sørg for, at du stadig er i webroot-mappen og kopier defaults.initil config.ini:

   sudo cp -iv defaults.ini config.ini
   

2. Åbn derefter config.inikonfigurationsfilen og tilføj følgende databaseværdier:

   [globals]
   db_type=mysql
   db_host=localhost
   db_database=selfoss_db
   db_username=selfoss_user
   db_password=UltraSecurePassword
   db_port=3306
   

3. Vi skal nu tilføje en adgangskodehash til config.ini, men først skal vi generere den, så besøg følgende URL i din browser:

   http://YOUR_VULTR_IP_ADDRESS/password
   

   Indtast derefter din ønskede adgangskode i Passwordfeltet og klik på Generate.

   Du skal blot kopiere den resulterende hashværdi til adgangskodeindstillingen i config.inifilen, så adgangskodesektionen nu ser sådan ud:

   username=admin
   password=b729a37c34ff9648c33d67de3b289b58b7486dd71236343a6c2c275c2cc0477bd1d254eb92248bfa753169547d4bd2e81c2c9e460ba5bba822af1e87722dd12a
   salt=<long string of random chracters>
   

   Bemærk: Din adgangskode-hash vil naturligvis være anderledes end den ovenfor viste hash, og du kan frit vælge et andet brugernavn.

4. Fjern alle de andre uredigerede indstillinger fra config.inifilen, så din komplette konfigurationsfil ligner denne:

   [globals]
   db_type=mysql
   db_host=localhost
   db_database=db1
   db_username=u1
   db_password=usecpass1
   db_port=3306
   username=admin
   password=b729a37c34ff9648c33d67de3b289b58b7486dd71236343a6c2c275c2cc0477bd1d254eb92248bfa753169547d4bd2e81c2c9e460ba5bba822af1e87722dd12a
   salt=<long string of random chracters>
   

   Bemærk: Hvis du vil ændre nogen af defaults.inimulighederne, kan du blot tilføje dem til listen over muligheder ovenfor.

   Når du er færdig med at redigere konfigurationsfilen, kan du gemme og afslutte filen.

5. Du kan nu logge ind på Selfoss RSS Reader ved at besøge hjemmesiden og indtaste dit brugernavn og adgangskode:

    http://YOUR_VULTR_IP_ADDRESS/
   

6. Hvis du vil have læseren til automatisk at opdatere dine feeds (og det gør du næsten helt sikkert), skal du redigere din crontab:

   sudo crontab -e
   

   Tilføj følgende linje for at opdatere dine feeds hver time:

   0 * * * * www cd /usr/local/www/apache24/data && php cliupdate.php
   

Hvis du endnu ikke har konfigureret dine Vultr DNS-indstillinger, kan du gøre det ved hjælp af Vultr DNS-kontrolpanelet.

Det er også tilrådeligt at konfigurere dit websted til at bruge SSL, da de fleste moderne browsere vil advare, når websteder ikke har SSL aktiveret, og SSL-certifikater er nu tilgængelige gratis.

Under alle omstændigheder er du nu fri til at begynde at tilføje dine feeds og yderligere tilpasse din læser, hvis du ønsker det.