Установка и деплой

Быстрый старт

Структура `docker-compose.yml`

services:
  vaultwarden:
    image: vaultwarden/server:latest
    container_name: vaultwarden
    restart: unless-stopped
    environment:
      DOMAIN: "https://bitwarden.main.novikovtv.tv"
      ADMIN_TOKEN: ${ADMIN_TOKEN}
      SMTP_HOST: "smtp.yandex.ru"
      SMTP_FROM: "g.isupov@novikovtv.tv"
      SMTP_PORT: 465
      SMTP_SECURITY: "force_tls"
      SMTP_USERNAME: "g.isupov@novikovtv.tv"
      SMTP_PASSWORD: "********"
    volumes:
      - ./vw-data/:/data/
    ports:
      - 10080:80

Переменные

DOMAIN — публичный URL, обязательно с https://
ADMIN_TOKEN — токен для входа в админ-панель (https://<домен>/admin)
SMTP_* — настройки SMTP для почтовых уведомлений

Установка

Склонируйте репозиторий:
git clone https://github.com/asianetsievskaya/bitwarden.git
Создайте файл .env и укажите переменные:
ADMIN_TOKEN=""
ADMIN_TOKEN пока что оставляем пустым
Запустите контейнер:
bash update.sh
Проверьте доступ:
- Панель входа: https://bitwarden.main.novikovtv.tv
- Админка: https://bitwarden.main.novikovtv.tv/admin

Админ токен

Для генерации токена для административной панели (ADMIN_TOKEN) его нужно сгенерировать. Есть несколько способов, описанных в официальной документации.

Но предпочтительный вариант:

docker exec -it vaultwarden /vaultwarden hash

Бэкапы

Все данные хранятся в ./vw-data/ (внутри /data контейнера). Для резервного копирования достаточно сохранить эту папку:

tar czvf vw-backup-$(date +%F).tar.gz vw-data/

Обновление

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

Для обновления нужно ввести следующие команды:

docker compose pull
bash update.sh

Безопасность

Используйте сложный ADMIN_TOKEN
Рекомендуется подключить HTTPS через внешний прокси (Nginx)
Поддерживаются 2FA, WebAuthn, YubiKey
Включите e-mail подтверждение и удалённую регистрацию только при необходимости

Клиенты

Web — совместим с вашим сервером (через DOMAIN)
Desktop
Mobile: iOS/Android
CLI
Browser extensions

Дополнительно

Документация Vaultwarden: https://github.com/dani-garcia/vaultwarden/wiki
Telegram-боты, Webhooks и прочее — через REST API (/api)