So installieren Sie den Selfoss RSS Reader auf einem FreeBSD 11 FAMP VPS

• Voraussetzungen
• Schritt 1: Fügen Sie einen Sudo-Benutzer hinzu
• Schritt 2: Aktualisieren Sie das FreeBSD 11-System
• Schritt 3: Installieren Sie Apache Web Server
• Schritt 4: Installieren Sie PHP 7.1
• Schritt 5: Installieren Sie den MariaDB (MySQL) Server
• Schritt 6: Erstellen Sie eine Datenbank für Selfoss RSS Reader
• Schritt 7: Installieren Sie Selfoss RSS Reader-Dateien
• Schritt 8: Installieren Sie Composer und führen Sie es aus
• Schritt 9: Schließen Sie die Installation des Selfoss RSS Readers ab

Selfoss RSS Reader ist ein kostenloser und selbst gehosteter Open-Source-Web-basierter Mehrzweck-, Live-Stream-, Mashup-, RSS / Atom-Reader (Newsfeed) und universeller Aggregator. Selfoss RSS Reader bietet OPML-Import, eine erholsame JSON-API und das offene Plug-In-System, mit dem Sie die Standardfunktionalität einfach erweitern können, indem Sie Ihre eigenen benutzerdefinierten Datenconnectors schreiben. Mit Selfoss können Sie alle Ihre Beiträge, Tweets, Podcasts und Feeds live streamen und an einem zentralen Ort sammeln, auf den Sie von jedem Desktop oder Mobilgerät aus problemlos zugreifen können.

In diesem Tutorial installieren wir Selfoss RSS Reader 2.17 auf einem FreeBSD 11 FAMP VPS unter Verwendung des Apache-Webservers, PHP 7.1 und einer MariaDB-Datenbank.

Voraussetzungen

• Eine saubere Vultr FreeBSD 11-Serverinstanz mit SSH-Zugriff

Schritt 1: Fügen Sie einen Sudo-Benutzer hinzu

Wir werden zunächst einen neuen sudoBenutzer hinzufügen .

Melden Sie sich zunächst wie folgt bei Ihrem Server an root:

ssh root@YOUR_VULTR_IP_ADDRESS

Der sudoBefehl ist nicht standardmäßig in der Vultr FreeBSD 11-Serverinstanz installiert, daher werden wir zuerst Folgendes installieren sudo:

pkg install sudo

Fügen Sie nun einen neuen Benutzer mit dem Namen user1(oder Ihren bevorzugten Benutzernamen) hinzu:

adduser user1

Der adduserBefehl fordert Sie auf, viele Details für das Benutzerkonto einzugeben. Wählen Sie daher einfach die Standardeinstellungen für die meisten aus, wenn dies sinnvoll ist. Wenn Sie gefragt werden, ob dies der Invite user1 into any other groups?Fall ist, sollten Sie eingeben wheel, um user1der wheelGruppe etwas hinzuzufügen .

Überprüfen Sie nun die /etc/sudoersDatei, um sicherzustellen, dass die sudoersGruppe aktiviert ist:

visudo

Suchen Sie nach einem Abschnitt wie diesem:

# %wheel        ALL=(ALL)       ALL

Diese Zeile zeigt an, dass Benutzer, die Mitglieder der wheelGruppe sind, den sudoBefehl verwenden können, um rootBerechtigungen zu erhalten. Es wird standardmäßig auskommentiert, daher müssen Sie es auskommentieren und dann die Datei speichern und beenden.

Wir können die user1Gruppenmitgliedschaft mit dem folgenden groupsBefehl überprüfen :

groups user1

Wenn Sie user1kein Mitglied der wheelGruppe sind, können Sie mit diesem Befehl die user1Gruppenmitgliedschaft aktualisieren :

pw group mod wheel -m user1 

Verwenden Sie nun den suBefehl, um zum neuen sudo-Benutzerkonto zu wechseln user1:

su - user1

Die Eingabeaufforderung wird aktualisiert, um anzuzeigen, dass Sie jetzt im user1Konto angemeldet sind . Sie können dies mit dem folgenden whoamiBefehl überprüfen :

whoami

Starten Sie nun den sshdDienst neu, damit Sie sich sshmit dem neuen Sudo-Benutzerkonto anmelden können, das Sie gerade erstellt haben:

sudo /etc/rc.d/sshd restart

Beenden Sie das user1Konto:

exit

Beenden Sie das rootKonto (wodurch Ihre sshSitzung getrennt wird):

exit

