Nach dem ich auf der Facebook Seite vom OwnCloud-Fork NextCloud berichtet haben, bin ich in den News zu NextCloud auf einen interessant Erweiterung namens Spreed.Me gestoßen. Diese App erweitert, im Zusammenspiel mit dem Spreed WebRTC Server, die Cloud um ein Audio und Video Konferenz Funktion.

Um ein paar Features des WebRTC Servers / der  App zu nennen:

  • Audio- / Video- / Text Kommunikation im Browser
  • Teilen von Dokumenten und speichern der Dokumente direkt in der Cloud (NextCloud/OwnCloud)
  • Teilen des Bildschirminhaltes (ggf. bestimmte Voraussetzungen erforderlich)

Damit diese Erweiterung lauffähig ist, benötigt man noch den WebRTC Server. Auf der GitHub Seite findet man nähere Informationen zur Erweiterung. Wie es scheint soll diese Erfolgsversprechende App vollen Support von NextCloud erhalten wie man auf der NextCloud Seite lesen kann. So ist auch davon auszugehen, dass diese Installation längere Zeit unter NextCloud Verwendung finden kann.

Vorteile die NextCloud jetzt schon mit sich bringt ist die Enterprise Funktionalität, einen Ordner für den Upload frei zu geben, ohne dass der Kunde in den Ordner sehen kann. Bis dato gibt es noch keine Unterschiede zur OwnCloud. Da es keine Nachteile mit sich bringt wurde kurzerhand eine NextCloud auf Uberspace aufgesetzt und läuft dort seit kurzem mit memcached reibungslos. Einziges Manko ist die Webupload Begrenzung auf ca. 300MB. Bei größeren Dateien bricht der Upload ab. Mit dem Desktop Client kann diese Grenze aber umgangen werden, da Dateien in mehreren Teilen auf den Server geladen werden.

In diesem Tutorial wird mit NextCloud gearbeitet, es sollte aber auch problemlos mit einer OwnCloud Installation funktionieren.

Spreed-ME Client

Spreed WebRTC

Als erstes wird der WebRTC Server installiert sowie weitere Extension geladen. Zuerst laden wir die letzte verfügbare WebRTC Version herunter und entpacken diese. In dieser Anleitung wird mit dem Release 0.27 gearbeitet (Pre-release).

$ cd ~/etc/
$ wget https://github.com/strukturag/spreed-webrtc/archive/release-0.27.zip
$ unzip -q release-0.27.zip
$ mv spreed-webrtc-release-0.27/ spreed-webrtc

Damit wurde das heruntergeladene Archiv in den Ordner spreed-webrtc-release-0.27 entpackt. Dieses wurde noch in spreed-webrtc umbenannt, ist aber nicht notwendig. Als nächstes werden zwei Scripte ausgeführt. Das erste generiert die notwendigen Configurationsscripte, das zweite ist ein neu erzeugtes Script.

$ ./autogen.sh

Die Ausgabe des Scripts könnte so ähnlich lauten.

