WIKi

<div class="vaultwarden-install-guide">

  <h2>🔐 Установка Vaultwarden (Docker + Nginx + Certbot)</h2>

  <h3>Шаг 1: Установка Docker и Docker Compose</h3>

  <p>Vaultwarden удобнее всего запускать в контейнере.</p>

  <pre class="bash"><code># Обновляем пакеты

sudo apt update && sudo apt upgrade -y

# Устанавливаем Docker

sudo apt install docker.io -y

# Устанавливаем плагин Docker Compose

sudo apt install docker-compose-plugin -y

# Добавляем пользователя в группу docker (чтобы не писать sudo перед docker)

sudo usermod -aG docker $USER

# Применим группу без перезагрузки

newgrp docker</code></pre>

  <h3>Шаг 2: Установка Nginx и Certbot</h3>

  <p>Nginx будет работать как обратный прокси (принимать запросы из интернета и передавать их в Vaultwarden), а Certbot получит SSL-сертификат.</p>

  <pre class="bash"><code>sudo apt install nginx certbot python3-certbot-nginx -y</code></pre>

  <h3>Шаг 3: Получение SSL-сертификата</h3>

  <p>На этом этапе Nginx должен быть запущен и доступен по порту 80.<br>

  Создайте временный конфиг для Nginx (чтобы Certbot мог проверить домен):</p>

  <pre class="bash"><code>sudo nano /etc/nginx/sites-available/vaultwarden</code></pre>

  <p>Вставьте следующее (замените <code>vault.example.com</code> на ваш домен):</p>

  <pre class="nginx"><code>server {

    listen 80;

    server_name vault.example.com;

    location / {

        return 200 'OK';

        add_header Content-Type text/plain;

    }

}</code></pre>

  <p>Включите сайт и перезапустите Nginx:</p>

  <pre class="bash"><code>sudo ln -s /etc/nginx/sites-available/vaultwarden /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl restart nginx</code></pre>

  <p>Запустите Certbot для получения сертификата:</p>

  <pre class="bash"><code>sudo certbot --nginx -d vault.example.com</code></pre>

  <ul>

    <li>Введите email для уведомлений</li>

    <li>Согласитесь с условиями</li>

    <li>Выберите вариант перенаправления на HTTPS (рекомендуется вариант 2)</li>

  </ul>

  <p>✅ Certbot автоматически настроил обновление сертификатов через systemd timer.<br>

  Проверить можно командой: <code>sudo systemctl list-timers | grep certbot</code></p>

  <div class="success-box">

    <strong>Пример успешного вывода:</strong>

    <pre><code>Saving debug log to /var/log/letsencrypt/letsencrypt.log

Requesting a certificate for vw.saria.by

Successfully received certificate.

Certificate is saved at: /etc/letsencrypt/live/vw.saria.by/fullchain.pem

Key is saved at:         /etc/letsencrypt/live/vw.saria.by/privkey.pem

This certificate expires on 2026-06-22.

These files will be updated when the certificate renews.

Certbot has set up a scheduled task to automatically renew this certificate in the background.

Deploying certificate

Successfully deployed certificate for vw.saria.by to /etc/nginx/sites-enabled/vaultwarden

Congratulations! You have successfully enabled HTTPS on https://vw.saria.by</code></pre>

  </div>

  <h3>Шаг 4: Настройка Nginx для проксирования</h3>

  <p>Теперь нужно настроить Nginx так, чтобы он передавал запросы в контейнер Vaultwarden.<br>

  Откройте конфиг снова (Certbot мог его изменить):</p>

  <pre class="bash"><code>sudo nano /etc/nginx/sites-available/vaultwarden</code></pre>

  <pre class="nginx"><code># HTTP на порту 80 → редирект на HTTPS с портом 55641

server {

    listen 80;

    server_name vw.saria.by;

    return 301 https://$server_name:55641$request_uri;

}

# HTTPS на порту 55641

server {

    listen 55641 ssl http2;

    server_name vw.saria.by;

    # Пути к сертификатам

    ssl_certificate /etc/letsencrypt/live/vw.saria.by/fullchain.pem;

    ssl_certificate_key /etc/letsencrypt/live/vw.saria.by/privkey.pem;

    # Современные настройки SSL

    ssl_protocols TLSv1.2 TLSv1.3;

    ssl_prefer_server_ciphers on;

    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;

    # Отключаем логирование токенов в доступе (опционально, для приватности)

    proxy_hide_header Authorization;

    location / {

        proxy_pass http://127.0.0.1:8000;

        proxy_set_header Host $host;

        proxy_set_header X-Real-IP $remote_addr;

        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_set_header X-Forwarded-Port 55641;  # Важно: сообщаем Vaultwarden о внешнем порте

        # Для веб-сокетов (уведомления)

        proxy_http_version 1.1;

        proxy_set_header Upgrade $http_upgrade;

        proxy_set_header Connection "upgrade";

    }

}</code></pre>

  <p>Примените изменения:</p>

  <pre class="bash"><code>sudo nginx -t &amp;&amp; sudo systemctl reload nginx</code></pre>

  <h3>Шаг 5: Обновите docker-compose.yml для Vaultwarden</h3>

  <p>Откройте файл:</p>

  <pre class="bash"><code>nano ~/vaultwarden/docker-compose.yml</code></pre>

  <p>Обновите секцию <code>environment</code>, особенно переменную <code>DOMAIN</code>:</p>

  <pre class="yaml"><code>version: '3'

