Как установить и настроить Nginx на Void Linux

Void Linux обрабатывает сервисы иначе, чем большинство дистрибутивов. Вместо того, чтобы систематизироваться, он использует runit, что означает, что включение и управление Nginx следует другой схеме, чем то, к чему вы привыкли на Debian или RHEL.

Предварительные условия

Сервер под управлением Void Linux.
Привилегии пользователя: пользователь root или не root с привилегиями sudo.

Конвенции

1
2
# - данные команды должны выполняться с правами root либо непосредственно от имени пользователя root, либо с помощью команды sudo.
$ - данные команды должны выполняться от имени обычного пользователя.

Обновите систему

Свежая установка Void Linux требует обновления пакетов до последних доступных версий.

1
sudo xbps-install -u xbps

После того, как xbps включен, запустите полное обновление системы.

1
sudo xbps-install -Syu

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

1
sudo reboot -f

Установите Nginx Web Server

Установите пакет Nginx из хранилища Void:

1
sudo xbps-install nginx

Подтвердите установленную версию:

1
nginx -v

На выходе должна быть показана версия 1.28.3 или новее:

1
nginx version: nginx/1.28.3

Void Linux использует runit вместо системного. Чтобы включить услугу, вы создаёте симлинк из /etc/sv/ в /var/service/. Runit поднимает его автоматически в течение нескольких секунд.

1
sudo ln -s /etc/sv/nginx /var/service/nginx

Дайте ему пару секунд, затем убедитесь, что Nginx работает:

1
sudo sv status nginx

На выходе должна отображаться услуга с PID и временем безотказной работы:

1
run: nginx: (pid 1842) 5s

Настройка Nginx

Void Linux поставляется с Nginx с минимальной конфигурацией по умолчанию. Замените его готовой к производству конфигурацией, которая включает в себя правильные настройки рабочего, сжатие gzip и блок сервера, указывающий на пользовательский корень документа.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
sudo tee /etc/nginx/nginx.conf > /dev/null <<'EOF'
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log warn;
pid /run/nginx.pid;

