RU

Приложения

Установка Vaultwarden с HTTPS и резервным копированием

Разверните Vaultwarden на Debian или Ubuntu с Docker и Caddy: обязательный HTTPS, закрытая регистрация, хешированный токен администратора, обновления, резервное копирование и проверка восстановления.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как развернуть на собственном сервере Vaultwarden — лёгкий сервер, совместимый с приложениями Bitwarden. Vaultwarden работает в Docker и доступен только локально. Caddy публикует его по HTTPS.

К концу руководства ваше хранилище будет отвечать по адресу https://vault.ваш-домен.com, никто не сможет зарегистрироваться в нём без приглашения, токен администратора будет храниться в виде хеша, а ежедневная резервная копия будет создаваться, и вы проверите её восстановление.

Заказать сервер

Это руководство подходит для серверов, которыми вы управляете самостоятельно:

Предварительные требования

  • Сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
  • Доступ по SSH под пользователем с правами sudo
  • Docker Engine и Docker Compose, установленные по руководству Установка Docker Engine и Docker Compose
  • Caddy, установленный по руководству Caddy как обратный прокси с автоматическим HTTPS
  • Доменное имя, DNS-зоной которого вы управляете
  • Публичный IP-адрес вашего компьютера, чтобы ограничить доступ к странице администрирования

Используемые порты

Порт Направление Назначение Нужно ли открывать
80/tcp Входящий Проверка сертификата и перенаправление на HTTPS Да
443/tcp Входящий Доступ к хранилищу по HTTPS Да
443/udp Входящий HTTP/3 Рекомендуется
8222/tcp Локальный Vaultwarden, только на 127.0.0.1 Нет

Шаг 1: подготовьте домен и брандмауэр

Создайте запись A для vault.ваш-домен.com, указывающую на IP_ВАШЕГО_СЕРВЕРА. Если ваш домен обслуживается в HostMyServers, следуйте руководству Создание записи A.

Если вы используете UFW, разрешите веб-порты:

Терминал
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp
sudo ufw status

Если UFW ещё не активен, сначала следуйте руководству Настройка брандмауэра UFW без потери SSH-доступа.

Порты, опубликованные Docker, обходят правила UFW. Поэтому файл Compose из шага 3 публикует Vaultwarden на 127.0.0.1: он недоступен из Интернета независимо от ваших правил.

Шаг 2: создайте хешированный токен администратора

Страница /admin позволяет управлять учётными записями экземпляра. Она защищена токеном, который вы будете хранить только в виде отпечатка Argon2.

Создайте каталог приложения, затем сгенерируйте длинный случайный пароль администратора:

Терминал
sudo mkdir -p /opt/vaultwarden
cd /opt/vaultwarden
openssl rand -base64 32

Храните этот пароль вне хранилища, например в другом менеджере паролей или на офлайн-носителе. Он понадобится вам для входа в /admin, в том числе когда хранилище недоступно.

Затем вычислите его отпечаток. Команда дважды запросит пароль:

Терминал
sudo docker run --rm -it vaultwarden/server:1.37.5 /vaultwarden hash

Она выведет строку такого вида:

Текст
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$...'

Создайте файл .env:

Терминал
sudo nano /opt/vaultwarden/.env

Вставьте в него отпечаток в апострофах, не удваивая символы $:

Терминал
VAULTWARDEN_ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$...'

Защитите файл:

Терминал
sudo chmod 600 /opt/vaultwarden/.env

Шаг 3: напишите файл Compose

Терминал
sudo nano /opt/vaultwarden/compose.yaml
YAML
services:
  vaultwarden:
    image: vaultwarden/server:1.37.5
    container_name: vaultwarden
    restart: unless-stopped
    environment:
      DOMAIN: "https://vault.ваш-домен.com"
      SIGNUPS_ALLOWED: "false"
      ADMIN_TOKEN: "${VAULTWARDEN_ADMIN_TOKEN}"
    volumes:
      - ./vw-data:/data
    ports:
      - "127.0.0.1:8222:80"
