Cấu hình¶
Trang này nói về các biến môi trường của container, các điểm gắn kết mà template cung cấp, mô hình bảo mật, sao lưu VM qua SSH và thiết lập off-site. Nơi lưu các bản sao lưu được thiết lập bên trong ứng dụng dưới dạng đích sao lưu, không phải qua biến môi trường.
Biến môi trường¶
| Biến | Bắt buộc | Mô tả |
|---|---|---|
APP_KEY |
Có | Bí mật hex 32 byte (64 ký tự hex) dùng để dẫn xuất mật khẩu kho restic. Tạo bằng openssl rand -hex 32. Giữ nó an toàn: đánh mất nó khiến các bản sao lưu đã mã hóa không thể khôi phục được. |
LIBVIRT_HOST |
Cho VM và tập dữ liệu ZFS | Máy chủ Unraid được kết nối qua SSH để sao lưu VM (mặc định host.docker.internal. Template điền sẵn một chỗ giữ chỗ IP-LAN). Dùng IP LAN Unraid của bạn, bắt buộc trên một mạng br0.x tùy chỉnh. Cũng dùng cho sao lưu tập dữ liệu ZFS (trường mẫu Host SSH: Address). Giá trị giữ chỗ 192.168.x.x được coi là chưa đặt. Khi host.docker.internal không phân giải được, như trong một ứng dụng TrueNAS, và LIBVIRT_URI cũng không nêu máy chủ nào, BombVault dùng cổng mặc định (default gateway) của container và nhật ký khởi động ghi rõ địa chỉ đó. |
LIBVIRT_SSH_PORT |
Không | Cổng SSH của máy chủ để sao lưu VM (mặc định 22). Trường mẫu Host SSH: Port, cũng dùng cho tập dữ liệu ZFS. |
LIBVIRT_SSH_USER |
Không | Người dùng SSH trên máy chủ để sao lưu VM (mặc định root). Trường mẫu Host SSH: User, cũng dùng cho tập dữ liệu ZFS. |
LIBVIRT_URI |
Không | URI kết nối libvirt đầy đủ, được dùng nguyên văn thay vì xây dựng từ ba biến LIBVIRT_* phía trên (khi đó các biến này bị bỏ qua đối với chuỗi kết nối). Mặc định không đặt. Cần thiết trên TrueNAS Scale, nơi libvirtd của nó lắng nghe trên một socket không chuẩn mà dạng chuỗi dựng sẵn không thể diễn đạt được: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Xem hướng dẫn sao lưu VM. Nếu là URI qemu+ssh://, mỗi biến trong LIBVIRT_HOST, LIBVIRT_SSH_USER và LIBVIRT_SSH_PORT chưa đặt sẽ lấy từ đó, kể cả cho các lệnh SSH riêng của BombVault (chuyển NVRAM, tập dữ liệu ZFS). |
PORT |
Không | Cổng HTTP (mặc định 3000. Chỉ dùng với HTTP_ONLY=true). |
HTTPS_PORT |
Không | Cổng HTTPS (mặc định 3443. Template công bố nó 1:1, nên WebUI trả lời tại https://<ip>:3443). |
HTTP_ONLY |
Không | Đặt true để tắt trình lắng nghe HTTPS tự ký và chỉ phục vụ HTTP thuần (để dùng phía sau một reverse proxy kết thúc TLS). |
BIND_HOST |
Không | Địa chỉ mà WebUI lắng nghe (mặc định 0.0.0.0, mọi giao diện). Để trống trong container, vì các cổng được công bố của nó cần mọi giao diện. 127.0.0.1 phù hợp khi chạy ngoài Docker. Healthcheck hỏi cùng địa chỉ đó. |
TRUSTED_PROXY |
Không | Các địa chỉ hoặc dải CIDR của proxy ngược đứng trước BombVault, phân tách bằng dấu phẩy (ví dụ 192.168.20.11 hoặc 10.0.0.0/8). Chỉ từ những chặng đó thì X-Forwarded-For mới được tin, và bộ hãm đăng nhập khi ấy đếm số lần thất bại theo từng máy khách thật thay vì dồn tất cả những ai ở sau proxy vào cùng một giỏ. Không đặt (mặc định) nghĩa là không tin ai: một tiêu đề được tin vô điều kiện sẽ cho phép bất kỳ ai tự chọn giỏ của mình. |
HOST_SOURCE_ROOT |
Không | Đường dẫn máy chủ được gắn kết làm Host Data (mặc định /mnt). BombVault dịch các nguồn bind-mount mà Docker báo cáo thành các đường dẫn dưới điểm gắn kết này. Chỉ thay đổi nếu bạn đã gắn kết một gốc máy chủ khác. |
HOST_MOUNT_ROOT |
Không | Nơi Host Data được gắn kết bên trong container (mặc định /host/user). Trên TrueNAS, Host Data được gắn kết tại chính đường dẫn của nó trên máy chủ, nên biến này và HOST_SOURCE_ROOT đều nêu đường dẫn đó, ví dụ /mnt/tank (xem TrueNAS SCALE). |
DATA_ROOT_SEGMENTS |
Không | Các tên đoạn đường dẫn cách nhau bởi dấu phẩy, đánh dấu một nguồn bind-mount là dữ liệu sao lưu (mặc định appdata, khớp với quy ước /mnt/user/appdata/<container> của Unraid). Bind-mount của một container được tự động chọn để sao lưu khi BẤT KỲ đoạn nào trong danh sách xuất hiện như một đoạn đường dẫn đầy đủ trong nguồn của nó trên máy chủ, ví dụ DATA_ROOT_SEGMENTS=appdata,config cũng bắt luôn một bind .../config. Xem Phát hiện nguồn sao lưu để biết những cách khác, luôn hoạt động, mà thư mục dữ liệu của một container được tìm thấy. |
PLATFORM |
Không | Buộc BombVault coi mình đang chạy trên nền tảng nào, thay vì tự phát hiện: unraid, generic, hoặc truenas (mặc định không đặt: tự phát hiện Unraid bằng cách dò tìm dấu hiệu dockerMan của nó dưới điểm gắn kết flash, nếu không thì dùng generic. Một giá trị không nhận dạng được cũng quay về generic, được ghi log). Đặt nó rõ ràng trên một máy chủ Docker thông thường hoặc TrueNAS Scale, thay vì dựa vào việc dò tìm tự động chỉ dành cho Unraid. Tệp compose thông thường đã làm đúng như vậy. Thay đổi quy ước dự phòng appdata, các đích khôi phục mặc định khi khôi phục sang một phiên bản khác, và liệu các bước thông báo/plugin đồng hành chỉ dành cho Unraid có được thử hay không (xem internal/platform). |
BOMBVAULT_SELF_CONTAINER |
Không | Tên của chính container BombVault, để nó không bao giờ sao lưu (và do đó dừng) chính mình. |
BACKUP_MAX_HOURS |
Không | Số giờ đồng hồ tối đa mà một lần sao lưu đơn có thể giữ khóa phần của nó trước khi bị hủy cưỡng bức (một biện pháp bảo vệ để một lần chạy bị kẹt không thể chặn phần mãi mãi). Để trống (mặc định) dùng 48. Tăng nó lên cho các bản sao lưu đám mây rất lớn hoặc chậm (một lần chạy bị hủy ở mức giới hạn thất bại với context deadline exceeded). Đặt 0 để tắt hoàn toàn giới hạn. Việc dọn bớt (prune) cũng chịu cùng giới hạn này, và một lần kiểm tra hay dọn bớt cứ chạy tiếp chừng nào restic còn báo tiến độ. |
BACKUP_STALL_HOURS |
Không | Số giờ một bản sao lưu có thể hoàn toàn không tiến triển trước khi bị hủy. Để trống (mặc định) dùng 2. Đặt 0 để không bao giờ hủy vì bị đình trệ. Đây là biện pháp bảo vệ tinh hơn trong hai cái và thường là cái kích hoạt: nó theo dõi xem còn điều gì đang diễn ra hay không thay vì lần chạy đã mất bao lâu, nên một bản sao lưu nhiều terabyte chậm nhưng khỏe mạnh được để yên, còn một bản bị kẹt trên một share không phản hồi sẽ bị dừng sau vài giờ thay vì vài ngày. Một cảnh báo được ghi vào nhật ký sau 30 phút im lặng, trước khi bất cứ thứ gì bị hủy. Việc quét được tính là tiến triển: restic không ghi byte nào khi đi qua một cây thư mục lớn, và giai đoạn đó được theo dõi qua tổng số tập tin và byte của nó thay vì qua số byte đã ghi. Hai biến độc lập với nhau, và BACKUP_MAX_HOURS vẫn giới hạn các giai đoạn sau chính bản sao lưu (lưu giữ, thống kê, bản sao off-site), nơi không có bộ đếm nào để theo dõi. |
DB_DUMP_MAX_HOURS |
Không | Số giờ một lần kết xuất cơ sở dữ liệu tự động được phép chạy trước khi bị dừng. Để trống (mặc định) là 6. Giá trị cho phép từ 1 đến 48, và giới hạn này được giữ thấp hơn BACKUP_MAX_HOURS một giờ (bằng một nửa giá trị đó khi nó dưới hai giờ), để một bản kết xuất dài bị chính giới hạn của nó cắt và được báo cáo như vậy, thay vì kéo cả bản sao lưu theo. Bản kết xuất không còn tiến triển sẽ bị dừng sớm hơn, sau BACKUP_STALL_HOURS. Một bản kết xuất bị dừng chỉ thất bại cho riêng nó, còn bản sao lưu của container vẫn tiếp tục. Trên Unraid, thêm biến này vào container BombVault bằng Add another Path, Port, Variable. |
TZ |
Không | Múi giờ cho bộ lập lịch (ví dụ Europe/Berlin). Nếu không đặt, mọi lịch trình sẽ chạy theo UTC: lịch đặt lúc 02:30 sẽ bắt đầu lúc 02:30 UTC chứ không theo giờ địa phương. Trên Unraid bạn không bao giờ tự đặt giá trị này: hệ thống truyền múi giờ của chính nó vào mọi container. Nhật ký khởi động cho biết múi giờ nào đã được chọn. Một múi giờ có giờ mùa hè sẽ bỏ qua một lần chạy vào mùa xuân và chạy một lần hai lượt vào mùa thu, còn UTC thì không gặp cả hai chuyện đó nhưng lệch một giờ so với đồng hồ của bạn hai lần mỗi năm. |
DATA_DIR |
Không | Nơi BombVault giữ cơ sở dữ liệu, khóa và bộ nhớ đệm của nó (mặc định /config). Đừng đổi nó trong container. Nó chỉ quan trọng khi bạn chạy tệp thực thi ngoài Docker. |
FLASH_DIR, FLASH_TEMPLATES_DIR |
Không | Nơi ổ flash và các mẫu Docker của nó được gắn bên trong container (mặc định /host/boot và /host/boot/config/plugins/dockerMan/templates-user). Chúng theo điểm gắn kết /boot của mẫu, nên hãy để trống. |
MODE |
Không | full (mặc định) chạy toàn bộ ứng dụng. node chạy một node: không có giao diện web và không có lịch riêng, chỉ làm những gì phiên bản chủ của nó bảo. Mọi giá trị khác sẽ dừng việc khởi động kèm một thông báo. Phiên bản chủ tự điền giá trị này cho bạn trong tệp compose của node. |
NODE_HOME |
Trên node | Node thuộc về phiên bản chủ nào, cùng khóa và relay của phiên bản chủ, gộp thành một giá trị bắt đầu bằng bvhome1.. Phiên bản chủ ghi nó vào tệp compose của node. Thiếu nó, node vẫn khởi động nhưng không phiên bản chủ nào tới được. Một node đã được một phiên bản chủ nhận sẽ từ chối khởi động khi NODE_HOME chỉ tới một phiên bản chủ khác, cho đến khi phiên bản chủ kia giải phóng nó. |
NODE_NAME |
Không | Tên của node, do phiên bản chủ điền từ tên bạn đặt cho nó. |
Điểm gắn kết¶
Gắn kết Docker socket, flash (/boot) và gốc Host Data (/mnt) như hiển thị trong template CA. Cả nguồn và đích sao lưu đều nằm dưới Host Data, và nó được gắn kết slave nên một share từ xa được gắn kết sau khi container khởi động (ví dụ dưới /mnt/remotes) trở nên hiển thị mà không cần khởi động lại.
Trên TrueNAS, Host Data là một đường dẫn tập dữ liệu như /mnt/tank, không bao giờ là một ixVolume. Dữ liệu mà một ứng dụng giữ trong ixVolume nằm ngoài đó và không được sao lưu. Xem TrueNAS SCALE.
Sao lưu tập dữ liệu ZFS cũng cần chế độ này: máy chủ chỉ gắn ảnh chụp của một tập dữ liệu sau khi container đã khởi động. Xem Tập dữ liệu ZFS.
Các kho cục bộ mặc định nằm ở /mnt/user/bombvault/{container,vms,flash,config,files,zfs} và được tạo ở lần sao lưu đầu tiên. Chúng là thư mục riêng của các phần và tạo thành đích sao lưu Cục bộ. Trên trang của nó trong Đích sao lưu, thẻ Kết nối đổi thư mục của từng phần.
Thư mục riêng của một phần cũng có thể nằm trong một đích sao lưu bạn đã có, chẳng hạn một NAS hoặc một bucket S3: Dùng làm thư mục riêng trên trang của đích đó chuyển nó sang đó và cho biết trước chuyện gì xảy ra với các bản sao lưu đã có. Xem Thư mục riêng của một phần.
Các thư mục kho cục bộ giữ chế độ 0755 và 0644, để một người dùng đồng bộ không phải root qua SMB không bị khóa ngoài, và các kho đã được mã hóa nên điều này không để lộ gì. Định nghĩa khôi phục nằm bên trong từng kho, nên một thư mục được sao chép tự nó đã đầy đủ. Kho tự sao lưu vẫn chỉ root đọc được.
Kiểm tra tích hợp máy chủ
Thẻ Tích hợp máy chủ trên Tổng quan (thêm qua Tùy chỉnh) kiểm tra mọi điểm gắn kết và CLI (Docker socket, libvirt, restic, qemu-img, rclone) và báo cáo bất kỳ phần nào bị thiếu.
Nhận diện nguồn sao lưu¶
Với mỗi container, BombVault tự động chọn bind mount và volume đặt tên nào cần sao lưu. Một đường dẫn được chọn khi bất kỳ điều nào sau đây áp dụng (bạn luôn có thể ghi đè kết quả trong thẻ Thư mục sao lưu ở tab Cài đặt của container):
- Khớp một đoạn gốc dữ liệu: nguồn trên máy chủ của bind chứa một trong các đoạn của
DATA_ROOT_SEGMENTSnhư một thành phần đường dẫn trọn vẹn (mặc định chỉappdata). - Volume Docker có tên luôn được đưa vào, vì chúng không có bản tương đương dùng một lần nên chẳng có gì để lọc bỏ, nhưng chỉ khi đường dẫn lưu trữ thật của volume trên máy chủ tự nó tới được qua điểm gắn Host Data, đúng như mọi đường dẫn máy chủ khác mà BombVault sao lưu. Trình điều khiển volume cục bộ mặc định đặt volume dưới gốc dữ liệu của chính daemon, tức
/var/lib/docker/volumes/<tên>/_datanếu bạn chưa đổi (kiểm tra bằngdocker info -f '{{.DockerRootDir}}'). Vị trí đó KHÔNG nằm trong điểm gắn Host Data hẹp, chỉ một thư mục, mà tệpdocker-compose.ymlchung dùng theo mặc định. Volume không tới được sẽ bị bỏ qua lặng lẽ, đó không phải lỗi. Để thật sự sao lưu volume có tên trên một máy chủ thông thường, hãy trỏ Host Data (vàHOST_SOURCE_ROOT) tới một thư mục cha chung bao trùm cả gốc dữ liệu của Docker: đánh đổi được nêu trong ghi chú Host Data của tệp compose (Unraid né chuyện này bằng cách gắn toàn bộ/mnt, quy ước cấp cao nhất của riêng nó, cũng vì cùng lý do). - Thư mục dự án Docker Compose: nếu container mang nhãn tiêu chuẩn
com.docker.compose.project.working_dir(dodocker compose uptự đặt), thư mục đó cũng được thêm vào, bất kể có bind nào khớp một đoạn gốc dữ liệu hay không. - Ghi đè bằng nhãn
bombvault.data: đặt nhãnbombvault.data=truelên container để đưa vào TẤT CẢ bind mount của nó, dành cho bố cục mà cả hai quy ước trên đều không bắt được (ví dụ một bind/srv/plex/configđơn lẻ, không có dự án Compose). Mọi giá trị không rỗng khácfalseđều tính là đúng. Thiếu nhãn hoặcbombvault.data=falsethì không thay đổi gì. - Nhãn
bombvault.dbdump: đặtbombvault.dbdump=falsetrên một container để tắt việc kết xuất cơ sở dữ liệu tự động của nó (0,novàoffcũng vậy), hoặc nêu tên engine (postgres,mysql,mariadb) để kết xuất một container mà BombVault tự không nhận ra. Nhãn này thắng công tắc trong thẻ Cơ sở dữ liệu ở tab Cài đặt của container, và trên Unraid đó là cách duy nhất.
Mô hình bảo mật¶
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 (qemu+ssh://, root theo mặc định) để 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ủ.
Đăng nhập¶
- Bảo vệ bằng mật khẩu tùy chọn (thẻ Mật khẩu trong Cài đặt, Bảo mật): đặt mật khẩu để yêu cầu đăng nhập, xóa nó để tắt. Mặc định tắt cho mạng LAN tin cậy. Mật khẩu được lưu bằng Argon2id trên một pepper gắn với
APP_KEY, nên một/configbị sao chép sẽ vô giá trị nếu thiếu khóa và chậm để tấn công kể cả khi có khóa. Mật khẩu mới cần ít nhất 12 ký tự. Mật khẩu cũ ngắn hơn vẫn dùng được cho đến khi đổi. Các phiên được ký (HMAC dẫn xuất từAPP_KEY) và đổi mật khẩu sẽ vô hiệu hóa chúng. Đăng nhập bị giới hạn năm lần thất bại mỗi phút cho mỗi máy khách. Đổi hoặc xóa mật khẩu sẽ hỏi Mật khẩu hiện tại và, khi xác thực hai yếu tố đang bật, cả mã. - Một số việc cần mật khẩu. Tải bộ khôi phục, báo cáo lỗi và tệp ZIP của một bản sao lưu flash, xuất một bản sao lưu flash hoặc bản tự sao lưu, gửi khóa cho bên giữ khóa, cho phép trao một bản gửi, tạo mã mở bản gửi mới, xuất cài đặt kèm thông tin đăng nhập, xác thực hai yếu tố, khóa truy cập, thêm node, hiện lại tệp compose của node và mở các mục của node đều bị từ chối cho đến khi đặt mật khẩu đăng nhập, và cần đăng nhập ngay tại phiên bản đó. Xóa bản sao lưu vẫn làm được khi không có mật khẩu. Khi đã đặt mật khẩu, việc này cũng cần đăng nhập như vậy.
- Đích sao lưu không hiển thị mật khẩu. Một đích sao lưu có thể chứa thông tin đăng nhập, như trong
rest:https://user:password@host/repo, và mọi trang cũng như mọi phản hồi API đều hiển thị nó thànhrest:https://[redacted]@host/repo, dù có hay không có mật khẩu đăng nhập. Khi bạn đổi đường dẫn phía sau, mật khẩu đã lưu vẫn được giữ. Để trỏ đích sao lưu sang một máy chủ khác, hãy gõ toàn bộ địa chỉ kèm mật khẩu của nó, vì mật khẩu bị ẩn vẫn gắn với máy chủ cũ. - Xác thực hai yếu tố (Cài đặt, Bảo mật): một mã thời gian từ ứng dụng xác thực bên cạnh mật khẩu, cùng tám mã khôi phục dùng một lần được trao một lần khi bật. Bí mật chia sẻ được lưu mã hóa bằng
APP_KEY, và tắt lại yếu tố này cần một mã hiện hành. - Khóa truy cập (WebAuthn) nằm trên một thẻ riêng khi đã đặt mật khẩu, dùng song song với mật khẩu chứ không bao giờ thay thế nó, nên xóa hết khóa truy cập cũng không khóa ai ở ngoài. Chúng cần một tên miền thật và một chứng chỉ mà trình duyệt tin cậy. Địa chỉ mặc định
https://<ip>:3443đúng là thứ WebAuthn từ chối, nên thẻ nói rõ điều đó thay vì đưa ra một nút bấm sẽ thất bại. Khi xác thực hai yếu tố đang bật, khóa truy cập phải kiểm tra mã PIN, vân tay hoặc khuôn mặt của bạn, nếu không thì lúc đăng nhập sẽ hỏi thêm mã. - Khôi phục cấu hình (Khôi phục cài đặt trong Trình hướng dẫn khẩn cấp) kết thúc mọi phiên, gỡ mọi khóa truy cập và thu hồi mọi mã thông báo API và khóa MCP, vì cài đặt được khôi phục có thể mang lại những thứ đã bị gỡ sau khi chúng được lưu. Hãy đăng nhập bằng mật khẩu và thiết lập lại khóa truy cập trong Cài đặt, Bảo mật.
- Mật khẩu bị quên được đặt lại trên trang đăng nhập. Quên mật khẩu? khiến BombVault ghi một mã 12 ký tự, chia ba nhóm bốn, vào nhật ký container của nó (trên Unraid: tab Docker, biểu tượng BombVault, Logs). Mã đó cùng một mật khẩu mới sẽ đưa bạn vào. Việc đặt lại cũng tắt xác thực hai yếu tố, gỡ mọi khóa truy cập, thu hồi mọi mã thông báo API, khóa MCP và phiên đăng nhập OAuth, kết thúc mọi phiên khác, đăng xuất mọi điện thoại đã ghép nối và tắt việc ghép nối điện thoại. Trang sau đó liệt kê những gì đã mất. Mã có hiệu lực 10 phút, và đoán sai không làm tiêu hao nó. Mã thông báo widget và metrics vẫn còn vì chúng chỉ đọc.
- Ai đọc được nhật ký container thì đặt lại được mật khẩu. Đó là root trên máy chủ, nhưng cũng là một trình xem nhật ký như Dozzle, bất kỳ container nào được cấp Docker socket (chỉ đọc là đủ) và một công cụ chuyển tiếp nhật ký đưa đầu ra container đi nơi khác. Chỉ trao những thứ đó cho người bạn tin tưởng với mật khẩu. Người chỉ truy cập được giao diện web thì không bao giờ thấy mã.
Điện thoại và thành viên nhóm¶
- Điện thoại đã ghép nối chạm tới một danh sách cho phép. Một điện thoại biết mười hai từ của nhóm đăng nhập mà không cần mật khẩu, miễn là Điện thoại có thể ghép nối bằng mười hai từ của nhóm đang bật trong thẻ Ứng dụng Android dưới Cài đặt, Bảo mật. Phiên của nó chỉ chạm tới những gì ứng dụng hiển thị: Tổng quan, các lần chạy, các bản sao lưu để xem, bắt đầu và khôi phục, các bất thường để đọc và trang Phiên bản để xem. Các đích sao lưu và lệnh đến với nó đã bị lược bỏ địa chỉ và bí mật, và một lần khôi phục thay thế bản gốc sẽ sao lưu trạng thái hiện tại trước. Một lần khôi phục vào thư mục chỉ nhận một thư mục mới hoặc trống bên trong thư mục khôi phục, và điện thoại không thể xem vào thư mục nào khác. Mọi thứ khác trả lời rằng cần đăng nhập ngay tại phiên bản đó: khóa, bộ khôi phục, bản gửi khóa, cài đặt, xóa bản sao lưu. Việc đặt lại mật khẩu tắt ghép nối điện thoại cho đến khi bạn bật lại. Một điện thoại bị xóa khỏi trang Phiên bản, hoặc bị tắt Truy vấn phiên bản này trong phần chi tiết của nó, sẽ mất phiên ngay lập tức, và một điện thoại đã bị xóa mà mở lại ứng dụng sẽ quay lại ở trạng thái tắt.
- Khi ra ngoài, điện thoại mở trang qua relay. Mỗi yêu cầu của trang được niêm phong bằng khóa của nhóm, relay không thể đọc hay thay đổi, và được ký bằng khóa riêng của điện thoại, mà máy chủ ghim lại ở lần gọi đầu tiên của điện thoại và cho vào khi có người duyệt điện thoại đó trên trang ghép nối. Máy chủ chỉ chạy một yêu cầu một lần và chỉ khi nó còn mới. Máy chủ chỉ trả lời một điện thoại có trong trang Phiên bản, miễn là ghép nối điện thoại đang bật, và chỉ bằng một phiên mà nó đã cấp cho điện thoại đó, nên đăng xuất ở mọi nơi và đặt lại mật khẩu cũng chấm dứt các trang này. Máy chủ ký mọi phản hồi, và ứng dụng kiểm tra chữ ký bằng khóa đã ghim cho máy chủ đó và cảnh báo khi khóa thay đổi. Trang như vậy chạm tới cùng danh sách cho phép với một điện thoại đã ghép nối, có hay không có mật khẩu đăng nhập, cộng với trạng thái đăng nhập mà trang đọc đầu tiên. Đăng nhập và đăng xuất, đặt lại mật khẩu và tải xuống vẫn nằm ở địa chỉ riêng của máy chủ, và một phản hồi bị giới hạn ở 16 MB.
- Các thành viên ký những gì họ yêu cầu. Yêu cầu vai trò và câu trả lời, các lời đề nghị lưu trữ, việc trao mật khẩu restic cho bên nhận hoặc bên kéo, đăng nhập bên nhận và bản gửi khóa được ký bằng khóa của từng thành viên, mà một phiên bản ghim lại lần đầu thấy thành viên đó. Một lệnh gọi ký bằng khóa khác bị từ chối. Quên khóa trong chi tiết của một phiên bản bỏ khóa đã ghim, cho trường hợp khóa đang biết ở đây không phải của chính thành viên. Thành viên sẽ bị hỏi lại khóa ở lệnh gọi ký kế tiếp. Các thành viên chạy BombVault 9.x không ký và có thể bị bất kỳ ai có các từ đóng giả, như ở 9.9. Một yêu cầu vai trò hoặc một lời đề nghị lưu trữ từ thành viên chạy 10.4 hoặc cũ hơn sẽ bị từ chối cho đến khi thành viên đó được cập nhật.
- Mười hai từ là một mật khẩu. Ai có chúng sẽ vào nhóm, thấy trạng thái bảo vệ của các thành viên và có thể yêu cầu vai trò, việc mà một người ở phiên bản kia vẫn phải cho phép. Không có mật khẩu đăng nhập thì bất kỳ ai mở được giao diện web đều đọc được chúng, và thẻ ghép nối nói điều đó cho đến khi đặt mật khẩu.
Khóa¶
- APP_KEY làm hai việc. Nó niêm phong những gì bản cài này lưu (mật khẩu, thông tin đăng nhập, mã thông báo) và là khóa của các bản sao lưu: mật khẩu restic được dẫn xuất từ nó, và định nghĩa container và VM được niêm phong bằng nó.
- Khóa được tiếp nhận được giữ riêng. Khi Trình hướng dẫn khẩn cấp tiếp nhận các bản sao lưu của một máy chủ khác, bản cài này tiếp tục niêm phong bằng APP_KEY của chính nó và lưu khóa của máy chủ kia làm khóa sao lưu, được niêm phong như mọi bí mật khác. Bộ khôi phục khi đó in cả hai. Nếu sau đó APP_KEY bị đổi, khóa sao lưu không còn mở được: BombVault ngừng sao lưu và nói điều đó trong Cần chú ý, thay vì ghi bằng khóa sai. Hãy tải lại bộ khôi phục trong Khôi phục, Khẩn cấp, hoặc đặt APP_KEY về như cũ. Xem Trình hướng dẫn khẩn cấp.
- Mã hóa được bật mặc định (Mã hóa bản sao lưu trong thẻ Mã hóa dưới Cài đặt, Bảo mật). Các bản sao lưu được restic mã hóa bằng mật khẩu dẫn xuất từ khóa sao lưu.
- Bản gửi khóa. Một bên giữ khóa trong nhóm của bạn giữ một bản niêm phong của bộ khôi phục của máy chủ này mà chính nó không mở được. Chỉ mã mở bản gửi 20 ký tự mới mở được, và bên giữ khóa chỉ trao nó sau khi ai đó ở đó nhấn Cho phép. Xem Bên giữ khóa.
Node¶
Một node là một BombVault không có giao diện web, nhận lệnh từ một phiên bản chủ.
- Phiên bản chủ nắm node. Một node gắn socket Docker của máy chủ của nó, tức là quyền root ở đó, và phiên bản chủ điều khiển node. Nếu phiên bản chủ bị chiếm, kẻ tấn công cũng điều khiển tất cả node của nó. Hãy đặt mật khẩu đăng nhập cho phiên bản chủ và đừng để giao diện web của nó lộ ra internet.
- Node giữ rất ít. Nếu một node bị chiếm, kẻ tấn công không có được nhóm ghép nối, pháo đài, node khác hay kho khác nào. Node chỉ có một liên kết tới phiên bản chủ của nó, một thông tin đăng nhập riêng trên máy chủ nhận và một thư mục riêng ở một đích sao lưu. Trên máy chủ nhận nó không xóa được lịch sử, vì máy chủ là append-only. Nó có thể làm đầy ổ đĩa của máy chủ, vì rest-server không đặt hạn mức, nên hãy cho máy chủ nhận đủ chỗ hoặc một share riêng. Ở một đích sao lưu, thông tin đăng nhập của nó thường xóa được những gì nằm ở đó. Các bản sao lưu giữ trên node sẽ rơi vào tay kẻ tấn công, đó là lý do phiên bản chủ lấy một bản sao của chúng về.
- Liên kết là riêng tư và được ký. Phiên bản chủ và node nói chuyện qua relay bằng một liên kết của riêng chúng, được niêm phong bằng một bí mật dẫn xuất từ
APP_KEYcủa node. Mỗi bên đã biết khóa của bên kia trước lệnh gọi đầu tiên, nên không có bước phê duyệt. Phiên bản chủ ký mọi lệnh gọi bằng khóa của chính nó và một bộ đếm, còn node từ chối lệnh gọi không do phiên bản chủ ký hoặc lệnh gọi nó đã nhận trước đó. Node không gọi gì ở phiên bản chủ ngoài lời chào của nó. - Phiên bản chủ chỉ tới được một danh sách cố định. Các yêu cầu phiên bản chủ chuyển tới node chỉ chạy trên một danh sách cố định các route của node, liệt kê ở
GET /api/nodes/routes, và node chỉ trả lời bằng JSON. Không có gì trong danh sách xóa được, hay tới được cài đặt, bộ nhớ, khóa, nhóm hoặc token. Trên phiên bản chủ, chúng cần đăng nhập bằng mật khẩu: điện thoại đã ghép nối, token API và khóa MCP không tới được node. Các bản sao lưu và lần khôi phục bắt đầu theo cách này hiện là do phiên bản chủ bắt đầu. - Bản gửi khóa mang theo khóa của node. Phiên bản chủ giữ
APP_KEYcủa từng node, và bộ khôi phục in nó trong chương Node, nên bản gửi khóa cũng mang theo nó. Một bên giữ khóa có được bản gửi và mã mở bản gửi có thể mở kho của các node của bạn, nhưng không ra lệnh được cho node nào, vì việc đó cần chữ ký của phiên bản chủ. - Giải phóng là vĩnh viễn. Một node đã giải phóng không nhận phiên bản chủ nào nữa với cùng
APP_KEY. Một node đang vắng mặt khi bạn giải phóng sẽ nghe tin từ phiên bản chủ khi nó quay lại.
Mạng¶
- Thay đổi cần JSON. Một yêu cầu thay đổi điều gì đó phải gửi
Content-Type: application/jsonvà không được trình duyệt đánh dấu là liên trang (cross-site), nên một trang trên trang web khác không thể khiến trình duyệt của bạn thay đổi cài đặt trên một địa chỉ LAN. Script điều khiển API sẽ gửi header đó. Mọi yêu cầu khác bị từ chối với415. - Vì cổng bảo vệ là tùy chọn, khi chưa đặt thì toàn bộ giao diện và API (gồm cả đích sao lưu, các route kiểm tra can thiệp và các route khôi phục) ai tới được cổng đều truy cập được. Hãy đặt mật khẩu đăng nhập ngay khi dùng sao lưu off-site, append-only hoặc mã hóa.
- Chỉ chạy BombVault trên một mạng tin cậy, không phơi ra ngoài. Để truy cập từ xa, đặt nó phía sau một reverse proxy có thêm xác thực và TLS. Các phản hồi mang theo các tiêu đề bảo mật cơ bản (CSP,
nosniff,X-Frame-Options,Referrer-Policy). - Sau một proxy ngược, mọi yêu cầu đều mang địa chỉ của proxy, nên nếu không có
TRUSTED_PROXYthì bộ hãm đếm tất cả máy khách vào một giỏ và những lần thất bại của kẻ tấn công cũng khóa bạn ở ngoài. Khai báo proxy trongTRUSTED_PROXYđể việc đếm trở lại theo từng máy khách. - Reverse proxy đặt trước BombVault phải chuyển tiếp header
AuthorizationhoặcX-API-Keytới/mcpvà không được đệm câu trả lời, nếu không trợ lý sẽ không kết nối được. Xem Máy chủ MCP. - Endpoint MCP
/mcptrả về404cho đến khi có một khóa hoặc bật đăng nhập qua OAuth, và nó đòi khóa hoặc token từ mọi máy khách ngay cả khi mật khẩu đăng nhập đang tắt. Không địa chỉ nào được miễn, kể cảlocalhost. Nó không có công cụ khôi phục hay xóa, và việc khôi phục bản sao lưu cấu hình sẽ thu hồi mọi khóa. Xem Máy chủ MCP. - Với
HTTP_ONLY=truecookie phiên mất cờSecurecủa nó (bắt buộc phải vậy, để hoạt động qua HTTP thuần), nên chỉ bật mật khẩu phía sau một proxy kết thúc TLS nếu tính bảo mật là quan trọng. - Kết nối SSH sao lưu VM tin cậy host key ở lần kết nối đầu tiên (TOFU) và ghim nó sau đó. Xác minh khóa của máy chủ ngoài luồng nếu đường dẫn container-tới-máy-chủ của bạn không tin cậy.
- Liên kết không dẫn ra ngoài điểm gắn kết. Một bản sao lưu hoặc một lần khôi phục tại chỗ sẽ dừng kèm thông báo khi một liên kết ở phía trên đường dẫn của nó dẫn ra ngoài điểm gắn kết của máy chủ, vì một container ghi vào share của chính nó có thể cài sẵn một liên kết như vậy. Một đích sao lưu có host hoặc remote rclone bắt đầu bằng dấu gạch ngang cũng bị từ chối theo cách đó, khi lưu và ở lần chạy kế tiếp, vì
sshhoặcrclonesẽ đọc nó như một tùy chọn.
Máy chủ MCP¶
Máy chủ MCP không cần biến môi trường nào. Bạn bật nó bằng cách tạo một khóa tại Cài đặt, Tích hợp, Máy chủ MCP, và nó trả lời ở /mcp trên cùng cổng với giao diện web (ví dụ https://192.168.1.10:3443/mcp). Khi không có khóa đang hoạt động, đường dẫn này trả lời 404. Máy khách, chứng chỉ và các giới hạn được mô tả tại Máy chủ MCP.
Sao lưu VM qua SSH¶
BombVault sao lưu các KVM/libvirt VM mà không gắn kết bất kỳ đường dẫn libvirt nào. Nó chạy virsh trên máy chủ qua SSH (qemu+ssh://), nên nó không bao giờ có thể ảnh hưởng đến VM Manager của máy chủ bạn.
Gắn socket libvirt của máy chủ vào một container là cách dễ hỏng trên Unraid: VM Manager sở hữu các đường dẫn đó, và việc bật tắt "Enable VMs" có thể khiến libvirt không khởi động được. Khóa SSH cấp quyền root trên máy chủ, cùng mức tin cậy với Docker socket mà BombVault vốn đã dùng.
Thiết lập nhanh:
- Cài đặt, Tích hợp, SSH máy chủ: sao chép khóa công khai được hiển thị.
- Thêm nó vào
/root/.ssh/authorized_keyscủa Unraid (cũng được lưu vào flash để nó tồn tại qua các lần khởi động lại). - Nhấp Kiểm tra kết nối.
Template thêm --add-host=host.docker.internal:host-gateway để container có thể tiếp cận máy chủ. Đặt LIBVIRT_HOST thành IP LAN Unraid của bạn nếu tên đó không phân giải được (ví dụ khi container chạy trên một mạng br0.x tùy chỉnh). Nếu bạn đã đổi cổng SSH của Unraid, đặt LIBVIRT_SSH_PORT cho khớp. Snapshot trực tiếp ngoài ra cần qemu guest agent trong VM và đĩa nằm trên /mnt/cache (không phải /mnt/user).
Hướng dẫn thiết lập VM và mạng đầy đủ
Hướng dẫn từng bước hoàn chỉnh (bật SSH, ủy quyền khóa lâu bền, định tuyến mạng tùy chỉnh và VLAN, phương thức theo từng VM và khắc phục sự cố phía máy chủ) là hướng dẫn sao lưu VM.
Thiết lập off-site¶
Các bản sao off-site đi tới đích sao lưu. Mở Đích sao lưu từ ô cài đặt của nó (hoặc ghim vào thanh bên) và chọn Thêm đích. Xem Off-site & khôi phục để biết quy trình đầy đủ (bảo vệ chống xóa, kiểm tra can thiệp và diễn tập DR). Tóm tắt:
- Backend: SMB/CIFS và WebDAV qua rclone không cần gắn kết trên máy chủ, NFS (gắn export trên máy chủ và dùng như thư mục cục bộ), các backend restic gốc không cần rclone (
s3:...,rest:http://host:8000/repo,sftp:user@host:/repo), hoặc bất kỳ rclone remote nào (rclone:<remote>:<bucket>/path). Backblaze B2 ở đây không có backend gốc: hãy dùng điểm cuối S3 của nó (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>) với ID khóa và khóa ứng dụng làm thông tin xác thực S3. - Thông tin đăng nhập được lưu mã hóa, dưới dạng một danh sách các thông tin đăng nhập đã lưu trong thẻ Thông tin đăng nhập dưới Cài đặt, Đích sao lưu. Một ngôi sao đánh dấu mặc định, được dùng ở bất cứ nơi nào không chọn thông tin đăng nhập. Trang riêng của một đích chọn cái nó dùng trong thẻ Thông tin đăng nhập của nó. Xem Thông tin đăng nhập.
- Đích SSH không cần cài đặt gì ở phía bên kia.
sftp:chỉ cần một máy chủ SSH. Thêm khóa công khai từ Cài đặt, Tích hợp, SSH máy chủ (cũng nằm tại/config/ssh/id_ed25519.pub) vào~/.ssh/authorized_keyscủa người dùng đích, hoặc để Thêm khóa trong Thêm đích đặt nó vào đó bằng mật khẩu của tài khoản. - rest-server dùng chứng chỉ tự ký: đặt chứng chỉ của nó, hoặc chứng chỉ của tổ chức đã ký nó, dưới dạng tệp PEM vào thư mục
certstrong thư mục dữ liệu của BombVault (/config/certstrong container,appdata/bombvault/certstrên Unraid). Sao lưu, sao chép off-site và bài kiểm tra bảo vệ chống xóa đều tin cậy nó mà không cần khởi động lại. - Bản sao off-site: BombVault sao chép các bản sao lưu mới bằng
restic copytheo kiểu hết sức có thể, bên trên một kho chính (thường là cục bộ). Thẻ Sao chép của một đích đặt việc nó sao chép Sau mỗi bản sao lưu hay theo kế hoạch riêng, và Cài đặt, Lịch trình, Bản sao ngoài site theo phần cho một phần kế hoạch sao chép riêng. Sao chép ngay nằm trong dòng của phần đó ở thẻ Bản sao ngoài site dưới Cài đặt, Đích sao lưu. - Nhiều đích sao lưu cho mỗi phần: thẻ Đích theo phần trên trang Đích sao lưu bật hoặc tắt từng dòng từ một phần tới một đích bằng một cú nhấp, kể cả Cục bộ. Một phần chỉ có các đích off-site sao lưu thẳng tới chúng, và một phần có mọi dòng đều tắt thì không được sao lưu. Quy tắc theo phần của một đích cho một phần kho, chính sách lưu giữ hoặc nén riêng ở đó.
- Nơi lưu trữ theo từng mục: mỗi container, VM và bộ thư mục làm sáng Cục bộ và các đích nhận bản sao lưu của nó, trong thẻ Lịch trình và đích sao lưu ở tab Cài đặt của nó. Các mục không có lựa chọn riêng theo phần của chúng. Xem Nơi lưu trữ theo từng mục.
- Lưu giữ: mỗi đích giữ các bản sao lưu theo thẻ Giữ trong bao lâu của nó, và một phần có thể giữ giá trị riêng ở đó trong Quy tắc theo phần. Bản sao trong trường off-site của một phần giữ quy tắc của thẻ Lưu giữ ngoài site dưới Cài đặt, Đích sao lưu, có Quy tắc lưu giữ theo nguồn cho từng phần (để toàn bộ bằng 0 nếu không bao giờ muốn tự động cắt tỉa bản sao lưu off-site).
- Giới hạn băng thông: giới hạn tốc độ tải lên/tải xuống của restic trong thẻ Băng thông off-site dưới Cài đặt, Đích sao lưu, hoặc theo từng đích trong thẻ Sao chép của nó. Bạn nhập KiB/s, và ô hiện cùng tốc độ đó theo MB/s và Mbit/s.
- Ưu tiên phát trực tuyến: trong thẻ Phát trực tuyến trên trang Đích sao lưu, chọn các máy chủ media (Plex, Jellyfin và Emby được chọn sẵn theo tên image), tốc độ gửi từ đó được coi là đang phát trực tuyến, giới hạn tải lên khi đang phát và bao lâu sau một luồng thì giới hạn bình thường quay lại.
- Lớp lưu trữ lạnh và lưu trữ lâu dài (S3): với một đích sao lưu S3, chọn một tầng đọc được khi khôi phục (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval) trên trang của nó. Các rclone remote đặt lớp của chúng trong cấu hình rclone.
- Thư mục riêng trong một đích sao lưu thay vì cục bộ: thư mục riêng của một phần có thể nằm trong một trong các đích sao lưu ở trên, không có bản sao cục bộ và không có bước sao chép. Xem Thư mục riêng của một phần.
Bất thường¶
Phát hiện bất thường không cần biến môi trường nào. Nó được thiết lập trong thẻ Bất thường dưới Cài đặt, Xác minh, được mô tả ở Bất thường.
Cài đặt di động (xuất và nhập)¶
Thẻ Xuất / nhập cài đặt dưới Cài đặt, Hệ thống ghi toàn bộ cấu hình BombVault của bạn (cài đặt các phần, đích sao lưu, lịch trình, lưu giữ, thông báo) ra một tệp JSON di động mà bạn có thể nhập trên phiên bản khác, nên chuyển sang máy mới hay nhân bản một thiết lập không có nghĩa là phải nhập lại mọi thứ bằng tay. Việc nhập hiển thị bản xem trước và hỏi xác nhận, và không bao giờ đụng tới dữ liệu sao lưu hay lịch sử của bạn. Các liên kết trong tệp tới đích sao lưu hoặc kho không còn tồn tại sẽ bị bỏ qua, và bản xem trước nêu tên chúng. Khi một bản sao ZFS đang chạy, việc nhập bị từ chối trước khi ghi bất cứ thứ gì.
Bản xuất có thể chứa thông tin đăng nhập
Bạn chọn có bao gồm thông tin đăng nhập off-site, thông báo và broker MQTT trong tệp hay không. Khi có kèm thông tin đăng nhập, bản xuất nhạy cảm như bộ khôi phục của bạn, nên hãy cất giữ nó ở nơi an toàn. Không có chúng, tệp chỉ chứa các cài đặt không bí mật.
APP_KEY không đi kèm tệp
Các kho được khóa bằng một mật khẩu dẫn xuất từ APP_KEY, và tệp không chứa khóa này. Khi chuyển máy có kế hoạch, hãy đặt APP_KEY cũ vào template của máy mới, hoặc tiếp nhận khóa bằng bộ khôi phục dưới Khẩn cấp. Với một khóa khác, các kho sẽ báo sai mật khẩu. Không có gì bị mất, và đặt đúng khóa sẽ mở lại chúng.