Installation von Tiny Tiny RSS: Unterschied zwischen den Versionen

Aus
Zeile 58: Zeile 58:


=== Erstellen von config.php ===
=== Erstellen von config.php ===
Die Datei ''config.php-dist'' muss in ''config.php'' umbenannt werden. Bei den darin definierten PHP-Konstanten 'DB_TYPE', 'DB_USER', 'DB_NAME', 'DB_PASS' und 'SELF_URL_PATH' müssen mit einem [[Vergleich von Texteditoren|Texteditor]] die richtigen Werte eingetragen werden. Ist die [[#Datenbank erstellen|angelegte Datenbank]] ''db'' und der darauf zugreifende MySQL-Nutzer ''user'' mit dem Passwort ''pass'', muß in der Datei folgendes eingetragen sein:
Die Datei ''config.php-dist'' muss in ''config.php'' umbenannt werden. Bei den darin definierten PHP-Konstanten 'DB_TYPE', 'DB_USER', 'DB_NAME', 'DB_PASS', 'DB_PORT' und 'SELF_URL_PATH' müssen mit einem [[Vergleich von Texteditoren|Texteditor]] die richtigen Werte eingetragen werden. Ist die [[#Datenbank erstellen|angelegte Datenbank]] ''db'' und der darauf zugreifende MySQL-Nutzer ''user'' mit dem Passwort ''pass'', muß in der Datei folgendes eingetragen sein:
<pre>
<pre>
define('DB_TYPE', "mysql");
define('DB_TYPE', "mysql");

Version vom 1. Juni 2013, 23:56 Uhr

Tiny Tiny RSS ist ein server-basierter Feedreader, vergleichbar mit dem (bald eingestellten) Google Reader, aber die Daten bleiben daheim. Neben einer AJAX-Weboberfläche (hier in Aktion zu sehen), die auch auf mobile Geräte angepasst werden kann, gibt es auch ein API, mit dem Informationen über die abonnierten Feeds auch externen Anwendungen zur Verfügung stehen (wird vom Linux-Feedreader Liferea und dem Android Client genutzt).

Dieser Artikel beschreibt, wie es auf einer DiskStation installiert und (basis-)konfiguriert werden kann. Es muss ein root-Zugang zur Kommandozeile bestehen. Die Anleitung bezieht sich auf die Version 1.7.9 von Tiny Tiny RSS, und DSM Version 4.2 mit PHP 5.3.x.

Es könnte bald auch ein fertiges Paket zur Installation geben, vgl. hier.

Vorarbeiten auf der DS

Webserver und Datenbank aktivieren

Sowohl die Web Station als auch MySQL müssen aktiviert werden. Tiny Tiny RSS akzeptiert auch PostgreSQL als Datenbank, worauf hier aber nicht eingegangen wird.

PHP konfigurieren

open_basedir

Seit Version 1.7.9 wird nichtleeres open_basedir offiziell unterstützt. Eventuell kann es nötig sein, den "richtigen" Pfad /volume(x)/web in open_basedir aufzunehmen.

PHP ausführen

Fehler beim Erstellen des Vorschaubildes: Datei fehlt
Beispielhafte Konfiguration von PHP in der Weboberfläche ohne open_basedir

Soll der Update daemon ausgeführt werden, muß die PHP-Konfiguration geändert werden. Eine Lösung ist, die Option PHP safe_mode_exec_dir-Zugriffsbeschränkung ganz abzuwählen. Das ist auch kein großes Problem, da PHPs Safe Mode veraltet (und auch nicht wirklich sicherer) ist.

Sollte das trotzdem nicht möglich sein, kann auf der Kommandozeile mit root-Rechten im Verzeichnis /usr/syno/bin ein symbolischer Link auf das php-binary gesetzt werden:

$ ln -s /usr/bin/php /usr/syno/bin/php

Hintergrund ist, das /usr/syno/bin das voreingestellte safe_mode_exec_dir ist, vgl. auch die Ausgabe der PHP-Funktion phpinfo().

Bei einem Firmware Update des DSM wird der Link gelöscht und muß wieder erzeugt werden.


Tiny Tiny RSS konfigurieren

Herunterladen

Es werden zwei Wege vorgestellt, um Tiny Tiny RSS in das Verzeichnis /var/services/web/ttrss zu bekommen.

tarball

Das geht zum Beispiel mit

$ cd /tmp
$ wget https://github.com/gothfox/Tiny-Tiny-RSS/archive/1.7.9.tar.gz
$ tar -xf tt-rss-1.7.9.tar.gz -C /var/services/web
$ mv /var/services/web/tt-rss-1.7.9 /var/services/web/ttrss

für Version 1.7.9; die genaue URL der aktuellen Version findet sich auf der Projektseite.

git

Alternativ kann man sich das Repository mit git herunterladen; git steht als Paket zur Verfügung. Das Updaten der Installation ist so wesentlich bequemer. Befehl zum erstmaligen Herunterladen auf der DS

$ git clone https://github.com/gothfox/Tiny-Tiny-RSS.git /var/services/web/ttrss

Das Pflegen der Installation setzt allerdings Grundkenntnisse über den Umgang mit git voraus.

Datenbank erstellen

Es muß eine Datenbank angelegt und das sich im Unterverzeichnis schema/ttrss_schema_mysql.sql befindende Schema installiert werden. Wie das geht, beschreibt dieser Artikel.

Die weitere Konfiguration erfordert, daß ein MySQL-Nutzer und dessen Passwort in die Datei config.php gespeichert werden. Der Benutzer nobody auf der DiskStation muß diese Datei lesen können. Daher empfiehlt es sich, zum Zugriff auf die angelegte Datenbank nicht den root-Account von MySQL zu benutzen, sondern einen eigenen MySQL-Nutzer anzulegen, der die nötigsten Privilegien hat. Details dazu ebenfalls hier.

Schreibrechte

Der Nutzer nobody (auf der DiskStation/Linux, nicht in MySQL) braucht Schreibrechte auf die Verzeichnisse lock/, cache/ und feed-icons/. Dazu einfach auf der Shell

for dir in "lock" "cache" "feed-icons"; do
	chown -R nobody:nobody "$dir";
done

ausführen.

Erstellen von config.php

Die Datei config.php-dist muss in config.php umbenannt werden. Bei den darin definierten PHP-Konstanten 'DB_TYPE', 'DB_USER', 'DB_NAME', 'DB_PASS', 'DB_PORT' und 'SELF_URL_PATH' müssen mit einem Texteditor die richtigen Werte eingetragen werden. Ist die angelegte Datenbank db und der darauf zugreifende MySQL-Nutzer user mit dem Passwort pass, muß in der Datei folgendes eingetragen sein:

	define('DB_TYPE', "mysql");
	define('DB_HOST', "localhost");
	define('DB_USER', "user");
	define('DB_NAME', "db");
	define('DB_PASS', "pass");
	define('DB_PORT', '3306');

('DB_HOST' bleibt unverändert). Bei 'SELF_URL_PATH' muß die URL eingetragen werden, unter der Tiny Tiny RSS aufgerufen wird. Das sind z.B. http://192.168.178.56/ttrss (hier hat die DiskStation die Adresse 192.168.178.56) oder http://subdomain.dnsdyn.co.uk/ttrss. Für Erreichbarkeit von außerhalb des eigenen Netzwerks siehe hier.

Updating Feeds

Tiny Tiny RSS sollte jetzt per Browser erreichbar sein. Damit es installierte Feeds abfragen kann, muß entweder ein mitgelieferter Update daemon gestartet oder ein cronjob eingetragen werden. Empfohlen (und auch machbar) ist die Methode mit dem daemon.

daemon

Wichtig: Damit es funktioniert, muss PHP konfiguriert sein, denn der daemon muss php ausführen. Der daemon wird so gestartet:

$ su -m nobody -c "(trap '' SIGHUP && /usr/bin/php /var/services/web/ttrss/update.php --daemon > /dev/null 2>&1) &"

Da dieser Befehl nach jedem Neustart der DS ausgeführt werden muss, bietet sich ein Start-Stop-Skript an. Hierbei gibt es die kleine Schwierigkeit, daß der Nutzer nobody in solchen Skripten beim Booten keine Befehle ausführen kann, weshalb ein kleiner Umweg nötig ist (wer mehr weiß, sagt Bescheid). Das Skript sollte in /usr/local/etc/rc.d/ gespeichert und mit chmod 755 ausführbar gemacht werden.

cron

Im cronjob muss der Befehl

su -m nobody -c "cd /var/services/web/ttrss && /usr/bin/php /var/services/web/ttrss/update.php --feeds >/dev/null 2>&1"

ausgeführt werden. Für eine Periode von 20 Minuten wäre das Cron-Präfix

*/20	*	*	*	*

einzutragen. Details sind im Artikel zu Cron beschrieben.

Fertig!

Tiny Tiny RSS sollte jetzt ausführbar sein. Die Oberfläche ist dann unter http://AdresseOderIPderDiskStation/ttrss erreichbar und zeigt ein Login-Fenster. Der angelegte default-user heißt admin mit Passwort password (was möglichst bald geändert werden sollte).

Weitere Optionen

Die Funktionalität von Tiny Tiny RSS kann noch erweitert werden, z.B. mit einer Indizierungssoftware, der Unterstützung des push-Protokolls PubSubHubbub oder einer Komprimierung der übertragenen Daten. Details dazu sind in der Datei config.php zu finden (und zu ändern).

Tiny Tiny RSS kann mit Plugins erweitert werden. Es werden einige mitgeliefert. Man kann sie in den Einstellungen an- und abschalten. Dort sind auch kurze Beschreibungen zu finden.