Обновите uv: токены от приватных индексов больше не видны другим пользователям сервера

17 ноября Astral выпустила uv 0.13.9, а пятью днями раньше вышла 0.13.8. Для тех, кто держит uv на общем сервере, главное в этой паре версий одно исправление: файл с токенами, который создаёт команда uv auth login, больше не может прочитать любой пользователь системы. Кроме того, uv научился понимать файл .venv со ссылкой на окружение, а lock-файлы в больших проектах стали заметно меньше.

Токены uv auth login были открыты другим пользователям

Если системного хранилища ключей нет, uv auth login сохраняет токен приватного индекса пакетов в обычный текстовый файл credentials.toml. Как говорится в отчёте #23202, права на этот файл и его папку uv брал из umask процесса, а не закрывал их только для владельца. При обычном umask 022 папка получала права 755, сам файл 644, а файл блокировки даже 666. Любой другой пользователь сервера, которому доступна домашняя папка владельца, мог прочитать токен. Проблему проверили на uv 0.12.21 в Linux, сообщили о ней через security@astral.sh.

В 0.13.8 это исправили: папка создаётся с правами 0700, файл и блокировка с правами 0600, а сам файл записывается атомарно через временный файл. Если папка уже была создана старой версией, uv закроет её при следующей записи. Исключение одно: папку, заданную через переменную UV_CREDENTIALS_DIR, uv не трогает, потому что там могут лежать и посторонние файлы.

На сервере, где uv ставили через официальный установщик, обновиться и проверить права можно так:

uv self update
uv --version
ls -la ~/.local/share/uv/credentials/

Ждать следующего входа не обязательно, права можно поправить руками. А если токен мог прочитать кто-то посторонний, его лучше перевыпустить в самом индексе пакетов.

chmod 700 ~/.local/share/uv/credentials
chmod 600 ~/.local/share/uv/credentials/*

Файл .venv может указывать на окружение в другой папке

PEP 832 Бретта Кэннона пока в статусе черновика. Он закрепляет то, что и так стало привычкой: окружение проекта лежит в папке .venv в его корне. Но вместо папки там может быть обычный файл .venv из одной строки с путём к окружению, которое хранится где-то ещё. Относительный путь считается от папки, где лежит сам файл. Так редактор, проверка типов и другие инструменты найдут нужное окружение, даже если программу запустили не из терминала с активированным venv.

uv 0.13.9 понимает такие файлы в режиме предварительных функций (preview), потому что сам стандарт ещё может измениться. Если окружение по ссылке подходит проекту, uv работает с ним, а если нет, заменяет файл обычной папкой. Сделать такой файл можно одной командой из PEP:

realpath /srv/venvs/myproject > .venv

Lock-файлы в больших проектах стали меньше

В uv.lock условия для разных платформ и версий Python раньше записывались длинным списком, и общие части повторялись в каждом варианте. Теперь uv выносит их за скобки. На большом проекте MTEB lock-файл уменьшился с 88,7 до 57,4 МБ, а проверка и экспорт такого файла стали быстрее примерно на треть. На обычных проектах вроде Flask или Airflow разница почти незаметна.

Одно практическое следствие: после обновления uv при следующей блокировке uv.lock может перезаписаться, и в git появится большой diff. Набор пакетов при этом не меняется, по словам разработчиков, старые и новые версии uv читают lock-файлы друг друга.

Что ещё поменялось в 0.13.8 и 0.13.9

В 0.13.9 uv перестал принимать колёса, которые индекс отдаёт под чужим именем пакета: если запросили один пакет, а пришёл файл с другим названием, uv отбросит его и поищет в других индексах. В той же версии появилась опция http2-keep-alive (тоже preview): она закрывает зависшие HTTP/2-соединения.

В 0.13.8 uv научился ставить вторую альфу Python 3.16, а собственные сборки CPython от 3.11 до 3.15 получили pip 26.3, zlib 1.4 и Expat 2.10.0. Ещё одно мелкое улучшение: если несколько команд uvx или uv run --with одновременно просят одинаковое окружение, оно собирается один раз. Тем, кто собирает uv из исходников, понадобится Rust не ниже 1.98.

Если uv стоит на сервере, где работают несколько человек или служб, обновление стоит сделать сейчас и сразу проверить права на папку с учётными данными. Остальное в этих версиях приятное, но не срочное: файл .venv пока в режиме preview, а lock-файлы заметно уменьшатся только в очень больших проектах.

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


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