Открыть Etherpad
- Пользовательский интерфейс:
https://<SERVER_IP> - Интерфейс администратора:
https://<SERVER_IP>/admin - Учётные данные администратора: имя пользователя
admin, пароль хранится в.envasADMIN_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. Выполните следующую команду, чтобы сгенерировать валидный сертификат 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 — его рекомендуется использовать для наилучшей совместимости.
