Hur man installerar Selfoss RSS Reader på en FreeBSD 11 FAMP VPS

Selfoss RSS Reader är en gratis och öppen källkod, webbaserad multifunktionell, livestream, mashup, nyhetsflödesläsare (RSS/Atom) och universell aggregator. Selfoss RSS Reader har OPML-import, en vilsam JSON API och dess öppna plug-in-system gör att du enkelt kan utöka standardfunktionaliteten genom att skriva dina egna anpassade dataanslutningar. Du kan använda Selfoss för att livestreama och samla alla dina inlägg, tweets, poddsändningar och flöden på en central plats som du enkelt kan komma åt från vilken stationär eller mobil enhet som helst.

I den här handledningen kommer vi att installera Selfoss RSS Reader 2.17 på en FreeBSD 11 FAMP VPS med hjälp av Apache-webbserver, PHP 7.1 och en MariaDB-databas.

Förutsättningar

• En ren Vultr FreeBSD 11-serverinstans med SSH-åtkomst

Steg 1: Lägg till en Sudo-användare

Vi börjar med att lägga till en ny sudoanvändare.

Logga först in på din server som root:

ssh root@YOUR_VULTR_IP_ADDRESS

Det sudokommando inte installeras som standard i Vultr FreeBSD 11 Server-instans, så vi kommer först installera sudo:

pkg install sudo

Lägg nu till en ny användare som heter user1(eller ditt föredragna användarnamn):

adduser user1

Det adduserkommando kommer att be dig för massor av information för användarkontot, så enkelt välja standard för de flesta av dem när det är vettigt att göra det. När du tillfrågas om Invite user1 into any other groups?du vill ska du ange för wheelatt lägga user1till i wheelgruppen.

Kontrollera nu /etc/sudoersfilen för att se till att sudoersgruppen är aktiverad:

visudo

Leta efter ett avsnitt så här:

# %wheel        ALL=(ALL)       ALL

Den här raden talar om för oss att användare som är medlemmar i wheelgruppen kan använda sudokommandot för att få rootprivilegier. Den kommer att kommenteras bort som standard så du måste avkommentera den och sedan spara och avsluta filen.

Vi kan verifiera user1gruppmedlemskapet med groupskommandot:

groups user1

Om du user1inte är medlem i wheelgruppen kan du använda det här kommandot för att uppdatera user1gruppmedlemskapet:

pw group mod wheel -m user1 

Använd nu sukommandot för att byta till det nya sudo användarkontot user1:

su - user1

Kommandotolken uppdateras för att indikera att du nu är inloggad på user1kontot. Du kan verifiera detta med whoamikommandot:

whoami

Starta nu om sshdtjänsten så att du kan logga in via sshmed det nya icke-root sudo användarkontot som du just har skapat:

sudo /etc/rc.d/sshd restart

Avsluta user1kontot:

exit

Avsluta rootkontot (vilket kommer att koppla bort din sshsession):

exit

Du kan nu gå sshin i serverinstansen från din lokala värd med det nya sudo-användarkontot som inte är root user1:

ssh user1@YOUR_VULTR_IP_ADDRESS

Om du vill köra sudo utan att behöva skriva ett lösenord varje gång, öppna sedan /etc/sudoersfilen igen med visudo:

sudo visudo

Redigera avsnittet för wheelgruppen så att det ser ut så här:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Observera: Att inaktivera lösenordskravet för sudo-användaren är inte en rekommenderad praxis, men det ingår här eftersom det kan göra serverkonfigurationen mycket bekvämare och mindre frustrerande, särskilt under längre systemadministrationssessioner. Om du är orolig över säkerhetskonsekvenserna kan du alltid återställa konfigurationsändringen till originalet efter att du har avslutat dina administrationsuppgifter.

När du vill logga in på rootanvändarkontot från sudoanvändarkontot kan du använda något av följande kommandon:

sudo -i
sudo su -

Du kan avsluta rootkontot och återgå till ditt sudoanvändarkonto när som helst:

exit

Steg 2: Uppdatera FreeBSD 11 System

Innan vi installerar några paket på FreeBSD-serverinstansen kommer vi först att uppdatera systemet.

Se till att du är inloggad på servern med en icke-root sudo-användare och kör följande kommandon:

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

Steg 3: Installera Apache Web Server

Installera Apache-webbservern:

sudo pkg install apache24

Ange ynär du uppmanas.

Använd nu sysrckommandot för att aktivera Apache-tjänsten att köras automatiskt vid uppstart:

sudo sysrc apache24_enable=yes

