Hvordan installere Selfoss RSS Reader på en FreeBSD 11 FAMP VPS

Forutsetninger

Trinn 1: Legg til en Sudo-bruker

Trinn 2: Oppdater FreeBSD 11-systemet

Trinn 3: Installer Apache Web Server

Trinn 4: Installer PHP 7.1

Trinn 5: Installer MariaDB (MySQL) Server

Trinn 6: Opprett database for Selfoss RSS Reader

Trinn 7: Installer Selfoss RSS Reader-filer

Trinn 8: Installer og kjør Composer

Trinn 9: Fullfør installasjonen av Selfoss RSS Reader

Selfoss RSS Reader er en gratis og åpen kildekode selvhostet nettbasert flerbruks, live stream, mashup, nyhetsfeed (RSS/Atom) leser og universell aggregator. Selfoss RSS Reader har OPML-import, en avslappende JSON API, og dets åpne plug-in-system lar deg enkelt utvide standardfunksjonaliteten ved å skrive dine egne tilpassede datakoblinger. Du kan bruke Selfoss til å livestreame og samle alle dine innlegg, tweets, podcaster og feeder på ett sentralt sted som du enkelt kan få tilgang til fra hvilken som helst stasjonær eller mobil enhet.

I denne opplæringen skal vi installere Selfoss RSS Reader 2.17 på en FreeBSD 11 FAMP VPS ved hjelp av Apache-webserver, PHP 7.1 og en MariaDB-database.

Forutsetninger

• En ren Vultr FreeBSD 11-serverforekomst med SSH-tilgang

Trinn 1: Legg til en Sudo-bruker

Vi starter med å legge til en ny sudobruker.

Først logger du på serveren din som root:

ssh root@YOUR_VULTR_IP_ADDRESS

Den sudokommandoen er ikke installert som standard i Vultr FreeBSD 11 server eksempel, så vil vi først installere sudo:

pkg install sudo

Legg nå til en ny bruker kalt user1(eller ditt foretrukne brukernavn):

adduser user1

Den adduserkommandoen vil be deg om mange detaljer for brukerkontoen, så velger du standardverdiene for de fleste av dem når det er fornuftig å gjøre det. Når du blir spurt om du vil Invite user1 into any other groups?, bør du skrive inn for wheelå legge user1til i wheelgruppen.

Sjekk nå /etc/sudoersfilen for å forsikre deg om at sudoersgruppen er aktivert:

visudo

Se etter en del som dette:

# %wheel        ALL=(ALL)       ALL

Denne linjen forteller oss at brukere som er medlemmer av wheelgruppen kan bruke sudokommandoen for å få rootprivilegier. Den vil bli kommentert ut som standard, så du må oppheve kommentaren og deretter lagre og avslutte filen.

Vi kan bekrefte user1gruppemedlemskapet med groupskommandoen:

groups user1

Hvis du user1ikke er medlem av wheelgruppen, kan du bruke denne kommandoen til å oppdatere user1gruppemedlemskapet:

pw group mod wheel -m user1 

Bruk nå sukommandoen for å bytte til den nye sudo- user1brukerkontoen:

su - user1

Ledeteksten vil oppdateres for å indikere at du nå er logget på user1kontoen. Du kan bekrefte dette med whoamikommandoen:

whoami

Start nå sshdtjenesten på nytt slik at du kan logge på sshmed den nye ikke-root sudo-brukerkontoen du nettopp har opprettet:

sudo /etc/rc.d/sshd restart

Avslutt user1kontoen:

exit

Avslutt rootkontoen (som vil koble fra sshøkten):

exit

Du kan nå gå sshinn i serverforekomsten fra din lokale vert ved å bruke den nye ikke-root sudo- user1brukerkontoen:

ssh user1@YOUR_VULTR_IP_ADDRESS

Hvis du vil kjøre sudo uten å måtte skrive inn et passord hver gang, åpner du /etc/sudoersfilen igjen ved å bruke visudo:

sudo visudo

