Этерпад

Доступ к Этерпаду

• Пользовательский интерфейс: 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, который рекомендуется для обеспечения наилучшей совместимости.