Sie können jetzt sshvon Ihrem lokalen Host aus mit dem neuen Sudo-Benutzerkonto ohne Rootberechtigung in die Serverinstanz zugreifen user1:

ssh user1@YOUR_VULTR_IP_ADDRESS

Wenn Sie sudo ausführen möchten, ohne jedes Mal ein Kennwort eingeben zu müssen, öffnen Sie die /etc/sudoersDatei erneut mit visudo:

sudo visudo

Bearbeiten Sie den Abschnitt für die wheelGruppe so, dass er folgendermaßen aussieht:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Bitte beachten Sie: Das Deaktivieren der Kennwortanforderung für den sudo-Benutzer wird nicht empfohlen, ist jedoch hier enthalten, da dies die Serverkonfiguration wesentlich komfortabler und weniger frustrierend machen kann, insbesondere bei längeren Systemverwaltungssitzungen. Wenn Sie über die Auswirkungen auf die Sicherheit besorgt sind, können Sie die Konfigurationsänderung nach Abschluss Ihrer Verwaltungsaufgaben jederzeit auf das Original zurücksetzen.

Wenn Sie sich über das rootBenutzerkonto aus beim sudoBenutzerkonto anmelden möchten , können Sie einen der folgenden Befehle verwenden:

sudo -i
sudo su -

Sie können das rootKonto jederzeit verlassen und zu Ihrem sudoBenutzerkonto zurückkehren:

exit

Schritt 2: Aktualisieren Sie das FreeBSD 11-System

Bevor Sie Pakete auf der FreeBSD-Serverinstanz installieren, aktualisieren wir zunächst das System.

Stellen Sie sicher, dass Sie mit einem Nicht-Root-Sudo-Benutzer am Server angemeldet sind, und führen Sie die folgenden Befehle aus:

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

Schritt 3: Installieren Sie Apache Web Server

Installieren Sie den Apache-Webserver:

sudo pkg install apache24

Geben Sie ein, ywenn Sie dazu aufgefordert werden.

Verwenden Sie nun den sysrcBefehl, um zu aktivieren, dass der Apache-Dienst beim Booten automatisch ausgeführt wird:

sudo sysrc apache24_enable=yes

Der sysrcBefehl aktualisiert die /etc/rc.confKonfigurationsdatei. Wenn Sie das Konfigurationsupdate manuell überprüfen möchten, können Sie die /etc/rc.confDatei einfach mit Ihrem bevorzugten Terminaleditor öffnen :

vi /etc/rc.conf

Starten Sie nun den Apache-Dienst:

sudo service apache24 start

Sie können schnell überprüfen, ob Apache ausgeführt wird, indem Sie die IP-Adresse oder Domäne der Serverinstanz in Ihrem Browser aufrufen:

http://YOUR_VULTR_IP_ADDRESS/

Auf der Standard-FreeBSD-Apache-Seite wird der folgende Text angezeigt:

It works!

Überprüfen Sie Ihre Apache-Standardkonfigurationsdatei, um sicherzustellen, dass die DocumentRootAnweisung auf das richtige Verzeichnis verweist:

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

Die DocumentRootKonfigurationsoption sieht folgendermaßen aus:

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

Wir müssen jetzt das mod_rewriteApache-Modul aktivieren . Wir können dies tun, indem wir die Standard-Apache-Konfigurationsdatei nach dem Begriff durchsuchen mod_rewrite.

Standardmäßig wird das mod_rewriteApache-Modul auskommentiert (was bedeutet, dass es deaktiviert ist). Die Konfigurationszeile einer sauberen Vultr FreeBSD 11-Instanz sieht folgendermaßen aus:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Entfernen Sie einfach das Hash-Symbol, um die Zeile zu entfernen und das Modul zu laden. Dies gilt natürlich auch für alle anderen erforderlichen Apache-Module:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Wir müssen auch die Module mod_authz_codeund aktivieren mod_headers, stellen Sie also sicher, dass beide auch nicht kommentiert sind:

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

Wir müssen jetzt die DirectoryApache-Direktive in derselben Konfigurationsdatei mod_rewritebearbeiten, damit sie mit Selfoss RSS Reader ordnungsgemäß funktioniert.

Suchen Sie den Abschnitt der Konfigurationsdatei, der mit beginnt, <Directory "/usr/local/www/apache24/data">und wechseln Sie AllowOverride nonezu AllowOverride All. Das Endergebnis (mit allen entfernten Kommentaren) sieht ungefähr so ​​aus:

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

Speichern und beenden Sie nun die Apache-Konfigurationsdatei.

