Окружение и домены
Локальное окружение Omut для 1С-Битрикс: nginx, PHP и MySQL, домены *.bitrix, порты и файлы.
Ваши проекты
Omut поднимает полноценный стек для Битрикса нативными процессами macOS — без контейнеров.
Компоненты
| Компонент | Назначение |
|---|---|
| Nginx | Веб-сервер, маршрутизация по домену *.bitrix |
| PHP-FPM | Один пул на каждую версию PHP (8.1–8.5, плюс legacy 7.4 для старых ядер Битрикса; на Apple Silicon 7.4 работает через Rosetta 2) |
| MySQL | СУБД по умолчанию 8.4; в Pro — также 8.0, 5.7 и 5.6 |
| DNS | Встроенный ответчик на 127.0.0.1:35353 для *.bitrix |
| Mailpit | Перехват mail() (функция Pro) |
| Redis | Кэш и очереди Битрикса (Pro) |
| Push & Pull | Локальный push-сервер для чата и realtime Битрикс24 (Pro; нужен Redis) — см. Битрикс24 локально |
Все компоненты окружения лежат в ~/Library/Application Support/Omut/bin/ (в режиме разработки — Omut-dev/).
Composer и Node.js не входят в «Запустить окружение»: они скачиваются с CDN при первом открытии терминала сайта. Push & Pull работает на этой же копии Node.
Домены *.bitrix
Каждый сайт получает адрес имя.bitrix, где имя — то, что вы указали при создании.
Папка проекта (корень сайта): ~/Omut/имя.bitrix/.
У новых сайтов веб-корень — ~/Omut/имя.bitrix/www/ (сюда смотрит nginx). Старые сайты без www/ по-прежнему отдают файлы из корня имя.bitrix/.
Порты
Omut сначала пробует стандартные порты. Если они заняты — переходит на запасные (их можно поменять в Настройках):
| Порт | Назначение |
|---|---|
| 80 | HTTP (nginx), если свободен |
| 443 | HTTPS (nginx), если свободен |
| 8765 | HTTP fallback, если 80 занят |
| 8443 | HTTPS fallback, если 443 занят |
| 3306 | MySQL |
| 35353 | Встроенный DNS для *.bitrix |
| 8025 / 1025 | Mailpit (веб / SMTP) |
| 6379 | Redis (если включён в настройках) |
| 8010 / 9010 | Push & Pull для Битрикс24 (если включён) |
Если HTTP не на 80-м порту, в URL сайта нужен порт: http://shop.bitrix:8765.
Текущие порты видны в боковой панели главного экрана и в разделе Статус.
Запуск и остановка
- Запустить окружение — старт nginx, php-fpm, mysql, DNS; при необходимости — Mailpit, Redis и Push & Pull (если включены в настройках, Pro).
- Остановить — корректная остановка всех служб.
При выходе из приложения службы тоже останавливаются. При следующем старте Omut «добивает» осиротевшие процессы прошлой сессии.
В Настройках можно включить автозапуск окружения при открытии приложения.
Где лежат файлы
| Что | Путь |
|---|---|
| Сайты (видимые) | ~/Omut/ |
| Корень сайта | ~/Omut/имя.bitrix/ |
| Веб-корень (новые сайты) | ~/Omut/имя.bitrix/www/ |
| Доп. директивы nginx (опц.) | ~/Omut/имя.bitrix/omut/nginx.locations.conf |
| Бинарники, конфиги, БД | ~/Library/Application Support/Omut/ |
| Логи | ~/Library/Application Support/Omut/logs/ |
| Сессии PHP | ~/Library/Application Support/Omut/tmp/sessions/ |
| Настройки приложения | ~/Library/Application Support/Omut/config.json |
Свои настройки PHP, MySQL и nginx
Конфигурации служб лежат в папке configs/ рядом с данными Omut. Открыть её можно на экране Статус → Где что лежит → Конфигурации.
| Что правите | Файл | Что рядом задаёт Omut |
|---|---|---|
| PHP | php/php-8.3-mysql-8.4.ini — для каждой пары версий PHP и MySQL свой | php/php-8.3-mysql-8.4.d/omut.ini |
| MySQL | mysql/my-8.4.cnf — для каждой версии MySQL свой | mysql/my-8.4.d/omut.cnf |
| nginx | nginx/nginx.conf | nginx/nginx.d/ |
- Файлы из второй колонки ваши. Omut создаёт их один раз и больше не перезаписывает, поэтому правки переживают перезапуск окружения и обновления приложения. Чтобы изменения применились, перезапустите окружение.
- В файлах из третьей колонки Omut задаёт то, что меняет сам: пути к данным, подключение к базе, часовой пояс, почту, Xdebug, сайты, порты и HTTPS. Omut пересобирает их при каждом запуске окружения, поэтому правки в них пропадут.
- Значения из файлов Omut применяются после ваших. Часовой пояс, почту и Xdebug меняйте в Настройках. Если нужно перекрыть и их, положите свой
.iniв папкуphp-8.3-mysql-8.4.d/с именем послеomut.ini, напримерzz-my.ini. - Строки
include nginx.d/…вnginx.confне удаляйте: через них подключаются сайты. Правила для одного сайта удобнее держать в папке сайта, в файлеomut/nginx.locations.conf. - Чтобы вернуть исходный вид, удалите свой файл и перезапустите окружение: Omut создаст его заново. Ваши правки в этом файле пропадут.
Экран «Статус»
В боковом меню — Статус: версии компонентов, платформа, порты, время работы служб и состояние сертификата для HTTPS.