BombVault¶
Dữ liệu Unraid của bạn, niêm phong trong một két sắt. Thả một bản sao lưu vào. Kích nổ một lần khôi phục.

BombVault là một ứng dụng web tự lưu trữ để sao lưu và khôi phục toàn diện sau thảm họa trên Unraid và các máy chủ Docker khác, như TrueNAS SCALE, ZimaOS hay một máy Linux thông thường. Nó sao lưu các Docker container, KVM/libvirt VM, thư mục, tập dữ liệu ZFS và ổ flash của Unraid. Nó chạy dưới dạng một Docker container đa kiến trúc duy nhất, cung cấp cho bạn giao diện web với chế độ tối, sáng hoặc theo hệ thống, và xử lý toàn bộ vòng đời: sao lưu, lên lịch, xác minh và khôi phục.
Việc khôi phục diễn ra tự động. Trên Unraid, các container xuất hiện lại trong tab Docker y hệt như trước, và các VM được định nghĩa lại trong VM Manager cùng với đĩa và UEFI NVRAM được gắn lại. Không cần cài đặt lại thủ công, không cấu hình lại, không rắc rối. Trên TrueNAS, một container được khôi phục bên cạnh bản gốc chạy như một Docker container thông thường mà màn hình Apps không liệt kê.
Được vận hành bởi restic, nên mỗi bản sao lưu đều được khử trùng lặp, tăng dần và được mã hóa theo mặc định.
Giữ APP_KEY của bạn an toàn
BombVault dẫn xuất mật khẩu kho lưu trữ restic từ một bí mật 32 byte tên là APP_KEY. Mất nó cùng với bộ khôi phục sẽ khiến các bản sao lưu đã mã hóa không thể khôi phục được. Hãy tạo một khóa bằng openssl rand -hex 32 và cất giữ nó ở nơi an toàn. Xem Cấu hình.
BombVault bảo vệ những gì¶
Mỗi container, VM, bộ thư mục, ổ flash, mỗi tập dữ liệu ZFS và chính cài đặt của BombVault là một mục có trang riêng. Các mục cùng loại tạo thành một phần, và bạn bật phần đó trong Cài đặt, Chung.
| Phần | Những gì được lưu |
|---|---|
| Containers | Thư mục appdata cùng với định nghĩa container (image, biến môi trường, cổng, nhãn, volume). |
| VMs | (Các) ảnh đĩa VM, định nghĩa XML và UEFI NVRAM, được sao lưu qua SSH (không gắn kết libvirt). |
| Flash | Toàn bộ USB flash (/boot): OS, giấy phép, cấu hình mảng, share, cấu hình mạng và plugin. |
| Tự sao lưu | /config của chính BombVault: cơ sở dữ liệu cài đặt, thông tin đăng nhập của các đích sao lưu, cặp khóa SSH libvirt, khóa và host pin của các máy chủ ZFS cùng các chứng chỉ. |
| Thư mục | Bất kỳ thư mục nào trên máy chủ dưới dạng một bộ thư mục, mỗi bộ có tùy chọn mẫu loại trừ riêng. |
| Tập dữ liệu ZFS | Một tập dữ liệu cùng mọi tập bên dưới, đọc từ một ảnh chụp ZFS và lưu như một thư mục. Xem Tập dữ liệu ZFS. |
Khôi phục là ngôi sao¶
Sau khi sao chép dữ liệu trở lại từ snapshot restic, BombVault phát lại định nghĩa container đã lưu qua Docker API, nên container xuất hiện lại trong tab Docker của Unraid như thể nó vẫn luôn ở đó (cùng image, cùng cài đặt, cùng ánh xạ cổng). Các VM được định nghĩa lại XML qua SSH cùng với đĩa và UEFI NVRAM được gắn lại, ngay cả sau khi VM đã bị xóa.
Một cửa sổ khôi phục mọi loại. Mặc định nó chọn Bên cạnh bản gốc, đưa bản sao lưu trở lại dưới dạng một bản sao và giữ nguyên bản gốc. Thay thế bản gốc sao lưu trạng thái hiện tại trước, nên một lần khôi phục có thể được hoàn tác. Một thư mục hoặc một tập dữ liệu ZFS mới là các đích khác.
Khi một lần sao lưu dừng các container phụ thuộc, chúng quay trở lại theo đúng thứ tự: BombVault khởi động lại chúng theo thứ tự depends_on của Compose và chờ mỗi cái báo khỏe mạnh trước khi khởi động những cái phụ thuộc vào nó, nên không có gì chạy vượt lên trước một cơ sở dữ liệu hay một gateway chưa sẵn sàng. Xem Khôi phục và Lệnh và các container khác.
Cách nó hoạt động¶
Browser --HTTPS--> BombVault container
|- Go binary: JSON API + embedded React UI
|- Background worker (per-section scheduler + job executor)
|
|- /var/run/docker.sock -> Docker API (container stop/inspect/recreate)
|- qemu+ssh://host -> libvirt / KVM on the HOST over SSH (no mount)
|- /mnt/ -> /host/user -> appdata, VM disks + restic repos (read/write)
|- /boot/ -> /host/boot -> Unraid flash backup (whole USB)
|- /config -> BombVault's own settings + sign-ins (self-backup)
'- <repo path> -> restic repository (local or remote: rclone/s3/rest/sftp)
BombVault dùng Docker socket để dừng các container trước khi sao lưu và tạo lại chúng sau khi khôi phục. Với VM, nó chạy virsh trên máy chủ qua SSH (qemu+ssh://) để tắt một domain êm ái hoặc chụp một snapshot trực tiếp. Nó không bao giờ bind-mount một đường dẫn libvirt, nên không thể cản trở VM Manager trên máy chủ.
BombVault là lớp điều phối và giao diện, không phải công cụ lưu trữ. Toàn bộ việc di chuyển dữ liệu thực tế đều đi qua restic.
Bắt đầu nhanh¶
Mới đến đây? Hãy vào Bắt đầu để cài đặt BombVault và chạy bản sao lưu đầu tiên của bạn, rồi thiết lập Off-site & khôi phục. Các ví dụ thực hành đi qua những việc thường gặp từ đầu đến cuối, trang Cài đặt liệt kê mọi ô, và Tính năng là danh mục ngắn về mọi thứ BombVault làm.
Mỗi phần có thể sao chép tới nhiều đích sao lưu cùng lúc, một BombVault đã ghép nối có thể giữ các bản sao off-site của bạn trên một máy chủ từ chối xóa, và Trình hướng dẫn khẩn cấp đưa một máy chủ bị mất trở lại từ bộ khôi phục của nó, qua nhóm của bạn hoặc bằng khóa nhập tay. Để mang cấu hình sang một máy mới, hãy dùng thẻ Xuất / nhập cài đặt. Xem Off-site & khôi phục và Cấu hình.
Ứng dụng Android đưa mọi máy chủ trong nhóm của bạn lên điện thoại, với nhật ký hoạt động của tất cả trên một màn hình.
Tài liệu có 26 ngôn ngữ và giao diện có 42. Các trang chưa có bản dịch sẽ hiện bằng tiếng Anh.
Các từ dùng ở đây¶
Một vài từ có nghĩa cố định trong BombVault và trong các trang này.
| Từ | Ý nghĩa |
|---|---|
| Mục | Một thứ BombVault sao lưu: một container, một VM, một bộ thư mục, ổ flash, một tập dữ liệu ZFS cùng các tập bên dưới nó, hoặc chính cài đặt của nó. Mỗi mục có một trang riêng. |
| Phần | Tất cả các mục cùng loại, chẳng hạn Containers. Bạn bật các phần trong Cài đặt, Chung. |
| Đích sao lưu | Một nơi các bản sao lưu được gửi tới: một thư mục trên máy chủ này, một share, một máy chủ của riêng bạn hoặc một dịch vụ đám mây. Xem Các đích sao lưu. |
| Cục bộ | Đích sao lưu trên máy chủ này, nơi giữ các thư mục của các phần. |
| Thư mục riêng | Kho mà một phần ghi các bản sao lưu của nó vào trước tiên. Mặc định nó nằm trên máy chủ này và có thể nằm trong một đích sao lưu. Xem Thư mục riêng của một phần. |
| Bản sao | Một bản sao lưu được sao chép từ thư mục riêng sang một đích sao lưu khác bằng restic copy. |
| Kho trực tiếp | Một kho tại một nơi ngoài cơ sở mà các mục sao lưu thẳng tới, không có bản sao cục bộ ở giữa. Xem Kho trực tiếp. |
| Thông tin đăng nhập | Khóa hoặc mật khẩu đã lưu cho một dịch vụ S3 hoặc một rest-server. Một trong số đó là mặc định. Xem Thông tin đăng nhập. |
| Vị trí đặt | Những đích sao lưu nào nhận các bản sao lưu của một mục, đặt trên mục hoặc làm mặc định của phần. Xem Vị trí theo từng mục. |
| Bản nhân bản | Một bản sao khớp từng khối của một mục ZFS trên máy chủ ZFS thứ hai, tạo bằng zfs send. Nó đứng cạnh bản sao lưu và không thay thế nó. Xem Bản nhân bản. |
| Vai trò | Việc mà một phiên bản trong nhóm của bạn làm cho phiên bản khác: Bộ nhận, Bên kéo, Máy chủ ZFS hoặc Bên giữ khóa. Xem Phiên bản và vai trò. |
| Node | Một BombVault không có giao diện web, ví dụ trên một VPS, được một phiên bản khác, tức phiên bản chủ của nó, cho biết sao lưu gì, khi nào và tới đâu. Xem Node. |
| Phiên bản chủ | Phiên bản đã thêm một node và điều khiển node đó. Nó giữ khóa của node và cho node biết sao lưu gì, khi nào và tới đâu. Xem Node. |
Ghi công¶
- VolumeVault của @Darkdragon14 (Apache-2.0) đã cho BombVault ý tưởng khởi đầu: sao lưu bằng một cú nhấp và tự động cài đặt lại các Docker container. BombVault là một bản hiện thực riêng trên Go và restic, đưa ý tưởng đó sang VM, flash và hơn thế nữa.
- restic là công cụ sao lưu nhanh, an toàn, có khử trùng lặp mà BombVault điều khiển.
- rclone cung cấp các backend đám mây.
- Phần lớn biểu tượng trên các nút lấy từ bộ Core Solid miễn phí của Streamline (CC BY 4.0, nguồn). Số còn lại lấy từ Font Awesome Free, Material Design Icons, Simple Icons và Tabler Icons, hoặc được vẽ riêng cho dự án.
Giấy phép¶
Copyright (C) 2026 Junker der Provinz. BombVault là phần mềm tự do theo GNU Affero General Public License v3.0 (LICENSE). Bạn có thể chạy, nghiên cứu, chia sẻ và sửa đổi nó. Nếu bạn phân phối nó, hoặc chạy một phiên bản đã sửa đổi dưới dạng dịch vụ mạng, bạn phải công bố mã nguồn của mình theo cùng giấy phép đó và giữ nguyên các thông báo bản quyền và ghi nhận tác giả hiện có.
Tên và thương hiệu không được cấp phép. AGPL chỉ áp dụng cho mã nguồn: "BombVault", logo và thương hiệu của nó vẫn được bảo lưu, nên một bản fork phải dùng tên và thương hiệu của riêng mình và không được tự giới thiệu là BombVault.
Liên kết¶
- Mã nguồn: github.com/junkerderprovinz/bombvault
- Luồng hỗ trợ Unraid: forums.unraid.net
- Vấn đề (Issues): github.com/junkerderprovinz/bombvault/issues
Quyền kiểm soát máy chủ tương đương root
Thông qua Docker socket, BombVault có thể dừng, xóa và tạo lại các container cũng như đọc/ghi appdata, và để sao lưu VM nó đăng nhập vào máy chủ qua SSH để chạy virsh. Bất kỳ ai truy cập được giao diện web của nó thực chất đều có quyền root trên máy chủ. Chỉ chạy BombVault trên một mạng tin cậy, không phơi ra ngoài, và đặt mật khẩu đăng nhập trong Cài đặt, Bảo mật. Bộ khôi phục, bản gửi khóa, tệp ZIP flash và việc xuất một bản sao lưu flash hoặc bản tự sao lưu đều cần mật khẩu đó. Xem Cấu hình để biết mô hình bảo mật đầy đủ.