Etherpad

Få adgang til Etherpad

• Brugergrænseflade: https://<SERVER_IP>
• Admin interface: https://<SERVER_IP>/admin
• Admin-legitimationsoplysninger: Brugernavn admin, adgangskode gemt i .env as ADMIN_PASSWORD

Tilføj brugere via administratorindstillinger

1. Besøg: https://<SERVER_IP>/admin

2. Gå til Indstillinger.

3. En JSON-konfigurationsfil vil blive vist.

4. Find users afsnit:

  "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. Tilføj en ny bruger (følg gyldig JSON-syntaks):

  "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 på Gem indstillinger.

7. Klik på Genstart Etherpad.

Vigtige filer og mapper

• Applikationsinstallation: /root/etherpad
• Docker Compose-fil: /root/etherpad/docker-compose.yml
• Miljøvariabler: /root/etherpad/.env
• PostgreSQL-databasedata: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Etherpad runtime data: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Plugins bibliotek: /var/lib/docker/volumes/etherpad_plugins/_data
• Nginx konfiguration: /etc/nginx/sites-available/etherpad
• SSL-certifikater: /etc/nginx/ssl/

Service-håndtering

Liste over containere:

docker ps

Genstart containere:

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

Følg Etherpad-logfiler:

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

Genstart Nginx:

systemctl restart nginx

Aktivering af SSL med et domæne

1. Peg dit domæne mod serverens IP.

2. Rediger Nginx-config og erstat begge server_name <IP>; med dit domæne (<your-domain>) for både HTTP (port 80) og HTTPS (port 443) blokke:

vim /etc/nginx/sites-available/etherpad

3. Installer Certbot:

apt install -y certbot python3-certbot-nginx

4. Kør følgende kommando for at generere et gyldigt Let’s Encrypt-certifikat:

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

5. Erstat SSL-stier i Nginx-config:

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. Genstart Nginx for at aktivere ændringerne:

systemctl restart nginx

7. Åbn din browser og gå til: https://yourdomain.com

Noter

• Etherpad serveres bag en Nginx omvendt proxy til SSL-opsigelse og forbedret sikkerhed.
• Et selvsigneret certifikat kan udløse browseradvarsler; dette forventes, medmindre Let's Encrypt bruges.
• Nogle browsere kan vise fejl eller få Etherpad til at fungere forkert.
• Etherpad er blevet testet og bekræftet, at den fungerer på Firefox, hvilket anbefales for den bedste kompatibilitet.