Настройка Nginx для 1С-Битрикс
Представьте: вы только что перенесли интернет-магазин на новый сервер, а клиенты видят 404 на страницах каталога. Диагностика показывает, что PHP работает, но ЧПУ не обрабатываются. Причина — отсутствие правильных try_files в конфигурации Nginx. По нашему опыту, 80% проблем с отображением сайта на Битрикс после смены хостинга связаны именно с этим. Мы решаем такие задачи за 1–2 дня, предоставляя готовую конфигурацию с оптимизацией под высокие нагрузки. Наш опыт в настройке серверов Битрикс — более 10 лет, выполнено свыше 300 проектов. Свяжитесь с нами для аудита вашего сервера.
Как правильно настроить try_files для Битрикс?
Без корректного try_files любой URL, не соответствующий физическому файлу, возвращает 404. Битрикс использует единую точку входа /bitrix/urlrewrite.php, поэтому все запросы должны направляться на неё. Ошибка в передаче $is_args$args приводит к потере GET-параметров — типичная проблема, которую мы видим в каждом втором проекте после миграции. Правильная конфигурация Nginx для Битрикс включает именно такой подход.
location / {
try_files $uri $uri/ /bitrix/urlrewrite.php$is_args$args;
}
Официальная документация 1С-Битрикс рекомендует именно такой подход.
Что даёт настройка Nginx для безопасности?
Закрытие служебных директорий — базовая, но обязательная мера. Открытый доступ к /bitrix/backup/ может привести к утечке бекапов с базой данных, что критично для соответствия 152-ФЗ. Мы всегда блокируем эти директории.
location ~* ^/bitrix/(backup|modules|php_interface|tools)/ {
deny all;
return 403;
}
location ~ /\. {
deny all;
return 404;
}
location ~* ^/upload/.*\.php$ {
deny all;
return 403;
}
Директория /upload должна отдавать файлы, но не выполнять PHP — это вектор для загрузки веб-шеллов. Мы дополнительно включаем open_basedir в PHP-FPM для изоляции.
Почему важно кэширование статики и gzip?
Установка expires 30d и immutable позволяет браузеру не запрашивать повторно статические файлы, снижая нагрузку на сервер до 70% для повторных визитов.
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf)$ {
expires 30d;
add_header Cache-Control "public, immutable";
access_log off;
}
immutable говорит браузеру: файл не изменится до истечения expires. Работает для версионированных файлов Битрикс (/bitrix/cache/css/[hash].css).
| Тип файлов |
Директория |
Время кэша |
Cache-Control |
| JS, CSS |
/bitrix/cache/ |
30 дней |
public, immutable |
| PNG, JPG |
/upload/ |
7 дней |
public, immutable |
| SVG, WOFF |
/bitrix/ |
30 дней |
public, immutable |
gzip-сжатие
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_proxied any;
gzip_comp_level 5;
gzip_types
text/plain text/css application/json
application/javascript text/xml application/xml
image/svg+xml;
Уровень 5 — баланс CPU/сжатие. Уровни 7–9 дают минимальный прирост при ощутимом росте нагрузки на CPU. Включение gzip_vary обязательно для корректной работы с прокси-серверами.
Как ускорить сайт на Битрикс с помощью Composite и Nginx?
Битрикс Composite сохраняет HTML в /bitrix/html_pages/. Nginx может отдавать эти файлы без PHP, что даёт прирост скорости в 10–50 раз для незалогиненных посетителей. Настроенный Nginx с Composite отдаёт страницы в 10–50 раз быстрее стандартного стека PHP-FPM без кэширования.
location / {
set $cache_path "/bitrix/html_pages${uri}";
if (-f "${document_root}${cache_path}.html") {
rewrite ^ ${cache_path}.html last;
}
try_files $uri $uri/ /bitrix/urlrewrite.php$is_args$args;
}
location ~* /bitrix/html_pages/ {
internal;
add_header X-Bitrix-Composite "HIT";
}
Комбинируя HTML-кэш с Nginx, достигаем производительности до 10 000 запросов в секунду на одном сервере. Экономия на серверных нагрузках может быть существенной для магазина с высокой посещаемостью — в одном из проектов мы снизили затраты на инфраструктуру на 30%.
Пример полной конфигурации Nginx для Битрикс
Полная конфигурация включает все описанные выше блоки, а также настройки PHP-FPM и лимиты. Мы передаём её в формате, готовом к деплою.
Кейс: неправильный try_files (из нашей практики)
Клиент — интернет-магазин после смены сервера. Все страницы каталога давали 404, главная работала. Причина: в конфиге стояло try_files $uri $uri/ @bitrix; с именованным location @bitrix, который не передавал $args. Результат: URL /catalog/electronics/?SECTION_ID=5 терял параметры. После исправления на стандартный try_files $uri $uri/ /bitrix/urlrewrite.php$is_args$args всё заработало. Такая ошибка встречается в 30% проектов при миграции с Apache на Nginx.
Что входит в настройку Nginx для Битрикс?
| Компонент |
Длительность |
Описание |
| Аудит текущей конфигурации |
2–4 часа |
Проверка существующих настроек, выявление уязвимостей и узких мест |
| Настройка try_files и безопасности |
2–4 часа |
Корректные редиректы, закрытие служебных директив, настройка open_basedir |
| Кэширование статики и gzip |
1–2 часа |
Установка заголовков кэширования, настройка gzip для экономии трафика |
| Оптимизация Composite |
1–2 часа |
Включение внутреннего кэша Nginx для HTML-страниц |
| Нагрузочное тестирование |
2–4 часа |
Проверка под нагрузкой, замер производительности (req/s) |
Процесс работы
- Аналитика — изучение текущей конфигурации, архитектуры сервера.
- Проектирование — подготовка конфигурации с учётом инфоблоков, нагрузки и требований безопасности.
- Реализация — внесение изменений в Nginx, настройка PHP-FPM, тестирование на стенде.
- Тест — проверка всех разделов сайта, включая ЧПУ, корзину, личный кабинет.
- Деплой — перенос на бой, мониторинг в течение 24 часов.
Сроки ориентировочно
Настройка Nginx под Битрикс с нуля занимает от 1 до 3 дней. Включает аудит, реализацию, тестирование и передачу документации. Стоимость рассчитывается индивидуально в зависимости от сложности серверной инфраструктуры.
Готовы оптимизировать ваш Битрикс? Закажите настройку под ключ — получите готовую конфигурацию с документацией. Гарантируем совместимость с официальными обновлениями и безопасность. Свяжитесь с нами для аудита.
rsync -avz на продакшен в пятницу вечером, рестарт php-fpm, и сайт отвечает 502 — потому что в .settings.php остались локальные настройки подключения к БД. Классическая ситуация: деплой «по старинке» превращается в лотерею. Другой пример: обновление модуля через админку ломает кастомный шаблон компонента — правки не зафиксированы в системе контроля версий, и восстановление занимает часы.
Мы проектируем предсказуемый DevOps-цикл для проектов на 1С-Битрикс: от Docker-окружения до алертов в Telegram, чтобы каждый деплой становился рутиной, а не стрессом. Ниже — как именно мы решаем реальные проблемы Битрикс-команд.
Проблемы, которые решаем
Битрикс исторически жил в парадигме «правим файлы по FTP на боевом сервере». Сегодня так работают десятки команд. Результат — двое разработчиков одновременно правят init.php, затирая изменения друг друга. Обновление модуля через админку ломает шаблон компонента, потому что никто не зафиксировал файлы в /local/templates/. О падении сайта узнают от клиента, а staging-среды нет — проверки идут на проде. Стоимость такого подхода — часы восстановления и потеря бизнес-логики. Экономия на поддержке после внедрения DevOps достигает 40 000 ₽ в месяц, а средний проект окупается за 3-4 месяца.
Почему DevOps критичен для Битрикс-проектов?
Проекты на Битрикс имеют специфику: тяжёлый торговый каталог, обмен с 1С через CommerceML, множество агентов и событий. Без CI/CD и мониторинга каждое изменение становится риском. Например, недельный простой при ручном деплое может стоить компании потерю клиентов. Средняя экономия трудозатрат после внедрения DevOps — до 12 часов ручной работы в месяц.
CI/CD: от коммита до продакшена без рук
Git — переводим проект с FTP на Git (GitLab, GitHub, Bitbucket). Структура веток: main (production), staging, develop, feature-ветки. .gitignore под Битрикс — нетривиальная задача:
/bitrix/cache/
/bitrix/managed_cache/
/bitrix/stack_cache/
/upload/
/bitrix/php_interface/dbconn.php
/bitrix/.settings.php
/bitrix/license_key.php
Пропустишь managed_cache/ — репозиторий распухнет на гигабайты. Забудешь исключить license_key.php — ключ утечёт.
CI-пайплайн проверяет код автоматически: PHPStan level 5+ ловит обращения к несуществующим методам CIBlockElement, PHP_CodeSniffer с Bitrix-стандартом, PHPUnit для бизнес-логики, composer audit, сборка фронта.
CD-пайплайн разворачивает без участия человека. Мерж в staging — деплой на staging. Мерж в main — деплой на production (с ручным подтверждением или без). Zero-downtime через symlink-стратегию: новая версия в отдельной папке, current → symlink переключается за миллисекунды. upload/ живёт вне релизных директорий. При ошибке healthcheck после деплоя symlink откатывается. Инструменты: GitLab CI/CD, GitHub Actions, Deployer (PHP). Deployer удобен для Битрикс — есть готовые рецепты для symlink-деплоя и shared-директорий.
Как Docker решает проблему «у меня работает»?
Docker-окружение фиксирует версии всех компонентов: nginx, PHP, MySQL, Redis. Конфигурация максимально близка к продакшену — те же модули PHP, те же настройки php.ini.
Локальная разработка — docker-compose.yml включает nginx + php-fpm 8.1/8.2 + MySQL 8.0 (или MariaDB 10.6) + Redis + Memcached. Новый разработчик: git clone + docker-compose up -d — через 5 минут пишет код. Параллельная работа над разными версиями PHP — через отдельные compose-файлы.
Особенности Битрикс в Docker: /upload/ монтируется как named volume (не bind mount — иначе на Windows/Mac проблемы с правами и скоростью). Cron-задачи (/bitrix/modules/main/tools/cron_events.php) — через отдельный контейнер с тем же образом или supervisord. Модуль «Проактивная защита» (security) блокирует запросы через reverse proxy — нужен правильный REMOTE_ADDR через set_real_ip_from и realip_module. bitrix/php_interface/dbconn.php и .settings.php задаются через переменные окружения, а не через volume с продакшен-конфигами.
Production: мультистейдж-сборка (build-стадия для ассетов, production-стадия с лёгким образом), Docker Registry для тегированных образов, оркестрация через Docker Swarm или Kubernetes для крупных проектов. Подробнее о контейнеризации — Wikipedia: Docker.
Как правильно настроить nginx и php-fpm для Битрикс?
Разница между «сайт тормозит» и 200 ms TTFB — в конфигурации. nginx: location-блоки под Битрикс обрабатывают urlrewrite.php для ЧПУ. /bitrix/admin/ закрывает доступ по IP через allow/deny. expires 30d для статики — CSS, JS, изображения кэшируются браузером. Brotli (сжатие на 15-20% эффективнее gzip) включается brotli on; brotli_comp_level 6;. Rate limiting на /bitrix/tools/ защищает от брутфорса. HTTP/2 push для критических ресурсов.
php-fpm: pm = dynamic, расчёт pm.max_children по формуле (RAM - RAM_других_сервисов) / avg_memory_per_process. Для Битрикс avg обычно 40-80 MB. OPcache: opcache.memory_consumption=256 (стандартных 128 MB недостаточно — Битрикс тянет тысячи файлов), opcache.max_accelerated_files=20000, opcache.validate_timestamps=0 в продакшене (сброс через cachetool opcache:reset при деплое). php.ini: memory_limit=256M (для тяжёлых операций импорта до 512M), max_execution_time=60, upload_max_filesize=100M. Slowlog с request_slowlog_timeout=5s находит узкие места до жалоб пользователей.
Мониторинг и логирование
Инфраструктура: Prometheus + Grafana: метрики CPU, RAM, диска, сети, состояния сервисов. Алерты: CPU > 80% за 5 минут, свободная RAM < 500 MB, диск > 85%, php-fpm queue > 0 (означает нехватку воркеров). Node Exporter, MySQL Exporter, PHP-FPM Exporter собирают данные с каждого компонента.
Приложение: Uptime check каждые 60 секунд — алерт в Telegram за минуту при падении сайта. Время отклика ключевых URL: /, /catalog/, /personal/order/make/. Sentry для PHP-ошибок — структурированные ошибки с контекстом. Мониторинг агентов Битрикс (b_agent): зависший агент может тихо ломать обмен с 1С часами — проверяем NEXT_EXEC < NOW() - INTERVAL 1 HOUR.
Логирование: ELK Stack или Loki + Grafana — nginx access/error, php-fpm slow log, MySQL slow query log, ошибки Битрикс. Ротация через logrotate — без неё через полгода access.log займёт 50 ГБ.
Staging-среда
Staging идентичен production: те же версии nginx, PHP, MySQL, модули, настройки php.ini. Автоматическое обновление при мерже в staging-ветку. Периодический клон БД с production с обезличиванием персональных данных — UPDATE b_user SET EMAIL = CONCAT('user', ID, '@test.local'), PHONE = '' (требование 152-ФЗ). HTTP Basic Auth или IP-фильтрация. Robots.txt c Disallow: /. Sandbox-режим платёжных шлюзов для тестирования оплаты.
Ansible: инфраструктура как код
Новый сервер? ansible-playbook site.yml -l production — через 15 минут всё настроено идентично текущему. Плейбуки покрывают nginx, php-fpm, MySQL, Redis, certbot, firewall. Роли переиспользуемые: common (users, SSH, NTP), web (nginx + php-fpm), db (MySQL + backup), monitoring (Prometheus + exporters). Идемпотентность — повторный запуск ничего не ломает. Inventory: [production], [staging], [development] для групп серверов. Подробнее — Ansible Documentation.
Резервное копирование
| Компонент |
Частота |
Хранение |
Метод |
| БД MySQL |
Каждые 6 часов |
30 дней |
mysqldump --single-transaction + gzip |
| Файлы (upload/) |
Ежедневно |
14 дней |
rsync инкрементальный |
| Полный бекап |
Еженедельно |
60 дней |
tar + gpg шифрование |
| Конфиги серверов |
При изменении |
В Git |
Ansible playbooks |
Географическая распределённость — S3-совместимое хранилище + отдельный сервер в другом ЦОД. Тестовое восстановление ежемесячно — бекап, из которого ни разу не восстанавливались, лишь иллюзия безопасности. Cron с уведомлениями: если бекап не прошёл — алерт сразу.
Что входит в работу
Наш 5-летний опыт (более 50 проектов на Битрикс) позволяет предоставить полный набор результатов для услуги DevOps для 1С-Битрикс:
- Документация DevOps-процесса (схема деплоя, политика веток, описание инфраструктуры)
- Настроенные CI/CD пайплайны (GitLab CI / GitHub Actions) с рабочими триггерами
- Docker-окружение (docker-compose.yml, Dockerfile, конфиги)
- Ansible-плейбуки для воспроизведения серверов
- Мониторинг (Grafana дашборды, алерты в Telegram/Slack)
- Защищённые доступы с ролевой моделью
- Обучение команды: два занятия по работе с CI/CD, Docker и деплою
- Поддержка на этапе внедрения (две недели после запуска) — помогаем отлавливать грабли
Пример GitLab CI для Битрикс (фрагмент)
stages:
- test
- build
- deploy
cache:
paths:
- vendor/
unit_tests:
stage: test
script:
- composer install --no-progress
- php vendor/bin/phpunit
deploy_staging:
stage: deploy
script:
- ansible-playbook deploy.yml -l staging
only:
- staging
Как проходит внедрение?
Процесс разбит на логические этапы, каждый с измеримым результатом:
-
Аудит текущего состояния — оценка инфраструктуры, софта, процессов. Занимает 2-3 дня.
-
Проектирование архитектуры — выбор стека (Docker/K8s/Ansible), согласование политик CI/CD, настройка репозитория.
-
Настройка окружений — Docker-окружение для локальной разработки, staging-среда, production-серверы.
-
Реализация CI/CD — написание пайплайнов, тестирование деплоя, интеграция с мониторингом.
-
Мониторинг и алертинг — установка Prometheus + Grafana, настройка дашбордов и оповещений.
-
Обучение команды — два занятия по работе с инструментами.
Типичные сроки внедрения
| Задача |
Сроки |
| Docker-окружение для локальной разработки |
2-3 дня |
| CI/CD пайплайн (GitLab CI / GitHub Actions) |
1-2 недели |
| Staging-среда |
3-5 дней |
| Мониторинг + алертинг (Prometheus + Grafana) |
1-2 недели |
| Централизованное логирование (ELK/Loki) |
1-2 недели |
| Ansible-автоматизация серверов |
2-3 недели |
| Комплексное DevOps-внедрение |
4-8 недель |
DevOps — не проект с финальной датой, а переход от «закинул по FTP и молюсь» к предсказуемым процессам. Каждый деплой — рутина, каждый инцидент — алерт с контекстом, каждый новый разработчик — docker-compose up вместо трёхдневной настройки окружения. Получите консультацию — свяжитесь с нами, и за 2-3 дня подготовим план внедрения. Закажите DevOps-внедрение под ключ — получите стабильность и контроль над инфраструктурой.