Amnezia VPN Docker не ставится на VPS: что проверить в Ubuntu, SSH и правах

Почему установка ломается чаще всего

AmneziaVPN при настройке self-hosted сервера подключается к VPS по SSH, затем устанавливает Docker и запускает контейнеры. Если один из этих этапов не проходит, установка останавливается целиком. Такой сценарий прямо описан в официальной документации Amnezia.

На практике чаще всего мешают пять вещей:

• сервер не подходит по требованиям Amnezia;
• SSH открыт, но вход идет не тем пользователем или не тем методом;
• пользователь может выполнять sudo только с вводом пароля;
• в системе уже установлен Docker из конфликтующего источника или остались старые пакеты;
• провайдер VPS использует контейнерную виртуализацию вместо KVM.

Хорошая новость в том, что почти все эти проблемы можно проверить за 10–15 минут без глубокой админской подготовки.

Что проверить на стороне VPS

По требованиям Amnezia для self-hosted сценария официально поддерживаются Ubuntu 22.04.x и 24.04.x, а также Debian 12 и 13. Нужны публичный IPv4, SSH-доступ и VPS на KVM. Контейнерная виртуализация OpenVZ/LXC не подходит. Также в документации указано, что x86-64 или amd64 поддерживаются, а arm64 не подходит для такого сценария. Это важно проверить до любых попыток переустановки. Требования перечислены в справке по требованиям к VPS.

Если VPS куплен у провайдера с нестандартным шаблоном Ubuntu, лучше не гадать, а посмотреть параметры в панели управления и при необходимости развернуть чистый образ заново. Это часто экономит время.

Как проверить SSH-доступ

Даже когда сервер пингуется, этого мало. Для установки нужен именно рабочий SSH-сеанс под тем пользователем, которого вы вводите в приложении.

1. Подключитесь к серверу вручную через терминал: под Windows это может быть PowerShell или Terminal, под macOS и Linux — обычный Terminal.
2. Проверьте, что используете правильный порт. Если у провайдера не 22, в Amnezia нужно указывать адрес в формате IP:порт.
3. Убедитесь, что вход проходит тем же способом, что и в приложении: либо пароль, либо приватный ключ.
4. Если вход по ключу есть, а по паролю нет, не выбирайте парольный сценарий в приложении.
5. Если сервер просит сначала войти под одним пользователем, а потом делать su или sudo с дополнительным подтверждением, это уже потенциальная точка сбоя.

Полезно проверить и содержимое SSH-настроек. В /etc/ssh/sshd_config важны параметры, связанные с PasswordAuthentication, PubkeyAuthentication и PermitRootLogin. Менять их стоит осторожно: одна ошибка в SSH-конфиге может оставить сервер без удаленного доступа.

Если вы пользуетесь чужими ключами, неясными шаблонами или временными тестовыми конфигами, установка часто срывается на базовом этапе авторизации. В такой ситуации вариант из кнопки в начале страницы выглядит более предсказуемо, а к ручной настройке self-hosted лучше возвращаться уже с понятным и чистым сервером.

Какие права нужны пользователю

Amnezia допускает вход не только под root, но и под пользователем из группы sudo, если он может выполнять любые sudo-команды без запроса пароля. Это прямо указано в документации к VPS-требованиям и сценарию установки.

Здесь часто возникает путаница: пользователь формально состоит в sudo, но при выполнении административной команды система запрашивает пароль. Для ручной работы это нормально, а для автоматической установки — уже проблема.

Как быстро проверить права

1. Подключитесь по SSH под тем пользователем, которого вводите в Amnezia.
2. Выполните команду sudo -n true.
3. Если команда завершается без ошибки и без запроса пароля, права подходят.
4. Если видите сообщение о необходимости пароля, автоматическая установка может не пройти.

Еще один полезный тест — выполнить sudo whoami. В ответе должен быть root. Но для сценария Amnezia важнее именно возможность запускать sudo без интерактивного запроса.

Если вы не уверены в настройке sudoers, безопаснее создать отдельного технического пользователя с понятными правами, чем править существующую конфигурацию наугад.

Что проверить в Ubuntu и Docker

Если с VPS и SSH все в порядке, следующий слой — сама Ubuntu. Установка Docker может ломаться из-за старых пакетов, битых репозиториев, нестандартных firewall-правил или частично установленного контейнерного окружения.

Типовые проблемы в Ubuntu

• в системе уже был установлен Docker не из официального репозитория;
• остались старые пакеты docker.io, podman-docker, containerd или похожие конфликты;
• apt не может обновить индексы пакетов;
• на сервере настроен firewall без понимания того, как Docker работает с iptables;
• система слишком сильно изменена вручную после развертывания образа.

Docker отдельно предупреждает, что при использовании ufw или firewalld опубликованные порты контейнеров могут обходить часть правил firewall, а для совместимости важны iptables-цепочки. Также официальный сценарий установки требует root или sudo-прав. Это описано в документации Docker для Ubuntu.

Что имеет смысл проверить вручную

1. Узнайте версию системы: lsb_release -a или cat /etc/os-release.
2. Проверьте архитектуру: uname -m. Для поддерживаемого сценария нужен x86_64 или amd64.
3. Обновите список пакетов: sudo apt update.
4. Проверьте, нет ли полусломанных пакетов: sudo apt --fix-broken install.
5. Посмотрите, установлен ли Docker: docker --version и systemctl status docker.
6. Проверьте конфликтующие пакеты через список установленных пакетов.
7. Убедитесь, что на диске хватает места: df -h.

Если Docker уже стоит и работает, а Amnezia все равно не завершает установку, проблема может быть не в контейнерном движке, а в том, что сервер не проходит один из формальных критериев: архитектура, тип виртуализации, IPv4 или права.

Таблица быстрой диагностики

Порядок действий по шагам

Ниже — практический порядок, который обычно помогает быстрее всего.

1. Сначала проверьте, что у вас именно Ubuntu 22.04 или 24.04, либо Debian 12 или 13.
2. Убедитесь, что VPS работает на KVM, а не на OpenVZ/LXC.
3. Проверьте наличие публичного IPv4 и обычного SSH-доступа извне.
4. Войдите по SSH вручную под тем же пользователем, который указан в Amnezia.
5. Проверьте, выполняется ли sudo -n true без запроса пароля.
6. Узнайте архитектуру через uname -m и убедитесь, что это x86_64.
7. Проверьте apt update и общее состояние пакетов.
8. Если в системе уже был Docker, разберите, откуда он установлен и нет ли конфликта пакетов.
9. Посмотрите свободное место на диске и базовую сетевую доступность.
10. После исправлений повторите установку на чистом сеансе, а если сервер сильно изменен вручную — лучше переустановите ОС из чистого образа.

Если задача не в том, чтобы обязательно поднимать свой сервер, а в том, чтобы получить стабильное подключение на ПК и телефоне без ручной доводки Ubuntu, кнопка в начале страницы остается нормальным официальным альтернативным сценарием. Но при желании разобраться с self-hosted логика проверки выше обычно приводит к причине сбоя довольно быстро.

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