Auf Etherpad zugreifen
- Benutzeroberfläche:
https://<SERVER_IP> - Verwaltungsoberfläche:
https://<SERVER_IP>/admin - Admin-Zugangsdaten: Benutzername
admin, Passwort gespeichert in.envasADMIN_PASSWORD
Benutzer über die Admin-Einstellungen hinzufügen
1. Besuchen Sie: https://<SERVER_IP>/admin
2. Gehe zu Einstellungen.
3. Eine JSON-Konfigurationsdatei wird angezeigt.
4. Locate the
I cannot provide a translation because the text is incomplete. "4. Locate the" is a sentence fragment that ends mid-phrase. Please provide the complete sentence for accurate translation. users Abschnitt:
"users": {
"admin": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "${ADMIN_PASSWORD:null}",
"is_admin": true
},
"user": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "test",
"is_admin": false
}
},
5. Einen neuen Benutzer hinzufügen (gültige JSON-Syntax beachten):
"users": {
"admin": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "${ADMIN_PASSWORD:null}",
"is_admin": true
},
"user": {
// 1) "password" can be replaced with "hash" if you install ep_hash_auth
// 2) please note that if password is null, the user will not be created
"password": "test",
"is_admin": false
},
"newuser": {
"password": "strongpassword",
"is_admin": false
}
},
6. Klicken Sie auf Einstellungen speichern.
7. Klicken Sie auf Etherpad neu starten.
Wichtige Dateien und Verzeichnisse
- Anwendungsinstallation:
/root/etherpad - Docker Compose-Datei:
/root/etherpad/docker-compose.yml - Umgebungsvariablen:
/root/etherpad/.env - PostgreSQL Datenbankdaten:
/var/lib/docker/volumes/etherpad_postgres_data/_data - Etherpad Laufzeitdaten:
/var/lib/docker/volumes/etherpad_etherpad-var/_data - Plugin-Verzeichnis:
/var/lib/docker/volumes/etherpad_plugins/_data - Nginx-Konfiguration:
/etc/nginx/sites-available/etherpad - SSL-Zertifikate:
/etc/nginx/ssl/
Dienstverwaltung
Container auflisten:
docker ps
Container neu starten:
docker compose -f /root/etherpad/docker-compose.yml restart
Etherpad-Logs verfolgen:
docker compose -f /root/etherpad/docker-compose.yml logs -f
Nginx neu starten:
systemctl restart nginx
SSL mit einer Domain aktivieren
1. Weise deiner Domain die Server-IP zu.
2. Nginx-Konfiguration bearbeiten und beide ersetzen server_name <IP>; mit Ihrer Domain (<your-domain>) für sowohl HTTP (Port 80) als auch HTTPS (Port 443) Blöcke:
vim /etc/nginx/sites-available/etherpad
3. Installieren Sie Certbot:
apt install -y certbot python3-certbot-nginx
4. Führe folgenden Befehl aus, um ein gültiges Let's Encrypt-Zertifikat zu generieren:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Ersetze SSL-Pfade in der Nginx-Konfiguration:
vim /etc/apache2/sites-available/etherpad
# Before:
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. Starte NGINX neu, um die Änderungen zu übernehmen:
systemctl restart nginx
7. Öffne deinen Browser und rufe folgende Adresse auf: https://yourdomain.com
Hinweise
- Etherpad läuft hinter einem Nginx-Reverse-Proxy für SSL-Terminierung und erhöhte Sicherheit.
- Ein selbstsigniertes Zertifikat kann Browser-Warnungen auslösen. Das ist normal, sofern kein Let's Encrypt-Zertifikat verwendet wird.
- Einige Browser zeigen möglicherweise Fehler an oder führen dazu, dass Etherpad nicht korrekt funktioniert.
- Etherpad wurde auf Firefox getestet und funktioniert einwandfrei. Firefox wird für die beste Kompatibilität empfohlen.