events {
    worker_connections 1024;
    multi_accept on;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

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

    access_log /var/log/nginx/access.log main;

    sendfile        on;
    tcp_nopush      on;
    tcp_nodelay     on;
    keepalive_timeout 65;
    types_hash_max_size 2048;
    server_tokens off;

    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 5;
    gzip_min_length 256;
    gzip_types
        text/plain
        text/css
        application/json
        application/javascript
        text/xml
        application/xml
        application/xml+rss
        text/javascript
        image/svg+xml
        application/x-font-ttf
        font/opentype;

    include /etc/nginx/conf.d/*.conf;

    server {
        listen 80 default_server;
        server_name _;
        root /srv/www/nginx;
        index index.html index.htm;

        location / {
            try_files $uri $uri/ =404;
        }
    }
}
EOF

Void Linux не создает корень документа по умолчанию для Nginx, поэтому его нужно создавать вручную:

1
sudo mkdir -p /srv/www/nginx

Также создайте каталог conf.d для виртуальных конфигураций хоста и каталог журнала:

1
2
sudo mkdir -p /etc/nginx/conf.d
sudo mkdir -p /var/log/nginx

Проверьте синтаксис конфигурации и перезагрузите.

1
sudo nginx -t && sudo sv reload nginx

Тестирование страницы Default

Создайте простую HTML-страницу в корне документа, чтобы подтвердить, что Nginx обслуживает файлы правильно.

1
echo '<!DOCTYPE html><html><head><title>Nginx on Void Linux</title></head><body><h1>Nginx is working on Void Linux</h1></body></html>' | sudo tee /srv/www/nginx/index.html

Испытайте его с помощью curl:

1
curl -s http://localhost

Ответ должен содержать вашу тестовую страницу HTML:

1
<!DOCTYPE html><html><head><title>Nginx on Void Linux</title></head><body><h1>Nginx is working on Void Linux</h1></body></html>

Если вы видите выход HTML, Nginx обслуживает контент из /srv/www/nginx, как и ожидалось.

Настройка PHP-FPM

Большинство веб-приложений (WordPress, MediaWiki, Nextcloud) требуют PHP. На Void Linux PHP-FPM работает как отдельный сервис, на который Nginx пересылает запросы.

Установите PHP-FPM вместе с обычно необходимыми расширениями:

1
sudo xbps-install php-fpm php-mysql php-gd php-intl

PHP-FPM 8.4 на Void Linux прослушивает 127.0.0.1:9000 по умолчанию и работает под _phpfpm пользователем и группой. Никаких изменений в конфигурации не требуется для стандартной настройки.

Включите службу PHP-FPM:

1
sudo ln -s /etc/sv/php-fpm8.4 /var/service/php-fpm8.4

Убедитесь, что сервис работает:

1
sudo sv status php-fpm8.4

Ожидаемый результат:

1
run: php-fpm8.4: (pid 2156) 3s

Расширения установлены, но не включены автоматически. PHP на Void считывает дополнительные файлы конфигурации из /etc/php8.4/conf.d/. Создайте этот каталог и включите расширения:

1
sudo mkdir -p /etc/php8.4/conf.d

После установки каждому расширению требуется активировать файл *.ini в каталоге conf.d:

1
2
3
4
echo "extension=mysqli.so" | sudo tee /etc/php8.4/conf.d/mysqli.ini
echo "extension=pdo_mysql.so" | sudo tee /etc/php8.4/conf.d/pdo_mysql.ini
echo "extension=gd.so" | sudo tee /etc/php8.4/conf.d/gd.ini
echo "extension=intl.so" | sudo tee /etc/php8.4/conf.d/intl.ini

Проверьте, загружаются ли расширения:

1
php -m | grep -i mysql

Все три модуля, связанные с MySQL:

1
2
3
mysqli
mysqlnd
pdo_mysql

Перезагрузите Nginx еще раз, чтобы получить новые расширения:

1
sudo sv reload nginx

Теперь настройте Nginx для передачи запросов PHP на PHP-FPM. Откройте основной файл конфигурации и добавьте блок местоположения для PHP в блок сервера:

1
sudo nano /etc/nginx/nginx.conf

Добавить следующий блок расположения внутри раздела server { } после существующего location / блока:

1
2
3
4
5
6
        location ~ \.php$ {
            fastcgi_pass 127.0.0.1:9000;
            fastcgi_index index.php;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            include fastcgi_params;
        }

Также обновите директиву index в блоке сервера, чтобы включить index.php:

1
        index index.php index.html index.htm;

Проверьте синтаксис конфигурации и перезагрузите.

1
sudo nginx -t && sudo sv reload nginx

Создайте страницу информации PHP для проверки работы интеграции:

1
echo '<?php phpinfo(); ?>' | sudo tee /srv/www/nginx/info.php

Проверьте:

1
curl -s http://localhost/info.php | head -5

Вы должны увидеть выход HTML, содержащий информацию о версии PHP. Если вы получаете пустую страницу или «Файл не найден», дважды проверьте, что SCRIPT FILENAME использует $document root и что /srv/www/nginx/info.php существует.

Удалите страницу с информацией после подтверждения работы PHP. Оставить его открытым - это риск безопасности:

1
sudo rm /srv/www/nginx/info.php

Виртуальные хосты Nginx

Чтобы обслуживать несколько веб-сайтов из одного экземпляра Nginx, используйте отдельные блоки сервера. Основной nginx.conf уже включает в себя /etc/nginx/conf.d/*.conf, поэтому каждый виртуальный хост получает свой собственный файл в этом каталоге.

Создайте виртуальную конфигурацию хоста для выборочного домена:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
sudo tee /etc/nginx/conf.d/example.com.conf > /dev/null <<'EOF'
server {
    listen 80;
    server_name example.com www.example.com;
    root /srv/www/example.com;
    index index.php index.html;

    access_log /var/log/nginx/example.com.access.log;
    error_log /var/log/nginx/example.com.error.log;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~* \.(css|js|jpg|jpeg|png|gif|ico|svg|woff|woff2)$ {
        expires 30d;
        add_header Cache-Control "public, no-transform";
    }
}
EOF

Создайте виртуальную конфигурацию хоста для выборочного домена:

1
sudo mkdir -p /srv/www/example.com

Для дополнительных доменов повторите процесс: создайте новый файл .conf в /etc/nginx/conf.d с соответствующими директивами server name и root. Каждый сайт остается изолированным в своем собственном файле конфигурации, что делает обслуживание простым

Тестирование и перезагрузка после добавления виртуального хоста:

1
sudo nginx -t && sudo sv reload nginx

SSL/TLS с функцией Let’s Encrypt

Установите Certbot и его плагин Nginx.

1
sudo xbps-install certbot certbot-nginx

Получить сертификат. Certbot автоматически изменит блок вашего сервера, чтобы включить HTTPS и настроить перенаправление с HTTP.

1
sudo certbot --nginx -d example.com -d www.example.com

Следуйте интерактивным подсказкам. Certbot создает файлы сертификатов под /etc/letsencrypt/live/example.com/ и вводит в конфигурацию директивы ssl certificate и ssl certificate key.

Тестирование процесса обновления без внесения изменений.

1
sudo certbot renew --dry-run

Если вы предпочитаете ручную конфигурацию SSL без изменения файлов Certbot, сгенерируйте сертификат с помощью флага certonly и настройте блок сервера самостоятельно.

1
sudo certbot certonly --nginx -d example.com -d www.example.com

Затем обратитесь к сертификату в блоке сервера.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
sudo tee /etc/nginx/conf.d/example.com.conf > /dev/null <<'EOF'
server {
    listen 443;
    server_name example.com www.example.com;
    root /srv/www/example.com;
    index index.php index.html;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;
    ssl_ciphers         HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 10m;

    access_log /var/log/nginx/example.com.access.log;
    error_log /var/log/nginx/example.com.error.log;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~* \.(css|js|jpg|jpeg|png|gif|ico|svg|woff|woff2)$ {
        expires 30d;
        add_header Cache-Control "public, no-transform";
    }
}
EOF

Заголовки безопасности

Заголовки безопасности защищают ваших посетителей от распространенных веб-атак. Добавьте их в блок сервера или в общий файл фрагмента, который вы включаете с каждого виртуального хоста.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
# Enforce HTTPS for one year, include subdomains
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;

# Prevent your site from being embedded in iframes on other domains
add_header X-Frame-Options "SAMEORIGIN" always;

# Block MIME-type sniffing
add_header X-Content-Type-Options "nosniff" always;

# Basic Content Security Policy - adjust to match your site's needs
add_header Content-Security-Policy "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self';" always;

# Control referrer information sent with requests
add_header Referrer-Policy "strict-origin-when-cross-origin" always;

# Restrict browser features
add_header Permissions-Policy "geolocation=(), microphone=(), camera=()" always;

После добавления этих заголовков используйте такой инструмент, как curl -I https://example.com, чтобы убедиться, что они отправляются правильно. Настройка политики безопасности контента в соответствии с вашим приложением. Чрезмерно ограничительная политика нарушает функциональность; чрезмерно разрешительная политика снижает защиту.

Ограничение ставок и лимиты подключения

Ограничение скорости защищает ваш сервер от грубых атак и оскорбительного трафика. Определите общую зону памяти в блоке http, затем нанесите ее в определенные места.

1
2
3
4
# Define zones in the http {} block
limit_req_zone $binary_remote_addr zone=general:10m rate=10r/s;
limit_req_zone $binary_remote_addr zone=login:10m rate=1r/s;
limit_conn_zone $binary_remote_addr zone=addr:10m;

Применяйте ограничения внутри вашего сервера или блоков местоположения.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
server {
    listen 80;
    server_name example.com;

    # Allow burst of 20 requests, then enforce 10r/s
    limit_req zone=general burst=20 nodelay;

    # Limit each IP to 50 simultaneous connections
    limit_conn addr 50;

    location /login {
        # Stricter rate limit on login endpoints
        limit_req zone=login burst=5 nodelay;
        proxy_pass http://127.0.0.1:3000;
    }

Параметр burst очередей излишних запросов, а не отклоняет их немедленно. Добавление процессов nodelay без задержек разрывает запросы, но по-прежнему считает их против ставки. При заполнении очереди Nginx возвращает статус 503.

Вы можете настроить ответ на ошибку для запросов с ограниченной скоростью.

1
limit_req_status 429;

Журналы доступа и журналы ошибок

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

1
2
3
4
5
# Custom log format in the http {} block
log_format main '$remote_addr - $remote_user [$time_local] '
                '"$request" $status $body_bytes_sent '
                '"$http_referer" "$http_user_agent" '
                '$request_time $upstream_response_time';

Применяйте пользовательский формат к конкретному виртуальному хосту.

1
2
    access_log /var/log/nginx/example.com.access.log main;
    error_log  /var/log/nginx/example.com.error.log warn;

Уровни журнала ошибок от наименее до наиболее многословных: emerg, alert, crit, error, warning, notice, info, debug. Для производства warn или error - это хороший баланс между видимостью и шумом.

Чтобы отключить регистрацию доступа для определенных путей (например, проверки здоровья), используйте этот шаблон.

1
2
3
4
    location = /health {
        access_log off;
        return 200 "OK\n";
    }

Настройте вращение журнала с помощью logrotate (уже настроенного пакетом Nginx) или проверьте существующую конфигурацию.

1
cat /etc/logrotate.d/nginx

Тюнинг производительности

Конфигурация Nginx по умолчанию работает для легких рабочих нагрузок. При более интенсивном трафике настройки этих параметров в /etc/nginx/nginx.conf. Конф делает измеримую разницу.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
# Set to 'auto' to match the number of CPU cores
worker_processes auto;

# Maximum open files per worker - raise this on busy servers
worker_rlimit_nofile 65535;

events {
    # Each worker can handle this many simultaneous connections
    worker_connections 4096;

    # Accept multiple connections at once
    multi_accept on;

    # Use epoll on Linux for better performance
    use epoll;
}

http {
    # Keep connections alive to avoid TCP handshake overhead
    keepalive_timeout 65;
    keepalive_requests 1000;

    # Buffer sizes for proxied responses
    proxy_buffer_size 128k;
    proxy_buffers 4 256k;
    proxy_busy_buffers_size 256k;

    # Client body and header limits
    client_max_body_size 50m;
    client_body_buffer_size 128k;
    client_header_buffer_size 1k;
    large_client_header_buffers 4 16k;

    # File serving optimizations
    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;

    # Cache open file descriptors
    open_file_cache max=10000 inactive=30s;
    open_file_cache_valid 60s;
    open_file_cache_min_uses 2;
    open_file_cache_errors on;
}

Проверьте синтаксис конфигурации и перезагрузите.

1
sudo nginx -t && sudo sv reload nginx

Завершение

Это руководство охватывало производственную установку Nginx с нуля на Void Linux.

Вы установили последнюю стабильную сборку из официального репозитория Nginx, настроили виртуальные хосты, интегрировали PHP-FPM, автоматизировали сертификаты TLS с Let’s Encrypt, включили HTTP/2 и HTTP/3, затвердели сервер с заголовками безопасности и ограничением скорости, настроили сжатие и производительность.

Nginx - лучший выбор для обратного прокси-сервера, обслуживания статического контента и обработки высокой параллели. Apache имеет больше смысла, если вам нужна поддержка .htaccess или вы мигрируете устаревшее приложение, которое зависит от правил mod_rewrite.

Предварительные условия#

Конвенции#

Обновите систему#

Установите Nginx Web Server#

Настройка Nginx#

Тестирование страницы Default#

Настройка PHP-FPM#

Виртуальные хосты Nginx#

SSL/TLS с функцией Let’s Encrypt#

Заголовки безопасности#

Ограничение ставок и лимиты подключения#

Журналы доступа и журналы ошибок#

Тюнинг производительности#

Завершение#

Предварительные условия

Конвенции

Обновите систему

Установите Nginx Web Server

Настройка Nginx

Тестирование страницы Default

Настройка PHP-FPM

Виртуальные хосты Nginx

SSL/TLS с функцией Let’s Encrypt

Заголовки безопасности

Ограничение ставок и лимиты подключения

Журналы доступа и журналы ошибок

Тюнинг производительности

Завершение