Etherpad

Открыть Etherpad

• Пользовательский интерфейс: https://<SERVER_IP>
• Интерфейс администратора: https://<SERVER_IP>/admin
• Учётные данные администратора: имя пользователя admin, пароль хранится в .env as ADMIN_PASSWORD

Добавьте пользователей через настройки администратора

1. Перейдите по адресу: https://<SERVER_IP>/admin

2. Go в раздел «Настройки».

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. Нажмите «Save Settings».

7. Нажмите «Restart 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. Выполните следующую команду, чтобы получить SSL-сертификат от 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 — его рекомендуется использовать для наилучшей совместимости.