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

Stirling PDF — это современное решение для работы с PDF-файлами, которое сочетает в себе удобство, гибкость и безопасность. Приложение доступно как локальное приложение, веб-интерфейс и серверная версия, которая может быть развернута на собственных серверах.

Для установки Stirling PDF на собственном сервере рекомендуется использовать Docker Compose. Это позволяет быстро развернуть приложение без необходимости устанавливать дополнительные зависимости. Ниже приведены подробные шаги для установки и запуска.

Требования к серверу

• Современный компьютер с поддержкой Docker или Kubernetes.
• Доступ к интернету для загрузки образа.
• Рекомендуется использовать сервер с достаточным объемом памяти для обработки больших объемов данных.

Шаги установки Stirling PDF через Docker Compose

1. Установите Docker и Docker Compose: Скачайте и установите Docker с официального сайта https://www.docker.com/products/docker-desktop. Убедитесь, что Docker Compose установлен.
2. Создайте каталог для проекта: Выберите папку на сервере и создайте в ней новый каталог, например, /opt/stirling-pdf.
3. Создайте файл compose.yaml: В созданной папке создайте файл docker-compose.yml с следующим содержимым.
4. Запустите контейнер: Выполните команду docker-compose up -d, чтобы запустить Stirling PDF в фоновом режиме.
5. Проверьте статус контейнера: Используйте команду docker ps, чтобы убедиться, что контейнер работает.
6. Доступ к приложению: Откройте браузер и перейдите по адресу http://localhost:8080 для доступа к интерфейсу Stirling PDF.
7. Первый вход: Зарегистрируйтесь или войдите в систему, используя учетные данные, предоставленные в официальной документации.
8. Обновление: Для обновления приложения выполните команду docker-compose pull, а затем перезапустите контейнер с помощью docker-compose up -d.
9. Резервное копирование: Регулярно создавайте резервные копии данных и конфигурации, используя инструменты для сохранения состояния контейнера.
10. Безопасность: Настройте HTTPS для передачи данных между клиентом и сервером. Используйте SSO и аудит действий пользователей для повышения уровня безопасности.

Пример compose.yaml

version: '3.8'
services:
  stirling-pdf:
    image: docker.stirlingpdf.com/stirlingtools/stirling-pdf
    container_name: stirling-pdf
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    environment:
      - TZ=Europe/Moscow
    restart: unless-stopped

Замените ./data на путь к вашему каталогу для хранения данных. Убедитесь, что переменные окружения соответствуют вашим требованиям.

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

• Ошибка подключения: Проверьте, что порт 8080 открыт и не используется другими приложениями. Убедитесь, что Docker работает корректно.
• Ошибка загрузки образа: Убедитесь, что у вас есть доступ к интернету и что URL образа указан правильно в compose.yaml.
• Ошибка входа: Проверьте учетные данные и настройки аутентификации. Свяжитесь с поддержкой, если проблема сохраняется.