Wir werden Apache am Ende dieses Tutorials neu starten, aber ein regelmäßiger Neustart von Apache während der Installation und Konfiguration ist sicherlich eine gute Angewohnheit. Machen wir es jetzt:

sudo service apache24 restart

Schritt 4: Installieren Sie PHP 7.1

Wir können jetzt PHP 7.1 zusammen mit allen erforderlichen PHP-Modulen installieren, die für den Selfoss RSS Reader erforderlich sind:

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 bietet uns die Möglichkeit, eine Entwicklung php.inioder eine Produktion zu verwenden php.ini. Da wir Selfoss auf einem öffentlichen Webserver installieren, verwenden wir die Produktionsversion. Zuerst sichern php.ini-production:

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

Dann Softlink php.ini-productionzu php.ini:

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

Wir müssen Apache so konfigurieren, dass es tatsächlich PHP verwendet. Erstellen wir also eine neue Datei mit dem Namen php.confApache Includes:

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

Geben Sie den folgenden Text in die neu erstellte Datei ein:

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

Speichern und beenden Sie die Datei.

Starten wir nun Apache neu, damit die Konfigurationsänderungen neu geladen werden können:

sudo service apache24 restart

Schritt 5: Installieren Sie den MariaDB (MySQL) Server

FreeBSD 11 verwendet standardmäßig den MariaDB-Datenbankserver, einen erweiterten, vollständig von Open Community entwickelten Drop-In-Ersatz für den MySQL-Server.

Installieren Sie die neueste Version des MariaDB-Datenbankservers:

sudo pkg install mariadb102-server mariadb102-client

Starten Sie den MariaDB-Server und aktivieren Sie ihn, damit er beim Booten automatisch ausgeführt wird:

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

Sichern Sie Ihre MariaDB-Serverinstallation:

sudo mysql_secure_installation

Wenn Sie aufgefordert werden, einen MariaDB / MySQL- rootBenutzer zu erstellen , wählen Sie "Y" (für "Ja") und geben Sie ein sicheres rootKennwort ein. Beantworten Sie einfach alle anderen Ja / Nein-Fragen mit "Y", da die Standardvorschläge die sichersten Optionen sind.

Schritt 6: Erstellen Sie eine Datenbank für Selfoss RSS Reader

Melden Sie sich als MariaDB- rootBenutzer bei der MariaDB-Shell an, indem Sie den folgenden Befehl ausführen :

sudo mysql -u root -p

Um auf die MariaDB-Eingabeaufforderung zuzugreifen, geben Sie einfach das MariaDB- rootKennwort ein, wenn Sie dazu aufgefordert werden.

Führen Sie die folgenden Abfragen aus, um eine MariaDB-Datenbank und einen Datenbankbenutzer für Selfoss RSS Reader zu erstellen:

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;

Wenn Sie möchten, können Sie den Datenbanknamen selfoss_dbund den Benutzernamen selfoss_userdurch einen anderen Namen ersetzen . Stellen Sie außerdem sicher, dass Sie "UltraSecurePassword" durch ein tatsächlich sicheres Kennwort ersetzen.

Schritt 7: Installieren Sie Selfoss RSS Reader-Dateien

Ändern Sie Ihr aktuelles Arbeitsverzeichnis in das Standard-Webverzeichnis:

cd /usr/local/www/apache24/data

Ihr aktuelles Arbeitsverzeichnis lautet nun : /usr/local/www/apache24/data. Sie können dies mit dem pwdBefehl (Arbeitsverzeichnis drucken) überprüfen :

pwd

Verwenden Sie jetzt wget, um das Selfoss RSS Reader-Installationspaket herunterzuladen:

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

Bitte beachten Sie: Sie sollten auf jeden Fall auf der Selfoss RSS Reader-Downloadseite nach der neuesten Version suchen .

Listen Sie das aktuelle Verzeichnis auf, um zu überprüfen, ob Sie die Datei erfolgreich heruntergeladen haben:

ls -la

Entfernen index.html:

sudo rm index.html

Dekomprimieren Sie jetzt das Zip-Archiv:

sudo unzip selfoss-2.17.zip

Verschieben Sie alle Installationsdateien in das Webstammverzeichnis:

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

Ändern Sie den Besitz der Webdateien, um Berechtigungsprobleme zu vermeiden:

sudo chown -R www:www * ./

Starten Sie Apache erneut:

sudo service apache24 restart

Schritt 8: Installieren Sie Composer und führen Sie es aus

Für den Selfoss RSS Reader müssen wir composereinige Plugins herunterladen, also installieren wir sie composer. Leider ist die Version der vorgefertigten Binärversion von Composer in den FreeBSD-Paket-Repositorys nicht mit PHP 7.1 kompatibel. Anstatt composermit dem pkgBefehl zu installieren , kompilieren wir ihn stattdessen aus dem Quellcode.

