Akses Etherpad

Antarmuka pengguna: https://<SERVER_IP>
Antarmuka admin: https://<SERVER_IP>/admin
Kredensial admin: Nama pengguna admin, kata sandi disimpan di .env sebagai ADMIN_PASSWORD

Tambahkan Pengguna melalui Pengaturan Admin

1. Kunjungi: https://<SERVER_IP>/admin

2. Buka Pengaturan.

3. Berkas konfigurasi JSON akan ditampilkan.

4. Temukan users bagian:

  "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. Tambahkan pengguna baru (ikuti sintaks JSON yang benar):

  "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. Klik Simpan Pengaturan.

7. Klik "Restart Etherpad".

Berkas dan Direktori Penting

Pemasangan aplikasi: /root/etherpad
Berkas Docker Compose: /root/etherpad/docker-compose.yml
Variabel lingkungan: /root/etherpad/.env
Data basis data PostgreSQL: /var/lib/docker/volumes/etherpad_postgres_data/_data
Data runtime Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
Direktori plugin: /var/lib/docker/volumes/etherpad_plugins/_data
Konfigurasi Nginx: /etc/nginx/sites-available/etherpad
Sertifikat SSL: /etc/nginx/ssl/

Manajemen Layanan

Daftar kontainer:

docker ps

Mulai ulang kontainer:

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

Ikuti log Etherpad:

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

Mulai ulang Nginx:

systemctl restart nginx

Mengaktifkan SSL dengan Domain

1. Arahkan domain Anda ke alamat IP server.

2. Edit konfigurasi Nginx dan ganti keduanya server_name <IP>; dengan domain Anda (<your-domain>) untuk blok HTTP (port 80) dan HTTPS (port 443):

vim /etc/nginx/sites-available/etherpad

3. Instal Certbot:

apt install -y certbot python3-certbot-nginx

4. Jalankan perintah berikut untuk menghasilkan sertifikat Let's Encrypt yang valid:

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

5. Ganti jalur SSL di konfigurasi 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. Restart Nginx untuk menerapkan perubahan:

systemctl restart nginx

7. Buka browser Anda dan kunjungi: https://yourdomain.com

Catatan

Etherpad dijalankan di balik proxy terbalik Nginx untuk terminasi SSL dan peningkatan keamanan.
Sertifikat yang ditandatangani sendiri dapat memicu peringatan browser; hal ini wajar terjadi kecuali jika menggunakan Let’s Encrypt.
Beberapa peramban mungkin menampilkan pesan kesalahan atau menyebabkan Etherpad tidak berfungsi dengan benar.
Etherpad telah diuji dan terbukti berfungsi dengan baik di Firefox, yang direkomendasikan untuk kompatibilitas terbaik.

Etherpad

Rincian Aplikasi