Etherpad

Доступ до Etherpad

• Користувацький інтерфейс: https://<SERVER_IP>
• Інтерфейс адміністратора: https://<SERVER_IP>/admin
• Облікові дані адміністратора: ім'я користувача admin, пароль збережено в .env as ADMIN_PASSWORD

Додавання користувачів через налаштування адміністратора

1. Відвідайте: https://<SERVER_IP>/admin

2. Перейдіть до Параметрів.

3. Буде відображено файл конфігурації JSON.

4. Знайдіть розташування users розділ:

  "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. Додайте нового користувача (дотримуйтесь коректного синтаксису 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. Натисніть «Зберегти налаштування».

7. Натисніть «Перезапустити Etherpad».

Важливі файли та директорії

• Встановлення програми: /root/etherpad
• Файл Docker Compose: /root/etherpad/docker-compose.yml
• Змінні середовища: /root/etherpad/.env
• Дані бази даних PostgreSQL: /var/lib/docker/volumes/etherpad_postgres_data/_data
• Дані середовища виконання Etherpad: /var/lib/docker/volumes/etherpad_etherpad-var/_data
• Каталог плагінів: /var/lib/docker/volumes/etherpad_plugins/_data
• Конфігурація Nginx: /etc/nginx/sites-available/etherpad
• SSL сертифікати: /etc/nginx/ssl/

Керування послугами

Список контейнерів:

docker ps

Перезавантажити контейнери:

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

Перегляд логів Etherpad:

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

Перезавантажити Nginx:

systemctl restart nginx

Увімкнення SSL з власним доменом

1. Вкажіть ваш домен на IP-адресу сервера.

2. Відредагуйте конфігурацію Nginx і замініть обидва значення server_name <IP>; на ваш домен (<your-domain>) для блоків HTTP (порт 80) і HTTPS (порт 443):

vim /etc/nginx/sites-available/etherpad

3. Встановіть Certbot:

apt install -y certbot python3-certbot-nginx

4. Виконайте наступну команду для отримання дійсного сертифіката Let's Encrypt:

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

5. Замініть шляхи SSL у конфігурації 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. Перезапустіть Nginx, щоб застосувати зміни:

systemctl restart nginx

7. Відкрийте браузер і перейдіть за адресою: https://yourdomain.com

Нотатки

• Etherpad працює за реверс-проксі Nginx для завершення SSL і підвищення безпеки.
• Самопідписаний сертифікат може спричинити попередження браузера — це очікувана поведінка, якщо не використовується Let's Encrypt.
• Деякі браузери можуть відображати помилки або порушувати коректну роботу Etherpad.
• Etherpad протестовано і підтверджено працездатним у Firefox, який рекомендується для найкращої сумісності.