Установка Vaultwarden с HTTPS и резервным копированием
Разверните Vaultwarden на Debian или Ubuntu с Docker и Caddy: обязательный HTTPS, закрытая регистрация, хешированный токен администратора, обновления, резервное копирование и проверка восстановления.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как развернуть на собственном сервере 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.yamlservices:
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/, если вы используете импорты:
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: создайте свою учётную запись по приглашению
Поскольку регистрация закрыта, первая учётная запись создаётся по приглашению администратора.
- Откройте
https://vault.ваш-домен.com/adminсВАШ_IP. - Введите пароль, сгенерированный на шаге 2, а не его отпечаток.
- На вкладке Users используйте блок Invite User и укажите свой адрес электронной почты.
- Без SMTP-сервера письма не отправляются. Откройте напрямую
https://vault.ваш-домен.com/#/signupи зарегистрируйтесь с тем же адресом. - Выберите длинный уникальный мастер-пароль и войдите.
Затем включите метод двухэтапной аутентификации в настройках безопасности учётной записи и храните код восстановления вне хранилища.
В приложениях Bitwarden для компьютера, телефона или браузера выберите на экране входа самостоятельно размещённый сервер, затем укажите https://vault.ваш-домен.com.
Шаг 6: уменьшите поверхность атаки
После создания учётных записей добавьте эту строку в environment, чтобы участники организации больше не могли приглашать новых пользователей:
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