Руководство: интеграция Rspamd в виде пользовательского скрипта в Proxmox Mail Gateway
Proxmox Mail Gateway позволяет выполнять расширенную настройку с помощью пользовательского скрипта для проверки спама и вирусов. В этом руководстве показано, как интегрировать Rspamd для оценки спам-оценок и передачи результатов обратно в PMG.
1. Требования
Рабочий кластер rspamd.
Он может находиться на том же хосте, что и PMG, или на удалённом сервере, но я рекомендую использовать удалённый сервер. Здесь я приведу простой пример установки на одном узле.
PMG должен быть корректно установлен и настроен.
Базовые знания shell-скриптинга.
2. Включение пользовательского скрипта в PMG
Откройте конфигурационный файл PMG: nano /etc/pmg/pmg.conf
Включите пользовательскую проверку, добавив или обновив следующий раздел:
section: admin
custom_check 1
custom_check_path /usr/local/bin/pmg-custom-check
Установите jq — скрипту он нужен:
apt install jq
3. Установка и настройка Rspamd
Установите Rspamd:
На том же сервере (или на другом):
apt update && apt install rspamd
Включите HTTP API в Rspamd:
Отредактируйте конфигурационный файл контроллера Rspamd:
nano /etc/rspamd/rspamd.conf
и обновите следующий код, чтобы контроллер был доступен извне. Если у вас локальная установка, этот шаг можно пропустить. Однако скрипт использует пароль.
worker "controller" {
bind_socket = "0.0.0.0:11334";
bind_socket = "[::]:11334";
password="use-a-strong-password";
enable_password = true;
.include "$CONFDIR/worker-controller.inc"
.include(try=true; priority=1,duplicate=merge) "$LOCAL_CONFDIR/local.d/worker-controller.inc"
.include(try=true; priority=10) "$LOCAL_CONFDIR/override.d/worker-controller.inc"
}
Перезапустите Rspamd:
systemctl restart rspamd
4. Создание пользовательского скрипта
Создайте файл скрипта:
nano /usr/local/bin/pmg-custom-check
Добавьте следующий скрипт для интеграции с Rspamd:
#!/bin/bash
API_URL="http://<your rspamd host>:11334/checkv2"
API_PASSWORD="your-strong-password"
if [ "$#" -ne 2 ]; then
echo "usage: $0 APIVERSION QUEUEFILENAME" 1>&2
exit 1
fi
apiver="$1"
queue_file="$2"
if [ "$apiver" != "v1" ]; then
echo "wrong APIVERSION: $apiver" 1>&2
exit 2
fi
# Вызов rspamd через HTTP API
rspamd_output=$(curl -s --data-binary @"$queue_file" -H "Password: $API_PASSWORD" "$API_URL")
if [ $? -ne 0 ]; then
echo "Error contacting rspamd" 1>&2
exit 3
fi
# Извлечение спам-оценки из JSON-ответа
spam_score=$(echo "$rspamd_output" | jq -r '.score')
# Проверка корректности спам-оценки
if [[ ! $spam_score =~ ^-?[0-9]+(\.[0-9]+)?$ ]]; then
echo "Error parsing rspamd output" 1>&2
exit 4
fi
# Вывод для PMG
echo "v1"
if (( $(echo "$spam_score > 0" | bc -l) )); then
echo "SCORE: $spam_score"
else
echo "OK"
fi
Сохраните и сделайте скрипт исполняемым:
chmod +x /usr/local/bin/pmg-custom-check
5. Тестирование пользовательского скрипта
Подготовьте тестовый файл с письмом
Создайте пример email в формате RFC 822:
From: test@example.com
To: recipient@example.com
Subject: Test Email
This is a test email for Rspamd integration.
Запустите скрипт вручную с тестовым файлом:
/usr/local/bin/pmg-custom-check v1 email.eml
Ожидаемый вывод:
Если спам-оценка > 0:
v1
SCORE: 1.1
Если спам-оценка ≤ 0:
v1
OK
6. Тонкая настройка конфигурации Rspamd
Отключение Greylisting (по желанию)
Если greylisting не нужен, отключите его в /etc/rspamd/local.d/greylist.conf:
enabled = false;
Перезапустите Rspamd:
systemctl restart rspamd
Заключение
После этой настройки Proxmox Mail Gateway интегрирован с Rspamd для пользовательской проверки спама. Rspamd будет анализировать письма, выставлять спам-оценки и передавать результаты в PMG. Настраивайте Rspamd под свои нужды и следите за логами для стабильной работы.
Рекомендую использовать обратный HTTP-прокси, чтобы поднять https, если в вашем кластере нет защищённой локальной сети.
Важно: спам-оценки добавляются к уже рассчитанным Proxmox значениями, поэтому убедитесь, что ваша фильтрация справляется с этими дополнительными значениями.
Если возникнут вопросы или потребуется помощь — пишите!
Proxmox Mail Gateway позволяет выполнять расширенную настройку с помощью пользовательского скрипта для проверки спама и вирусов. В этом руководстве показано, как интегрировать Rspamd для оценки спам-оценок и передачи результатов обратно в PMG.
1. Требования
Рабочий кластер rspamd.
Он может находиться на том же хосте, что и PMG, или на удалённом сервере, но я рекомендую использовать удалённый сервер. Здесь я приведу простой пример установки на одном узле.
PMG должен быть корректно установлен и настроен.
Базовые знания shell-скриптинга.
2. Включение пользовательского скрипта в PMG
Откройте конфигурационный файл PMG: nano /etc/pmg/pmg.conf
Включите пользовательскую проверку, добавив или обновив следующий раздел:
section: admin
custom_check 1
custom_check_path /usr/local/bin/pmg-custom-check
Установите jq — скрипту он нужен:
apt install jq
3. Установка и настройка Rspamd
Установите Rspamd:
На том же сервере (или на другом):
apt update && apt install rspamd
Включите HTTP API в Rspamd:
Отредактируйте конфигурационный файл контроллера Rspamd:
nano /etc/rspamd/rspamd.conf
и обновите следующий код, чтобы контроллер был доступен извне. Если у вас локальная установка, этот шаг можно пропустить. Однако скрипт использует пароль.
worker "controller" {
bind_socket = "0.0.0.0:11334";
bind_socket = "[::]:11334";
password="use-a-strong-password";
enable_password = true;
.include "$CONFDIR/worker-controller.inc"
.include(try=true; priority=1,duplicate=merge) "$LOCAL_CONFDIR/local.d/worker-controller.inc"
.include(try=true; priority=10) "$LOCAL_CONFDIR/override.d/worker-controller.inc"
}
Перезапустите Rspamd:
systemctl restart rspamd
4. Создание пользовательского скрипта
Создайте файл скрипта:
nano /usr/local/bin/pmg-custom-check
Добавьте следующий скрипт для интеграции с Rspamd:
#!/bin/bash
API_URL="http://<your rspamd host>:11334/checkv2"
API_PASSWORD="your-strong-password"
if [ "$#" -ne 2 ]; then
echo "usage: $0 APIVERSION QUEUEFILENAME" 1>&2
exit 1
fi
apiver="$1"
queue_file="$2"
if [ "$apiver" != "v1" ]; then
echo "wrong APIVERSION: $apiver" 1>&2
exit 2
fi
# Вызов rspamd через HTTP API
rspamd_output=$(curl -s --data-binary @"$queue_file" -H "Password: $API_PASSWORD" "$API_URL")
if [ $? -ne 0 ]; then
echo "Error contacting rspamd" 1>&2
exit 3
fi
# Извлечение спам-оценки из JSON-ответа
spam_score=$(echo "$rspamd_output" | jq -r '.score')
# Проверка корректности спам-оценки
if [[ ! $spam_score =~ ^-?[0-9]+(\.[0-9]+)?$ ]]; then
echo "Error parsing rspamd output" 1>&2
exit 4
fi
# Вывод для PMG
echo "v1"
if (( $(echo "$spam_score > 0" | bc -l) )); then
echo "SCORE: $spam_score"
else
echo "OK"
fi
Сохраните и сделайте скрипт исполняемым:
chmod +x /usr/local/bin/pmg-custom-check
5. Тестирование пользовательского скрипта
Подготовьте тестовый файл с письмом
Создайте пример email в формате RFC 822:
From: test@example.com
To: recipient@example.com
Subject: Test Email
This is a test email for Rspamd integration.
Запустите скрипт вручную с тестовым файлом:
/usr/local/bin/pmg-custom-check v1 email.eml
Ожидаемый вывод:
Если спам-оценка > 0:
v1
SCORE: 1.1
Если спам-оценка ≤ 0:
v1
OK
6. Тонкая настройка конфигурации Rspamd
Отключение Greylisting (по желанию)
Если greylisting не нужен, отключите его в /etc/rspamd/local.d/greylist.conf:
enabled = false;
Перезапустите Rspamd:
systemctl restart rspamd
Заключение
После этой настройки Proxmox Mail Gateway интегрирован с Rspamd для пользовательской проверки спама. Rspamd будет анализировать письма, выставлять спам-оценки и передавать результаты в PMG. Настраивайте Rspamd под свои нужды и следите за логами для стабильной работы.
Рекомендую использовать обратный HTTP-прокси, чтобы поднять https, если в вашем кластере нет защищённой локальной сети.
Важно: спам-оценки добавляются к уже рассчитанным Proxmox значениями, поэтому убедитесь, что ваша фильтрация справляется с этими дополнительными значениями.
Если возникнут вопросы или потребуется помощь — пишите!