services:

  vaultwarden:

    image: vaultwarden/server:latest

    container_name: vaultwarden

    restart: always

    volumes:

      - ${PWD}/data:/data

    ports:

      - 127.0.0.1:8000:80  # Vaultwarden внутри контейнера по-прежнему слушает порт 80

    environment:

      - DOMAIN=https://vw.saria.by:55641    # ← Обязательно укажите порт!

      - WEBSOCKET_ENABLED=true

      - SIGNUPS_ALLOWED=false

      - ADMIN_TOKEN=ПридумайтеОченьСложныйПароль_2026!

  watchtower:

    image: containrrr/watchtower

    container_name: watchtower

    restart: always

    volumes:

      - /var/run/docker.sock:/var/run/docker.sock

    command: --interval 86400 --cleanup</code></pre>

  <p>Перезапустите контейнеры:</p>

  <pre class="bash"><code>cd ~/vaultwarden

docker compose up -d</code></pre>

  <div class="info-box">

    💡 <strong>Важно:</strong> Переменная <code>DOMAIN</code> с указанием порта критически важна: 

    Vaultwarden использует её для генерации ссылок в письмах, настройки клиентов и проверки безопасности.

  </div>

  <h3>✅ Проверка работы</h3>

  <pre class="bash"><code># Проверьте, что Nginx слушает порт 55641

sudo ss -tlnp | grep 55641

# Протестируйте доступ локально

curl -kI https://127.0.0.1:55641

# Проверьте, что контейнер Vaultwarden запущен

docker ps | grep vaultwarden

# Посмотрите логи Nginx на ошибки

sudo tail -f /var/log/nginx/error.log</code></pre>

  <h3>🔧 Полезные команды</h3>

  <ul>

    <li><code>docker compose logs -f vaultwarden</code> — просмотр логов контейнера</li>

    <li><code>sudo certbot renew --dry-run</code> — тестовое обновление сертификата</li>

    <li><code>sudo systemctl status nginx</code> — статус Nginx</li>

    <li><code>docker exec -it vaultwarden /bin/bash</code> — вход в контейнер</li>

  </ul>

</div>

<style>

.vaultwarden-install-guide {

  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;

  line-height: 1.6;

  color: #333;

  max-width: 100%;

}

.vaultwarden-install-guide h2 {

  color: #2c3e50;

  border-bottom: 2px solid #3498db;

  padding-bottom: 0.5em;

  margin-top: 1.5em;

}

.vaultwarden-install-guide h3 {

  color: #34495e;

  margin: 1.2em 0 0.8em;

  background: #f8f9fa;

  padding: 0.5em 0.8em;

  border-left: 4px solid #3498db;

}

.vaultwarden-install-guide pre {

  background: #2d2d2d;

  color: #f8f8f2;

  padding: 1em;

  border-radius: 4px;

  overflow-x: auto;

  font-size: 0.9em;

  margin: 0.8em 0;

}

.vaultwarden-install-guide code {

  font-family: "Consolas", "Monaco", monospace;

}

.vaultwarden-install-guide .bash::before,

.vaultwarden-install-guide .nginx::before,

.vaultwarden-install-guide .yaml::before {

  content: attr(class);

  display: block;

  background: #444;

  color: #aaa;

  padding: 0.2em 0.5em;

  margin: -1em -1em 1em -1em;

  font-size: 0.8em;

  border-radius: 4px 4px 0 0;

}

.vaultwarden-install-guide ul {

  padding-left: 1.5em;

}

.vaultwarden-install-guide li {

  margin: 0.3em 0;

}

.vaultwarden-install-guide .success-box {

  background: #d4edda;

  border: 1px solid #c3e6cb;

  border-left: 4px solid #28a745;

  padding: 1em;

  margin: 1em 0;

  border-radius: 0 4px 4px 0;

}

.vaultwarden-install-guide .info-box {

  background: #d1ecf1;

  border: 1px solid #bee5eb;

  border-left: 4px solid #17a2b8;

  padding: 1em;

  margin: 1em 0;

  border-radius: 0 4px 4px 0;

}

.vaultwarden-install-guide a {

  color: #3498db;

  text-decoration: none;

}

.vaultwarden-install-guide a:hover {

  text-decoration: underline;

}

</style>