Установка HedgeDoc через Docker Compose для self-hosted

HedgeDoc — это приложение для совместной работы с Markdown-заметками, которое позволяет нескольким пользователям редактировать документы в реальном времени. Установка через Docker Compose упрощает развертывание на любом сервере.

1 просмотр

HedgeDoc — это приложение для совместной работы с Markdown-заметками, которое позволяет нескольким пользователям редактировать документы в реальном времени. Установка через Docker Compose упрощает развертывание на любом сервере.

Требования

  • Docker: установленный и запущенный Docker Engine.
  • Docker Compose: установленный и запущенный Docker Compose.
  • Сервер: доступ к серверу с оперативной памятью не менее 128 МБ.
  • База данных: PostgreSQL или MongoDB, поддерживаемые HedgeDoc.
  • Интернет: для загрузки зависимостей и обновлений.

Подготовка

  1. Создайте отдельный каталог для хранения конфигурации и данных HedgeDoc:
  2. Загрузите официальный Docker-образ HedgeDoc с GitHub.
  3. Проверьте контрольную сумму образа, если она доступна.
  4. Создайте файл docker-compose.yaml в каталоге.
  5. Настройте переменные окружения и параметры безопасности.

Установка через Docker Compose

  1. Запустите контейнер с помощью команды docker-compose up -d.
  2. Проверьте статус контейнера с помощью docker ps.
  3. Дождитесь, пока все сервисы (база данных, веб-сервер) будут готовы.
  4. Откройте браузер и перейдите по адресу http://localhost:3000.
  5. Войдите в систему или зарегистрируйтесь для начала работы.

Настройка безопасности и HTTPS

  1. Настройте SSL-сертификаты с помощью Let’s Encrypt через Docker Compose.
  2. Используйте переменные окружения для хранения секретных данных, таких как пароли и API-ключи.
  3. Включите аутентификацию пользователей в настройках приложения.
  4. Настройте резервное копирование данных через интеграцию с облачными хранилищами.
  5. Регулярно обновляйте образы и зависимости для обеспечения безопасности.

Обновление и резервное копирование

  1. Остановите контейнер с помощью docker-compose down.
  2. Загрузите последнюю версию образа с GitHub.
  3. Создайте резервную копию данных перед обновлением.
  4. Запустите контейнер снова с docker-compose up -d.
  5. Проверьте логи и убедитесь, что все службы работают корректно.

Частые ошибки и решение

  1. Ошибка: «Cannot connect to database»: Проверьте настройки базы данных в docker-compose.yaml.
  2. Ошибка: «Port already in use»: Измените порт в конфигурации или остановите другие приложения, использующие этот порт.
  3. Ошибка: «Missing dependencies»: Убедитесь, что все зависимости установлены и доступны в сети.
  4. Ошибка: «Invalid SSL certificate»: Проверьте настройки Let’s Encrypt и SSL-сертификатов.
  5. Ошибка: «Authentication failed»: Убедитесь, что переменные окружения для аутентификации корректны.