Lassen Sie uns zunächst das FreeBSD 11-System so konfigurieren, dass PHP-Software mit PHP Version 7.1 anstelle von Standard 5.6 kompiliert wird.

Erstellen Sie eine neue Datei im /etc/Verzeichnis make.conf:

sudo vi /etc/make.conf

Geben Sie den folgenden Text in die Datei ein:

DEFAULT_VERSIONS+= php=7.1

Speichern und schließen Sie nun die Datei.

Als nächstes müssen wir die FreeBSD-Ports-Sammlung mit dem folgenden portsnapBefehl herunterladen :

sudo portsnap fetch extract update

portsnapWechseln Sie nach Abschluss des Befehls in das php-composerQuellcodeverzeichnis:

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

Starten Sie nun die php-composerKompilierung und Installation mit dem folgenden makeBefehl:

sudo make install clean BATCH=yes

Wenn die Kompilierung abgeschlossen ist, wechseln Sie in das Webroot-Verzeichnis:

cd /usr/local/www/apache24/data

Führen Sie Composer mit dem wwwBenutzer aus:

sudo -u www composer install

Sie werden einige Warnmeldungen sehen composer, dass Sie nicht in den Cache schreiben können, aber machen Sie sich darüber keine allzu großen Sorgen, da alles weiterhin einwandfrei installiert wird.

Wir sind jetzt bereit, mit dem letzten Schritt fortzufahren.

Schritt 9: Schließen Sie die Installation des Selfoss RSS Readers ab

1. Wir müssen zuerst die Selfoss RSS Reader-Konfigurationsdatei config.inimit den richtigen Datenbankeinstellungen aktualisieren. Stellen Sie daher sicher, dass Sie sich noch im Webroot-Verzeichnis befinden, und kopieren Sie defaults.ininach config.ini:

   sudo cp -iv defaults.ini config.ini
   

2. Öffnen Sie als Nächstes die config.iniKonfigurationsdatei und fügen Sie die folgenden Datenbankwerte hinzu:

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

3. Wir müssen jetzt einen Passwort-Hash hinzufügen config.ini, aber zuerst müssen wir ihn generieren. Besuchen Sie daher die folgende URL in Ihrem Browser:

   http://YOUR_VULTR_IP_ADDRESS/password
   

   Geben Sie dann Ihr gewünschtes Passwort in das PasswordFeld ein und klicken Sie auf Generate.

   Kopieren Sie einfach den resultierenden Hashwert in die Kennwortoption in der config.iniDatei, damit der Kennwortabschnitt nun ungefähr so ​​aussieht:

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

   Hinweis: Ihr Passwort-Hash unterscheidet sich offensichtlich von dem oben gezeigten Hash und Sie können einen anderen Benutzernamen wählen.

4. Entfernen Sie alle anderen unbearbeiteten Optionen aus der config.iniDatei, damit Ihre vollständige Konfigurationsdatei folgendermaßen aussieht:

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

   Hinweis: Wenn Sie eine der defaults.iniOptionen ändern möchten , können Sie sie einfach zur Liste der oben genannten Optionen hinzufügen.

   Wenn Sie die Konfigurationsdatei bearbeitet haben, können Sie die Datei speichern und beenden.

5. Sie können sich jetzt bei Selfoss RSS Reader anmelden, indem Sie die Startseite besuchen und Ihren Benutzernamen und Ihr Passwort eingeben:

    http://YOUR_VULTR_IP_ADDRESS/
   

6. Wenn Sie möchten, dass der Reader Ihre Feeds automatisch aktualisiert (und das tun Sie mit ziemlicher Sicherheit), müssen Sie Ihre Crontab bearbeiten:

   sudo crontab -e
   

   Fügen Sie die folgende Zeile hinzu, um Ihre Feeds stündlich zu aktualisieren:

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

Wenn Sie Ihre Vultr-DNS-Einstellungen noch nicht konfiguriert haben, können Sie dies über das Vultr-DNS-Kontrollfeld tun.

Es ist auch ratsam, Ihre Site für die Verwendung von SSL zu konfigurieren, da die meisten modernen Browser Warnungen ausgeben, wenn auf Websites SSL nicht aktiviert ist und SSL-Zertifikate jetzt kostenlos verfügbar sind.

In jedem Fall können Sie jetzt Ihre Feeds hinzufügen und Ihren Reader weiter anpassen, wenn Sie dies wünschen.