# Ошибка при установке requirements.txt: почему падает сборка

https://netrun.io/blog/oshibka-requirements-txt

_8 августа 2026 г. · 5 мин чтения_

> Ошибка при установке requirements.txt почти всегда вызвана самим файлом, а не хостингом. Причина номер один — файл сделан командой pip freeze, и в него попали строки с путями к папкам вашего компьютера (вида @ file:///) и пакеты, которых нет в открытом индексе. Дальше по частоте идут закрепленная версия, которой не существует для той версии Python, на которой идет сборка, пакеты только для Windows и посторонние символы в файле. Лечение одно: переписать requirements.txt руками, оставив только те библиотеки, которые проект действительно импортирует, и убрать лишние закрепления версий.

Ошибка при установке requirements.txt выглядит одинаково пугающе на любом хостинге: длинная простыня текста, где-то в середине строка could not find a version that satisfies the requirement, и сборка останавливается. Хорошая новость в том, что виновата обычно не платформа и даже не ваш код, а сам список библиотек: чаще всего его сделали автоматически, и в него попало лишнее.

Обычно такую ошибку разбирают вслепую: заходят на сервер, ставят пакеты руками, пробуют снова, ловят момент, когда все встало. В Netrun логи сборки видны в кабинете в реальном времени, и в них написано, на каком пакете и на какой строке все остановилось, — дальше дело в одной-двух правках файла. Ниже причины по частоте: от самой популярной до редкой, и что делать с каждой.

## 1. Прочитайте логи сборки и найдите имя пакета

Не читайте весь вывод целиком — смотрите последние строки перед остановкой. Там почти всегда написано имя пакета и номер строки в requirements.txt: например, could not find a version that satisfies the requirement и дальше название библиотеки. Логи сборки обычно можно открыть прямо у хостинга, где вы публикуете проект, — начните с них, а не с догадок по коду. Имя пакета из этой строки и есть ваш диагноз.

## 2. Уберите строки с путями к вашему компьютеру

Если файл сделан командой pip freeze, в нем часто оказываются строки вида имя-пакета @ file:///Users/... или @ file:///C:/... — это ссылки на папки на вашей машине. На сервере таких папок нет, и установка падает сразу. Удалите из такой строки все, что идет после символа @, оставив только имя пакета, а если пакет вам не нужен — удалите строку целиком. Это причина номер один у всех, кто получил файл автоматически.

## 3. Соберите requirements.txt заново — по импортам, а не через freeze

Команда pip freeze выгружает все, что стоит в окружении: инструменты разработки, зависимости зависимостей, случайно поставленные библиотеки и системные пакеты, которых в открытом индексе нет вообще. Надежнее написать файл руками: пройдитесь по своим файлам с кодом, выпишите то, что реально импортируется — requests, flask, aiogram, — и оставьте только это. Список из пяти строк ставится быстрее и ломается реже, чем список из двухсот. Виртуальное окружение, папку venv, в архив класть не нужно: библиотеки ставятся при сборке.

## 4. Снимите закрепления версий, которых не существует

Строка вида пакет==1.2.3 требует ровно этой версии. Если такой версии нет для той версии Python, на которой идет сборка, или ее убрали из индекса, вы увидите то самое could not find a version that satisfies the requirement, а рядом обычно печатается список версий, которые есть на самом деле. Уберите номер версии у проблемного пакета или возьмите версию из этого списка. Так же лечатся несовместимые закрепления, когда две библиотеки требуют разных версий третьей: снимите жесткие версии там, где они вам не принципиальны.

## 5. Уберите пакеты только для Windows и тяжелые сборки

Библиотеки pywin32, pypiwin32, windows-curses и им подобные существуют только под Windows и на сервере с Linux не поставятся никогда. В коде они обычно не используются и попали в файл все тем же freeze — удаляйте смело. Отдельный случай — пакеты, которые собираются из исходников и требуют системных библиотек: часто помогает не закреплять версию, потому что у свежих версий есть готовые сборки под Linux, или взять библиотеку попроще. Если пакет нужен именно такой, положите рядом с кодом свой Dockerfile, который ставит нужные системные библиотеки, — Netrun возьмет его вместо автоматической сборки.

## 6. Проверьте файл на посторонние символы и загрузите новую версию

Файл должен быть простым текстом: одна библиотека на строку, без кириллицы, без пояснений на русском в конце строки, без кавычек и лишних пробелов. Часто все ломает копирование из чата или из статьи: вместо обычного дефиса приезжает длинное тире, вместо пробела — неразрывный, а редактор дописывает свою кодировку. Сохраните файл обычным текстовым редактором в кодировке UTF-8, загрузите новую версию проекта и смотрите логи. Если сборка снова упала, у вас уже есть следующее имя пакета, и круг повторяется на одну строку короче.

Главное, что стоит знать, пока вы это чините: неудачная сборка ничего не удаляет. Код, настройки и секреты остаются на месте, а исправленную версию можно загрузить заново — столько раз, сколько потребуется. В Netrun логи каждой попытки видны в кабинете в реальном времени, так что сразу понятно, сдвинулась ли ошибка на следующий пакет или осталась на том же. [Попробовать Netrun](https://netrun.io/).

Похожие инструкции: [хостинг Telegram-бота на Python](https://netrun.io/blog/hosting-telegram-bota-na-python), [секреты и переменные окружения](https://netrun.io/blog/peremennye-okruzheniya-bez-env), [сайт на Django](https://netrun.io/blog/sayt-na-django).

## Частые вопросы

### Что означает ошибка could not find a version that satisfies the requirement?

Это значит, что установщик сходил в индекс пакетов и не нашел там ни одной версии, подходящей под вашу строку. Чаще всего дело в закрепленной версии, которой не существует для той версии Python, на которой идет сборка, либо в опечатке в названии пакета. Рядом с ошибкой обычно печатается список версий, которые есть на самом деле, — возьмите версию оттуда или уберите закрепление совсем.

### Почему на моем компьютере все ставится, а при публикации падает?

На вашей машине часть библиотек уже стоит с прошлых проектов, поэтому установщик их не трогает и ошибку вы не видите. На сервере окружение чистое: ставится ровно то, что перечислено в файле, и любая неверная строка останавливает сборку. Кроме того, версия Python и операционная система при сборке могут отличаться от ваших — часть пакетов из вашего окружения там просто не существует.

### Нужно ли закреплять версии пакетов в requirements.txt?

Закреплять полезно, когда проект живет долго и вам важна повторяемость, но закреплять все подряд выгрузкой из pip freeze вредно. Практичный компромисс: зафиксируйте одну-две библиотеки, где версия для вас критична, а остальные оставьте без номера. Тогда сборка не будет падать из-за версии пакета, которым вы даже не пользуетесь.

### Что делать, если пакет требует компиляции и системных библиотек?

Сначала попробуйте не закреплять версию: у свежих версий популярных библиотек обычно есть готовые сборки под Linux, и компилировать ничего не придется. Если системные библиотеки все равно нужны, положите в проект свой Dockerfile, который их устанавливает, — платформа возьмет его вместо автоматической сборки. Иногда проще заменить библиотеку на более легкую: например, разбирать HTML без браузера.

### Что происходит с проектом, если новая сборка упала?

Ничего не удаляется: код, настройки и секреты остаются на месте, а новая версия просто не применяется, пока не соберется. В кабинете видно, что публикация не удалась и на каком пакете все остановилось. Исправленный requirements.txt можно загрузить заново столько раз, сколько нужно.

### Что делать, если requirements.txt вообще нет?

Создайте его сами: обычный текстовый файл в корне проекта, по одной библиотеке на строку. Впишите туда только то, что ваш код импортирует, — без стандартных модулей Python вроде os, json или datetime, они уже есть. Без этого файла зависимости ставить неоткуда, и проект упадет уже при запуске с сообщением, что модуль не найден.

### Можно ли запустить проект на Python — Django, Flask или FastAPI?

Да. Положите зависимости в requirements.txt — Netrun определит Python и соберет проект сам. Django, Flask и FastAPI поддерживаются; приложение должно слушать порт из переменной окружения, а ключи и доступ к базе задаются как секреты, а не в коде.

### Где посмотреть логи и статус проекта?

На странице проекта есть статус, логи и история событий — по ним видно, что происходит с проектом прямо сейчас. Лента логов показывает и более ранние строки: пролистайте ее вверх, и они подгрузятся сами.

### Как обновить код уже опубликованного проекта?

Откройте проект и загрузите новую версию или обновите его из GitHub. Ссылка останется прежней, а данные сохранятся, если лежат в постоянном хранилище — папке /data или томе вашего compose-файла.
