Отладка Gunicorn + Nginx + Django

Я пытаюсь развернуть экземпляр readthedocs на своем сервере. Рекомендуемый способ развертывания — использовать Gunicorn + nginx с postgres. Поскольку фактически нет документации о том, как это сделать (кроме их fabfiles, которые, конечно, работают только на их сервере), я пытаюсь настроить свой собственный сервер вручную.

Вот мой nginx.conf:

server {
    listen 80 default;
    server_name mysite.com;
    access_log /var/log/nginx/mysite.access.log;
    error_log /var/log/nginx/mysite.error.log;

    location /favicon.ico {
        root /home/mysite/Code/checkout/readthedocs.org/media/images;
        break;
    }

    location robots.txt {
        root /home/mysite/Code/checkout/readthedocs.org/media;
        break;
    }

    location /static/ {
        alias /home/mysite/Code/checkout/readthedocs.org/media/;
        expires 30d;
        break;
    }

    location /media/ {
        alias /home/mysite/Code/checkout/readthedocs.org/media/;
        expires 30d;
        break;
    }

    location / {
        proxy_pass_header Server;
        proxy_set_header Host $http_host;
        proxy_redirect off;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Scheme $scheme;
        proxy_connect_timeout 10;
        proxy_read_timeout 10;
        proxy_pass http://127.0.0.1:8888;
    }
}

Файл settings.py для конфигурации django можно найти здесь. Единственное, что я изменил в settings.py, это добавил gunicorn в INSTALLED_APPS, чтобы я мог запустить его.

Команда, которую я использую для запуска сервера gunicorn:

./manage.py run_gunicorn -b 127.0.0.1:8888

Затем, если я пытаюсь получить доступ к 127.0.0.1 из локального браузера, это работает, но всегда показывает страницу 404, независимо от того, какой URL я ввожу. Запуск ./manage.py runserver работает корректно.

Теперь я не системный администратор и у меня практически 0 опыта с django, gunicorn или nginx раньше. Я искал в Google и экспериментировал с конфигурацией неделями, но без результатов. Мой вопрос:

1. Как я могу узнать, какой маршрут django вызывается gunicorn? Могу ли я это отладить? Все файлы журналов, которые я могу найти, это не показывают.
2. Вы видите что-то неправильное в моем конфигурационном файле? Если да, не могли бы вы сказать, что именно неправильно?

Большое спасибо.

Вы пробовали загрузить сайт на порту 8888, чтобы убедиться, что он работает правильно?

Сообщение 404, которое вы получаете, содержит nginx в тексте? Это означало бы, что nginx не может найти ресурс, а не служба на порту 8888. В этом случае вы можете устранить неполадки в вашем конфигурационном файле.

Вы ведете журнал доступа в nginx, так что вы можете посмотреть в ваш журнал для дополнительной информации. tail -n 10 /var/log/nginx/mysite.access.log покажет вам последние 10 строк этого журнала.

По умолчанию nginx использует формат журнала combined:

log_format combined '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';

Это должно помочь вам понять, что означает каждый столбец в вашем файле журнала.

Убедитесь, что вы правильно запускаете Gunicorn. Он должен запускаться из директории вашего проекта, и вы можете захотеть указать WSGI-приложение Django.
Пример:

gunicorn --bind 127.0.0.1:8888 myproject.wsgi:application

Замените myproject.wsgi:application на правильный путь импорта для вашего WSGI-приложения Django.

Отладьте маршруты и проверьте, какие представления вызываются; вы можете добавить журналирование в ваш проект Django, добавив это в ваш settings.py:

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'file': {
            'level': 'DEBUG',
            'class': 'logging.FileHandler',
            'filename': '/path/to/your/logs/django_debug.log',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['file'],
            'level': 'DEBUG',
            'propagate': True,
        },
    },
}

Убедитесь, что путь к файлу журнала существует и записываемый.

Когда вы запускаете Gunicorn, вы можете направить его вывод в файл журнала, чтобы записать любые проблемы. Например:

gunicorn --bind 127.0.0.1:8888 myproject.wsgi:application --log-file /path/to/your/logs/gunicorn.log

Убедитесь, что ваши PostgreSQL настройки в settings.py правильные и что база данных доступна. Неправильные настройки базы данных могут вызвать проблемы, которые могут быть не сразу очевидны.

Убедитесь, что ваши статические и медиафайлы правильно собраны и обслуживаются. Запустите эти команды:

./manage.py collectstatic
./manage.py migrate

Подтвердите, что Nginx, Gunicorn и PostgreSQL работают без ошибок.

sudo systemctl status nginx
sudo systemctl status gunicorn
sudo systemctl status postgresql

Убедитесь, что процесс Nginx имеет права на чтение для директорий, где хранятся ваши статические и медиафайлы.

Теперь вы должны быть в состоянии определить причину ошибок 404 и подтвердить, что ваше развертывание настроено правильно.