Etherpad

Dostęp do Etherpad

• Interfejs użytkownika: https://<SERVER_IP>
• Interfejs administracyjny: https://<SERVER_IP>/admin
• Dane logowania administratora: nazwa użytkownika admin, hasło przechowywane w .env as ADMIN_PASSWORD

Dodaj użytkowników przez ustawienia administratora

1. Odwiedź: https://<SERVER_IP>/admin

2. Przejdź do Ustawień.

3. Wyświetlony zostanie plik konfiguracyjny JSON.

4. Zlokalizuj users sekcja:

  "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. Dodaj nowego użytkownika (zachowaj poprawną składnię JSON):

  "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. Kliknij Zapisz ustawienia.

7. Kliknij Uruchom ponownie Etherpad.

Ważne pliki i katalogi

• Instalacja aplikacji: /root/etherpad
• Plik Docker Compose: /root/etherpad/docker-compose.yml
• Zmienne środowiskowe: /root/etherpad/.env
• Dane bazy PostgreSQL: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Dane środowiska uruchomieniowego Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Katalog wtyczek: /var/lib/docker/volumes/etherpad_plugins/_data
• Konfiguracja Nginx: /etc/nginx/sites-available/etherpad
• Certyfikaty SSL: /etc/nginx/ssl/

Zarządzanie usługami

Wyświetl kontenery:

docker ps

Uruchom ponownie kontenery:

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

Śledź logi Etherpad:

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

Uruchom ponownie Nginx:

systemctl restart nginx

Włączanie SSL z własną domeną

1. Wskaż domenę na adres IP serwera.

2. Edytuj konfigurację Nginx i zamień obie wartości server_name <IP>; na swoją domenę (<your-domain>) w blokach HTTP (port 80) i HTTPS (port 443):

vim /etc/nginx/sites-available/etherpad

3. Zainstaluj Certbot:

apt install -y certbot python3-certbot-nginx

4. Uruchom następujące polecenie, aby wygenerować ważny certyfikat Let's Encrypt:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Zaktualizuj ścieżki SSL w konfiguracji Nginx:

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. Zrestartuj Nginx, aby zastosować zmiany:

systemctl restart nginx

7. Otwórz przeglądarkę i przejdź pod adres: https://yourdomain.com

Notatki

• Etherpad działa za odwrotnym proxy Nginx, które obsługuje terminację SSL i zwiększa bezpieczeństwo.
• Certyfikat z podpisem własnym może powodować ostrzeżenia przeglądarki - to normalne zachowanie, chyba że używasz Let's Encrypt.
• Niektóre przeglądarki mogą wyświetlać błędy lub powodować nieprawidłowe działanie Etherpad.
• Etherpad został przetestowany i działa poprawnie w Firefox - ta przeglądarka jest zalecana dla najlepszej zgodności.