В PyYAML 6.0.4 закрыли способ завесить сервер маленьким YAML-файлом

В ночь на 21 ноября по Москве вышел PyYAML 6.0.4. Главное в нём: исправили уязвимость, из-за которой небольшой YAML-документ с ключами слияния << мог надолго занять процессор и съесть память даже при безопасной загрузке через yaml.safe_load. Кроме того, готовые пакеты теперь собраны с libyaml 0.2.6, а в ней появился предел глубины вложенности.

PyYAML стоит в зависимостях у огромного числа проектов, от Ansible до веб-приложений, которые читают конфиги и настройки в YAML. Больше всего обновление нужно сервисам, которые разбирают YAML, пришедший снаружи: загруженные пользователями файлы, тела запросов к API, описания задач в CI. У одного изменения есть побочный эффект, о нём ниже.

Как маленький файл заставлял PyYAML работать часами

В YAML можно пометить кусок документа якорем (&base), сослаться на него в другом месте (*base) и подмешать его содержимое в словарь специальным ключом <<. Так в конфигах избавляются от повторов. Проблема была в том, как PyYAML обрабатывал такое слияние: если на один и тот же якорь ссылались несколько раз на разных уровнях, список элементов на каждом уровне удваивался.

Автор исправления в PR #937 описывает это так: число операций растёт как 2n+1 — 1, где n это число уровней, и документа меньше килобайта хватает на миллионы лишних шагов. Уязвимы и обычный SafeLoader, и быстрые загрузчики на C вроде CSafeLoader, потому что логику слияния они берут из одного и того же класса. В issue #897, где проблему описали ещё в октябре 2025 года, документ из 18 уровней превращался в словарь на 524 287 ключей и грузился 22 секунды.

Исправление запоминает, какие узлы уже подмешаны, и пропускает повторы. По замерам автора, документ с 22 уровнями вложенных слияний теперь грузится за 0,003 секунды вместо 3,8. В основную ветку правку приняли ещё в июне, но в релиз она попала только сейчас.

libyaml 0.2.6 ограничивает вложенность тысячей уровней

В ту же ночь вышла libyaml 0.2.6, библиотека на C, на которой работают быстрые загрузчики PyYAML. В ней появился настраиваемый предел глубины вложенности списков и словарей, по умолчанию около 1000 уровней. Это исправляет CVE-2026-44842: раньше каждый новый уровень вложенности добавлял парсеру памяти в стеке и работы, и очень глубокий документ можно было использовать для атаки на отказ в обслуживании.

Колёса PyYAML 6.0.4 на PyPI собраны уже с этой версией, поэтому загрузчики с буквой C в названии (CLoader, CSafeLoader, CFullLoader и другие) на документе глубже 1000 уровней выбрасывают ScannerError с текстом «exceeded maximum nesting depth». Обычный SafeLoader написан на чистом Python и этот предел не использует. Если PyYAML собран из исходников со старой libyaml, функции управления пределом ничего не делают, а текущее значение возвращается как -1.

Проверить, что стоит у вас, можно одной командой. На свежем колесе она выведет 6.0.4 True 1000:

python3 -c "import yaml; print(yaml.__version__, yaml.__with_libyaml__, yaml._yaml._get_max_nest_level())"

Поменять предел можно через yaml._yaml._set_max_nest_level(), но мейнтейнеры прямо советуют без нужды этого не делать: значение общее на весь процесс, а смена небезопасна при работе в нескольких потоках.

При слиянии ключей теперь побеждает последний источник

Теперь о побочном эффекте. По спецификации YAML, если подмешать несколько якорей списком <<: [*a, *b] и в них есть одинаковые ключи, побеждает значение из первого источника. Исправление из PR #937 поменяло этот порядок: для ключей из двух и более символов теперь побеждает последний источник. Об этом с августа открыт issue #953, а PR #954 с исправлением пока не принят, так что в 6.0.4 новое поведение уже есть.

base_a: &a
  kk: 1
base_b: &b
  kk: 2
result:
  <<: [*a, *b]

# PyYAML 6.0.3: result.kk = 1
# PyYAML 6.0.4: result.kk = 2

С однобуквенными ключами всё по-старому, но только потому, что CPython хранит такие строки в единственном экземпляре. Если в ваших конфигах есть списки якорей в << с пересекающимися ключами и вы полагаетесь на порядок, после обновления проверьте итоговые значения. Найти такие места можно поиском по <<: [.

Как обновиться

  • pip: pip install -U "PyYAML==6.0.4", в requirements.txt поднять версию до 6.0.4.
  • uv: uv lock --upgrade-package pyyaml, затем uv sync.
  • Python 3.8 и 3.9 больше не поддерживаются, на них pip останется на 6.0.3 без исправления. Заодно появилась поддержка Python 3.15.
  • Пакет python3-yaml из репозитория дистрибутива обновляется отдельно, по графику его мейнтейнеров.

Если ваш сервис разбирает чужой YAML, обновление до PyYAML 6.0.4 стоит поставить в ближайшее время: оно закрывает способ положить сервер маленьким файлом и ограничивает глубину вложенности. Если YAML только ваш собственный, спешки меньше, но перед обновлением проверьте конфиги, где несколько якорей подмешиваются одним списком.

Источники и ссылки


Комментарии загружаются…