In diesem Artikel zeigen wir Ihnen, wie Sie Etherpad auf einem verwalteten Debian 9-Server installieren.
Etherpad ist ein webbasierter Echtzeit-Editor, der als Open-Source-Paket geliefert wird. Diese Anwendung ermöglicht es Benutzern, Dokumente gleichzeitig in Echtzeit zu bearbeiten und die Unterschiede durch die Verwendung von farbigem Text zu sehen. Etherpad hat auch eine Chat-Box, die es Benutzern ermöglicht, einfach miteinander zu kommunizieren, was die Produktivität weiter verbessert. Die Installation dauert nicht lange, also fangen wir anz
Schritt 1:Verbinden Sie sich mit Ihrem Server
Bevor wir beginnen, müssen Sie sich als Root-Benutzer oder als Administratorkonto über SSH mit Ihrem Server verbinden. Verwenden Sie dazu den folgenden Befehl:
ssh root@IP_ADDRESS -p PORT_NUMBER
Natürlich müssen Sie IP_ADDRESS ersetzen und PORT_NUMBER mit Ihrer jeweiligen Server-IP-Adresse und SSH-Portnummer. Ersetzen Sie bei Bedarf „root“ durch den Benutzernamen Ihres Administratorkontos.
Stellen Sie nach der Anmeldung sicher, dass Ihr Server auf dem neuesten Stand ist, indem Sie die folgenden Befehle ausführen:
apt update apt upgrade
Schritt 2:Abhängigkeiten installieren
Nach erfolgreicher Anmeldung müssen Sie den folgenden Befehl ausführen, damit Sie alle Abhängigkeiten für die Node.js-Installation installieren können.
apt install gzip git curl python libssl-dev pkg-config gcc g++ make build-essential -y
Schritt 3:Node.js installieren
Etherpad erfordert Node.js Version 8.9.0 oder höher, daher werden wir in diesem Tutorial die neueste Version von Node.js installieren (zum Zeitpunkt des Schreibens dieses Tutorials).
Aktivieren Sie das NodeSource-Repository mit dem folgenden Curl-Befehl:
curl -sL https://deb.nodesource.com/setup_11.x | sudo bash -
Jetzt können Sie Node.js mit dem folgenden Befehl installieren:
apt install -y nodejs
Sie können die nodejs- und npm-Versionen mit den folgenden Befehlen überprüfen.
nodejs --version npm --version
Schritt 4:MySQL installieren und konfigurieren
Ein Datenbankserver ist eine der Voraussetzungen, um Etherpad auszuführen. Sie können MySQL installieren, einen großartigen Open-Source-Datenbankserver. Geben Sie den folgenden Befehl ein, um MySQL auf Ihrem Server zu installieren:
apt install mysql-server mysql-client
Sobald MySQL auf Ihrem Server installiert ist, können Sie die folgenden Befehle verwenden, um den MySQL-Dienst zu stoppen, zu starten und zu aktivieren.
systemctl start mysql systemctl stop mysql systemctl enable mysql
Der nächste Befehl ist optional, wird aber von uns empfohlen. Sie können den Befehl ausführen, wenn Sie den MySQL-Server sichern möchten, indem Sie den Remote-Root-Zugriff verbieten, die Testdatenbank entfernen und ein Root-Passwort für MySQL festlegen.
mysql_secure_installation
Wenn Sie dazu aufgefordert werden, beantworten Sie die folgenden Fragen, indem Sie der Anleitung folgen.
Enter current password for root (enter for none): Just press the [Enter] key, as no password is set by default. Set root password? [Y/n]: Y New password: Enter your password Re-enter new password: Repeat your password Remove anonymous users? [Y/n]: Y Disallow root login remotely? [Y/n]: Y Remove test database and access to it? [Y/n]: Y Reload privilege tables now? [Y/n]: Y
Starten Sie den MySQL-Server neu, damit die Änderungen wirksam werden.
systemctl restart mysql
Jetzt sollten Sie sich mit dem Befehl:
bei der MySQL-Shell anmelden könnenmysql -u root -p
Geben Sie dann das oben erstellte Passwort ein, um sich anzumelden. Sobald Sie sich in der MySQL-Shell befinden, können Sie den folgenden Befehl verwenden und eine Datenbank namens etherpad_db erstellen für die Etherpad-Anwendung.
CREATE DATABASE etherpad_db;
Um dem Benutzer etherpad_user vollen Zugriff auf die etherpad_db zu gewähren, führen Sie den folgenden Befehl aus:
GRANT ALL PRIVILEGES ON etherpad_db.* TO etherpad_user@localhost IDENTIFIED BY 'Str0n9Pas$worD';
HINWEIS: Vergessen Sie nicht, „Str0n9Pas$word“ durch ein eindeutiges, sicheres Passwort zu ersetzen. Jetzt können Sie die Operation Flush Privileges verwenden, um die Grant-Tabellen neu zu laden, wonach Sie die MySQL-Shell verlassen können.
FLUSH PRIVILEGES; EXIT;
Schritt 5:Etherpad herunterladen und installieren
Mit den folgenden Befehlen erstellen Sie einen neuen Benutzer namens etherpad und wechseln zu diesem Benutzer.
useradd -m -s /bin/bash etherpad su - etherpad
Führen Sie den folgenden Git-Befehl aus und klonen Sie das Etherpad-Repository.
git clone git://github.com/ether/etherpad-lite.git
Nachdem Sie das etherpad-Repository erfolgreich geklont haben, können Sie das etherpad-lite-Verzeichnis aufrufen und bin/run.sh ausführen Skript zum Starten von Etherpad.
cd etherpad-lite/ bin/run.sh
Etherpad wurde nun temporär gestartet. Um die Etherpad-Startseite anzuzeigen, können Sie Ihren bevorzugten Webbrowser öffnen und die öffentliche IP-Adresse Ihres Servers mit Port 9001 eingeben.
http://server_IP_address:9001/Sie sollten die Etherpad-Homepage sehen können.
Um die Anwendung zu stoppen, können Sie in Ihrem Terminal „Strg+c“ drücken. Das Problem dabei ist, dass der Dienst nur vorübergehend läuft – nur solange er in Ihrer Terminalsitzung geöffnet ist. Damit der Server dauerhaft läuft, müssen Sie einen Dienst dafür erstellen. Dies wird in Schritt 7 erklärt .
Schritt 6:Etherpad konfigurieren
Nach diesem Schritt aus dem Artikel führen Sie einige grundlegende Konfigurationen des Etherpad-Editors durch.
Melden Sie sich beim etherpad-Benutzer an und geben Sie das etherpad-lite-Verzeichnis ein.
su - etherpad cd etherpad-lite/
Öffnen Sie die settings.json Konfigurationsdatei mit Ihrem bevorzugten Texteditor. In unserem Beispiel verwenden wir nano als bevorzugten Texteditor.
nano settings.json
Ändern Sie die IP-Adresse in der Konfigurationsdatei in „server_IP_address“, und optional können Sie den Überwachungsport auf einen nicht standardmäßigen ändern. In unserem Beispiel verwenden wir den Standardport.
"ip": "server_IP_address", "port" : 9001,
Deaktivieren Sie die „schmutzige“ Datenbank, die standardmäßig in der Konfigurationsdatei enthalten ist, indem Sie die Kommentar-Tags /* verwenden und */ wie im folgenden Beispiel gezeigt.
/*
"dbType" : "dirty",
"dbSettings" : {
"filename" : "var/dirty.db"
},
*/ Entkommentieren Sie nun die MySQL-Datenbankkonfiguration und geben Sie die MySQL-Informationen ein, die Sie im vierten Schritt dieses Artikels erstellt haben.
"dbType" : "mysql",
"dbSettings" : {
"user" : "etherpad_user",
"host" : "localhost",
"port" : 3306,
"password": "Str0n9Pas$worD",
"database": "etherpad_db",
"charset" : "utf8mb4"
},
Sie können den Admin-Benutzer aktivieren, indem Sie den Kommentar aus diesen Zeilen entfernen und Str0n9Pas$worD ersetzen mit einem Passwort Ihrer Wahl.
"users": {
"admin": {
// "password" can be replaced with "hash" if you install ep_hash_auth
"password": "Str0n9Pas$worD",
"is_admin": true
},
"user": {
// "password" can be replaced with "hash" if you install ep_hash_auth
"password": "Str0n9Pas$worD",
"is_admin": false
}
}, installieren Sobald Sie alle Änderungen vorgenommen haben, können Sie die Konfigurationsdatei speichern und beenden.
Schritt 7:Etherpad als Dienst einrichten
Methode 1:Systemd
In diesem Schritt konfigurieren Sie Etherpad so, dass es als systemd-Dienst auf Ihrem Debian 9-System läuft.
Führen Sie den folgenden Befehl aus, damit Sie eine neue Dienstdatei mit dem Namen „etherpad.service“ erstellen können.
cd /etc/systemd/system/ && nano etherpad.service
Fügen Sie dann die folgende Konfiguration ein.
[Unit] Description=etherpad-lite (real-time collaborative document editing) After=syslog.target network.target [Service] Type=simple User=etherpad Group=etherpad WorkingDirectory=/home/etherpad/etherpad-lite Environment=NODE_ENV=development ExecStart=/usr/bin/nodejs /home/etherpad/etherpad-lite/node_modules/ep_etherpad-lite/node/server.js Restart=always # use mysql plus a complete settings.json to avoid Service hold-off time over, scheduling restart. [Install] WantedBy=multi-user.target
Sie können dann die Konfigurationsdatei speichern und beenden. Verwenden Sie den folgenden Befehl, um die systemd-Dienstliste auf Ihrem Server neu zu laden.
systemctl daemon-reload
Jetzt können Sie das systemctl verwenden Befehl, damit Sie die Etherpad-Anwendung einfach und dauerhaft starten und aktivieren können. Wenn der Dienst aktiviert ist, wird er bei jedem Systemstart automatisch gestartet.
systemctl start etherpad systemctl enable etherpad
Methode 2:Init.d
Wenn Sie lieber init verwenden, können Sie mit dem folgenden Befehl ein neues Anfangsskript erstellen.
nano /etc/init.d/etherpad
Fügen Sie das folgende Skript ein.
#!/bin/sh
### BEGIN INIT INFO
# Provides: etherpad-lite
# Required-Start: $local_fs $remote_fs $network $syslog
# Required-Stop: $local_fs $remote_fs $network $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: starts etherpad lite
# Description: starts etherpad lite using start-stop-daemon
### END INIT INFO
PATH="/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/opt/node/bin"
LOGFILE="/var/www/etherpad-lite/etherpad-lite.log"
EPLITE_DIR="/var/www/etherpad-lite"
EPLITE_BIN="bin/safeRun.sh"
USER="etherpad"
GROUP="etherpad"
DESC="Etherpad Lite"
NAME="etherpad-lite"
set -e
. /lib/lsb/init-functions
start() {
echo "Starting $DESC... "
start-stop-daemon --start --chuid "$USER:$GROUP" --background --make-pidfile --pidfile /var/run/$NAME.pid --exec $EPLITE_DIR/$EPLITE_BIN -- $LOGFILE || true
echo "done"
}
#We need this function to ensure the whole process tree will be killed
killtree() {
local _pid=$1
local _sig=${2-TERM}
for _child in $(ps -o pid --no-headers --ppid ${_pid}); do
killtree ${_child} ${_sig}
done
kill -${_sig} ${_pid}
}
stop() {
echo "Stopping $DESC... "
while test -d /proc/$(cat /var/run/$NAME.pid); do
killtree $(cat /var/run/$NAME.pid) 15
sleep 0.5
done
rm /var/run/$NAME.pid
echo "done"
}
status() {
status_of_proc -p /var/run/$NAME.pid "" "etherpad-lite" && exit 0 || exit $?
}
case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
status)
status
;;
*)
echo "Usage: $NAME {start|stop|restart|status}" >&2
exit 1
;;
esac
exit 0 Speichern und schließen Sie die Datei. Machen Sie das Skript ausführbar, indem Sie die Berechtigungen der Datei ändern, und aktivieren Sie es, um beim Booten zu starten.
chmod +x /etc/init.d/etherpad update-rc.d etherpad defaults /etc/init.d/etherpad start
Mit den folgenden Befehlen können Sie überprüfen, ob die Anwendung auf Port 9001 ausgeführt wird.
systemctl status etherpad and netstat -tunlp | grep 9001
Schritt 8:Reverse-Proxy einrichten
Da Apache und Nginx zu den beliebtesten Webservern im Internet gehören, zeigen wir Ihnen in diesem Schritt, wie Sie einen Reverse-Proxy für sie erstellen, damit Sie die Website mit Etherpad mit einem Domainnamen öffnen können. Dies hat zusätzlich den Vorteil, dass für den Zugriff auf Etherpad keine Portnummer angegeben werden muss.
Wir gehen davon aus, dass Sie bereits Apache oder Nginx auf Ihrem Server installiert haben. Sie können den Status des Webservers mit den folgenden Befehlen überprüfen.
Für Apache2:
systemctl status apache2
Für Nginx:
systemctl status nginx
Wenn Sie Apache2 auf Ihrem Server installiert haben, können Sie eine neue virtuelle Host-Konfigurationsdatei erstellen, damit Sie mit einem Domänennamen auf die Etherpad-Anwendung zugreifen können.
nano /etc/apache2/sites-available/domain_name.conf
fügen Sie der Datei folgenden Inhalt hinzu:
<VirtualHost *:80>
ServerName domain_name.com ServerAlias www.domain_name.com ServerSignature Off <IfModule mod_proxy.c> ProxyVia On ProxyRequests Off ProxyPass / http://server_IP_address:9001/ ProxyPassReverse / http://server_IP_address:9001/ ProxyPreserveHost on <Proxy *> Options FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all </Proxy> </IfModule> </VirtualHost> Natürlich müssen Sie domain_name.com durch Ihren tatsächlich registrierten Domainnamen ersetzen und server_IP_address durch die öffentliche IP-Adresse Ihres Servers ersetzen. Wenn Sie mit der Bearbeitung der Konfigurationsdatei fertig sind, speichern Sie die Datei und beenden Sie.
Die folgenden Apache-Module müssen installiert sein:
a2enmod proxy a2enmod proxy_http a2enmod headers
Um den soeben erstellten virtuellen Host zu aktivieren, führen Sie a2ensite aus Befehl:
a2ensite domain_name
Damit die vorgenommenen Änderungen wirksam werden, müssen Sie Apache neu starten:
apache2ctl restart
Wenn Sie Nginx auf Ihrem Server installiert haben, können Sie einen neuen Serverblock erstellen, sodass Sie mit einem Domänennamen und ohne Portnummer auf die Etherpad-Anwendung zugreifen können.
Erstellen Sie den neuen Etherpad-Serverblock mit dem Befehl:
nano /etc/nginx/sites-available/etherpad.conf
fügen Sie der Datei folgenden Inhalt hinzu:
server {
listen 80;
server_name domain_name.com;
location / {
proxy_pass http://server_IP_address:9001/
proxy_set_header Host $host;
proxy_buffering off;
}
} Sie müssen domain_name.com durch Ihren tatsächlich registrierten Domainnamen ersetzen, sowie server_IP_address durch die öffentliche IP-Adresse Ihres Servers. Wenn Sie mit der Bearbeitung der Konfigurationsdatei fertig sind, speichern Sie die Datei und beenden Sie.
Um den virtuellen Etherpad-Host zu aktivieren, können Sie mit dem folgenden Befehl einen Symlink erstellen:
ln -s /etc/nginx/sites-available/etherpad /etc/nginx/sites-enabled/
Testen Sie anschließend die Nginx-Konfiguration.
nginx -t
Bevor Sie den Nginx-Dienst starten und aktivieren, müssen Sie sicherstellen, dass während des Nginx-Konfigurationstests keine Fehler auftreten. Wenn alles ausgecheckt ist, können Sie die folgenden Befehle ausführen:
systemctl restart nginx systemctl enable nginx
Schritt 9:Zugriff auf Etherpad
Öffnen Sie nun Ihren bevorzugten Webbrowser und geben Sie Ihren Domainnamen ein.http://domain_name.com/
Sie sollten den Etherpad-Editor in Ihrem Browser sehen können.
Geben Sie den Namen Ihres neuen Pads ein und klicken Sie auf die Schaltfläche OK.
Sie sollten jetzt den Etherpad-Editor sehen können, wie im Bild unten gezeigt.
Um auf die Admin-URL zuzugreifen, fügen Sie /admin/ hinzu an das Ende Ihres Domainnamens.
http://domain_name.com/admin/
Sie werden aufgefordert, einen Administrator-Benutzernamen und ein Kennwort einzugeben. Geben Sie Ihren Admin-Benutzernamen und Ihr Passwort ein und klicken Sie dann auf die Schaltfläche Anmelden.
Herzliche Glückwünsche. Sie haben den Etherpad-Editor erfolgreich installiert und konfiguriert.
In diesem Artikel haben wir Ihnen gezeigt, wie Sie Etherpad unter Debian 9 installieren. Sie können diese unglaubliche Open-Source-Anwendung jetzt weiter verwenden und erkunden.
Wenn Sie einer unserer Debian-Hosting-Kunden sind, müssen Sie Etherpad natürlich nicht auf Ihrem Debian 9 VPS installieren – fragen Sie einfach unsere Administratoren, lehnen Sie sich zurück und entspannen Sie sich. Unsere Admins werden Etherpad auf Debian 9 umgehend für Sie installieren und konfigurieren.
PS. Wenn Ihnen dieser Beitrag über die Installation von Etherpad auf einem Debian 9 VPS gefallen hat, teilen Sie ihn bitte mit Ihren Freunden in den sozialen Netzwerken über die Schaltflächen zum Teilen unten oder hinterlassen Sie einfach einen Kommentar im Kommentarbereich. Danke.