Files
ispmanager-mod_rewrite/README.ru.md
Alexey Berezhok e85d945984 Fixes
2026-07-19 01:18:52 +03:00

76 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ispmanager-mod_rewrite
## Описание
Плагин для ispmanager дляя поддержки [mod_rewrite](https://github.com/bayrepo/ngx_http_apache_rewrite_module)
## Поддерживаемые ОС
- AlmaLinux 9/10
- CentOS Stream 9/10
- и подбные RedHat подобные операционные системы
## Описание работы
Плагин при установке пытается определить установленный nginx и его версию, скачивает необходимые пакеты и исходные коды модуля для nginx, собирает модуль и подкладывает собранные so файл, к модулям nginx.
Далее в UI ispmanager можно активировать модуль и подключить для нужных сайтов.
В пакете установлен хук, которые отслеживает версию nginx пакета и при обнолвлении пересобирает модуль.
## Логи
Файлы логов работы плагина и сборки можно найти по пути:
- /usr/local/mgr5/var/nginx-mod-rewrite-plugin-addon.log
- /usr/local/mgr5/var/nginx-mod-rewrite-plugin.log
## Сборка пакета
Для сборки пакета требуется наличие docker в ОС, более ничего не нужно.
Для сборки пакета rpm плагина для ispmanager, необходимо выполнить следующую команду:
```
bash build_package.sh almalinux:9
```
Где almalinux:9 - это может быть любой образ rpm-based ОС.
Если сборка прошла успешно, в каталоге _packages появятся rpm файлы, пример таких файлов:
```
_packages/ispmanager-plugin-nginx_mod_rewrite_plugin-0.0.1-1.el9.src.rpm
_packages/ispmanager-plugin-nginx_mod_rewrite_plugin-0.0.1-1.el9.x86_64.rpm
```
На этом сборка окончена.
## Установка и описание настроек
Для установки, необходимо установить пакет `ispmanager-plugin-nginx_mod_rewrite_plugin` на машине с уставновленным ispmanager. ispmanager должен быть сконфигурирован поддерживать nginx. Во время установки будут доустановлены, некоторые пакеты.
Список пакетов, которые будут достановлены:
- openssl-devel
- pcre-devel
- zlib-devel
- gcc
- gcc-c++
- make
- wget
- python3
Т.к nginx требует сборки любого модуля именно с текущей версией, поэтому модуль собирается именно при установке, детектится версия nginx и под нее происходит сборка.
Если же nginx обновляется, то при установке добавляется хук, который при обновлении nginx пересобирает под новый nginx модуль.
Для установки нужно установить собранный в предыдущем пункте пакет:
```
sudo dnf install _packages/ispmanager-plugin-nginx_mod_rewrite_plugin-0.0.1-1.el9.x86_64.rpm
```
Если вдруг установка провалилась, лог установки можно изучить здесь - `/usr/local/mgr5/var/nginx-mod-rewrite-plugin.log`
Если все прошло успешно, то необходимо перейти