Как nginx определяет главную страницу без index.html

Если в вашей директории /home/deploy/projects/site.ru/current/public нет файла index.html, но сайт все равно отображается, то nginx передает управление Passenger, а Passenger, в свою очередь, передает управление Rails приложению для обработки маршрутов.

Содержание

• Как nginx определяет главную страницу
• Роль Passenger в обработке запросов
• Правильная конфигурация для Rails приложений
• Пошаговая диагностика
• Решение проблемы с отображением
• Бест-практики для Rails + Nginx + Passenger

Как nginx определяет главную страницу

Когда nginx получает запрос на корневой URL (/), он выполняет следующие действия:

1. Проверяет наличие статических файлов в директории, указанной в директиве root (/home/deploy/projects/site.ru/current/public)
2. Ищет файлы, указанные в директиве index (по умолчанию: index.html index.htm)
3. Если находит index.html - отдает его как статический файл
4. Если не находит index.html - передает управление Passenger

В вашем случае, поскольку файла index.html нет в директории public, nginx передает управление Passenger, который и запускает ваше Rails приложение.

Роль Passenger в обработке запросов

Passenger работает как модуль nginx и автоматически обрабатывает Rails приложения:

Once you have obtained the value, open your Nginx configuration file and insert a passenger_root option somewhere with that value. This option enables or disables Passenger for that particular context. source

Когда Passenger получает запрос, он:

1. Запускает Rails приложение (если оно еще не запущено)
2. Передает запрос Rails маршрутизатору через Rack интерфейс
3. Rails определяет маршрут через файл config/routes.rb
4. Вызывает соответствующий контроллер и действие

В вашем случае Rails, скорее всего, имеет маршрут вида root 'pages#home' или аналогичный, который указывает, какое действие контроллера должно обрабатывать корневой URL.

Правильная конфигурация для Rails приложений

Ваша конфигурация правильная для Rails приложения:

server {
    listen 80;
    server_name www.site.ru site.ru;
    root /home/deploy/projects/site.ru/current/public;
    passenger_enabled on;
    rails_env production;
}

Важные моменты:

• Директива root должна указывать на директорию public вашего Rails приложения
• passenger_enabled on; включает поддержку Passenger для этого сервера
• rails_env production; устанавливает окружение Rails

In the above app we have created a variable response in pages_controller.rb which has the value "Hello World!. This variable is used to display the Hello World from the file app/views/pages/home.html.erb source

Пошаговая диагностика

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

1. Проверьте файл маршрутов

Откройте файл config/routes.rb вашего Rails проекта. Поищите строку вида:

root 'pages#home'
# или
root 'home#index'

2. Проверьте соответствующий контроллер

Если в маршрутах указан pages#home, проверьте файл app/controllers/pages_controller.rb:

class PagesController < ApplicationController
  def home
    @response = "Hello World!"
  end
end

3. Проверьте представление

Проверьте файл app/views/pages/home.html.erb или соответствующий файл для вашего маршрута.

Решение проблемы с отображением

Если сайт отображает не то, что вы ожидаете, возможные решения:

1. Проверьте журналы Rails

Просмотрите логи Rails для диагностики:

tail -f log/production.log

2. Проверьте конфигурацию Passenger

Убедитесь, что Passenger правильно настроен:

Inside the location block, set passenger_app_root source

3. Проверьте права доступа

Убедитесь, что у пользователя, от имени которого работает Passenger, есть доступ к директориям приложения.

Бест-практики для Rails + Nginx + Passenger

1. Структура директорий

/home/deploy/projects/site.ru/current/
├── app/
│   ├── controllers/
│   ├── views/
│   └── assets/
├── config/
│   └── routes.rb
└── public/          # сюда указывает nginx root
    ├── assets/
    ├── 404.html
    ├── 500.html
    └── robots.txt

2. Оптимальная конфигурация nginx

server {
    listen 80;
    server_name www.site.ru site.ru;
    
    # Важно: указываем на public директорию
    root /home/deploy/projects/site.ru/current/public;
    
    passenger_enabled on;
    rails_env production;
    
    # Оптимизация для статических файлов
    location ~ ^/assets/ {
        expires 1y;
        add_header Cache-Control public;
        add_header ETag "";
        break;
    }
    
    # Обработка ошибок
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root html;
    }
}

3. Проверка работоспособности

The settings are explained below. In this file, we enable listening on port 80, set your domain name, enable Passenger, and set the root to the public directory of our new project source

Чтобы проверить, правильно ли настроена главная страница:

1. Временно создайте файл index.html в директории public
2. Проверьте, что nginx отдает его
3. Удалите index.html и убедитесь, что Passenger передает управление Rails

Источники

1. How to configure nginx with passenger with rails application - Stack Overflow
2. Configuration reference - Nginx - Passenger Library
3. Deploying a Ruby application - Nginx - Passenger Library
4. How To Deploy a Rails App with Passenger and Nginx on Ubuntu 14.04 - DigitalOcean
5. Setup Rails with Nginx using Passenger - TO THE NEW Blog

Заключение

Главная страница вашего сайта определяется не статическим файлом index.html, а маршрутизацией Rails. Поскольку у вас нет index.html в директории public, nginx передает управление Passenger, который, в свою очередь, обращается к вашему Rails приложению.

Чтобы проверить, какая страница отображается как главная:

1. Посмотрите файл config/routes.rb - там должен быть маршрут для корневого URL
2. Проверьте соответствующий контроллер и представление
3. Просмотрите логи Rails для диагностики проблем

Ваша конфигурация nginx правильная - она указывает на директорию public и включает Passenger. Если контент отображается не так, как ожидается, проблема скорее всего в коде Rails приложения, а не в настройке nginx.