После установки CMS MODX на сервер VPS с ISPmanager вы можете столкнуться с неожиданной проблемой: при открытии /manager/ вас перенаправляет на главную страницу сайта. Это связано с особенностями шаблонов конфигурации веб-сервера. Рассказываем, как убрать ненужный редирект и открыть административную панель MODX.
Введение
Когда вы устанавливаете CMS MODX на сервер с ISPmanager, кажется, что всё должно заработать сразу: файлы загружены, база подключена, сайт открывается. Но при попытке зайти в админку по адресу /manager/ вы вдруг попадаете… на главную страницу сайта. Ни ошибок, ни предупреждений — просто тихий редирект, который сбивает с толку и мешает работать.
Это не баг и не проблема самой CMS. Это результат того, как устроена система шаблонов в ISPmanager. Панель создаёт конфигурации для веб-сервера (Apache или Nginx) по шаблонам, где всё заточено под типичную работу популярных CMS с ЧПУ-маршрутизацией. А MODX — система со своими особенностями. В частности, её административный интерфейс размещён не по /admin, как у многих, а по /manager/, и ему критично важно, чтобы этот путь обрабатывался напрямую, а не подменялся в пользу index.php или внутренних маршрутов.
Такой редирект не всегда бросается в глаза, но может серьёзно затормозить запуск сайта. Важно понимать, что ISPmanager сам по себе не «портит» MODX — просто требует ручной настройки под нестандартную логику маршрутов. Именно об этом и пойдёт речь в статье.
Мы подробно разберём, почему возникает проблема, как она связана с работой Apache и Nginx, и как корректно её устранить на разных конфигурациях сервера. В конце вы получите полностью рабочую систему: сайт на MODX с доступной админкой и без лишних редиректов. Всё — в рамках логики ISPmanager и без риска сломать панель.
В чём проблема
После установки MODX в корень сайта на сервере с панелью ISPmanager, переход по адресу site.ru/manager/ часто приводит к редиректу на главную страницу. Хотя директория manager/ существует физически, веб-сервер её игнорирует — всё из-за того, как ISPmanager генерирует конфигурации для Apache или Nginx. По умолчанию запросы к подпапкам могут обрабатываться как ЧПУ-маршруты и перенаправляться на index.php.
Для MODX это критично — админка располагается именно по этому адресу.
Почему так происходит
Когда вы создаёте сайт через ISPmanager, система автоматически формирует конфигурационный файл на основе шаблона.
В нём часто прописана следующая строка.
Для Nginx:
try_files $uri $uri/ /index.php?$args;
или для Apache:
FallbackResource /index.php
Эти директивы предназначены для корректной работы CMS с ЧПУ, но они же и перехватывают запрос к /manager/, воспринимая его как несуществующий маршрут. В итоге — редирект.
Как убрать редирект в Apache
Если вы используете Apache или связку Apache + Nginx, нужно вручную добавить директиву Alias
, указывающую путь к каталогу manager.
- Откройте конфигурационный файл виртуального хоста. Обычно он находится в:
/etc/httpd/conf/httpd.conf
или
/etc/httpd/conf.d/название-домена.conf
- Внутри блока <VirtualHost> добавьте строку:
Alias /manager/ /var/www/ИМЯ_ПОЛЬЗОВАТЕЛЯ/data/www/ВАШ_ДОМЕН/manager/
Например:
Alias /manager/ /var/www/admin/data/www/example.com/manager/
- Перезапустите Apache:
systemctl restart httpd
Теперь путь example.com/manager/ будет обрабатываться напрямую, без переадресации.
Как настроить для Nginx (если используется без Apache)
Если вы используете только Nginx, потребуется изменить конфигурацию сайта, добавив отдельный блок location для папки manager.
- Откройте файл конфигурации, расположенный по адресу:
/etc/nginx/conf.d/ВАШ_ДОМЕН.conf
- Добавьте внутри блока
server
следующий фрагмент:
location /manager/ {
alias /var/www/ИМЯ_ПОЛЬЗОВАТЕЛЯ/data/www/ВАШ_ДОМЕН/manager/;
index index.php index.html;
}
- Сохраните файл и перезапустите Nginx:
systemctl restart nginx
После этого site.ru/manager/ будет работать корректно.
Как внести изменения через ISPmanager
В ISPmanager (версии 5 и 6) можно использовать пользовательские шаблоны конфигураций, чтобы изменения не перетирались при обновлениях панели или сайта.
- Создайте каталог шаблонов, если он ещё не существует:
mkdir -p /usr/local/mgr5/etc/templates/nginx/
- Скопируйте стандартный шаблон веб-домена:
cp /usr/local/mgr5/etc/defaults/nginx/web_domain.tpl /usr/local/mgr5/etc/templates/nginx/
- В файле web_domain.tpl найдите секцию location / и добавьте перед ней новый блок:
location /manager/ {
alias %docroot%/manager/;
index index.php index.html;
}
- Перегенерируйте конфигурацию сайта через панель или вручную.
Проверка
Откройте в браузере https://ВАШ_ДОМЕН/manager/. Если всё сделано правильно — откроется админка MODX без редиректа на главную. Если нет — проверьте логи ошибок веб-сервера (/var/log/httpd/ и /var/log/nginx/) и корректность путей.
Заключение
Панель ISPmanager удобна, но не всегда учитывает особенности конкретных CMS. MODX требует прямого доступа к папке manager, и в случае с редиректом проблему нужно решать вручную — через Alias в Apache или alias + location в Nginx. Это несложно, но важно понимать, как работает маршрутизация запросов на сервере, чтобы избежать подобных ситуаций в будущем.
Если вы не уверены в своих действиях — сделайте бекап перед редактированием конфигурации. Или обратитесь в техподдержку AdminVPS — мы поможем.
Читайте в блоге:
- Настройка NGINX на Ubuntu 24.04 LTS: от первого запуска до HTTPS
- Интеграция WordPress с Nginx и MariaDB на Ubuntu 24.04: от базы данных до SSL
- CI/CD на базе Ubuntu 24.04 LTS: GitHub Actions, Docker, NGINX