In diesem Tutorial zeigen wir Ihnen, wie Sie Etherpad auf einem Ubuntu 18.04 VPS installieren.
Etherpad ist eine webbasierte Open-Source-Anwendung, die die gemeinsame Bearbeitung eines Dokuments in Echtzeit über einen Webbrowser ermöglicht. Auf diese Weise können Benutzer Dokumente gleichzeitig eingeben, bearbeiten und überprüfen – es steht sogar eine Chat-Funktion zur Verfügung, die den Benutzern bei der Zusammenarbeit an Dokumenten weiter hilft. Beginnen wir mit der Installation.
Voraussetzungen
- Ein Ubuntu 18.04 VPS (wir verwenden unseren SSD 2 VPS-Plan)
- Node.js Version 6.9.0 oder höher (bevorzugte Version:Node.js 8.9 oder höher)
- Zugriff auf das Root-Benutzerkonto (oder Zugriff auf ein Administratorkonto mit Root-Rechten)
Schritt 1:Melden Sie sich beim Server an und aktualisieren Sie die Server-Betriebssystempakete
Melden Sie sich über SSH als Root-Benutzer bei Ihrem Ubuntu 18.04-Server an:
ssh root@IP_Address -p Port_number
Sie müssen „IP_Address“ und „Port_number“ durch die jeweilige IP-Adresse und SSH-Portnummer Ihres Servers ersetzen. Ersetzen Sie außerdem „root“ gegebenenfalls durch den Benutzernamen des Administratorkontos.
Bevor wir mit der Etherpad-Installation beginnen können, müssen wir sicherstellen, dass alle auf dem Server installierten Ubuntu-OS-Pakete auf dem neuesten Stand sind. Wir können dies tun, indem wir die folgenden Befehle ausführen:
sudo apt-get update sudo apt-get upgrade
Schritt 2:Installieren Sie die erforderlichen Pakete
Installieren Sie die erforderlichen Pakete, die Etherpad helfen, auf unserem Server zu laufen:
sudo apt install libssl-dev pkg-config gcc g++ make build-essential
Etherpad erfordert auch Node.js, daher installieren wir die neueste Version (zum Zeitpunkt des Schreibens dieses Tutorials), Node.js 10.15.3. Die neueste Version von Node.js kann aus dem Repository „nodesource“ installiert werden. Nachdem Sie den Tarball heruntergeladen haben, extrahieren Sie ihn in ein neues Verzeichnis unter /opt/nodejs/
.
cd /opt wget https://nodejs.org/dist/v10.15.3/node-v10.15.3-linux-x64.tar.xz tar xJf node-v*-linux-x64.tar.xz sudo mkdir /opt/nodejs/ && mv node-*-linux-x64/* /opt/nodejs
Schritt 3:Installieren Sie MySQL und erstellen Sie eine MySQL-Datenbank
Wir brauchen MySQL, um die Daten zu speichern, die Etherpad erstellt und bearbeitet. Installieren Sie MySQL mit dem folgenden Befehl:
apt-get install mysql-server mysql-client
Erstellen Sie einen neuen MySQL-Benutzer und eine neue Datenbank:
mysql> create database etherpad_db; mysql> grant all privileges on etherpad_db.* to etherpad@localhost identified by 'Str0ngPa55w0rd'; mysql> flush privileges; mysql> quit
Vergessen Sie nicht, Str0ngPa55w0rd
zu ändern mit einem echten, starken Passwort.
Schritt 4:Etherpad-Benutzer erstellen
Führen Sie die folgenden Befehle aus, um einen neuen Systembenutzer für die Etherpad-Instanz zu erstellen:
sudo adduser --home /opt/etherpad --shell /bin/bash etherpad sudo install -d -m 755 -o etherpad -g etherpad /opt/etherpad sudo su - etherpad PATH=$PATH:/opt/nodejs/bin echo "PATH=$PATH:/opt/nodejs/bin" >> ~/.profile
Überprüfen Sie die Node.js-Version:
etherpad@localhost:~$ node --version v10.15.3
Jetzt können wir mit der Installation von Etherpad beginnen.
Schritt 5:Etherpad installieren und konfigurieren
Klonen Sie das Etherpad-Repository von der GitHub-Seite mit dem folgenden Befehl:
git clone git://github.com/ether/etherpad-lite.git ~/etherpad-lite
Gehen Sie in das Verzeichnis „etherpad-lite“ und führen Sie das Bash-Skript „run.sh“ aus, um Etherpad zu starten.
cd /opt/etherpad/etherpad-lite/ bin/run.sh
Kopieren Sie die Datei „settings.json.template“ in eine neue Datei mit dem Namen „settings.json“:
cp settings.json.template settings.json
Bearbeiten Sie dann die Datei settings.json mit Ihrem bevorzugten Texteditor (wir verwenden „nano“):
nano settings.json
Folgendes hinzufügen/ändern:
- Ersetzen Sie „ip“:„0.0.0.0“ durch „ip“:„127.0.0.1“
- Entfernen Sie die folgenden Zeilen:
"dbType" : "dirty", "dbSettings" : { "filename" : "var/dirty.db" },
- Ändern Sie die Zeilen zu den MySQL-Einstellungen so, dass sie wie folgt aussehen:
"dbType" : "mysql", "dbSettings" : { "user" : "etherpad", "host" : "localhost", "port" : 3306, "password": "Str0ngPa55w0rd", "database": "etherpad_db" },
- Ersetzen Sie „trustProxy“ :false durch „trustProxy“ :true
- Legen Sie ein Passwort für den Benutzer „admin“ fest:
"users": { "admin": { // "password" can be replaced with "hash" if you install ep_hash_auth "password": "Str0ngPa55w0rd", "is_admin": true },
Speichern und beenden Sie die Datei dann, sobald alle Änderungen vorgenommen wurden.
Führen Sie den folgenden Befehl aus, um alle anderen Abhängigkeiten zu installieren und den Etherpad-Dienst zu starten:
~/etherpad-lite/bin/installDeps.sh ~/etherpad-lite/bin/run.sh
Um auf Etherpad zuzugreifen, öffnen Sie Ihren Webbrowser und geben Sie die Server-IP-Adresse mit Port „9001“ ein:http://server_IP_address:9001/
Sie können den Etherpad-Prozess mit STRG + C stoppen.
Schritt 6:Richten Sie einen Reverse-Proxy in Apache ein
Um auf Ihren Etherpad-Editor nur über Ihren Domainnamen zuzugreifen, ohne die Portnummer 9001 in der URL, müssen wir ihn hinter einem Reverse-Proxy einrichten.
Dazu müssen wir einige zusätzliche Proxy-Module aktivieren im Apachen. Wir können dies mit den folgenden Befehlen tun:
a2enmod proxy a2enmod proxy_http
Starten Sie Apache neu, damit die Änderungen wirksam werden:
systemctl restart apache2
Sobald „mod_proxy“ und „mod_proxy_http“ in Apache aktiviert sind, erstellen Sie mit dem folgenden Befehl eine neue Konfigurationsdatei für Ihre Domain:
nano /etc/apache2/sites-available/your-domain.com.conf
Und geben Sie die folgenden Zeilen ein:
<VirtualHost *:80> ServerNameyour-domain.com
ServerAliaswww.your-domain.com
ProxyRequests Off <Proxy *> Order deny,allow Allow from all </Proxy> ProxyPass /http://127.0.0.1:9001/
ProxyPassReverse /http://127.0.0.1:9001/
<Location /> Order allow,deny Allow from all </Location> </VirtualHost>
Denken Sie daran, Ihre „your-domain.com“ durch Ihren tatsächlichen Domainnamen zu ersetzen. Speichern Sie die Datei, schließen Sie sie und deaktivieren Sie die Apache-Standardkonfiguration:
a2dissite 000-default
Aktivieren Sie die „your-domain.com.conf“-Konfiguration in Apache mit:
a2ensite your-domain.com
Optional können wir diesen Befehl verwenden, um es zu aktivieren:
ln -s /etc/apache2/sites-available/your-domain.com.conf /etc/apache2/sites-enabled/your-domain.com.conf
Starten Sie dann Apache neu, damit die Änderungen wirksam werden:
systemctl restart apache2
Schritt 7:Erstellen Sie einen systemd-Dienst für Etherpad
Wir können auch einen systemd-Dienst erstellen, damit wir Etherpad wie jeden anderen Ubuntu-Dienst starten können. Erstellen Sie diese Datei unter dem Pfad /etc/systemd/system/etherpad.service
:
nano /etc/systemd/system/etherpad.service
Und fügen Sie die folgenden Zeilen hinzu:
[Unit] Description=Etherpad-lite, the collaborative editor. After=syslog.target network.target [Service] Type=simple User=etherpad Group=etherpad WorkingDirectory=/opt/etherpad/etherpad-lite Environment=NODE_ENV=production ExecStart=/opt/nodejs/bin/node /opt/etherpad/etherpad-lite/src/node/server.js Restart=always [Install] WantedBy=multi-user.target
Speichern Sie die Exit-Datei. Danach laden Sie die Dateien mit diesem Befehl neu:
sudo systemctl daemon-reload
Sie können jetzt den Etherpad-Dienst starten und Etherpad so aktivieren, dass es beim Serverstart automatisch gestartet wird:
sudo systemctl start etherpad.service sudo systemctl enable etherpad.service
Das ist es. Wenn Sie alle Anweisungen korrekt befolgt haben, können Sie jetzt mit Ihrem Domainnamen auf Ihren Etherpad-Editor zugreifen.
Natürlich müssen Sie Etherpad auf Ubuntu 18.04 nicht installieren und konfigurieren, wenn Sie eine unserer verwalteten Ubuntu-Hosting-Lösungen verwenden. In diesem Fall können Sie einfach unsere erfahrenen Linux-Administratoren bitten, Etherpad auf Ubuntu 18.04 für Sie einzurichten und zu konfigurieren. Sie sind 24×7 erreichbar und kümmern sich umgehend um Ihr Anliegen. Wir haben auch einen Beitrag zur Installation von Etherpad unter Ubuntu 20.04 veröffentlicht.
PS . Wenn Ihnen dieser Beitrag über Installation von Etherpad auf einem Ubuntu 18.04 VPS gefallen hat , teilen Sie es bitte mit Ihren Freunden in den sozialen Netzwerken, indem Sie die Schaltflächen zum Teilen unten verwenden, oder hinterlassen Sie einfach einen Kommentar unten im Kommentarbereich. Danke.