Etherpad elérése
- Felhasználói felület:
https://<SERVER_IP> - Adminisztrációs felület:
https://<SERVER_IP>/admin - Admin hitelesítő adatok: Felhasználónév
admin, jelszó tárolva a.envasADMIN_PASSWORD
Felhasználók hozzáadása az Admin beállításokon keresztül
1. Látogass el: https://<SERVER_IP>/admin
2. Lépjen a Beállítások menübe.
3. Megjelenik egy JSON konfigurációs fájl.
4. Keresse meg a users szakasz:
"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. Adj hozzá egy új felhasználót (kövesd az érvényes JSON szintaxist):
"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. Kattints a Beállítások mentése gombra.
7. Kattints az Etherpad újraindítása gombra.
Fontos fájlok és könyvtárak
- Alkalmazás telepítése:
/root/etherpad - Docker Compose fájl:
/root/etherpad/docker-compose.yml - Környezeti változók:
/root/etherpad/.env - PostgreSQL adatbázis adatai:
/var/lib/docker/volumes/etherpad_postgres_data/_data - Etherpad futtatókörnyezet adatai:
/var/lib/docker/volumes/etherpad_etherpad-var/_data - Plugins könyvtár:
/var/lib/docker/volumes/etherpad_plugins/_data - Nginx konfiguráció:
/etc/nginx/sites-available/etherpad - SSL tanúsítványok:
/etc/nginx/ssl/
Szolgáltatáskezelés
Tárolók listázása:
docker ps
Tárolók újraindítása:
docker compose -f /root/etherpad/docker-compose.yml restart
Etherpad naplók követése:
docker compose -f /root/etherpad/docker-compose.yml logs -f
Nginx újraindítása:
systemctl restart nginx
SSL engedélyezése domainnel
1. Irányítsa a domainjét a szerver IP-jére.
2. Szerkessze az Nginx konfigurációt, és cserélje le mindkettőt server_name <IP>; a domainjével (<your-domain>) mind a HTTP (80-as port), mind a HTTPS (443-as port) blokkokhoz:
vim /etc/nginx/sites-available/etherpad
3. Telepítse a Certbotot:
apt install -y certbot python3-certbot-nginx
4. Futtassa a következő parancsot egy érvényes Let's Encrypt tanúsítvány létrehozásához:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Cserélje le az SSL útvonalakat az Nginx konfigurációban:
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. Indítsa újra az Nginxet a változtatások alkalmazásához:
systemctl restart nginx
7. Nyissa meg a böngészőjét és látogassa meg: https://yourdomain.com
Megjegyzések
- Az Etherpad egy Nginx fordított proxy mögött fut az SSL lezáráshoz és a fokozott biztonsághoz.
- Önaláírt tanúsítvány esetén a böngésző figyelmeztetést jeleníthet meg; ez várható, hacsak nem Let's Encrypt tanúsítványt használsz.
- Egyes böngészők hibákat jelezhetnek, vagy az Etherpad nem fog megfelelően működni.
- Az Etherpad-t Firefox böngészőn tesztelték és igazoltan működik, ezért a legjobb kompatibilitás érdekében Firefox használata javasolt.
