Ruby on Rails и Nginx: эффективно отдаем большие файлы

В этом посте я расскажу, как правильно настроить Nginx для максимально эффективной отдачи больших файлов из вашего rails приложения. К своему удивлению, на русском языке я такой информации не нашел. Есть статьи про использование X-Accel-Redirect совместно с php, а вот чтобы про рельсы да на родном языке что-то не густо… Вобщем, постараюсь восполнить этот пробел.

Задача

Итак, исходные данные следующие:

• мы используем Ruby on Rails, запросы пользователей проходят через Nginx;
• нам нужно отдавать большие файлы;
• файлы должны быть недоступны для прямого скачивания, решение об отдаче файла принимает rails приложение.

Решение

Как бы мне не хотелось избежать ссылок на англоязычные источники, но пройти мимо официальной документации я не могу. В Nginx есть замечательная штука X-Accel-Redirect, с помощью которой и решается наша задача. Сейчас я покажу, как заставить ее работать.

В нашем Rails приложении в файле config/environments/production.rb нужно раскоментировать строчку:

config.action_dispatch.x_sendfile_header = 'X-Accel-Redirect' # for nginx 

В конфигах nginx нужно добавить:

proxy_set_header  X-Accel-Mapping       /mnt/filestorage/=/private_files/;  location /private_files/ {   internal;   alias   /mnt/filestorage/; } 

Все. Настройка закончена. Давайте посмотрим, как все это работает на примере скачивания файла. На этом этапе считаем что Nginx и Rails приложение уже настроены и работают.

1. Браузер запрашивает файл

# HTTP заголовок GET /download/kino.avi HTTP/1.1 

2. Nginx получает этот запрос и передает его rails приложению, добавив еще один заголовок.

# конфиг Nginx proxy_set_header   X-Accel-Mapping       /mnt/filestorage/=/private_files/; 

# HTTP запрос GET /download/kino.avi HTTP/1.1 X-Accel-Mapping: /mnt/filestorage/=/private_files/ 

3. Контроллер rails приложения проверяет, можно ли отдать файл этому пользователю, и вызывает send_file. В этом месте важно использовать абсолютный путь.

# контроллер rails приложения (например app/controllers/downloads_controller.rb) send_file('/mnt/filestorage/kino.avi') 

4. Rails (точнее Rack) решает, что делать с этим файлом. Раньше на этом этапе содержимое файла включалось в тело ответа. Но мы поменяли настройки Rails приложения, и теперь вместо содержимого файла в ответе будет заголовок X-Accel-Redirect, который потом обработает Nginx. Тело ответа будет пустым. Также, меняется путь к файлу в соответствии с информацией из заголовка X-Accel-Mapping.

# конфигурация Rails (config/environments/production.rb) config.action_dispatch.x_sendfile_header = 'X-Accel-Redirect' 

# HTTP ответ HTTP/1.1 200 OK X-Accel-Redirect: /private_files/kino.avi Content-Type: application/octet-stream Content-length: ... Content-Disposition: attachment; filename="kino.avi" пустое тело ответа 

5. Nginx обрабатывает этот заголовок, находит подходящий location, меняет путь к файлу и отдает его пользователю.

# конфиг Nginx  location /private_files/ {     internal;     alias   /mnt/filestorage/; }

# HTTP ответ HTTP/1.1 200 OK Content-Type: application/octet-stream Content-Length: ... Content-Disposition: attachment; filename="kino.avi" <содержимое /mnt/filestorage/kino.avi> 

6. Браузер пользователя получает файл.

Если вы используете Passenger, то в конфигах Nginx’а нужно вместо proxy_set_header использовать passenger_set_cgi_param