So installierst du Wallabag unter Ubuntu 22.04
Wallabag ist ein Dienst, mit dem du später lesen kannst. Er ermöglicht es dir, Webseiten zu speichern, um sie später in deinem eigenen Tempo zu lesen. Es gibt viele Dienste wie Pocket, Instapaper usw., aber ein Dienst, der auf einem eigenen Server installiert ist, ist viel besser. Zum einen kann er nicht den Betrieb einstellen und die Links mit sich herunterziehen.
Diese Anleitung behandelt die Installation und Einrichtung von Wallabag auf einem Server mit Ubuntu 22.04. Außerdem wird erklärt, wie du Nginx, MySQL, Composer und PHP einrichtest, die alle für Wallabag benötigt werden, um zu funktionieren.
Voraussetzungen
- Ein Server mit Ubuntu 22.04.
- Ein Nicht-Root-Benutzer mit sudo-Rechten.
- Ein vollständig qualifizierter Domainname (FQDN) wie
wallabag.example.com
. - Stelle sicher, dass alles auf dem neuesten Stand ist.
$ sudo apt update $ sudo apt upgrade
- Einige wenige Pakete, die dein System benötigt.
$ sudo apt install wget curl nano software-properties-common dirmngr apt-transport-https gnupg2 ca-certificates lsb-release ubuntu-keyring unzip -y
Einige dieser Pakete sind vielleicht schon auf deinem System installiert.
Schritt 1 – Firewall konfigurieren
Der erste Schritt besteht darin, die Firewall zu konfigurieren. Ubuntu wird standardmäßig mit ufw (Uncomplicated Firewall) ausgeliefert.
Überprüfe, ob die Firewall läuft.
$ sudo ufw status
Du solltest die folgende Ausgabe erhalten.
Status: inactive
Erlaube den SSH-Port, damit die Firewall die aktuelle Verbindung nicht unterbricht, wenn du sie aktivierst.
$ sudo ufw allow OpenSSH
Lasse auch HTTP- und HTTPS-Ports zu.
$ sudo ufw allow http $ sudo ufw allow https
Aktiviere die Firewall
$ sudo ufw enable Command may disrupt existing ssh connections. Proceed with operation (y|n)? y Firewall is active and enabled on system startup
Überprüfe den Status der Firewall erneut.
$ sudo ufw status
Du solltest eine ähnliche Ausgabe sehen.
Status: active To Action From -- ------ ---- OpenSSH ALLOW Anywhere 80/tcp ALLOW Anywhere 443 ALLOW Anywhere OpenSSH (v6) ALLOW Anywhere (v6) 80/tcp (v6) ALLOW Anywhere (v6) 443 (v6) ALLOW Anywhere (v6)
Schritt 2 – Installiere PHP und seine Erweiterungen
Ubuntu 22.04 wird mit der Version PHP 8.1.2 ausgeliefert, die ein wenig veraltet ist. Wir werden die neueste PHP 8.1 Version installieren, indem wir Ondrejs PHP Repository benutzen.
$ sudo add-apt-repository ppa:ondrej/php
Als Nächstes installierst du PHP und die für Wallabag benötigten Erweiterungen.
$ sudo apt install php8.1-fpm php8.1-mysql php8.1-bcmath php8.1-xml php8.1-zip php8.1-curl php8.1-mbstring php8.1-gd php8.1-tidy php8.1-intl php8.1-cli
Überprüfe die Installation.
$ php --version PHP 8.1.16 (cli) (built: Feb 14 2023 18:35:37) (NTS) Copyright (c) The PHP Group Zend Engine v4.1.16, Copyright (c) Zend Technologies with Zend OPcache v8.1.16, Copyright (c), by Zend Technologies
Schritt 3 – Installiere Composer
Composer ist ein Tool zur Verwaltung von Abhängigkeiten für PHP und wird für die Installation von Wallabag benötigt.
Führe die folgenden Befehle aus, um die Composer-Binärdatei herunterzuladen. Wallabag funktioniert nur mit Composer 2.2 LTS, daher haben wir den Befehl entsprechend angepasst.
$ php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" $ php composer-setup.php --2.2 $ php -r "unlink('composer-setup.php');"
Installiere den Composer, indem du die Binärdatei in das Verzeichnis /usr/local/bin
verschiebst.
$ sudo mv composer.phar /usr/local/bin/composer
Überprüfe die Installation, indem du die Version überprüfst.
$ composer --version Composer version 2.2.21 2023-02-15 13:07:40
Schritt 4 – Installiere MySQL
Ubuntu 22.04 wird mit der neuesten Version von MySQL ausgeliefert. Du kannst sie mit einem einzigen Befehl installieren.
$ sudo apt install mysql-server
Überprüfe die Version von MySQL.
$ mysql --version mysql Ver 8.0.32-0ubuntu0.22.04.2 for Linux on x86_64 ((Ubuntu))
Dieser Schritt ist für die MySQL-Versionen 8.0.28 und höher notwendig. Rufe die MySQL-Shell auf.
$ sudo mysql
Führe den folgenden Befehl aus, um das Passwort für deinen Root-Benutzer festzulegen. Achte darauf, dass es eine Mischung aus Zahlen, Groß- und Kleinbuchstaben und Sonderzeichen enthält.
mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'YourPassword12!';
Beende die Shell.
mysql> exit
Führe das Skript für die sichere Installation von MySQL aus.
$ sudo mysql_secure_installation
Zuerst wirst du nach deinem Root-Passwort gefragt. Gib es ein. Als Nächstes wirst du aufgefordert, die Validate Password Component zu installieren. Sie prüft die Stärke der in MySQL verwendeten Passwörter. Drücke Y, um sie zu installieren. Als Nächstes wirst du aufgefordert, die Stufe der Passwortüberprüfung festzulegen. Wähle 2, da dies die stärkste Stufe ist.
Securing the MySQL server deployment. Enter password for user root: VALIDATE PASSWORD COMPONENT can be used to test passwords and improve security. It checks the strength of password and allows the users to set only those passwords which are secure enough. Would you like to setup VALIDATE PASSWORD component? Press y|Y for Yes, any other key for No: Y There are three levels of password validation policy: LOW Length >= 8 MEDIUM Length >= 8, numeric, mixed case, and special characters STRONG Length >= 8, numeric, mixed case, special characters and dictionary file Please enter 0 = LOW, 1 = MEDIUM and 2 = STRONG: 2 Using existing password for root. Estimated strength of the password: 100
Gib N ein, um die Änderung deines Root-Passworts abzulehnen. Gib außerdem Y ein, um anonyme Benutzer zu entfernen, Remote-Root-Logins zu verbieten, die Testdatenbank zu entfernen und die Berechtigungstabellen neu zu laden.
Change the password for root ? ((Press y|Y for Yes, any other key for No) : N ... skipping. By default, a MySQL installation has an anonymous user, allowing anyone to log into MySQL without having to have a user account created for them. This is intended only for testing, and to make the installation go a bit smoother. You should remove them before moving into a production environment. Remove anonymous users? (Press y|Y for Yes, any other key for No) : Y Success. Normally, root should only be allowed to connect from 'localhost'. This ensures that someone cannot guess at the root password from the network. Disallow root login remotely? (Press y|Y for Yes, any other key for No) : Y Success. By default, MySQL comes with a database named 'test' that anyone can access. This is also intended only for testing, and should be removed before moving into a production environment. Remove test database and access to it? (Press y|Y for Yes, any other key for No) : Y - Dropping test database... Success. - Removing privileges on test database... Success. Reloading the privilege tables will ensure that all changes made so far will take effect immediately. Reload privilege tables now? (Press y|Y for Yes, any other key for No) : Y Success. All done!
Schritt 5 – MySQL konfigurieren
Melde dich in der MySQL-Shell an. Gib dein Root-Passwort ein, wenn du dazu aufgefordert wirst.
$ sudo mysql -u root -p
Erstelle eine Beispieldatenbank.
mysql> CREATE DATABASE wallabag;
Erstelle ein SQL-Benutzerkonto.
mysql> CREATE USER 'wallabaguser'@'localhost' IDENTIFIED BY 'Your_password2';
Erteile dem Benutzer alle Rechte für die Datenbank.
mysql> GRANT ALL PRIVILEGES ON wallabag.* TO 'wallabaguser'@'localhost';
Lösche die Benutzerrechte.
mysql> FLUSH PRIVILEGES;
Beende die Shell.
mysql> exit
Schritt 6 – Nginx installieren
Ubuntu 22.04 wird mit einer älteren Version von Nginx ausgeliefert. Du musst das offizielle Nginx-Repository herunterladen, um die neueste Version zu installieren.
Importiere den Signierschlüssel von Nginx.
$ curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \ | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
Füge das Repository für die stabile Version von Nginx hinzu.
$ echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg arch=amd64] \ http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \ | sudo tee /etc/apt/sources.list.d/nginx.list
Aktualisiere die System-Repositories.
$ sudo apt update
Installiere Nginx.
$ sudo apt install nginx
Überprüfe die Installation.
$ nginx -v nginx version: nginx/1.22.1
Starte den Nginx-Server.
$ sudo systemctl start nginx
Schritt 7 – SSL installieren
Wir müssen Certbot installieren, um das SSL-Zertifikat zu erstellen. Du kannst Certbot entweder über das Repository von Ubuntu installieren oder die neueste Version mit dem Snapd-Tool herunterladen. Wir werden die Snapd-Version verwenden.
Bei Ubuntu 22.04 ist Snapd standardmäßig installiert. Führe die folgenden Befehle aus, um sicherzustellen, dass deine Version von Snapd auf dem neuesten Stand ist.
$ sudo snap install core && sudo snap refresh core
Installiere Certbot.
$ sudo snap install --classic certbot
Verwende den folgenden Befehl, um sicherzustellen, dass der Certbot-Befehl ausgeführt werden kann, indem du einen symbolischen Link zum Verzeichnis /usr/bin
erstellst.
$ sudo ln -s /snap/bin/certbot /usr/bin/certbot
Führe den folgenden Befehl aus, um ein SSL-Zertifikat zu erzeugen.
$ sudo certbot certonly --nginx --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m name@example.com -d wallabag.example.com
Mit dem obigen Befehl wird ein Zertifikat in das Verzeichnis /etc/letsencrypt/live/wallabag.example.com
auf deinem Server heruntergeladen.
Erstelle ein Diffie-Hellman-Gruppenzertifikat.
$ sudo openssl dhparam -dsaparam -out /etc/ssl/certs/dhparam.pem 4096
Überprüfe den Certbot Erneuerungszeitplanungsdienst.
$ sudo systemctl list-timers
Du findest snap.certbot.renew.service
als einen der Dienste, die für die Ausführung vorgesehen sind.
NEXT LEFT LAST PASSED UNIT ACTIVATES ..... Sun 2023-02-26 06:32:00 UTC 9h left Sat 2023-02-25 18:04:05 UTC 2h 59min ago snap.certbot.renew.timer snap.certbot.renew.service Sun 2023-02-26 06:43:20 UTC 9h left Sat 2023-02-25 10:49:23 UTC 10h ago apt-daily-upgrade.timer apt-daily-upgrade.service Sun 2023-02-26 09:00:06 UTC 11h left Sat 2023-02-25 20:58:06 UTC 5min ago apt-daily.timer apt-daily.service
Führe einen Probelauf des Prozesses durch, um zu prüfen, ob die SSL-Erneuerung einwandfrei funktioniert.
$ sudo certbot renew --dry-run
Wenn du keine Fehler siehst, bist du bereit. Dein Zertifikat wird automatisch erneuert.
Schritt 8 – Wallabag installieren
Erstelle das Verzeichnis /var/www/wallabag/html
.
$ sudo mkdir /var/www/html/wallabag -p
Lade die neueste Version von Wallabag herunter.
$ wget https://wllbg.org/latest-v2-package
Entpacke das Archiv.
$ tar xzf latest-v2-package
Verschiebe die Dateien aus dem extrahierten Verzeichnis in das zuvor erstellte Verzeichnis. Du kannst die neueste Version von Wallabag auf der GitHub-Releaseseite überprüfen. Die neueste Version zum Zeitpunkt der Erstellung dieses Tutorials ist 2.5.4.
$ sudo mv wallabag-2.5.4/* /var/www/html/wallabag
Erstelle das Asset-Verzeichnis.
$ sudo mkdir /var/www/html/wallabag/data/assets
Ändere die Berechtigungen des Verzeichnisses /var/www/html/wallabag
auf den aktuell angemeldeten Benutzer.
$ sudo chown -R $USER:$USER /var/www/html/wallabag
Wechsle in das Verzeichnis.
$ cd /var/www/html/wallabag
Erstelle die Datei parameters.yml
, indem du die Beispieldatei kopierst.
$ cp app/config/parameters.yml.dist app/config/parameters.yml
Bevor wir mit der Konfiguration von Wallabag beginnen, generiere einen geheimen Schlüssel. Notiere dir den Schlüssel für die spätere Verwendung.
$ openssl rand -base64 32 QLV/GpZwDobQbyQZQ15FkM1Hvt+ZFJZXw8GW9F4KR3o=
Öffne die Parameterdatei zum Bearbeiten.
$ nano app/config/parameters.yml
Suche den folgenden Abschnitt und trage die Zugangsdaten für die Datenbank ein. Der Datenbankport ist 3306 für MySQL.
.......... database_driver: pdo_mysql database_host: 127.0.0.1 database_port: 3306 database_name: wallabag database_user: wallabaguser database_password: Your_password2
Gib die Serverbeschreibung und den Domänennamen ein.
domain_name: https://wallabag.example.com server_name: "Howtoforge Wallabag"
Gib deine SMTP-Details ein. In unserem Fall verwenden wir den Amazon SES Service.
mailer_transport: smtp mailer_user: YOUR_AES_USERNAME mailer_password: YOUR_AES_PASSWORD mailer_host: email-smtp.us-west-2.amazonaws.com mailer_port: 587 mailer_encryption: tls
Gib den zuvor erstellten geheimen Schlüssel ein. Wenn du die Zwei-Faktor-Authentifizierung beibehalten willst, musst du die folgenden Einstellungen vornehmen. Wenn du die Benutzerregistrierung ausschalten willst, setze den Wert von fouser_registration
auf false
. Die Variable fouser_confirmation
ist auf true gesetzt, was bedeutet, dass jede Benutzerregistrierung per E-Mail bestätigt werden muss. Ändere den Wert der Variable from_email
auf die E-Mail-ID deiner Wahl.
# A secret key that's used to generate certain security-related tokens secret: QLV/GpZwDobQbyQZQ15FkM1Hvt+ZFJZXw8GW9F4KR3o= # two factor stuff twofactor_auth: true twofactor_sender: no-reply@wallabag.org # fosuser stuff fosuser_registration: true fosuser_confirmation: true ..... from_email: no-reply@wallabag.org .....
Es gibt noch weitere Sentrys, die mit Redis, RabbitMQ und den Sentry-Einstellungen zusammenhängen. Du kannst sie nach der Installation der genannten Pakete nach deinen Bedürfnissen konfigurieren.
Speichere die Datei, indem du Strg + X drückst und Y eingibst, wenn du dazu aufgefordert wirst.
Verwende Composer, um die von Wallabag benötigten Abhängigkeiten herunterzuladen und zu installieren.
$ SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
Schließe die Installation mit dem Wallabag-Kommandozeilentool ab.
$ php bin/console wallabag:install --env=prod
Du wirst gefragt, ob du die Datenbank und ihr Schema zurücksetzen möchtest. Gib beide Male no
als Antwort ein. Als Nächstes wirst du gefragt, ob du ein Administratorkonto erstellen möchtest. Gib yes
ein, um fortzufahren, und gib den Benutzernamen, das Passwort und die E-Mail-Adresse für das Konto ein.
wallabag installer ================== Step 1 of 4: Checking system requirements. ------------------------------------------ ------------------------ -------- ---------------- Checked Status Recommendation ------------------------ -------- ---------------- PDO Driver (pdo_mysql) OK! Database connection OK! Database version OK! curl_exec OK! curl_multi_init OK! ------------------------ -------- ---------------- [OK] Success! Your system can run wallabag properly. Step 2 of 4: Setting up database. --------------------------------- It appears that your database already exists. Would you like to reset it? (yes/no) [no]: > no Seems like your database contains schema. Do you want to reset it? (yes/no) [no]: > no Clearing the cache... Database successfully setup. Step 3 of 4: Administration setup. ---------------------------------- Would you like to create a new admin user (recommended)? (yes/no) [yes]: > yes Username [wallabag]: > navjot Password [wallabag]: > Email [wallabag@wallabag.io]: > navjot@example.com Administration successfully setup. Step 4 of 4: Config setup. -------------------------- Config successfully setup. [OK] wallabag has been successfully installed. [OK] You can now configure your web server, see https://doc.wallabag.org
Schalte die Verzeichnisberechtigung wieder auf Nginx um.
$ sudo chown -R nginx:nginx /var/www/html/wallabag
Schritt 9 – Nginx und PHP konfigurieren
PHP-FPM konfigurieren
Öffne die Datei /etc/php/8.1/fpm/pool.d/www.conf
.
$ sudo nano /etc/php/8.1/fpm/pool.d/www.conf
Wir müssen den Unix-Benutzer/die Unix-Gruppe der PHP-Prozesse auf nginx setzen. Finde die Zeilen user=www-data
und group=www-data
in der Datei und ändere sie in nginx
.
... ; Unix user/group of processes ; Note: The user is mandatory. If the group is not set, the default user's group ; will be used. ; RPM: apache user chosen to provide access to the same directories as httpd user = nginx ; RPM: Keep a group allowed to write in log dir. group = nginx ...
Finde die Zeilen listen.owner = www-data
und listen.group = www-data
in der Datei und ändere sie in nginx
.
; Set permissions for unix socket, if one is used. In Linux, read/write ; permissions must be set in order to allow connections from a web server. Many ; BSD-derived systems allow connections regardless of permissions. The owner ; and group can be specified either by name or by their numeric IDs. ; Default Values: user and group are set as the running user ; mode is set to 0660 listen.owner = nginx listen.group = nginx
Speichere die Datei, indem du Strg + X drückst und Y eingibst, wenn du dazu aufgefordert wirst.
Erhöhe die Ausführungszeit für PHP-FPM und PHP-CLI auf 60 Sekunden.
$ sudo sed -i 's/max_execution_time = 30/max_execution_time = 60/' /etc/php/8.1/fpm/php.ini $ sudo sed -i 's/max_execution_time = 30/max_execution_time = 60/' /etc/php/8.1/cli/php.ini
Erhöhe das Speicherlimit für PHP-FPM von 128 MB auf 256 MB.
$ sudo sed -i 's/memory_limit = 128M/memory_limit = 256M/' /etc/php/8.1/fpm/php.ini
Starte den PHP-FPM-Dienst neu.
$ sudo systemctl restart php8.1-fpm
Ändere die Gruppe des PHP-Sessions-Verzeichnisses auf Nginx.
$ sudo chgrp -R nginx /var/lib/php/sessions
Nginx konfigurieren
Erstelle und öffne die Datei /etc/nginx/conf.d/wallabag.conf
zum Bearbeiten.
$ sudo nano /etc/nginx/conf.d/wallabag.conf
Füge den folgenden Code in die Datei ein.
server { listen 443 ssl http2; listen [::]:443 ssl http2; server_name wallabag.example.com; access_log /var/log/nginx/wallabag.access.log; error_log /var/log/nginx/wallabag.error.log; # SSL ssl_certificate /etc/letsencrypt/live/wallabag.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/wallabag.example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/wallabag.example.com/chain.pem; ssl_session_timeout 5m; ssl_session_cache shared:MozSSL:10m; ssl_session_tickets off; ssl_protocols TLSv1.2 TLSv1.3; ssl_prefer_server_ciphers on; ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384; ssl_ecdh_curve X25519:prime256v1:secp384r1:secp521r1; ssl_stapling on; ssl_stapling_verify on; ssl_dhparam /etc/ssl/certs/dhparam.pem; resolver 8.8.8.8; root /var/www/html/wallabag/web; location / { try_files $uri /app.php$is_args$args; } # Pass PHP Scripts To FastCGI Server location ~ ^/app\.php(/|$) { fastcgi_split_path_info ^(.+\.php)(/.*)$; fastcgi_pass unix:/run/php/php8.1-fpm.sock; # Depends On The PHP Version fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; fastcgi_param DOCUMENT_ROOT $realpath_root; include fastcgi_params; internal; } location ~ \.php$ { return 404; } } # enforce HTTPS server { listen 80; listen [::]:80; server_name wallabag.example.com; return 301 https://$host$request_uri; }
Beachte, dass das Stammverzeichnis, das in der Nginx-Konfiguration verwendet werden soll, /var/www/html/wallabag/public/
ist.
Speichere die Datei, indem du Strg + X drückst und Y eingibst, wenn du danach gefragt wirst.
Öffne die Datei /etc/nginx/nginx.conf
zum Bearbeiten.
$ sudo nano /etc/nginx/nginx.conf
Füge die folgende Zeile vor der Zeile include /etc/nginx/conf.d/*.conf;
ein.
server_names_hash_bucket_size 64;
Speichere die Datei, indem du Strg + X drückst und Y eingibst, wenn du dazu aufgefordert wirst.
Überprüfe die Syntax der Nginx-Konfigurationsdatei.
$ sudo nginx -t nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
Starte den Nginx-Dienst neu.
$ sudo systemctl restart nginx
Schritt 10 – Zugriff auf Wallabag
Öffne die URL https://wallabag.example.com
in deinem Browser und du erhältst den folgenden Anmeldebildschirm.
Gib deine Anmeldedaten ein, die du während der Installation erstellt hast, und klicke auf die Schaltfläche LOG IN, um fortzufahren. Du wirst mit dem Wallabag Dashboard begrüßt.
Wallabag bietet dir eine Vielzahl von Apps für jeden Browser, Handy oder Ebook-Reader, mit denen du Links hinzufügen kannst. Und wenn dir nichts anderes einfällt, kannst du auch ein Bookmarklet verwenden. Die Details dazu findest du unter How to
, indem du auf das Benutzersymbol oben rechts im Dashboard klickst.
Dort erhältst du Links zu den Browser-Erweiterungen, den mobilen Apps und dem Wallabag-Bookmarklet.
Das war’s schon. Du kannst Wallabag jetzt nutzen, um Artikel zum späteren Lesen zu speichern.
Fazit
Damit ist unsere Anleitung zur Installation von Wallabag auf einem Ubuntu 22.04 Server abgeschlossen. Wenn du Fragen hast, schreibe sie unten in die Kommentare.