Forudsætninger
											
										
																			
											
												Trin 1: Tilføj en Sudo-bruger
											
										
																			
											
												Trin 2: Opdater FreeBSD 11 System
											
										
																			
											
												Trin 3: Installer Apache Web Server
											
										
																			
											
												Trin 4: Installer PHP 7.1
											
										
																			
											
												Trin 5: Installer MariaDB (MySQL) Server
											
										
																			
											
												Trin 6: Opret database til læseren selv
											
										
																			
											
												Trin 7: Installer Reader Self Files
											
										
																			
											
												Trin 8: Fuldfør selvinstallation af læseren
											
										
																	
												
						
												
Reader Self 3.5 er en enkel og fleksibel, gratis og open source, selvhostet RSS-læser og Google Reader-alternativ. Reader Self understøtter de vigtigste tastaturgenveje fra Google Reader, OPML-import, indbygget godkendelse, HTTPS-billedproxy (for at downloade HTTP-billeder), synkronisering af stjernemarkerede elementer med Pinboard, mulighed for at dele på tværs af store sociale netværk, Elastic Search-integration og er smukt responsiv på tværs af desktop, tablet og mobil.
I denne tutorial skal vi installere Reader Self 3.5 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 forlade rootkontoen og vende tilbage til din sudobrugerkonto når som helst ved blot at skrive følgende:
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 skal nu redigere DirectoryApache-direktivet i den samme konfigurationsfil, så det mod_rewritefungerer korrekt med Reader Self.
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 Reader Self:
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 giver os mulighed for at bruge en udvikling php.inieller en produktion php.ini. Da vi skal installere Reader Self på en offentlig webserver, bruger vi produktionsversionen. Sikkerhedskopier først php.ini-production:
sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup
Så soft-link php.ini-productiontil php.ini:
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Vi skal konfigurere Apache til rent faktisk at bruge PHP, så lad os oprette en ny fil kaldet php.confi Apache- Includesmappen:
sudo vi /usr/local/etc/apache24/Includes/php.conf
Indtast følgende tekst i den nyoprettede fil:
<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>
Gem og afslut filen.
Lad os nu genstarte Apache, så den kan genindlæse konfigurationsændringerne:
sudo service apache24 restart
Trin 5: Installer MariaDB (MySQL) Server
FreeBSD 11 bruger som standard MariaDB-databaseserver, som er en forbedret, fuldt open source, community-udviklet drop-in-erstatning for MySQL-server.
Installer den seneste version af MariaDB-databaseserveren:
sudo pkg install mariadb102-server mariadb102-client
Start og aktiver MariaDB-serveren til at køre automatisk ved opstart:
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Sikre din MariaDB-serverinstallation:
sudo mysql_secure_installation
Når du bliver bedt om at oprette en MariaDB/MySQL- rootbruger, skal du vælge "Y" (for ja) og derefter indtaste en sikker rootadgangskode. Du skal blot svare "Y" på alle de andre ja/nej-spørgsmål, da standardforslagene er de mest sikre muligheder.
Trin 6: Opret database til læseren selv
Log ind på MariaDB-skallen som MariaDB- rootbrugeren ved at køre følgende kommando:
sudo mysql -u root -p
For at få adgang til MariaDB-kommandoprompten skal du blot indtaste MariaDB- rootadgangskoden, når du bliver bedt om det.
Kør følgende forespørgsler for at oprette en MariaDB-database og databasebruger til Reader Self:
CREATE DATABASE self_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'self_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON self_db.* TO 'self_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Du kan erstatte databasenavnet self_dbog brugernavnet self_usermed noget mere efter din smag, hvis du foretrækker det. Sørg også for at erstatte "UltraSecurePassword" med en faktisk sikker adgangskode.
Trin 7: Installer Reader Self Files
Skift din nuværende arbejdsmappe til standardwebbiblioteket:
cd /usr/local/www/apache24/data
Din nuværende arbejdsmappe vil nu være:   /usr/local/www/apache24/data. Du kan kontrollere dette med pwdkommandoen (udskriv arbejdsmappe):
pwd
Brug nu wgettil at downloade Reader Self-installationspakken:
sudo wget --content-disposition https://github.com/readerself/readerself/archive/3.5.6.zip
Bemærk venligst:  Du bør helt sikkert tjekke efter den seneste version ved at besøge Reader Self download-siden .
List den aktuelle mappe for at kontrollere, at du har downloadet filen:
ls -la
Fjern index.html:
sudo rm index.html
Udkomprimer nu zip-arkivet:
sudo unzip readerself-3.5.6.zip
Flyt alle installationsfilerne til web-rodmappen:
sudo mv -v readerself-3.5.6/* readerself-3.5.6/.* /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
Nu er vi klar til at gå videre til det sidste trin. 
Trin 8: Fuldfør selvinstallation af læseren
Det er nu tid til at besøge IP-adressen på din serverforekomst i din browser, eller hvis du allerede har konfigureret dine Vultr DNS-indstillinger (og givet den tid nok til at sprede sig), kan du blot besøge dit domæne i stedet for.
For at få adgang til Reader Self-installationssiden skal du indtaste din Vultr-instans IP-adresse i din browsers adresselinje efterfulgt af /setup/:
http://YOUR_VULTR_IP_ADDRESS/setup/
- Du vil se en - Pre-Installation Checkøverst på siden, så sørg for, at alt ser okay ud, og fortsæt til næste trin.
 
- Indtast følgende databaseværdier i - Databaseafsnittet på installationssiden:
 - Database Type:              MySQL (improved version)
Hostname:                   localhost
Username:                   self_user
Password:                   UltraSecurePassword
Database Name:              self_db
 
- Indtast følgende - Userdetaljer:
 - Email:                  <your email address>
Password:               <a secure password>
 
- Når du har kontrolleret, at alle ovenstående detaljer er i orden, skal du blot klikke på fluebensikonet nederst til venstre på siden for at afslutte installationen. 
Du vil blive omdirigeret til en bekræftelse, der siger Installation successful.
For yderligere at konfigurere Reader Self, klik på menuen i øverste højre hjørne og vælg settings.
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 index.php refresh items
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 klar til at begynde at tilføje dine feeds og yderligere tilpasse udseendet og funktionaliteten af din læser.