Det sysrckommando uppdaterar /etc/rc.confkonfigurationsfilen, så om du vill verifiera konfigurationen uppdateringen manuellt kan du helt enkelt öppna /etc/rc.conffilen med din favorit terminal editor:

vi /etc/rc.conf

Starta nu Apache-tjänsten:

sudo service apache24 start

Du kan snabbt kontrollera att apache körs genom att besöka IP-adressen eller domänen för serverinstansen i din webbläsare:

http://YOUR_VULTR_IP_ADDRESS/

Du kommer att se standardsidan för FreeBSD Apache som visar texten:

It works!

Kontrollera din Apache-standardkonfigurationsfil för att säkerställa att DocumentRootdirektivet pekar till rätt katalog:

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

Det DocumentRootalternativet konfigurationen ser ut så här:

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

Vi måste nu aktivera mod_rewriteApache-modulen. Vi kan göra detta genom att söka i Apaches standardkonfigurationsfil för termen mod_rewrite.

Som standard kommer mod_rewriteApache-modulen att kommenteras bort (vilket betyder att den är inaktiverad). Konfigurationsraden på en ren Vultr FreeBSD 11-instans kommer att se ut så här:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Ta helt enkelt bort hash-symbolen för att avkommentera raden och ladda modulen. Detta gäller naturligtvis även alla andra nödvändiga Apache-moduler:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Vi måste också göra det möjligt för mod_authz_codeoch mod_headersmoduler, så se till att de båda okommenterad också:

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

Vi behöver nu redigera DirectoryApache-direktivet i samma konfigurationsfil så att det mod_rewritefungerar korrekt med Selfoss RSS Reader.

Hitta avsnittet i konfigurationsfilen som börjar med <Directory "/usr/local/www/apache24/data">och ändra AllowOverride nonetill AllowOverride All. Slutresultatet (med alla kommentarer borttagna) kommer att se ut ungefär så här:

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

Spara och avsluta nu Apache-konfigurationsfilen.

Vi kommer att starta om Apache i slutet av denna handledning, men att starta om Apache regelbundet under installation och konfiguration är verkligen en god vana, så låt oss göra det nu:

sudo service apache24 restart

Steg 4: Installera PHP 7.1

Vi kan nu installera PHP 7.1 tillsammans med alla nödvändiga PHP-moduler som krävs av 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 ger oss möjligheten att använda en utveckling php.inieller en produktion php.ini. Eftersom vi ska installera Selfoss på en offentlig webbserver kommer vi att använda produktionsversionen. Säkerhetskopiera först php.ini-production:

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

Länka sedan php.ini-productiontill php.ini:

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

Vi måste konfigurera Apache för att faktiskt använda PHP, så låt oss skapa en ny fil som heter php.confi Apache- Includeskatalogen:

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

Skriv in följande text i den nyskapade filen:

<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>

Spara och avsluta filen.

Låt oss nu starta om Apache så att den kan ladda om konfigurationsändringarna:

sudo service apache24 restart

Steg 5: Installera MariaDB (MySQL) Server

FreeBSD 11 använder som standard MariaDB-databasserver, som är en förbättrad, helt öppen källkod, communityutvecklad, drop-in-ersättning för MySQL-server.

Installera den senaste versionen av MariaDB databasserver:

sudo pkg install mariadb102-server mariadb102-client

Starta och aktivera MariaDB-servern att köra automatiskt vid uppstart:

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

Säkra din MariaDB-serverinstallation:

sudo mysql_secure_installation

När du uppmanas att skapa en MariaDB/MySQL- rootanvändare, välj "Y" (för ja) och ange sedan ett säkert rootlösenord. Svara helt enkelt "Y" på alla andra ja/nej-frågor eftersom standardförslagen är de säkraste alternativen.

Steg 6: Skapa databas för Selfoss RSS Reader

Logga in på MariaDB-skalet som MariaDB- rootanvändare genom att köra följande kommando:

sudo mysql -u root -p

För att komma åt MariaDB-kommandotolken, ange bara MariaDB- rootlösenordet när du uppmanas.

Kör följande frågor för att skapa en MariaDB-databas och databasanvändare för 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;

Du kan byta ut databasnamnet selfoss_dboch användarnamnet selfoss_usermed något mer som du vill, om du föredrar det. Se också till att du ersätter "UltraSecurePassword" med ett faktiskt säkert lösenord.

Steg 7: Installera Selfoss RSS Reader-filer

Ändra din nuvarande arbetskatalog till standardwebbkatalogen:

cd /usr/local/www/apache24/data

