Следующий облачный docker-compose с nginx-proxy nginx 503

Вопрос или проблема

services:
  db:
    image: mariadb:10.11
    command: --transaction-isolation=READ-COMMITTED
    restart: always
    volumes:
      - /mnt/user/nextcloud-db:/var/lib/mysql:Z
    environment:
      - MYSQL_ROOT_PASSWORD=pass1
      - MYSQL_PASSWORD=pass2
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
    env_file:
      - /mnt/user/nextcloud-ssl/nextcloud-docker/db.env

  redis:
    image: redis:alpine
    restart: always

  app:
    image: nextcloud:apache
    restart: always
    volumes:
      - /mnt/user/nextcloud:/var/www/html:z
      # ПРИМЕЧАНИЕ: Конфигурация `volumes` контейнеров `cron` и `app` должна совпадать
    environment:
      - VIRTUAL_HOST=nextcloud.zaznet.net
      - DEFAULT_HOST=nextcloud.zaznet.net      
      - REDIS_HOST=redis
      - MYSQL_PASSWORD=pass2
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_HOST=db      
    env_file:
      - /mnt/user/nextcloud-ssl/nextcloud-docker/db.env
    depends_on:
      - db
      - redis
      - proxy
    networks:
      - eth0
      - default

  cron:
    image: nextcloud:apache
    restart: always
    volumes:
      - /mnt/user/nextcloud:/var/www/html:z
      # ПРИМЕЧАНИЕ: Конфигурация `volumes` контейнеров `cron` и `app` должна совпадать
    entrypoint: /cron.sh
    depends_on:
      - db
      - redis

  proxy:
    build: /mnt/user/nextcloud-ssl/nextcloud-docker/proxy
    restart: always
    ports:
      - 80:80
      - 443:443
    volumes:
      - /mnt/user/nextcloud-ssl/certs:/etc/nginx/certs:ro,z
      - /mnt/user/nextcloud-ssl/vhost.d:/etc/nginx/vhost.d:z
      - /mnt/user/nextcloud-ssl/html:/usr/share/nginx/html:z
      - /mnt/user/nextcloud-ssl/dhparam:/etc/nginx/dhparam:z
      - /var/run/docker.sock:/tmp/docker.sock:z,ro
    networks:
      - eth0

networks:
  nextcloud_default:
    driver: bridge
  eth0:
    external: true

ssl_certificate     certs/nextcloud.local.crt;
ssl_certificate_key     certs/nextcloud.local.key;

Ответ или решение

Конфигурация Docker Compose для запуска Nextcloud с поддержкой HTTPS через Nginx за счет использования уже имеющихся TLS-сертификата и ключа представляет некоторые сложности, особенно когда возникает ошибка "503 service unavailable". Такие ошибки часто связаны с неправильной конфигурацией прокси-сервера Nginx или с проблемами в сети контейнеров Docker. Давайте разберемся, почему возникает подобная ошибка, и как ее можно устранить.

Теория

Ошибка "503 service unavailable" указывает на то, что Nginx, выполняющий роль обратного прокси, не может связаться с соответствующим бэкенд-сервисом, в данном случае — с контейнером Nextcloud. Это может быть вызвано рядом причин:

1. Сетевая изоляция: Контейнеры могут быть в разных сетях или неправильно связанными.
2. Неправильная конфигурация виртуального хоста: Не полностью или неправильно настроенные файлы конфигурации Nginx.
3. Проблемы с сертификатами: Nginx может не считывать сертификаты, если они не имеют правильных прав доступа или путей.
4. Сбой в запуске Nginx: Неверные конфигурации могут вызвать постоянное перезапускание контейнера.

Пример

Исходя из предоставленного вами docker-compose.yml, у вас описаны сервисы db, redis, app и proxy. Проблема явно связана с конфигурацией прокси-сервера, так как именно Nginx выдает ошибку. Давайте разберем несколько возможных причин:

1. Сетевые конфигурации: Обратите внимание, что сервис app находится одновременно в сетях eth0 и default, в то время как proxy только в eth0. Это может вызвать проблемы с доступностью, так как Nginx может не видеть app.

2. Конфигурация виртуального хоста: Убедитесь, что файлы сертификатов доступны в контейнере и имеют правильные права доступа внутри него. Проверьте правильность путей в файле /mnt/user/nextcloud-ssl/vhost.d/nextcloud.local.

3. Логирование: Воспользуйтесь встроенными в контейнер Docker командами для анализа логов с nginx и docker для более глубокого понимания проблемы. Например:

   docker logs <имя-контейнера>

Применение

Чтобы устранить проблему, выполните следующие действия:

1. Проверка сетей: Пересмотрите настройки сетей. Возможно, стоит добавить proxy в сеть default, если она используется app. Это делается простым добавлением внутри секции networks для сервиса proxy:

   networks:
    - eth0
    - default

2. Права доступа к сертификатам: Проверьте, имеют ли сертификаты корректные права на чтение в системе. Все файлы, маппируемые внутрь контейнера, должны иметь права, которые позволяют nginx прочитать их:

   chmod 644 /mnt/user/nextcloud-ssl/certs/nextcloud.local.crt
   chmod 644 /mnt/user/nextcloud-ssl/certs/nextcloud.local.key

3. Логи Nginx и Docker: Исследуйте причины падения Nginx с помощью:

   docker logs <имя-контейнера-с-nginx>

   В логах может содержаться подсказка о причине проблем.

4. Проверка конфигурации Nginx: Проверьте корректность файла /mnt/user/nextcloud-ssl/vhost.d/nextcloud.local. Возможно, он не включает все необходимые настройки или имеет синтаксическую ошибку.

5. Используйте docker-compose up --build: Чтобы убедиться, что все изменения применены и все образцы построены заново. Это может решить проблемы кэширования.

6. Отключите временно HTTPS: Для диагностики проблема может быть временно упростить конфигурацию, убрав правила реррайта на HTTPS, чтобы удостовериться в исправности остальных компонентов.

Решение этих проблем значительно повысит шансы на правильный запуск Nextcloud с использованием Nginx как обратного прокси. Надеюсь, данные шаги помогут вам выявить и устранить источники ошибки 503. Подходя методично, возможно выяснить источник неполадок и обеспечить корректное функционирование сервиса.