Пакетный менеджер apt это основа работы с софтом в Debian, Ubuntu и их производных. Когда он перестаёт работать, система не может ставить новые приложения и получать патчи безопасности. Хорошая новость: большинство ошибок apt решается за две или три команды, если понимать, что именно сломалось. Ниже разбираем типовые симптомы, даём пошаговый порядок действий и универсальный алгоритм на случай, когда точечный фикс не срабатывает.
С чего начинать диагностику
Сначала читаем сообщение об ошибке целиком. Apt и dpkg обычно сами указывают, что им не нравится: имя пакета, URL репозитория, конкретный файл. Случайные команды из интернета без понимания причины могут сделать хуже.
Базовый набор диагностических команд:
- sudo apt update показывает актуальные ошибки при обращении к репозиториям.
- sudo apt check выявляет нарушенные зависимости установленных пакетов.
- sudo dpkg --audit выводит пакеты, застрявшие в промежуточном состоянии.
- dpkg -l | grep -E '^iF|^iU|^rc' показывает пакеты с нетипичным статусом.
Журналы операций хранятся в /var/log/apt/history.log и /var/log/dpkg.log. По ним видно, в какой момент и на каком пакете всё сломалось.
Типовые ошибки apt и их решения
Блокировка lock-файлами
Сообщение: E: Could not get lock /var/lib/dpkg/lock-frontend. Apt не может начать работу, потому что ресурс занят.
Причины: параллельный apt в соседнем терминале, фоновая служба unattended-upgrades или предыдущий процесс упал из-за разрыва SSH либо ребута.
- Проверяем активные процессы: ps aux | grep -E 'apt|dpkg'.
- Если процессы живые, ждём: unattended-upgrades завершится сам.
- Если процессов нет, удаляем lock-файлы: sudo rm /var/lib/dpkg/lock /var/lib/dpkg/lock-frontend /var/cache/apt/archives/lock /var/lib/apt/lists/lock.
- Завершаем настройку: sudo dpkg --configure -a.
Удалять lock при работающем apt нельзя: это повреждает базу пакетов.
dpkg был прерван
Сообщение: E: dpkg was interrupted, you must manually run 'sudo dpkg --configure -a'. Предыдущая операция не завершилась, и apt отказывается продолжать.
Типичные поводы: жёсткая перезагрузка во время установки, OOM-killer, обрыв SSH во время апдейта, отключение питания.
- Запускаем sudo dpkg --configure -a. В большинстве случаев этого достаточно.
- При ошибке зависимостей: sudo apt --fix-broken install, затем снова dpkg --configure -a.
- Для конкретного пакета: sudo apt install --reinstall имя_пакета.
- При повреждении файла состояния восстанавливаем из резервной копии: sudo cp /var/lib/dpkg/status-old /var/lib/dpkg/status. Dpkg делает такой бэкап автоматически.
Ошибки GPG-ключей репозиториев
Сообщения: NO_PUBKEY, The following signatures couldn't be verified, Key is stored in legacy trusted.gpg keyring. Apt не доверяет репозиторию, потому что не может проверить подпись.
Важный нюанс: в Ubuntu 24.04 и Debian 12 команда apt-key удалена, а хранилище /etc/apt/trusted.gpg больше не читается по умолчанию. Устаревшие инструкции из интернета тут не сработают.
Современный способ добавления ключа:
- Создаём каталог: sudo mkdir -p /etc/apt/keyrings.
- Скачиваем ключ и сразу конвертируем в бинарный формат:
sudo gpg --dearmor -o /etc/apt/keyrings/example.gpg
- В файле источника прописываем параметр signed-by:
main
- Проверяем: sudo apt update.
Ключ в формате .asc кладём в /etc/apt/keyrings/ без конвертации. Старые ключи из legacy-хранилища экспортируем через gpg --export и сохраняем туда же.
Hash Sum mismatch и проблемы с зеркалами
Сообщение: W: Failed to fetch ... Hash Sum mismatch. Контрольная сумма скачанного файла не совпала с той, что в подписанном Release-файле.
Причины: устаревший кэш, несинхронный CDN, обрыв при скачивании или временно битое зеркало.
- Чистим кэш: sudo rm -rf /var/lib/apt/lists/* и sudo apt clean.
- Повторяем sudo apt update.
- Если не помогло, форсируем IPv4 через файл /etc/apt/apt.conf.d/99force-ipv4 с содержимым Acquire::ForceIPv4 "true";.
- Если проблема сохраняется часами, значит сломано конкретное зеркало. Меняем его.
Для серверов в России стандартные зеркала Canonical иногда работают нестабильно. В таких случаях переключаемся на отечественные: mirror.yandex.ru, mirror.logol.ru и аналогичные:
sudo apt update
На VPS от Serverspace сетевая инфраструктура изначально оптимизирована под российских пользователей, поэтому apt работает быстро и подобные ошибки встречаются реже.
Ошибка 404 и недоступный репозиторий
Симптом: 404 Not Found при apt update или The repository ... no longer has a Release file.
Первая причина: дистрибутив достиг конца поддержки. Пакеты переезжают на old-releases.ubuntu.com, основные зеркала их больше не раздают. Меняем адрес:
s|security.ubuntu.com|old-releases.ubuntu.com|g' /etc/apt/sources.list
После такого фикса имеет смысл запланировать обновление до актуального LTS, потому что патчей безопасности для снятых с поддержки версий уже нет.
Вторая причина: удалённый или переехавший PPA. Находим файл в /etc/apt/sources.list.d/ и удаляем либо комментируем.
Третья причина: опечатка в URL или кодовом имени релиза. Ищем виновника: grep -r "проблемный_урл" /etc/apt/sources.list /etc/apt/sources.list.d/.
Unmet dependencies и held broken packages
Сообщения: The following packages have unmet dependencies, E: Unable to correct problems, you have held broken packages.
Причины: PPA конфликтует с официальными репо, в sources.list смешаны разные кодовые имена (например, noble и jammy), либо пакет зафиксирован через apt-mark hold.
- Смотрим зажатые пакеты: apt-mark showhold. При необходимости снимаем hold: sudo apt-mark unhold имя_пакета.
- Проверяем источники пакета: apt-cache policy пакет.
- Стандартный фикс: sudo apt --fix-broken install.
- Если apt не справляется, пробуем aptitude: sudo apt install aptitude, затем sudo aptitude install пакет. Aptitude предлагает несколько вариантов решения конфликта.
- Если виноват сторонний PPA, отключаем его и повторяем процедуру.
Команды dpkg --force-depends и dpkg --force-all оставляем на крайний случай: они обходят проверку зависимостей.
Переполнение /boot и no space left on device
Симптомы: E: gzip: stdout: No space left on device, mkinitramfs failure. Почти всегда вылезает при установке нового ядра.
На типичном VPS раздел /boot небольшой (500 МБ или 1 ГБ), а каждое ядро с initrd занимает 100-200 МБ. За год регулярных обновлений раздел забивается.
- Смотрим занятость: df -h /boot и список ядер: dpkg -l | grep linux-image.
- Определяем текущее ядро: uname -r. Его не трогаем ни при каких условиях.
- Простой путь: sudo apt autoremove --purge.
- Если /boot забит настолько, что autoremove не хватает места, вручную удаляем один старый initrd (кроме текущего), затем sudo apt -f install, потом autoremove.
- Обновляем загрузчик: sudo update-grub.
Для профилактики в файле /etc/apt/apt.conf.d/50unattended-upgrades раскомментируем Unattended-Upgrade::Remove-Unused-Kernel-Packages "true";.
Универсальный порядок действий, если ничего не помогает
Когда непонятно, с чего начать, или точечный фикс не сработал, применяем стандартную цепочку от безопасного к радикальному:
- sudo rm -rf /var/lib/apt/lists/* и sudo apt clean сбрасывают кэш.
- sudo apt update пересобирает индексы.
- sudo dpkg --configure -a завершает недоделанные операции.
- sudo apt --fix-broken install чинит зависимости.
- sudo apt full-upgrade подтягивает систему до согласованного состояния.
- sudo apt autoremove --purge убирает мусор.
- Если цепочка не помогла, повторяем шаги 3, 4 и 5 через aptitude.
Перед радикальными действиями на продакшене разумно сделать снапшот диска. На VPS Serverspace снапшот создаётся из панели управления за несколько кликов, что позволяет откатиться к рабочему состоянию за минуту в случае неудачного эксперимента.
Таблица быстрой диагностики ошибок apt
Короткая справка по основным сообщениям и первым шагам восстановления.
| Сообщение об ошибке | Вероятная причина | Первое действие |
|---|---|---|
| Could not get lock /var/lib/dpkg/lock | Параллельный apt или упавший процесс | Проверить ps aux, удалить lock-файлы при отсутствии процессов |
| dpkg was interrupted | Прерванная установка или обновление | sudo dpkg --configure -a |
| NO_PUBKEY | Отсутствует ключ репозитория | Добавить ключ в /etc/apt/keyrings/ с параметром signed-by |
| Hash Sum mismatch | Битый кэш или несинхронное зеркало | Очистить /var/lib/apt/lists/ и повторить update |
| 404 Not Found | EOL-релиз, мёртвый PPA или опечатка в URL | Переключить на old-releases или удалить источник |
| Unmet dependencies | Конфликт репозиториев или зажатый пакет | apt --fix-broken install, при необходимости aptitude |
| No space left on device | Забит /boot старыми ядрами | apt autoremove --purge, затем update-grub |
| sub-process /usr/bin/dpkg returned an error code (1) | Повреждён пакет или база dpkg | dpkg --configure -a, затем reinstall пакета |
Как избежать проблем с apt в будущем
Большинство поломок предотвращается аккуратной эксплуатацией. Несколько простых правил:
- Обновляться регулярно. sudo apt update && sudo apt upgrade хотя бы раз в неделю.
- Минимизировать сторонние источники. Каждый PPA это потенциальная точка отказа.
- Делать снапшот перед серьёзными изменениями: смена ядра, переход между LTS, установка Plesk или ISPmanager.
- Настроить автоочистку старых ядер, чтобы не ловить переполнение /boot.
- Не смешивать кодовые имена релизов в sources.list.
Заключение
Ошибки apt выглядят пугающе только до первого успешного разбора. Почти все они укладываются в несколько типовых сценариев: прерванный процесс, проблема с ключами, протухший кэш, переполненный /boot, конфликт репозиториев. Подход один и тот же: сначала читаем сообщение об ошибке, затем применяем точечное действие, начиная с самого безопасного. Таблица выше покрывает большинство ситуаций из повседневной работы с VPS на Debian и Ubuntu.