آیا Vaultwarden امن است؟ راهنمای امنسازی و سختکاری
Vaultwarden محتوا را در سمت کلاینت رمزنگاری میکند اما متادیتا را به صورت متن ساده نگه میدارد. امنیت نهایی شما به محافظت از ADMIN_TOKEN و فایلهای پشتیبان بستگی دارد.
آیا Vaultwarden امن است؟ پاسخ کوتاه
Vaultwarden در مهمترین بخش خود امن است، زیرا هر آیتم موجود در vault پیش از رسیدن به سرور، روی دستگاه شما رمزنگاری میشود. سرور محتوای رمزنگاریشدهٔ vault را در کنار متادیتای حساب کاربری که به صورت متن ساده (plaintext) است، ذخیره میکند. کسی که کل دیتابیس را کپی کند، برای خواندن محتوا همچنان به کلیدهای رمزنگاری vault نیاز دارد، اما بلافاصله به آدرسهای ایمیل و راهنمای رمز عبور (password hints) دسترسی پیدا میکند.
این پاسخ کوتاه، جنبههای زیادی را پوشش نمیدهد و بخشهایی که آسیبپذیر هستند، همان قسمتهاییاند که شما پیکربندی میکنید. پنل مدیریتی که پشت یک توکن قابل حدس قرار دارد. پورت کانتینری که برای کل اینترنت باز شده است. یک config.json به صورت متن ساده. یک فایل پشتیبان tarball که در دایرکتوری home روی همان سرور رها شده است. هیچکدام از اینها مشکلات رمزنگاری نیستند. همهٔ اینها دلایلی هستند که باعث میشوند vaultهای شخصیسازیشده (self-hosted) خالی شوند.
تمام موارد زیر فرض را بر این میگذارند که یک نصب فعال دارید. اگر هنوز نصبی ندارید، ابتدا آن را با راهنمای نصب Vaultwarden برای VPS راهاندازی کنید، سپس بازگردید و این لیست را به ترتیب دنبال کنید.
آنچه سرور واقعاً ذخیره میکند
Vaultwarden مدل دادهای Bitwarden را پیادهسازی میکند. نام، نام کاربری، رمز عبور، یادداشتها و URIهای یک آیتم در vault، پیش از ارسال هرگونه درخواست، در سمت کلاینت با یک کلید آیتم که بهصورت تصادفی تولید شده، رمزنگاری میشوند. آن کلید توسط کلید متقارن کاربر یا سازمان محافظت میشود؛ کلید مشتقشده از رمز عبور نیز از کلید متقارن کاربر محافظت میکند. محتوای فایلهای پیوست از یک کلید پیوست مجزا استفاده میکنند که توسط کلید آیتم محافظت میشود. سرور دادههای مبهم (opaque) را به همراه یک UUID (شناسه منحصربهفرد جهانی) دریافت میکند.
برخی موارد به صورت متن رمزنگاریشده (ciphertext) نیستند و باید دقیقاً بدانید کدامها هستند:
- آدرس ایمیل حساب کاربری و راهنمای رمز عبور اصلی (master password hint) به صورت متن ساده (plaintext).
- تنظیمات KDF (تابع مشتق کلید) و salt، زیرا کلاینت برای بازسازی کلید در ورود بعدی به آنها نیاز دارد.
- هش سمت سرور از هش رمز عبور اصلی که کلاینت ارسال میکند؛ این مورد برای احراز هویت خودِ ورود استفاده میشود.
- متادیتا: عضویت در سازمان، نام دستگاهها، زمانهای آخرین ورود.
- کلید مخفی TOTP برای ورود دومرحلهای مبتنی بر authenticator. این کلید در جدول
twofactorبهصورت رمزنگارینشده قرار دارد، زیرا سرور باید کد مورد انتظار را محاسبه کند تا با کد شما مقایسه نماید. این مورد با کلید مخفی TOTP که داخل یک آیتم vault ذخیره میکنید متفاوت است؛ آن مورد مانند سایر فیلدها رمزنگاری میشود.
پوشه دادهها کوچک است. در نصب Docker، این پوشه همان مسیری است که در /data mount کردهاید.
sudo ls -l /vw-data/فایل db.sqlite3 تقریباً تمام وضعیت (state) را نگه میدارد. attachments/ فایلهای آپلودشده را در دایرکتوریهای UUID، خارج از جداول دیتابیس، نگهداری میکند. sends/ پیوستهای Send را نگه میدارد و ماهیت موقتی دارد. icon_cache/ قابل حذف است. rsa_key.pem و فایلهای همراه آن، JWTهای (توکنهای وب JSON) کاربران واردشده را امضا میکنند، بنابراین یک کپی از آن کلید خصوصی میتواند برای جعل نشست ورود به vault استفاده شود. config.json تنظیمات ذخیرهشده از طریق صفحه مدیریت، شامل اعتبارنامههای SMTP به صورت متن ساده و مقدار توکن مدیریت پیکربندیشده را ذخیره میکند. پیروی از دستورالعملهای Argon2 در ادامه، باعث ذخیره هش توکن مدیریت بهجای رمز عبور به صورت متن ساده میشود.
بنابراین مدل تهدید عملی، دسترسی به سیستم فایل است، نه رمزنگاری شبکه. دسترسی خواندن به آن دایرکتوری، آدرس ایمیل همه کاربران، کلیدهای مخفی ورود دومرحلهای، کلیدی برای جعل نشستها و یک کپی آفلاین از تمام vaultها برای حمله در فرصت مناسب را در اختیار مهاجم قرار میدهد. تمام مراحل زیر برای دور نگه داشتن افراد از آن دایرکتوری است.
ابتدا توکن مدیریت را اصلاح کنید
/admin یک پنل کنترل کامل است: شامل فهرست کاربران، دعوتنامهها، حذف و تمامی تنظیمات زمان اجرا. این پنل تنها با یک رمز مشترک (shared secret) محافظت میشود و هیچ نام کاربری یا احراز هویت دو مرحلهای برای هر کاربر ندارد.
راهنماهای قدیمی پیشنهاد میکنند که ADMIN_TOKEN را با openssl rand -base64 48 تولید کنید. این روش کار میکند، اما رمز را به صورت متن ساده (plaintext) در هر جایی که پیکربندی میکنید باقی میگذارد. Vaultwarden از رشته Argon2 PHC (مسابقه هش رمز عبور) نیز پشتیبانی میکند، بنابراین مقدار ذخیرهشده به جای متن ساده، یک هش خواهد بود. یک هش را با استفاده از کانتینر در حال اجرا تولید کنید:
docker exec -it vaultwarden /vaultwarden hashیا بدون دسترسی به کانتینر در حال اجرا:
docker run --rm -it vaultwarden/server /vaultwarden hashاین دستور دو بار رمز عبور را میپرسد و سپس خطی که با $argon2id$ شروع میشود را چاپ میکند. در نصب bare-metal، دستور ./vaultwarden hash را اجرا کنید. اگر ترجیح میدهید مستقیماً از CLI مربوط به argon2 استفاده کنید، پروژه پارامترهای حداقلی OWASP را مستند کرده است:
echo -n 'MySecretPassword' | argon2 "$(openssl rand -base64 32)" -e -id -k 19456 -t 2 -p 1اکنون تلهای که ممکن است ساعتها وقت شما را بگیرد: یک رشته PHC پر از کاراکترهای $ است و Docker Compose کاراکتر $ را به عنوان متغیر (interpolation) در نظر میگیرد. اگر آن را بدون escape کردن در یک بلوک environment: قرار دهید، مقداری که به کانتینر میرسد تغییر میکند و در نتیجه /admin توکنی که میدانید صحیح است را رد میکند. دو روش امن وجود دارد. در docker-compose.yml، هر $ را دو برابر کنید:
environment:
ADMIN_TOKEN: $$argon2id$$v=19$$m=19456,t=2,p=1$$UUZxK1FZMkZoRHFQRlVrTXZvS0E3bHpNQW55c2dBN2NORzdsa0Nxd1JhND0$$cUoId+JBUsJutlG4rfDZayExfjq4TCt48aBc9qsc3UIدر یک فایل .env، نیازی به escape کردن نیست، اما از تککوتیشن استفاده کنید:
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$MmeKRnGK5RW5mJS7h3TOL89GrpLPXJPAtTK8FTqj9HM$DqsstvoSAETl9YhnsXbf43WeaUwJC6JhViIvuPoig78'سپس برای پنل محدودیت نرخ (rate limit) اعمال کرده و نشست (session) آن را کوتاه کنید:
ADMIN_RATELIMIT_SECONDS=300
ADMIN_RATELIMIT_MAX_BURST=3
ADMIN_SESSION_LIFETIME=20این تنظیم اجازه میدهد هر IP کلاینت در هر لحظه 3 درخواست ورود به پنل داشته باشد و سپس این سهمیه با نرخ یک درخواست در هر 5 دقیقه بازیابی شود. رمزهای عبور صحیح و غلط هر دو شمرده میشوند، زیرا محدودکننده پیش از بررسی رمز عبور اجرا میشود. درخواستهای بیش از حد مجاز، خطای HTTP 429 را با Too many requests, try again later. دریافت میکنند. نشست مدیریت 20 دقیقه پس از ورود منقضی میشود، فارغ از اینکه همچنان از پنل استفاده میکنید یا خیر، زیرا فعالیت کاربر باعث تمدید زمان نشست نمیشود.
بهتر از همه اینها: صفحه مدیریت را خاموش کنید. اکثر نمونهها فقط یکبار برای پیکربندی SMTP و دعوت کاربران اولیه به آن نیاز دارند و پس از آن دیگر نیازی نیست. برای غیرفعال کردن آن، نه ADMIN_TOKEN و نه DISABLE_ADMIN_TOKEN را تنظیم نکنید، هر کلید "admin_token" را از config.json حذف کنید و سپس کانتینر را دوباره ایجاد کنید. حذف کلید از فایل اهمیت دارد، زیرا صفحه مدیریت تنظیمات را در آنجا مینویسد و آنچه در config.json قرار دارد بر متغیرهای محیطی (environment) اولویت دارد. حذف کردن متغیر به تنهایی باعث باز ماندن صفحه میشود.
بستن ثبتنام پیش از آنکه کسی دامنه را پیدا کند
SIGNUPS_ALLOWED=false
SIGNUPS_VERIFY=true
SHOW_PASSWORD_HINT=falseSIGNUPS_ALLOWED بهصورت پیشفرض روی true تنظیم شده است. اگر آن را به همین حالت رها کنید، هر کسی که به دامنه شما برسد میتواند یک حساب کاربری بسازد و دادههایش در همان db.sqlite3 شما ذخیره خواهد شد. آن را روی false تنظیم کنید و افراد را از طریق دعوتنامه در صفحه مدیریت اضافه کنید؛ SMTP ایمیل دعوت را ارسال میکند و در صورت عدم تنظیم SMTP، سرور دعوتنامه را برای آن آدرس ثبت میکند. INVITATIONS_ALLOWED نیز بهصورت پیشفرض true است و به مدیران سازمان اجازه میدهد دیگران را دعوت کنند. این حالت زمانی که به کاربران خود اعتماد دارید مناسب است، اما در یک نمونه تککاربره باید false باشد. اگر فقط دامنههای خاصی مجاز به ثبتنام هستند، SIGNUPS_DOMAINS_WHITELIST=example.com محدودتر از ثبتنام آزاد است اما امنیت آن بسیار کمتر از استفاده از دعوتنامه است.
SHOW_PASSWORD_HINT بهصورت پیشفرض false است و باید در همین حالت باقی بماند. وقتی این گزینه فعال باشد و SMTP تنظیم نشده باشد، وارد کردن یک آدرس ایمیل معتبر در فرم ورود، راهنمای رمز عبور اصلی (master password hint) آن حساب را نمایش میدهد که هم باعث افشای راهنما میشود و هم وجود آن آدرس ایمیل را تأیید میکند.
اگر نمونه شما برای مدتی با ثبتنام آزاد اجرا شده است، پیش از آنکه فرض کنید تنها کاربر آن هستید، صفحه مدیریت را باز کرده و لیست کاربران را بررسی کنید.
پورتی که قصد انتشار آن را نداشتید
ایمیج Docker داخل کانتینر روی پورت 80 گوش میدهد. نصب روی سیستمعامل (bare-metal) بهصورت پیشفرض از ROCKET_PORT=8000 استفاده میکند. دستور اجرای مستندشده، آن را به این صورت منتشر میکند:
--publish 127.0.0.1:8000:80پیشوند 127.0.0.1: تمام هدف این دستور است. اگر بهجای آن -p 8000:80 بنویسید، Docker پورت را به 0.0.0.0 متصل (bind) میکند و این کار را با نوشتن قوانین DNAT (ترجمه آدرس شبکه مقصد) در جدول nat انجام میدهد. این قوانین پیش از زنجیرههای filter که توسط ufw مدیریت میشوند ارزیابی میگردند؛ بنابراین ufw status پورت را مسدود گزارش میدهد، در حالی که پورت همچنان با خوشحالی به اینترنت پاسخ میدهد. مطالعه مکانیسم کامل این فرآیند در راهنمای دور زدن ufw توسط پورتهای Docker ارزشمند است.
بررسی کنید چه چیزی واقعاً در حال گوش دادن است:
sudo ss -tlnp | grep 8000نتیجه سالم، یک خط واحد است که به 127.0.0.1:8000 متصل شده باشد. خطی که به 0.0.0.0:8000 متصل باشد، به این معنی است که vault مستقیماً در معرض دید قرار دارد. نگاشت (mapping) را اصلاح کنید و سپس کانتینر را دوباره بسازید، زیرا اتصال پورت هنگام ایجاد کانتینر تعیین میشود و docker compose restart آن را تغییر نخواهد داد:
docker compose up -d --force-recreateیک پورت دیگر در راهنماهای قدیمی باقی مانده است: 3012، که پورت جداگانه WebSocket است. پشتیبانی از آن در Vaultwarden 1.31.0 حذف شد، زیرا ترافیک اعلانها به پورت اصلی HTTP منتقل شده است. متغیرهای WEBSOCKET_ENABLED و WEBSOCKET_PORT از نسخه 1.29.0 منسوخ شدهاند و نادیده گرفته میشوند. سوئیچ فعلی ENABLE_WEBSOCKET است که مقدار پیشفرض آن true میباشد. اگر فایروال یا فایل compose شما هنوز پورت 3012 را باز نگه داشته است، آن را ببندید.
پایاندهی TLS در reverse proxy، نه در Rocket
سرویس Vaultwarden میتواند از طریق Rocket (فریمورک وب خود) TLS (امنیت لایه انتقال) را ارائه دهد، اما مستندات پروژه توصیه میکنند در محیط production از این قابلیت استفاده نکنید. قابلیت TLS داخلی Rocket فاقد پشتیبانی دقیق از SNI (نشانگر نام سرور) است؛ به همین دلیل توصیه امنیتی این است که همیشه از طریق نام دامنه (hostname) به instance خود متصل شوید و هرگز از IP خام استفاده نکنید. محدودههای IP عمومی دائماً اسکن میشوند و هر vault که روی یک IP پاسخ دهد، در معرض شناسایی قرار میگیرد.
بخشهای مهم در یک server block مربوط به nginx:
client_max_body_size 525M;
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 Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}مقدار پیشفرض nginx برای client_max_body_size برابر با 1m است، بنابراین بدون تغییر این مقدار، درخواستهایی که بدنه (body) بزرگتری دارند با خطا مواجه میشوند. در این حالت nginx کد خطای HTTP 413 را به کلاینت برمیگرداند و در لاگ خود client intended to send too large body: ... bytes را ثبت میکند؛ آپلود رد شده هرگز به Vaultwarden نمیرسد. هدرهای Upgrade و Connection وظیفه انتقال WebSocket handshake به /notifications/hub را بر عهده دارند. اگر این هدرها حذف شوند، vault همچنان کار میکند اما اعلانهای (notifications) WebSocket به کلاینتهای مرورگر و دسکتاپ نمیرسند؛ کلاینتهای موبایل از اعلانهای push که جداگانه پیکربندی میشوند، استفاده میکنند.
پیکربندی Caddy کوتاهتر است و گواهی را بهصورت خودکار دریافت میکند:
vw.example.com {
reverse_proxy 127.0.0.1:8000 {
header_up X-Real-IP {remote_host}
}
}سپس این موضوع را به Vaultwarden اطلاع دهید:
DOMAIN=https://vw.example.com
IP_HEADER=X-Real-IPمقدار IP_HEADER بهصورت پیشفرض X-Real-IP است، بنابراین وظیفه شما اطمینان از تنظیم صحیح این هدر توسط پروکسی است. Vaultwarden این هدر را تنها از آدرسهایی میپذیرد که در IP_HEADER_TRUSTED_PROXIES لیست شده باشند؛ مقدار پیشفرض آن local است که شامل تمام آدرسهای غیرعمومی (non-global) میشود و پروکسیهای موجود روی همان میزبان یا همان شبکه کانتینری را پوشش میدهد. اگر پروکسی از یک آدرس عمومی متصل میشود، باید آن را در این لیست اضافه کنید. اگر هدر وجود نداشته باشد یا از یک آدرس غیرقابلاعتماد ارسال شود، تمام لاگها و محدودیتهای نرخ ورود (login rate limit) آدرس خودِ پروکسی را ثبت میکنند؛ این یعنی شکستهای یک مهاجم به پای تمام کاربران instance نوشته میشود. اگر بهجای آن از IP_HEADER=X-Forwarded-For استفاده میکنید، نسخه 1.37.4 آخرین آدرس سمت راست که پروکسی مورد اعتماد نیست را انتخاب میکند، بنابراین تمام پروکسیهای موجود در زنجیره، از جمله CDNهایی که قبل از nginx قرار دارند را لیست کنید. مقدار DOMAIN را نیز روی URL واقعی https تنظیم کنید، زیرا Vaultwarden لینکهای دعوت و بازیابی حساب را بر اساس آن میسازد و کلیدهای امنیتی WebAuthn نیز به همان origin متصل هستند.
یک نکته که اغلب نادیده گرفته میشود: اتصال WebSocket توکن نشست (session token) را در query string و با نام /notifications/hub?access_token=[JWT] ارسال میکند. این مقدار بهصورت متن ساده (clear text) در لاگ دسترسی پروکسی شما ثبت میشود. پارامتر access_token را در فرمت لاگ خود حذف (redact) کنید یا اطمینان حاصل کنید که این لاگها به هیچ مکانی که تحت کنترل شما نیست، ارسال نمیشوند.
مسدودسازی حملات brute force در endpoint ورود
محدودیتهای نرخ (rate limits) بهصورت پیشفرض فعال هستند (LOGIN_RATELIMIT_SECONDS=60، LOGIN_RATELIMIT_MAX_BURST=10). این محدودیتها سرعت مهاجم را کاهش میدهند، اما مانع او نمیشوند. ابزار fail2ban این کار را انجام میدهد، اما نیاز دارد لاگهای ورود ناموفق Vaultwarden را در جایی بخواند که به آن دسترسی داشته باشد. در Docker، سادهترین راه استفاده از یک فایل لاگ است، اما Vaultwarden بهصورت پیشفرض چنین فایلی تولید نمیکند:
LOG_FILE=/data/vaultwarden.log
LOG_LEVEL=info
EXTENDED_LOGGING=trueیک ورود ناموفق با رمز عبور، خطی با این فرمت ایجاد میکند و این همان رشتهای است که فیلتر شما باید با آن مطابقت داشته باشد:
[2026-08-07 09:14:22.000][vaultwarden::api::identity][ERROR] Username or password is incorrect. Try again. IP: 203.0.113.10. Username: user@example.com.فیلتر را در /etc/fail2ban/filter.d/vaultwarden.local بنویسید:
[INCLUDES]
before = common.conf
[Definition]
failregex = ^.*?Username or password is incorrect\. Try again\. IP: <ADDR>\. Username:.*$
ignoreregex =و jail را در /etc/fail2ban/jail.d/vaultwarden.local تنظیم کنید:
[vaultwarden]
enabled = true
backend = pyinotify
port = 80,443
filter = vaultwarden
banaction = %(banaction_allports)s
logpath = /vw-data/vaultwarden.log
maxretry = 3
bantime = 14400
findtime = 14400اگر Vaultwarden بهجای container، بهعنوان یک سرویس systemd اجرا میشود، میتوانید از LOG_FILE صرفنظر کنید: ویکی fail2ban این پروژه، ژورنال را با backend = systemd و یک journalmatch روی unit مربوط به Vaultwarden بهجای logpath میخواند.
اگر صفحه مدیریت (admin page) را حفظ کردهاید، یک jail دوم اضافه کنید که failregex آن ^.*Invalid admin token\. IP: <ADDR>.*$ باشد، زیرا خطاهای ورود به بخش مدیریت با پیام متفاوتی ثبت میشوند و فیلتر ورود هرگز آنها را نمیبیند. سپس عملکرد خود را بررسی کنید:
sudo systemctl restart fail2ban
sudo fail2ban-client status vaultwardenیک jail فعال، فایل لاگ شما را در بخش File list لیست میکند و Currently failed: 0 را گزارش میدهد. از یک شبکه دیگر سه بار رمز عبور اشتباه وارد کنید تا شمارنده افزایش یابد، سپس آدرس در بخش Banned IP list ظاهر میشود. اگر شمارنده هرگز تغییر نکرد، دلیل معمول آن logpath است: این مسیر باید مسیر فایل روی host باشد، نه مسیر /data/... داخل container. دلیل معمول دوم، نبود یا عدم اعتماد به X-Real-IP است که باعث میشود هر مسدودسازی، proxy خودتان را هدف قرار دهد. باقی مراحل راهاندازی، از جمله jail مربوط به SSH که باید از قبل فعال کرده باشید، در راهنمای fail2ban برای Ubuntu 24.04 موجود است.
رمز عبور اصلی همچنان کل سیستم است
رمزنگاری سمت کلاینت به این معناست که رمز عبور اصلی از کلید متقارن کاربر محافظت میکند. یک رمز عبور اصلی کوتاه در نمونهای که مهاجم دیتابیس آن را کپی کرده است، با هیچکدام از موارد این پست محافظت نمیشود، زیرا آنها به آن کپی بهصورت آفلاین و با هر سرعتی که سختافزارشان اجازه دهد حمله میکنند. هیچ تنظیمات سروری به ماشین شخصی مهاجم دسترسی ندارد.
PASSWORD_ITERATIONS=600000 بهراحتی ممکن است اشتباه برداشت شود. این گزینه تعداد تکرارها (iterations) را برای هش سمت سرور از هش لاگینی که کلاینت ارسال میکند تعیین میکند و قالب پیکربندی پروژه میگوید که مقدار تغییریافته در لاگین بعدی برای کاربران موجود اعمال میشود. این گزینه به KDF سمت کلاینت دست نمیزند؛ همان تنظیمی که تعیین میکند حمله آفلاین به vault چقدر هزینهبر باشد. آن تنظیم متعلق به هر حساب کاربری است و در بخش Settings، Security، Keys در web vault تغییر میکند که کلید را دوباره رمزنگاری میکند. مستندات Bitwarden میگوید کلاینتهای آن از نسخه 2026.2.1 به بعد، تنظیمات PBKDF2 زیر 600,000 تکرار را بهطور خودکار هنگام لاگین یا باز کردن قفل با رمز عبور اصلی افزایش میدهند. تا تاریخ 10 October 2026 این رفتار در برابر سرور Vaultwarden تأیید نشده است و هرگز تنظیمات Argon2id را تغییر نمیدهد. بنابراین کسی که سالها پیش ثبتنام کرده است ممکن است همچنان روی تنظیمات KDF قدیمی و پایینتر باشد. بررسی کنید و به آنها اطلاع دهید، زیرا سرور نمیتواند این کار را برای آنها انجام دهد.
سپس احراز هویت دو مرحلهای را برای هر حساب فعال کنید. این کار از متن رمزنگاریشده (ciphertext) محافظت نمیکند، زیرا در رمزنگاری vault نقشی ندارد. این کار مانع از آن میشود که یک رمز عبور سرقتشده برای لاگین و همگامسازی یک کپی کافی باشد. با پیکربندی ایمیل، REQUIRE_DEVICE_EMAIL=true ایمیل لاگین دستگاه جدید را اجباری میکند: اگر ارسال ایمیل با شکست مواجه شود، لاگین نیز ناموفق خواهد بود. اگر سرویس ایمیل بهطور کامل غیرفعال باشد، این تنظیم مانع لاگین دستگاههای جدید نمیشود.
پشتیبانگیری؛ جایی که مخازن self-hosted دچار مشکل میشوند
یک tar czf از پوشهٔ دادهها که در دایرکتوری home روی همان VPS باقی بماند، تمام مراحل قبلی را بیاثر میکند. آن آرشیو حاوی db.sqlite3 با متن رمزنگاریشدهٔ هر کاربر، rsa_key.pem که نشستهای ورود را جعل میکند، و config.json با مقدار توکن مدیریتی پیکربندیشده و رمز عبور SMTP است. پیروی از دستورالعملهای Argon2، هش رمز عبور مدیر را ذخیره میکند؛ اما رمز عبور SMTP به صورت متن ساده (plaintext) باقی میماند. دسترسی خواندن به آن یک فایل، متادیتای حساب، اسرار سرور و دادههای رمزنگاریشدهٔ مخزن را افشا میکند.
دو قانون این موضوع را پوشش میدهند: آرشیو را از سرور خارج کنید و پیش از خروج، آن را رمزنگاری کنید.
یک مشکل صحت داده نیز وجود دارد. کپی کردن db.sqlite3 با cp در حالی که سرویس در حال اجراست، میتواند فایلی ایجاد کند که در میانهٔ نوشتن بوده و باز نخواهد شد؛ و شما تا زمان بازیابی (restore) متوجه این موضوع نخواهید شد. بهجای آن از snapshot خودِ SQLite استفاده کنید:
sqlite3 /vw-data/db.sqlite3 ".backup '/tmp/vw-db-backup.sqlite3'"بخش بازیابی، که نیمهای است که هیچکس آن را تست نمیکند، در راهنمای پشتیبانگیری و بازیابی Vaultwarden پوشش داده شده است.
آنچه با میزبانی شخصی Bitwarden از دست میدهید
حسابوکتاب صادقانه: سرویس میزبانیشدهٔ Bitwarden توسط افرادی اداره میشود که شغل تماموقتشان همین است و ممیزیهای امنیتی شخص ثالث نیز برای آن منتشر شده است. در میزبانی شخصی، شما این مزیت را با چرخهٔ بهروزرسانی خودتان جایگزین میکنید.
Vaultwarden اصلاحات امنیتی را در قالب نسخههای معمولی (releases) منتشر میکند و این انتشارها مکرر هستند. طبق بررسی انجامشده در تاریخ 2 نوامبر 2026 در فید انتشار پروژه، نسخهٔ فعلی 1.37.5 است که در 1 نوامبر 2026 منتشر شده است. یادداشتهای این نسخه شامل دو هشدار امنیتی با سطح «متوسط» است و اکیداً توصیه میکند که در اسرع وقت بهروزرسانی انجام شود. همچنین برای استفاده از web vault نسخه 2026.7.1 و جدیدتر، جهت فعال یا غیرفعال کردن روشهای ورود دومرحلهای، و برای نسخه 2026.9.0 و جدیدتر جهت در اختیار گرفتن حساب از طریق دسترسی اضطراری، این بهروزرسانی الزامی است. نسخهٔ پیشین، یعنی 1.37.4 که در 5 اکتبر 2026 منتشر شد، هفت هشدار امنیتی را پوشش میداد که شدیدترین آنها دارای رتبه «بالا» بود. این چهارمین نسخه پس از 1.37.0 در تاریخ 24 ژوئیه 2026 بود: نسخه 1.37.1 در 29 ژوئیه، نسخه 1.37.2 در 22 اوت (الزامی برای کلاینتهای نسخه 2026.8.0 و جدیدتر) و نسخه 1.37.3 در 13 سپتامبر منتشر شدند که توکنهای «مرا به خاطر بسپار» برای 2FA را هنگام تغییر اعتبارنامهها یا 2FA ابطال میکند و نرخ درخواستهای prelogin و auth را محدود میسازد. اگر سازمانهایی را با مدیرانی اداره میکنید که کاملاً به آنها اعتماد ندارید، یادداشتهای نسخه 1.37.4 پیشنهاد میکنند که پس از بهروزرسانی، کلید API هر سازمان را تغییر دهید. نسخه 1.37.4 همچنین آدرسی را که از X-Forwarded-For خوانده میشود تغییر میدهد که در بخش reverse proxy در بالا به آن پرداخته شد. نمونهای که یک سال پیش راهاندازی کرده و فراموش کردهاید، کدی یکساله را اجرا میکند. تگ latest بهتنهایی کمکی نمیکند: کانتینر در حال اجرا، ایمیجی را که با آن شروع شده حفظ میکند تا زمانی که شما docker compose pull را اجرا کرده و آن را دوباره ایجاد کنید. برای بستههای میزبان، ارتقاهای خودکار در Ubuntu را فعال کنید و بهروزرسانی کانتینر را در یادآور تقویمی قرار دهید که واقعاً آن را میخوانید.
نتیجهگیری که یک خواننده صادق باید بگیرد این است: رمزنگاری در اینجا طراحی Bitwarden است و کاملاً قابلاتکا است، اما ریسک عملیاتی کاملاً به عهده شما منتقل میشود. اگر آن را بهروز نگه دارید و در جای دیگری از آن نسخه پشتیبان تهیه کنید، یک نمونه Vaultwarden روی VPS تحت کنترل شما، مکانی معقول برای نگهداری گذرواژههایتان است. اگر قرار نیست این دو عادت را رعایت کنید، هزینه سرویس میزبانیشده را بپردازید و توجه خود را صرف کارهای دیگر کنید. مقایسه ویژگیبهویژگی در مقایسه Vaultwarden با Bitwarden میزبانیشده موجود است.
ایمنسازی میزبان زیرین کانتینر
Vaultwarden تنها یک پردازش روی سیستمعامل Linux است و کاربر root روی آن سیستم میتواند /vw-data را فارغ از تنظیمات داخلی برنامه بخواند. کانتینر را با استفاده از یک کاربر بدون امتیاز (unprivileged) و با تنظیم user: "1000:1000" در فایل compose اجرا کنید؛ مالکیت پوشه دادهها را نیز مطابق با آن تنظیم نمایید. هر فایلی که کانتینر نیازی به نوشتن در آن ندارد را با استفاده از :ro به صورت فقطخواندنی (read-only) mount کنید. سپس درب ورودی را ببندید: ایمنسازی SSH روی VPS به موضوع ورود فقط با کلید و غیرفعالسازی احراز هویت با رمز عبور میپردازد؛ این همان اقدامی است که حملات رایج و سادهای را که از سد موارد فوق عبور میکنند، متوقف میسازد.
FAQ
آیا اگر کسی دیتابیس Vaultwarden را سرقت کند، میتواند رمزهای عبور من را بخواند؟
نه مستقیماً. هر آیتم در vault در سمت کلاینت با یک کلید تصادفی رمزنگاری میشود که خود توسط کلید متقارن کاربر یا سازمان محافظت شده است؛ کلید مشتقشده از رمز عبور نیز از کلید متقارن کاربر محافظت میکند. db.sqlite3 حاوی محتوای رمزنگاریشدهٔ vault به همراه متادیتای حساب کاربری بهصورت متن ساده (plaintext) است. آنچه مهاجم بلافاصله به دست میآورد، آدرس ایمیل و راهنمای رمز عبور (password hint) هر حساب، تنظیمات KDF، متادیتای ورود و دستگاه، و همچنین کدهای TOTP در جدول twofactor است که بهصورت رمزنگارینشده ذخیره میشوند، زیرا سرور باید کد مورد انتظار را محاسبه کند. آنها همچنین میتوانند تا هر زمان که بخواهند بهصورت آفلاین به ciphertext موجود در vault حمله کنند؛ به همین دلیل است که طول رمز عبور اصلی (master password) تعیینکنندهٔ نتیجه است.
آیا باید از ADMIN_TOKEN استفاده کنم یا صفحهٔ مدیریت را کاملاً غیرفعال کنم؟
اگر میتوانید آن را غیرفعال کنید، زیرا اکثر نمونهها (instances) فقط یکبار برای پیکربندی SMTP و دعوت از کاربران به آن نیاز دارند و پس از آن دیگر نیازی به آن نیست. برای غیرفعال کردن آن، نه ADMIN_TOKEN و نه DISABLE_ADMIN_TOKEN را تنظیم نکنید، هر کلید "admin_token" را از config.json حذف کنید و سپس container را دوباره بسازید. حذف کردن فقط متغیر محیطی (environment variable) کافی نیست، زیرا تنظیماتی که توسط صفحهٔ مدیریت نوشته شدهاند در config.json قرار دارند و اولویت بالاتری دارند. اگر صفحه را نگه میدارید، توکن را بهجای یک رشتهٔ تصادفی ساده، بهصورت هش Argon2 تولیدشده توسط vaultwarden hash ذخیره کنید و ADMIN_RATELIMIT_MAX_BURST=3 را تنظیم نمایید.
توکن ADMIN_TOKEN من صحیح است اما بخش /admin آن را رد میکند. مشکل چیست؟
تقریباً همیشه مشکل از جایگذاری (interpolation) $ است. یک رشتهٔ Argon2 PHC حاوی چندین کاراکتر $ است و Docker Compose آنها را بهعنوان متغیر در داخل بلوک docker-compose.yml در environment: بسط میدهد؛ بنابراین container مقدار تغییریافتهای دریافت میکند در حالی که فایل شما درست به نظر میرسد. تمام $ها را در فایل compose به $$ تبدیل کنید (دوبرابر کنید)، یا مقدار را به یک فایل .env منتقل کرده و داخل کوتیشن تکی قرار دهید که در آن نیازی به escape کردن نیست. پس از آن container را دوباره بسازید، زیرا تغییرات محیطی با یک restart ساده اعمال نمیشوند.
آیا هنوز نیاز است پورت 3012 را برای اعلانها (notifications) باز بگذارم؟
خیر. پشتیبانی از ترافیک WebSocket روی پورت 3012 در Vaultwarden 1.31.0 حذف شد، زیرا اعلانها به پورت اصلی HTTP منتقل شدند و WEBSOCKET_ENABLED و WEBSOCKET_PORT از نسخه 1.29.0 منسوخ شده و نادیده گرفته میشوند. تنظیم فعلی ENABLE_WEBSOCKET است که بهصورت پیشفرض true میباشد. پورت 3012 را در فایروال ببندید و آن را از فایل compose خود حذف کنید، سپس مطمئن شوید که reverse proxy شما هدرهای Upgrade و Connection را فوروارد میکند، زیرا اعلانهای WebSocket در مرورگر و نسخه دسکتاپ به آنها وابسته هستند. کلاینتهای موبایل از اعلانهای push که بهطور جداگانه پیکربندی میشوند، استفاده میکنند.