Etherpad

Etherpad'e Erişim

• Kullanıcı arayüzü: https://<SERVER_IP>
• Yönetici arayüzü: https://<SERVER_IP>/admin
• Yönetici bilgileri: Kullanıcı adı admin, şifre kaydedildi .env as ADMIN_PASSWORD

Yönetici Ayarları Üzerinden Kullanıcı Ekle

1. Ziyaret edin: https://<SERVER_IP>/admin

2. Ayarlar'a gidin.

3. Bir JSON yapılandırma dosyası görüntülenecektir.

4. Bölümü bulun users bölüm:

  "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. Yeni bir kullanıcı ekleyin (geçerli JSON söz dizimine uyun):

  "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. Ayarları Kaydet'e tıklayın.

7. Etherpad'yi Yeniden Başlat'a tıklayın.

Önemli Dosyalar ve Dizinler

• Uygulama yüklemesi: /root/etherpad
• Docker Compose dosyası: /root/etherpad/docker-compose.yml
• Ortam değişkenleri: /root/etherpad/.env
• PostgreSQL veritabanı verileri: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Etherpad çalışma zamanı verileri: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Eklentiler dizini: /var/lib/docker/volumes/etherpad_plugins/_data
• Nginx yapılandırması: /etc/nginx/sites-available/etherpad
• SSL sertifikaları: /etc/nginx/ssl/

Servis Yönetimi

Konteynerları listele:

docker ps

Konteynerleri yeniden başlat:

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

Etherpad günlüklerini takip edin:

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

Nginx'i Yeniden Başlat:

systemctl restart nginx

Bir Alan Adı ile SSL Etkinleştirme

1. Alan adını sunucu IP'sine yönlendir.

2. Nginx config'i düzenle ve her ikisini de değiştir server_name <IP>; alan adın ile (<your-domain>) hem HTTP (port 80) hem HTTPS (port 443) blokları için:

vim /etc/nginx/sites-available/etherpad

3. Certbot'u kur:

apt install -y certbot python3-certbot-nginx

4. Geçerli bir Let's Encrypt sertifikası üretmek için şu komutu çalıştır:

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

5. Nginx config'inde SSL yollarını değiştir:

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. Değişiklikleri uygulamak için Nginx'i yeniden başlat:

systemctl restart nginx

7. Tarayıcını aç ve şu adresi ziyaret et: https://yourdomain.com

Notlar

• Etherpad, SSL sonlandırması ve gelişmiş güvenlik için bir Nginx ters proxy arkasında sunulmaktadır.
• Kendinden imzalı sertifika tarayıcı uyarılarına yol açabilir; Let's Encrypt kullanılmıyorsa bu beklenen bir durumdur.
• Bazı tarayıcılar hata gösterebilir veya Etherpad'nin düzgün çalışmasını engelleyebilir.
• Etherpad, Firefox üzerinde test edilmiş ve sorunsuz çalıştığı doğrulanmıştır. En iyi uyumluluk için Firefox önerilir.