UFW Service

class services.ufw_service.UFWService[source]

Bases: object

Сервис взаимодействия с UFW (Uncomplicated Firewall).

Назначение:
  • Чтение статуса и списка правил брандмауэра.

  • Добавление, удаление и массовая обработка правил с поддержкой диапазонов портов, комментариев и выбором протоколов.

Детали реализации:
  • Команды выполняются через sudo ufw …; вывод парсится в модели pydantic.

  • Для операций удаления соблюдается порядок с конца, чтобы не нарушать нумерацию.

add_rules(rules: List[UFWRule]) → dict[source]

Добавляет правила UFW.

Args:

rules: Список правил для добавления

Returns:

dict: Результат добавления правил

add_rules_base(rules: List[UFWRule], direction: str = '') → bool[source]

Базовый метод для добавления правил UFW.

Args:

rules: Список правил для добавления direction: Направление трафика (“in” или “out”)

Returns:

bool: True если все правила были успешно добавлены, False в противном случае

add_ufw_in_rules(rules: List[UFWRule]) → bool[source]

Добавляет входящие (in) правила UFW.

Args:

rules (List[UFWRule]): Список правил для добавления

Returns:

bool: True если все правила были успешно добавлены, False в противном случае

add_ufw_out_rules(rules: List[UFWRule]) → bool[source]

Добавляет исходящие (out) правила UFW.

Args:

rules (List[UFWRule]): Список правил для добавления

Returns:

bool: True если все правила были успешно добавлены, False в противном случае

delete_rules(rule_numbers: List[int]) → dict[source]

Удаляет правила UFW по их номерам.

Args:

rule_numbers (List[int]): Список номеров правил для удаления

Returns:

dict: Результат операции удаления

disable_ufw() → bool[source]

Выключает UFW.

Returns:

bool: True если успешно выключен, False в противном случае

enable_ufw() → bool[source]

Включает UFW.

Returns:

bool: True если успешно включен, False в противном случае

get_ufw_rules() → UFWRulesResponse[source]

Получает список правил UFW.

Returns:

UFWRulesResponse: Объект, содержащий статус UFW и список правил

get_ufw_status() → UFWStatus[source]

Проверяет статус UFW.

Returns:

UFWStatus: Объект с информацией о статусе UFW