Din nuvarande arbetskatalog kommer nu att vara: /usr/local/www/apache24/data. Du kan kontrollera detta med pwdkommandot (skriv ut arbetskatalog):

pwd

Använd nu för wgetatt ladda ner installationspaketet för Selfoss RSS Reader:

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

Observera: Du bör definitivt söka efter den senaste versionen genom att besöka nedladdningssidan för Selfoss RSS Reader .

Lista den aktuella katalogen för att kontrollera att du har laddat ned filen:

ls -la

Ta bort index.html:

sudo rm index.html

Packa upp zip-arkivet:

sudo unzip selfoss-2.17.zip

Flytta alla installationsfiler till webbrotkatalogen:

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

Ändra äganderätten till webbfilerna för att undvika eventuella behörighetsproblem:

sudo chown -R www:www * ./

Starta om Apache igen:

sudo service apache24 restart

Steg 8: Installera och kör Composer

Selfoss RSS Reader kräver att vi använder för composeratt ladda ner några plugins så låt oss installera composer. Tyvärr är versionen av den förbyggda binära versionen av composer i FreeBSD-paketförråden inte kompatibel med PHP 7.1. Så istället för att installera composermed pkgkommandot kommer vi istället att kompilera det från källan.

Låt oss först konfigurera FreeBSD 11-systemet för att kompilera PHP-programvara med PHP version 7.1 istället för standard 5.6.

Skapa en ny fil i /etc/katalogen som heter make.conf:

sudo vi /etc/make.conf

Skriv in följande text i filen:

DEFAULT_VERSIONS+= php=7.1

Spara och stäng nu filen.

Därefter måste vi ladda ner FreeBSD-portsamlingen med portsnapkommandot:

sudo portsnap fetch extract update

När portsnapkommandot är klart, byt till php-composerkällkodskatalogen:

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

Starta nu php-composerkompileringen och installationen med makekommandot:

sudo make install clean BATCH=yes

När kompileringen är klar, byt till webroot-katalogen:

cd /usr/local/www/apache24/data

Kör kompositör med wwwanvändaren:

sudo -u www composer install

Du kommer att se några varningsmeddelanden från composerom att inte kunna skriva till cachen, men oroa dig inte för mycket om det eftersom allt fortfarande kommer att installeras bra.

Vi är nu redo att gå vidare till det sista steget.

Steg 9: Slutför installationen av Selfoss RSS Reader

1. Vi måste först uppdatera Selfoss RSS Reader-konfigurationsfilen config.inimed rätt databasinställningar så se till att du fortfarande är i webroot-katalogen och kopiera defaults.initill config.ini:

   sudo cp -iv defaults.ini config.ini
   

2. Öppna sedan config.inikonfigurationsfilen och lägg till följande databasvärden:

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

3. Vi behöver nu lägga till en hash för lösenord till config.ini, men först måste vi generera den, så besök följande URL i din webbläsare:

   http://YOUR_VULTR_IP_ADDRESS/password
   

   Ange sedan önskat lösenord i Passwordfältet och klicka på Generate.

   Kopiera helt enkelt det resulterande hashvärdet till lösenordsalternativet i config.inifilen så att lösenordsavsnittet nu ser ut ungefär så här:

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

   Obs: Din lösenords-hash kommer uppenbarligen att skilja sig från hashen som visas ovan och du är fri att välja ett annat användarnamn.

4. Ta bort alla andra oredigerade alternativ från config.inifilen så att din fullständiga konfigurationsfil ser ut så här:

   [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>
   

   Obs: Om du vill ändra något av defaults.inialternativen kan du helt enkelt lägga till dem i listan med alternativ ovan.

   När du är klar med att redigera konfigurationsfilen kan du spara och avsluta filen.

5. Du kan nu logga in på Selfoss RSS Reader genom att besöka hemsidan och ange ditt användarnamn och lösenord:

    http://YOUR_VULTR_IP_ADDRESS/
   

6. Om du vill att läsaren ska uppdatera dina flöden automatiskt (och det gör du nästan säkert), måste du redigera din crontab:

   sudo crontab -e
   

   Lägg till följande rad för att uppdatera dina flöden varje timme:

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

Om du ännu inte har konfigurerat dina Vultr DNS-inställningar kan du göra det med Vultr DNS-kontrollpanelen.

Det är också tillrådligt att konfigurera din webbplats för att använda SSL eftersom de flesta moderna webbläsare kommer att varna när webbplatser inte har SSL aktiverat och SSL-certifikat nu är tillgängliga gratis.

I vilket fall som helst är du nu fri att börja lägga till dina flöden och ytterligare anpassa din läsare, om du vill.