Rediger seksjonen for wheelgruppen slik at den ser slik ut:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Vennligst merk: Deaktivering av passordkravet for sudo-brukeren er ikke en anbefalt praksis, men det er inkludert her da det kan gjøre serverkonfigurasjonen mye mer praktisk og mindre frustrerende, spesielt under lengre systemadministrasjonsøkter. Hvis du er bekymret for sikkerhetsimplikasjonene, kan du alltid tilbakestille konfigurasjonsendringen til den opprinnelige etter at du er ferdig med administrasjonsoppgavene.

Når du vil logge på rootbrukerkontoen fra sudobrukerkontoen, kan du bruke en av følgende kommandoer:

sudo -i
sudo su -

Du kan avslutte rootkontoen og gå tilbake til sudobrukerkontoen din når som helst:

exit

Trinn 2: Oppdater FreeBSD 11-systemet

Før vi installerer noen pakker på FreeBSD-serverforekomsten, vil vi først oppdatere systemet.

Pass på at du er logget på serveren med en ikke-root sudo-bruker og kjør følgende kommandoer:

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

Trinn 3: Installer Apache Web Server

Installer Apache-nettserveren:

sudo pkg install apache24

Skriv inn ynår du blir bedt om det.

Bruk nå sysrckommandoen for å aktivere Apache-tjenesten til å kjøre automatisk ved oppstart:

sudo sysrc apache24_enable=yes

Den sysrckommandoen oppdaterer /etc/rc.confkonfigurasjonsfilen, så hvis du ønsker å kontrollere konfigurasjonen oppdateringen manuelt kan du bare åpne /etc/rc.conffilen med din favoritt terminal redaktør:

vi /etc/rc.conf

Start nå Apache-tjenesten:

sudo service apache24 start

Du kan raskt sjekke at apache kjører ved å besøke IP-adressen eller domenet til serverforekomsten i nettleseren din:

http://YOUR_VULTR_IP_ADDRESS/

Du vil se standard FreeBSD Apache-siden som viser teksten:

It works!

Sjekk Apache standard konfigurasjonsfil for å sikre at DocumentRootdirektivet peker til riktig katalog:

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

Den DocumentRootkonfigurasjon alternativet vil se slik ut:

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

Vi må nå aktivere mod_rewriteApache-modulen. Vi kan gjøre dette ved å søke i standard Apache-konfigurasjonsfilen for termen mod_rewrite.

Som standard vil mod_rewriteApache-modulen bli kommentert ut (som betyr at den er deaktivert). Konfigurasjonslinjen på en ren Vultr FreeBSD 11-forekomst vil se slik ut:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Bare fjern hash-symbolet for å fjerne kommentaren til linjen og last inn modulen. Dette gjelder selvfølgelig også for alle andre nødvendige Apache-moduler:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Vi trenger også å aktivere mod_authz_codeog mod_headersmoduler, så sørg for at de er både uncommented også:

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

Vi må nå redigere DirectoryApache-direktivet i samme konfigurasjonsfil slik at det mod_rewritevil fungere korrekt med Selfoss RSS Reader.

Finn delen av konfigurasjonsfilen som starter med <Directory "/usr/local/www/apache24/data">og endre AllowOverride nonetil AllowOverride All. Sluttresultatet (med alle kommentarer fjernet) vil se omtrent slik ut:

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

Lagre og avslutt Apache-konfigurasjonsfilen.

Vi vil starte Apache på nytt på slutten av denne opplæringen, men å starte Apache på nytt regelmessig under installasjon og konfigurasjon er absolutt en god vane, så la oss gjøre det nå:

sudo service apache24 restart

Trinn 4: Installer PHP 7.1

Vi kan nå installere PHP 7.1 sammen med alle nødvendige PHP-moduler som kreves 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 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

Dekomprimer nå zip-arkivet:

sudo unzip selfoss-2.17.zip

Flytt alle installasjonsfilene til webrotkatalogen:

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

Endre eierskap til nettfilene for å unngå problemer med tillatelser:

sudo chown -R www:www * ./

Start Apache på nytt:

sudo service apache24 restart

Trinn 8: Installer og kjør Composer

Selfoss RSS Reader krever at vi bruker for composerå laste ned noen plugins, så la oss installere composer. Dessverre er ikke versjonen av den forhåndsbygde binære versjonen av composer i FreeBSD-pakkelagerene kompatibel med PHP 7.1. Så i stedet for å installere composermed pkgkommandoen, vil vi i stedet kompilere den fra kilden.

Først, la oss konfigurere FreeBSD 11-systemet til å kompilere PHP-programvare ved å bruke PHP versjon 7.1 i stedet for standard 5.6.

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

sudo vi /etc/make.conf

Skriv inn følgende tekst i filen:

DEFAULT_VERSIONS+= php=7.1

Lagre og lukk filen nå.

Deretter må vi laste ned FreeBSD-portsamlingen ved å bruke portsnapkommandoen:

sudo portsnap fetch extract update

Når portsnapkommandoen er fullført, bytt til php-composerkildekodekatalogen:

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

Start nå php-composerkompileringen og installasjonen ved å bruke makekommandoen:

sudo make install clean BATCH=yes

Når kompileringen er fullført, bytt til webroot-katalogen:

cd /usr/local/www/apache24/data

Kjør komponist med wwwbrukeren:

sudo -u www composer install

Du vil se noen advarselsmeldinger fra composerom ikke å kunne skrive til hurtigbufferen, men ikke bekymre deg for mye om det, da alt fortsatt vil installeres helt fint.

Vi er nå klare til å gå videre til det siste trinnet.

Trinn 9: Fullfør installasjonen av Selfoss RSS Reader

1. Vi må først oppdatere Selfoss RSS Reader-konfigurasjonsfilen config.inimed de riktige databaseinnstillingene, så sørg for at du fortsatt er i webroot-katalogen og kopier defaults.initil config.ini:

   sudo cp -iv defaults.ini config.ini
   

2. Deretter åpner du config.inikonfigurasjonsfilen og legger til følgende databaseverdier:

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

3. Vi må nå legge til en hash for passord til config.ini, men først må vi generere den, så besøk følgende URL i nettleseren din:

   http://YOUR_VULTR_IP_ADDRESS/password
   

   Skriv deretter inn ønsket passord i Passwordfeltet og klikk på Generate.

   Bare kopier den resulterende hash-verdien til passordalternativet i config.inifilen slik at passorddelen nå ser omtrent slik ut:

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

   Merk: Din passordhash vil åpenbart være annerledes enn hashen vist ovenfor, og du står fritt til å velge et annet brukernavn.

4. Fjern alle de andre uredigerte alternativene fra config.inifilen slik at den komplette konfigurasjonsfilen ser ut som dette:

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

   Merk: Hvis du vil endre noen av defaults.inialternativene, kan du ganske enkelt legge dem til i listen over alternativer ovenfor.

   Når du er ferdig med å redigere konfigurasjonsfilen, kan du lagre og avslutte filen.

5. Du kan nå logge inn på Selfoss RSS Reader ved å gå inn på hjemmesiden og skrive inn brukernavn og passord:

    http://YOUR_VULTR_IP_ADDRESS/
   

6. Hvis du vil at leseren skal automatisk oppdatere feedene dine (og det gjør du nesten helt sikkert), må du redigere crontab:

   sudo crontab -e
   

   Legg til følgende linje for å oppdatere feedene dine hver time:

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

Hvis du ennå ikke har konfigurert Vultr DNS-innstillingene, kan du gjøre det ved å bruke Vultr DNS-kontrollpanelet.

Det er også tilrådelig å konfigurere nettstedet ditt til å bruke SSL, da de fleste moderne nettlesere vil advare når nettsteder ikke har SSL aktivert, og SSL-sertifikater er nå tilgjengelig gratis.

Uansett er du nå fri til å begynne å legge til feedene dine og tilpasse leseren din ytterligere, hvis du ønsker det.