Параметр Назначение
image Точная версия, которую вы меняете осознанно при обновлениях
DOMAIN Точный публичный адрес с https://
SIGNUPS_ALLOWED false закрывает свободную регистрацию с самого первого запуска
ADMIN_TOKEN Отпечаток, прочитанный из .env
127.0.0.1:8222:80 Порт, доступный только с самого сервера

Проверьте результат, затем запустите службу:

Терминал
cd /opt/vaultwarden
sudo docker compose config --quiet
sudo docker compose up -d
sudo docker compose ps
curl -fsS http://127.0.0.1:8222/alive

Последняя команда возвращает дату в кавычках. Примерно через минуту в столбце состояния docker compose ps появится healthy.

Шаг 4: опубликуйте хранилище через Caddy

Добавьте этот сайт в /etc/caddy/Caddyfile или в файл из /etc/caddy/sites/, если вы используете импорты:

caddyfile
vault.ваш-домен.com {
	encode zstd gzip

	@admin_denied {
		path /admin /admin/*
		not client_ip ВАШ_IP
	}
	abort @admin_denied

	reverse_proxy 127.0.0.1:8222 {
		header_up X-Real-IP {remote_host}
	}
}

К /admin может обратиться только ВАШ_IP: остальные соединения обрываются без ответа. Если вы выходите в Интернет по IPv6, добавьте также свой адрес IPv6 после client_ip. Заголовок X-Real-IP позволяет Vaultwarden записывать в журнал реальные адреса посетителей.

Проверьте и примените конфигурацию:

Терминал
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo -u caddy caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy

Проверка результата

Терминал
curl -I http://vault.ваш-домен.com
curl -fsS https://vault.ваш-домен.com/alive
sudo ss -ltnp | grep 8222

Первая команда должна вернуть перенаправление 308 на HTTPS, вторая — дату. Третья должна показать 127.0.0.1:8222 и ни одного публичного адреса.

С вашего компьютера http://IP_ВАШЕГО_СЕРВЕРА:8222 не должен отвечать. При подключении не с ВАШ_IP, например с телефона через мобильный интернет, https://vault.ваш-домен.com/admin должен быть недоступен.

Шаг 5: создайте свою учётную запись по приглашению

Поскольку регистрация закрыта, первая учётная запись создаётся по приглашению администратора.

  1. Откройте https://vault.ваш-домен.com/admin с ВАШ_IP.
  2. Введите пароль, сгенерированный на шаге 2, а не его отпечаток.
  3. На вкладке Users используйте блок Invite User и укажите свой адрес электронной почты.
  4. Без SMTP-сервера письма не отправляются. Откройте напрямую https://vault.ваш-домен.com/#/signup и зарегистрируйтесь с тем же адресом.
  5. Выберите длинный уникальный мастер-пароль и войдите.

Затем включите метод двухэтапной аутентификации в настройках безопасности учётной записи и храните код восстановления вне хранилища.

В приложениях Bitwarden для компьютера, телефона или браузера выберите на экране входа самостоятельно размещённый сервер, затем укажите https://vault.ваш-домен.com.

Шаг 6: уменьшите поверхность атаки

После создания учётных записей добавьте эту строку в environment, чтобы участники организации больше не могли приглашать новых пользователей:

YAML
      INVITATIONS_ALLOWED: "false"

Если вы больше не пользуетесь страницей администрирования, отключите её, удалив строку ADMIN_TOKEN из compose.yaml. Убедитесь также, что в vw-data/config.json нет ключа admin_token, если этот файл существует. Затем примените изменения:

Терминал
cd /opt/vaultwarden
sudo docker compose up -d

Чтобы позже пригласить нового человека, временно верните ADMIN_TOKEN, удалите INVITATIONS_ALLOWED и пересоздайте контейнер тем же способом.

Обновление Vaultwarden

Прочитайте примечания к выпуску, запустите резервное копирование службой, созданной в следующем разделе, затем замените номер версии в compose.yaml:

Терминал
cd /opt/vaultwarden
sudo systemctl start vaultwarden-backup.service
sudo nano compose.yaml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs --tail=50 vaultwarden

Начиная с версии 1.37.5, недопустимое значение конфигурации не позволяет запуститься. Если контейнер перезапускается в цикле, прочитайте его журналы.

Автоматическое резервное копирование

Следующий скрипт создаёт согласованную копию базы встроенной в Vaultwarden командой, а затем архивирует нужные файлы. Кэш значков намеренно пропускается.

Терминал
sudo nano /usr/local/sbin/vaultwarden-backup.sh
Терминал
#!/bin/sh
set -eu
umask 077

APP_DIR=/opt/vaultwarden
DEST=/var/backups/vaultwarden
STAMP=$(date +%F-%H%M)
WORK=$(mktemp -d)
trap 'rm -rf "$WORK"' EXIT

mkdir -p "$DEST" "$WORK/data"
cd "$APP_DIR"

docker compose exec -T vaultwarden /vaultwarden backup
DB=$(ls -1t vw-data/db_*.sqlite3 | head -n 1)
mv "$DB" "$WORK/data/db.sqlite3"

for item in vw-data/attachments vw-data/sends vw-data/config.json vw-data/rsa_key*; do
    if [ -e "$item" ]; then
        cp -a "$item" "$WORK/data/"
    fi
done
cp -a compose.yaml .env "$WORK/"

tar -czf "$DEST/vaultwarden-$STAMP.tar.gz" -C "$WORK" .
find "$DEST" -name 'vaultwarden-*.tar.gz' -mtime +14 -delete

Создайте службу /etc/systemd/system/vaultwarden-backup.service:

Конфигурация
[Unit]
Description=Vaultwarden backup
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
ExecStart=/usr/local/sbin/vaultwarden-backup.sh

Затем таймер /etc/systemd/system/vaultwarden-backup.timer:

Конфигурация
[Unit]
Description=Daily Vaultwarden backup

[Timer]
OnCalendar=*-*-* 03:15:00
RandomizedDelaySec=15m
Persistent=true

[Install]
WantedBy=timers.target

Включите всё это и запустите первое резервное копирование:

Терминал
sudo chmod 700 /usr/local/sbin/vaultwarden-backup.sh
sudo systemctl daemon-reload
sudo systemctl enable --now vaultwarden-backup.timer
sudo systemctl start vaultwarden-backup.service
sudo ls -lh /var/backups/vaultwarden

Архивы хранятся на сервере 14 дней, а это не защищает от его потери. Регулярно копируйте их в другое место. Они содержат, в частности, .env и ключ rsa_key.pem: шифруйте их, если место назначения вам не подконтрольно, например командой gpg --symmetric --cipher-algo AES256 archive.tar.gz.

Элемент Содержимое Резервное копирование
db.sqlite3 Учётные записи, зашифрованные хранилища, организации Обязательно
attachments/ Вложения Обязательно
rsa_key* Подпись сессий Рекомендуется
config.json Настройки, сохранённые из /admin Рекомендуется
sends/ Файлы Send Необязательно
icon_cache/ Значки сайтов Не нужно

Проверка восстановления

Резервная копия имеет ценность, только если её можно восстановить. Этот тест запускает изолированную копию на другом порту, не затрагивая работающий экземпляр.

Распакуйте последний архив и проверьте базу:

Терминал
sudo apt install -y sqlite3
sudo install -d -m 700 /root/vw-restore-test
sudo sh -c 'tar -xzf "$(ls -1t /var/backups/vaultwarden/*.tar.gz | head -n 1)" -C /root/vw-restore-test'
sudo sqlite3 /root/vw-restore-test/data/db.sqlite3 'PRAGMA integrity_check;'

Последняя команда должна вывести ok. Затем запустите копию:

Терминал
sudo docker run -d --rm --name vaultwarden-restore-test \
  -e DOMAIN=http://localhost:8223 \
  -e SIGNUPS_ALLOWED=false \
  -v /root/vw-restore-test/data:/data \
  -p 127.0.0.1:8223:80 \
  vaultwarden/server:1.37.5
curl -fsS http://127.0.0.1:8223/alive

С вашего компьютера откройте SSH-туннель:

Терминал
ssh -L 8223:127.0.0.1:8223 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА

Откройте http://localhost:8223, войдите в свою учётную запись, затем убедитесь, что недавняя запись и вложение открываются корректно. Браузеры считают localhost защищённым контекстом, поэтому этот тест возможен без сертификата.

Закройте туннель, затем удалите копию:

Терминал
sudo docker stop vaultwarden-restore-test
sudo rm -rf /root/vw-restore-test

Повторяйте этот тест после каждого важного изменения и не реже одного раза в квартал.

Восстановление в рабочей среде

Замените имя архива на имя выбранной резервной копии. На новом сервере сначала восстановите compose.yaml и .env в /opt/vaultwarden из корня архива.

Терминал
ARCHIVE=/var/backups/vaultwarden/vaultwarden-2026-11-18-0315.tar.gz
cd /opt/vaultwarden
sudo docker compose down
sudo mv vw-data "vw-data.old-$(date +%F)"
sudo install -d -m 700 /root/vw-restore
sudo tar -xzf "$ARCHIVE" -C /root/vw-restore
sudo cp -a /root/vw-restore/data /opt/vaultwarden/vw-data
sudo docker compose up -d
sudo rm -rf /root/vw-restore

Войдите и проверьте свои данные, прежде чем удалять старый каталог vw-data.old-*.

Если что-то пошло не так

The "argon2id" variable is not set

Docker Compose пытается интерпретировать символы $ в отпечатке. Он должен находиться в .env в апострофах, а compose.yaml должен лишь ссылаться на ${VAULTWARDEN_ADMIN_TOKEN}. Проверьте результат командой sudo docker compose config: символы $ там удвоены, и в этом месте это нормально.

The configured Argon2 PHC in ADMIN_TOKEN is invalid

Значение, полученное Vaultwarden, неверно, часто из-за лишних кавычек или удвоенных $ в .env. Проверьте его:

Терминал
sudo docker exec vaultwarden printenv ADMIN_TOKEN

Вывод должен начинаться с $argon2id$, без кавычек.

Invalid admin token, please try again.

Введите исходный пароль, а не отпечаток. Если вы его потеряли, сгенерируйте новый, повторив шаг 2, затем пересоздайте контейнер командой sudo docker compose up -d.

You are using a plain text ADMIN_TOKEN which is insecure

Vaultwarden всё ещё читает токен в открытом виде. Чаще всего config.json имеет приоритет над compose.yaml:

Терминал
sudo grep admin_token /opt/vaultwarden/vw-data/config.json

Тогда замените токен на странице /admin, в поле Admin token/Argon2 PHC.

The admin panel is disabled

Токен не настроен. Проверьте строку ADMIN_TOKEN в compose.yaml и содержимое .env, затем пересоздайте контейнер.

/admin больше не отвечает

Вероятно, IP-адрес вашего компьютера изменился. Исправьте client_ip в Caddyfile, затем проверьте и перезагрузите Caddy.

Registration not allowed or user already exists

Введённый адрес не соответствует ожидающему приглашению, либо учётная запись уже существует. Проверьте адрес на вкладке Users страницы /admin. Если INVITATIONS_ALLOWED равно false, удалите эту строку на время регистрации.

Изменённая переменная не действует

Если vw-data/config.json существует, он заменяет переменные окружения. Измените настройку на странице /admin или удалите соответствующий ключ из файла при остановленном контейнере.

Хранилище не открывается или сообщает, что требуется HTTPS

Убедитесь, что вы используете адрес с https:// и что DOMAIN содержит ровно этот адрес. Доступ по http://IP_ВАШЕГО_СЕРВЕРА не поддерживается.

Ошибка 502 в браузере

Caddy не может подключиться к контейнеру:

Терминал
cd /opt/vaultwarden
sudo docker compose ps
sudo docker compose logs --tail=50 vaultwarden
curl -fsS http://127.0.0.1:8222/alive

Ссылки