autoreconf: Entering directory `.‘
autoreconf: configure.ac: not using Gettext
autoreconf: running: aclocal –force -I m4
autoreconf: configure.ac: tracing
autoreconf: configure.ac: not using Libtool
autoreconf: running: /usr/bin/autoconf –force
autoreconf: configure.ac: not using Autoheader
autoreconf: running: automake –add-missing –copy –force-missing
configure.ac:47: installing `./install-sh‘
configure.ac:47: installing `./missing‘
Makefile.am: installing `./INSTALL‘
autoreconf: Leaving directory `.‘

$ ./configure

Dieses Skript prüft ob alle Abhängigkeiten die für den Server gegeben sind. Wir können sehen was noch fehlt und können es nachinstallieren.

checking for a BSD-compatible install… /usr/bin/install -c
checking whether build environment is sane… yes
checking for a thread-safe mkdir -p… /bin/mkdir -p
checking for gawk… gawk
checking whether make sets $(MAKE)… yes
checking whether to disable maintainer-specific portions of Makefiles… yes
checking for a thread-safe mkdir -p… /bin/mkdir -p
checking for a BSD-compatible install… /usr/bin/install -c
checking for grep that handles long lines and -e… /bin/grep
checking for a sed that does not truncate output… /bin/sed
checking for gawk… (cached) gawk
checking for find… /bin/find
checking for gpm… no
checking for jshint… no
checking for python2… /usr/bin/python2
checking for version of python2… 2.6.6
checking for go… /home/justit/.linuxbrew/bin/go
checking for version of Go… 1.6.2
checking third-party Go source code path… /home/justit/tmp/spreed-webrtc/vendor
checking for nodejs… no
checking for node… /usr/local/bin/node
checking for version of node.js… 0.10.43
checking for compass… /home/justit/.gem/ruby/2.3.0/bin/compass
checking for version of compass… 1.0.3
checking for sass… /home/justit/.gem/ruby/2.3.0/bin/sass
checking for version of sass… 3.4.22
checking for scss-lint… /home/justit/.gem/ruby/2.3.0/bin/scss-lint
checking for version of scss-lint… 0.38.0
checking for compass support in sass… ok
checking for autoprefixer… no
configure: WARNING: Please install autoprefixer before trying to build styles.
checking for pybabel… /home/justit/bin/pybabel
checking for version of pybabel… 2.3.4
checking for npm… /usr/local/bin/npm
checking for version of npm… 1.4.29
checking for po2json support in node.js… not available
configure: WARNING: Please install the node.js module po2json to build i18n.
configure: creating ./config.status
config.status: creating Makefile
config.status: creating src/styles/Makefile
config.status: creating src/i18n/Makefile

In diesem Fall ist nur noch weniges zu installieren. Allerdings ist diese Ausgabe erst gemacht worden nachdem eine aktuellere Go (golang) Version 1.6.2 installiert wurde. Auf den Uberspace Servern findet sich eine ältere Version.Last euch nicht von den Voraussetzungen täuschen die auf der GitHub Seite zum WebRTC Server stehen. Es wird eine Go Version auf den CentOS Server benötigt die mindestes Version 1.6.2 ist.

Die erste Anlaufstelle eine neue Go Version zu installieren ist sicher der Paktemanager toast, leider brachte das keinen Erfolg. Daher wurde an dieser Stelle auf den Paketmanager Linuxbrew zurück gegriffen. Die Installation ist im Uberspace Wiki gut beschrieben, daher hier nur die Befehle um Go zu installieren.

$ brew search go
$ brew info go
$ brew install go

Mit dem ersten Befehl suchen wir nach einem Paket für Go. Der zweite Befehl gibt die Version von Go im Linuxbrew-Paket aus. Mit dem dritten Befehl wird das Go-Paket installiert.

Nach dem jetzt eine neue Go-Version installiert wurde, go version zeigt uns das, können die restlichen Abhängigkeiten installiert werden.

$ npm install autoprefixer
$ npm install po2json
$ pip2.7 install babel --user

Bei einigen Uberspace Usern kann es u.a. noch notwendig sein, folgende Pakete zu installieren (Compass, Sass).

$ gem install compass --user
$ gem install sass --user
$ gem install scss-lint --user

Nachdem alle Fehlermeldungen beseitigt sind können wir den Server erstellen.

$ make

Theoretisch kann der Server ab hier mit ./spreed-webrtc-server gestartet werden. Es fehlt aber noch die Konfigurationsdatei, eine Spezielle Datei kann mit -c angegeben werden. Der Defaultwert für die Datei ist aber in diesem Fall ausreichend. Wir erstellen eine Kopie der mitgelieferten Datei und passen sie dann auf unsere Gegebenheiten an. Für den ersten Test (debug) können wir den WebRTC Server auch ohne die NextCloud laufen lassen.

Da der WebRTC Server eine neue Webserver Instanz bildet, müssen wir einen tcp Port sowie einen Port für UDP und TCP, von außen verfügbar machen.

$ uberspace-add-port -p tcp --firewall
$ uberspace-add-port -p both --firewall
$ uberspace-list-ports --open

Mit dem dritten Befehl, bekommen wir die geöffneten Ports angezeigt (merken).

WebRTC Server konfiguration

$ cp server.conf.in server.conf
$ vi server.conf

Hier wird als Editor jetzt vi verwendet, unter dem Punkt [http] finden wir schon den konfigurierten Eintrag listen. Dort tragen wir die IP-Adresse von unserem Uberspace Server ein, sowie den tcp-Port den wir zuvor geöffnet haben. Mit diesen Einstellungen kann der Server auf Funktion getestet werden.

$ ./spreed-webrtc-server

Dieser Befehl starten wir den WebRTC Server. In der Konsole können wir einige Warnungen sehen (die Konfiguration ist noch nicht beendet), den WebRTC Server können wir jetzt aber schon ansurfen.

http://IP-Adresse:tcp-Port

Strg + C beendet den Server wieder und wir können uns an die weitere Konfiguration begeben. Jetzt wird die Spreed.ME App installiert aktuell in Version 0.1.6 zum Download. Die Spreed.ME App befindet sich unter den experimentellen Erweiterungen. Daher müssen diese, falls noch nicht geschehen, links unten in der Ecke über das Zahnrad aktiviert werden. Nach dem die App installiert ist, können wir sie zwar noch nicht verwenden, aber das Konfigurieren kann losgehen!

Die Installation ist sehr ausführlich auf der GitHub Seite des Plug-Ins beschrieben. Anbei werde ich aber meine Konfigurationsänderungen aufzeigen. Nach dem der WebRTC Server für die App konfiguriert wurde, kann man nur noch über die NextCloud (OwnCloud) Seite oder einen Einladungslink (Temporäres Passwort) zur Video Konferenz gelangen.

Als erstes öffnen wir wieder server.conf Datei des WebRTC Server. Ich gehe an dieser Stelle davon aus, dass Ihr eure NextCloud (OwnCloud) nur per https erreicht. Falls noch nicht geschehen wird in diesem Tutorial zumindest beschrieben wie man ein Zertifikat erzeugt, dass man anschließend an eine CA schicken kann um es danach bei Uberspace einzubinden. Da wir im [http] Bereich damit kein ‚listen =‘ mehr benötigen, können wir diesen auskommentieren. Dafür habe ich unter ‚basePath =‘ einen Eintrag gesetzt. Dieser wird sich in der Konfiguration der App an anderer Stelle wiederholen. Im Abschnitt [https] tragen wir die selben Daten bei ‚listen =‚ ein wie zuvor ohne SSL. Nun wird der Pfad zum Zertifikat angegeben. Da der WebRTC Server nachher ja unter dem selben Domainname wie die Cloud zu erreichen ist, kann man hier das selbe Zertifikat verwenden. Die Pfade hier sind nur beispielhaft, sie können auch an anderer Stelle in Eurem Uberspace liegen.

[http]
basePath = /spreed-webrtc/

[https]
listen = :tcp-Port
certificate = /home/USERNAME/Zertifikate/Domainname/Pub-Server.crt
key = /home/USERNAME/Zertifikate/Domainname/Priv-Server.key

Weiter geht es im Bereich [app], hier wird jetzt u.a. die Verbindung zur NextCloud (OwnCloud) Erweiterung hergestellt. Außerdem werden Session-Secrets gesetzt. Diese Secrets kann man sich einfach auf der Konsole z.B. mit xxd -ps -l 32 -c 32 /dev/random erzeugen (steht notfalls auch im server.conf file). Was mir erst im laufe der Einrichtung aufgefallen ist, wird auch ein TURN-Server benötigt. Dieser kann aber auch jetzt schon vorkonfiguriert werden.

[app]
stunURIs = 
turnURIs = turn::?transport=udp
turnSecret = 
sessionSecret = 
encryptionSecret = 
authorizeRoomJoin = true
serverToken = 
serverRealm = local
extra = /var/www/virtual/USERNAME/NextCloud/apps/spreedme/extra # Pfad zur Cloud-Installation und zum App Verzeichnis
plugin = extra/static/owncloud.js

Als letztes werden jetzt noch einige Einstellungen unter [users] vorgenommen.

[users]
enabled = true
mode = sharedsecret
sharedsecret_secret =

Spreed.ME Erweiterung konfigurieren

Der Server ist soweit konfiguriert. Jetzt geht es an die Spreed.ME Erweiterung. Hierfür wechseln wir jetzt in das config-Verzeichnis der App. Dort finden wir eine config.php.in Datei vor. Diese wird dann kopiert und zum bearbeiten geöffnet.

$ cp config.php.in config.php
$ vi config.php

In der Datei werden jetzt folgenden Konfigurationen angepasst.

const SPREED_WEBRTC_ORIGIN = 'https://:tcp-Port';
const SPREED_WEBRTC_BASEPATH = '/spreed-webrtc/';
const SPREED_WEBRTC_SHAREDSECRET = '[users] eingetragen wurde>';
const OWNCLOUD_TEMPORARY_PASSWORD_LOGIN_ENABLED = true;
const OWNCLOUD_TEMPORARY_PASSWORD_SIGNING_KEY = '';

Die letzte Konfiguration am Plug-In findet im Ordner ../extra/static/config/ statt. Hier befindet sich die Datei OwnCloudConfig.js.in die wir wieder kopieren und bearbeiten.

$ cp OwnCloudConfig.js.in OwnCloudConfig.js
$ vi OwnCloudConfig.js

In dieser Datei wir noch einmal der Domainname der Nextcloud Installation eingetragen. Mit diesem letzten Schritt ist die Konfiguration des Servers sowie der Spreed.ME Erweiterung abgeschlossen.

OWNCLOUD_ORIGIN: 'https://cloud.zonedata.de',

Turn Server

Beim der Turn-Server Installation kann man jetzt erstmal ne kurze Auszeit nehmen. Das einrichten dauert eine weile.

$ brew search turn
$ brew info coturn
$ brew install coturn

Das Ende einer coturn Installation kann dann so aussehen.

######################################################################## 100.0%
==> Caveats
A CA file has been bootstrapped using certificates from the system
keychain. To add additional certificates, place .pem files in
  /home/corellia/.linuxbrew/etc/openssl/certs

and run
  /home/corellia/.linuxbrew/opt/openssl/bin/c_rehash

==> Summary
/home/justit/.linuxbrew/Cellar/openssl/1.0.2h: 1,698 files, 14.5M, built in 5 minutes 24 seconds
==> Installing coturn dependency: libevent
==> Downloading https://linuxbrew.bintray.com/bottles/libevent-2.0.22.x86_64_linux.bottle.tar.gz
######################################################################## 100.0%
==> Pouring libevent-2.0.22.x86_64_linux.bottle.tar.gz
/home/justit/.linuxbrew/Cellar/libevent/2.0.22: 58 files, 1.9M
==> Installing coturn
==> Downloading http://turnserver.open-sys.org/downloads/v4.5.0.3/turnserver-4.5.0.3.tar.gz
######################################################################## 100.0%
==> ./configure --disable-silent-rules --mandir=/home/justit/.linuxbrew/Cellar/coturn/4.5.0.3/share/man --prefix=/home/justit/.linuxbrew/Cellar/coturn/4.5.0.3
==> make install
/home/justit/.linuxbrew/Cellar/coturn/4.5.0.3: 97 files, 4.7M, built in 20 seconds
[justit@hadar spreed-webrtc]$

Sobald alles durchgelaufen ist kann der Server konfiguriert werden. Hier liefert die GitHub Seite der Entwickler vom Spreed-WebRTC Server eine gutes Beispielkonfiguration. Bei vielen Einstellungen muss nur das # entfernt werden, die Konfigurationsdatei ist ziemlich groß. Hier wird auch wieder eine Beispielkonfiguration verwendet. Außerdem wir noch ein Symlink dafür erstellt. Evtl. passt der Pfad nicht mehr ganz, weil sich die coturn Version geändert hat.

$ cp /home/$USER/.linuxbrew/Cellar/coturn/4.5.0.3/etc/turnserver.conf.default /home/$USER/.linuxbrew/Cellar/coturn/4.5.0.3/etc/turnserver.conf
$ ln -s /home/$USER/.linuxbrew/Cellar/coturn/4.5.0.3/etc/turnserver.conf /home/$USER/.linuxbrew/etc/turnserver.conf
$ vi /home/$USER/.linuxbrew/Cellar/coturn/4.5.0.3/etc/turnserver.conf
listening-port=63804
listening-ip=185.26.156.13
relay-ip=185.26.156.13
fingerprint
lt-cred-mech
use-auth-secret
static-auth-secret=
realm=spreedbox.local
total-quota=100
bps-capacity=0
stale-nonce
cipher-list="ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:ECDH+3DES:DH+3DES:RSA+AES:RSA+3DES:!ADH:!AECDH:!MD5"
no-loopback-peers
no-multicast-peers

Daemon Tools

Damit jetzt alle Server im Hintergrund Ihr Werk tun, auch wenn der Uberspace-Server mal neu gestartet wird, oder ein Dienst sich ins Nirwana verabschiedet, wird für beide Server ein Service erstellt. Auf die Konfiguration von daemontools wird hier nicht mehr näher eingegangen. Es wurden zwei Scripte erstelle die dann aufgerufen werden.

# WebRTC-Skript#!/bin/sh

#WebRTC dir
export WEBRTC=$HOME/etc/spreed-webrtc

cd $WEBRTC
exec ./spreed-webrtc-server 2>&1
# coturn Skript
#!/bin/sh

exec /home/justit/.linuxbrew/Cellar/coturn/4.5.0.3/bin/./turnserver 2>&1

Go

Wenn beide Server ordnungsgemäß gestartet sind kann der Audio / Video & Chat Server unter der NextCloud (OwnCloud) je nach Endgerät, in vollem Umfang genutzt werden. Einmal in der Weboberfläche eingeloggt kann man erstmal viele Einstellungen bearbeiten.