Etherpad

Hozzáférés az Etherpadhoz

• Felhasználói felület: https://<SERVER_IP>
• Admin felület: https://<SERVER_IP>/admin
• Adminisztrátori hitelesítési adatok: Felhasználónév admin, jelszó tárolva .env as ADMIN_PASSWORD

Felhasználók hozzáadása az Adminisztrációs beállításokon keresztül

1. Látogassa meg: https://<SERVER_IP>/admin

2. Nyissa meg a Beállításokat.

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. Új felhasználó hozzáadása (kövesse 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. Kattintson a Beállítások mentése gombra.

7. Kattintson 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 futásidejű adatok: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Beépülő modulok könyvtára: /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

Konténerek listája:

docker ps

Tárolók újraindítása:

docker compose -f /root/etherpad/docker-compose.yml restart

Kövesse az Etherpad naplóit:

docker compose -f /root/etherpad/docker-compose.yml logs -f

Indítsa újra az Nginxet:

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. nyisd 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 szolgál az SSL-lezáráshoz és a fokozott biztonsághoz.
• Az önaláírt tanúsítvány figyelmeztetéseket válthat ki a böngészőben; ez várható, hacsak nem használjuk a Let’s Encrypt funkciót.
• Egyes böngészők hibákat jeleníthetnek meg, vagy az Etherpad hibás működését okozhatják.
• Az Etherpad tesztelése megtörtént, és megerősítették, hogy a Firefoxon működik, ami a legjobb kompatibilitás érdekében ajánlott.