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

Дата публикации: 2026-04-10T11:16:32

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

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

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

Конвенции

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

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

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

sudo xbps-install -u xbps

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

sudo xbps-install -Syu

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

sudo reboot -f

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

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

sudo xbps-install nginx

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

nginx -v

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

nginx version: nginx/1.28.3

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

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

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

sudo sv status nginx

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

run: nginx: (pid 1842) 5s

Настройка Nginx

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

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, поэтому его нужно создавать вручную:

sudo mkdir -p /srv/www/nginx

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

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

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

sudo nginx -t && sudo sv reload nginx

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

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

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:

curl -s http://localhost

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

<!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 вместе с обычно необходимыми расширениями:

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:

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

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

sudo sv status php-fpm8.4

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

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

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

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

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

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

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

php -m | grep -i mysql

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

mysqli
mysqlnd
pdo_mysql

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

sudo sv reload nginx

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

sudo nano /etc/nginx/nginx.conf

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

        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`:

        index index.php index.html index.htm;

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

sudo nginx -t && sudo sv reload nginx

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

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

Проверьте:

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

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

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

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

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

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

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

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

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

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

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

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

sudo nginx -t && sudo sv reload nginx

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

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

sudo xbps-install certbot certbot-nginx

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

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

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

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

sudo certbot renew --dry-run

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

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

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

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

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

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

# 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, затем нанесите ее в определенные места.

# 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;

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

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.

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

limit_req_status 429;

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

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

# 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';

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

    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` - это хороший баланс между видимостью и шумом.

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

    location = /health {
        access_log off;
        return 200 "OK\n";
    }

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

cat /etc/logrotate.d/nginx

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

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

# 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;
}

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

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.