Tăng cường bảo mật cho Vaultwarden: loại bỏ cấu hình cũ và bảo vệ quyền truy cập quản trị
Một đánh giá kỹ thuật về Vaultwarden 1.37.5 chỉ ra các cài đặt WebSocket lỗi thời, những sai lầm nghiêm trọng trong cấu hình nginx và rủi ro bảo mật token quản trị đối với người dùng tự host.
Bài được dịch tự động từ bản gốc tiếng Anh.
Việc tự host một trình quản lý mật khẩu đòi hỏi nhiều hơn là chỉ khởi chạy một container. Một phân tích sâu gần đây về Vaultwarden phiên bản 1.37.5, phát hành vào ngày 1 tháng 11 năm 2026, làm nổi bật cách các cấu hình mặc định và hướng dẫn cũ có thể để lại những lỗ hổng bảo mật nghiêm trọng. Bài phân tích tập trung vào việc loại bỏ các biến môi trường đã ngừng hỗ trợ, thực thi yêu cầu HTTPS nghiêm ngặt và quản lý đúng cách các token truy cập quản trị.
Chuyện gì đã xảy ra
Bài viết xem xét trạng thái hiện tại của Vaultwarden, một bản triển khai độc lập bằng ngôn ngữ Rust cho API máy chủ Bitwarden. Mặc dù thường được so sánh với giải pháp tự host chính thức của Bitwarden, bối cảnh đã thay đổi. Bitwarden Lite hiện cung cấp khả năng triển khai single-container, thách thức quan điểm trước đây rằng Vaultwarden vượt trội chỉ vì dung lượng nhỏ gọn. Tuy nhiên, Vaultwarden vẫn khác biệt nhờ không có máy chủ giấy phép (license servers) và các cổng tính năng (feature gates), chạy dưới dạng binary tĩnh trên nền tảng Debian nhẹ.
Vấn đề cốt lõi được giải quyết là sự tồn tại dai dẳng của các lời khuyên cấu hình lỗi thời trong các hướng dẫn cộng đồng. Nhiều hướng dẫn vẫn khuyến nghị bật các cổng WebSocket riêng biệt và sử dụng các preset token quản trị yếu. Tác giả xác minh các cài đặt này dựa trên mã nguồn thực tế của tag 1.37.5, chứng minh rằng nhiều khuyến nghị phổ biến không chỉ thừa thãi mà còn tiềm ẩn nguy hại. Ví dụ, máy chủ WebSocket riêng biệt đã bị loại bỏ từ phiên bản 1.31.0, nhưng nhiều file compose vẫn mở cổng 3012.
Hơn nữa, bài viết chi tiết hóa việc các bản cập nhật phía client diễn ra nhanh hơn phía server, dẫn đến các lỗi tính năng âm thầm. Phiên bản 1.37.5 hiện là yêu cầu bắt buộc cho một số tính năng truy cập khẩn cấp và công tắc đăng nhập hai bước trong các web vault mới hơn. Vòng quay cập nhật phiên bản này có nghĩa là việc trì hoãn cập nhật server có thể làm hỏng chức năng trên các client di động và desktop tự động cập nhật mà không hiển thị thông báo lỗi rõ ràng chỉ ra sự không khớp phiên bản server.
Chi tiết chính
- Cổng WebSocket riêng biệt (3012) đã bị loại bỏ từ phiên bản 1.31.0; đồng bộ hóa thời gian thực giờ đây sử dụng cổng HTTP chính.
- Cấu hình Nginx phải xử lý kích thước body lớn cho việc nhập vault, yêu cầu tăng
client_max_body_sizetừ mức mặc định 1MB. - Token quản trị nên được tạo bằng preset mặc định
bitwarden, mạnh hơn presetowaspthường được khuyến nghị trong các hướng dẫn cũ. - Cài đặt
SIGNUPS_DOMAINS_WHITELISTghi đè lênSIGNUPS_ALLOWED=false, thực chất là mở lại đăng ký cho các tên miền được chỉ định. - HTTPS được thực thi nghiêm ngặt bởi API Web Crypto của trình duyệt và các client Bitwarden, khiến các triển khai HTTP thuần túy không hoạt động được khi truy cập từ xa.
- Các nỗ lực xác thực hai lớp không hoàn tất sẽ kích hoạt thông báo email sau ba phút theo mặc định, một chỉ báo quan trọng cho thấy thông tin đăng nhập có thể đã bị xâm phạm.
Bối cảnh
Vaultwarden đóng vai trò là backend cho các client Bitwarden chính thức, xử lý lưu trữ dữ liệu trong khi mã hóa diễn ra cục bộ trên thiết bị của người dùng. Điều này có nghĩa là server chỉ lưu trữ ciphertext, nên việc xâm phạm server không trực tiếp tiết lộ mật khẩu. Tuy nhiên, metadata và quyền truy cập quản trị vẫn dễ bị tổn thương. Hệ thống phụ thuộc vào một reverse proxy, thường là Nginx, để xử lý kết thúc TLS vì ứng dụng tự nó không quản lý chứng chỉ.
Cấu hình được quản lý qua biến môi trường hoặc file config.json. Một bẫy phổ biến là các giá trị được lưu trong bảng điều khiển quản trị sẽ ghi vào config.json, sau đó ghi đè lên các biến môi trường trong file Docker compose. Điều này gây nhầm lẫn khi quản trị viên cập nhật file compose nhưng không thấy thay đổi nào, vì file cấu hình cục bộ có ưu tiên cao hơn. Hiểu rõ thứ bậc này là điều cần thiết để duy trì một triển khai an toàn và dự đoán được.
Tại sao điều này quan trọng
Đối với các đội ngũ vận hành phần mềm riêng, các cấu hình sai bảo mật có thể dẫn đến truy cập trái phép hoặc gián đoạn dịch vụ. Sử dụng cài đặt WebSocket lỗi thời phơi bày các cổng không cần thiết, làm tăng bề mặt tấn công. Tương tự, việc không cấu hình Nginx đúng cách có thể ngăn người dùng nhập các vault hiện có, gây thất vọng do mất dữ liệu. Yêu cầu nghiêm ngặt về HTTPS có nghĩa là bất kỳ sơ suất nào trong quản lý chứng chỉ sẽ ngay lập tức phá vỡ quyền truy cập cho tất cả người dùng, vì các client hiện đại từ chối kết nối qua kênh không mã hóa.
Bảo mật quản trị cũng quan trọng không kém. Bảng điều khiển quản trị cung cấp quyền kiểm soát toàn diện đối với instance, bao gồm quản lý người dùng và cài đặt tổ chức. Nếu token quản trị yếu hoặc được băm không đúng cách, kẻ tấn công có thể giành toàn quyền kiểm soát. Bài viết nhấn mạnh rằng việc sử dụng preset hash yếu owasp làm giảm chi phí tính toán cho kẻ tấn công cố gắng brute-force token. Ngoài ra, hiểu sai danh sách trắng đăng ký có thể vô tình cho phép đăng ký công khai, biến một instance riêng tư thành mục tiêu công khai.
Bạn có thể làm gì
- Loại bỏ
WEBSOCKET_ENABLEDvàWEBSOCKET_PORTkhỏi file Docker compose của bạn, vì chúng đã ngừng hỗ trợ. - Tạo token quản trị bằng preset mặc định
bitwardenthông qua công cụ dòng lệnh để đảm bảo độ mạnh hash tối đa. - Cấu hình Nginx với
client_max_body_size 128Mđể hỗ trợ nhập vault lớn và tránh các lỗi tải lên âm thầm. - Kiểm tra phiên bản Nginx của bạn trước khi sử dụng
http2 on; hãy dùnglisten 443 ssl http2;cho các phiên bản cũ hơn 1.25.1 để tránh lỗi khởi động. - Đặt
SIGNUPS_ALLOWEDthànhfalsevà tránh sử dụngSIGNUPS_DOMAINS_WHITELISTtrừ khi bạn đặc biệt muốn cho phép đăng ký mở cho các tên miền đó. - Giám sát các email xác thực hai lớp không hoàn tất như một dấu hiệu của các cuộc tấn công credential stuffing nhắm vào người dùng của bạn.


