Sao lưu

Giữ một bản sao thiết lập của bạn để phục hồi sau một bản cập nhật lỗi, ổ đĩa hỏng hoặc khi chuyển sang máy tính mới.

Trước khi bắt đầu

• Settings > Backups (Cài đặt > Sao lưu) cần quyền Change settings (đổi cài đặt). Chỉ chủ sở hữu mới được khôi phục.
• Tải xuống, xóa và khôi phục cần bạn đã đăng nhập bằng mật khẩu trong vài phút gần đây.

Tạo bản sao lưu

1. Mở Settings > Backups.
2. Nhấn Back up now (sao lưu ngay). Bạn sẽ thấy bản sao lưu mới dưới Saved backups (các bản sao lưu đã lưu).
3. Nhấn Download (tải xuống) bên cạnh nó để giữ một bản ngoài máy chủ.

Lưu khóa chính

Bản sao lưu không bao giờ chứa khóa chính, là khóa mở các mật khẩu và khóa API trong cài đặt của bạn. Thiếu khóa tương ứng, bản sao lưu đã khôi phục không đọc được chúng.

1. Dưới Master key (khóa chính), chủ sở hữu nhấn Download key kit (tải xuống bộ khóa).
2. Giữ tệp này tách khỏi máy chủ và tách khỏi các bản sao lưu. Bạn sẽ thấy cảnh báo về bộ khóa biến mất khỏi Settings > Backups và khỏi các kiểm tra tình trạng.

Để dùng sau này, đổi tên nó thành holyarrs.key và đặt vào thư mục cấu hình. Không phải chủ sở hữu? Nhờ chủ sở hữu tải xuống.

Khôi phục bản sao lưu

Nguy hiểm

Các thay đổi sau thời điểm sao lưu sẽ mất. Hãy chuẩn bị sẵn khóa chính tương ứng trước.

1. Nhấn Restore from a file (khôi phục từ tệp) và chọn một tệp zip sao lưu của HolyArrs.
2. Xác nhận.
3. HolyArrs kiểm tra tệp. Bạn sẽ thấy Restore ready. It applies on the next start. (Sẵn sàng khôi phục. Sẽ áp dụng ở lần khởi động tới.)
4. HolyArrs khởi động lại và đặt bản sao lưu vào chỗ. Với chính sách khởi động lại Docker được khuyên dùng, việc này tự diễn ra.

Các cơ sở dữ liệu hiện tại của bạn được chuyển sang /config/backups/before-restore-<time>, nên bạn có thể hoàn tác một lần khôi phục.

Lựa chọn

Tần suất

Lựa chọn	Sao lưu	Giữ lại
Balanced (cân bằng, mặc định)	Mỗi ngày	7 ngày gần nhất và 4 bản hằng tuần
Light (nhẹ)	Mỗi tuần một lần	4 tuần. Tốn ít dung lượng nhất
Careful (cẩn thận)	Mỗi ngày	Mọi bản trong 30 ngày

Bản sao lưu theo lịch mới nhất luôn được giữ. Các quy tắc này chỉ dọn các bản sao lưu theo lịch. Bản sao lưu do bạn tạo được giữ cho đến khi bạn xóa (nút thùng rác trên dòng đó; không thể hoàn tác). HolyArrs cũng sao lưu trước một bản cập nhật có thay đổi dữ liệu đã lưu và giữ 3 bản mới nhất; xem Cập nhật.

Chuyển sang máy tính mới

Bản cài đặt mới tạo khóa chính riêng ở lần khởi động đầu tiên. Khóa đó không mở được các bản sao lưu cũ, nên việc khôi phục bị từ chối. Hãy đặt khóa cũ vào trước. Các ví dụ gọi container là holyarrs; hãy dùng tên của bạn.

1. Trước lần khởi động đầu tiên, tạo container mà không khởi động nó: docker compose create, hoặc dòng docker run của bạn với docker create thay cho docker run -d.
2. Sao chép khóa cũ vào: docker cp holyarrs.key holyarrs:/config/. Một bộ khóa đã đổi tên thành holyarrs.key cũng được. Cách này dùng được cho named volume hoặc thư mục trên máy chủ; HolyArrs giao các tệp trong /config cho PUID và PGID của bạn khi khởi động. Nếu bạn dùng HOLYARRS_MASTER_KEY_FILE, hãy đặt khóa ở đường dẫn đó trên máy chủ, với quyền đọc cho PUID và PGID của bạn.
3. Khôi phục bản sao lưu. Chọn một cách:

   • Khởi động HolyArrs, hoàn tất lần chạy đầu tiên, rồi dùng Restore from a file trong Settings > Backups.

   • Hoặc khôi phục trước lần khởi động đầu tiên. Đặt tệp zip, giữ nguyên tên, vào một thư mục tên backups và sao chép vào bằng docker cp backups holyarrs:/config/. Sau đó chạy lệnh khôi phục một lần với cùng image:

     • Compose: docker compose run --rm holyarrs restore <zip name>
     • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

     Nếu dùng đường dẫn tệp khóa, thêm -e HOLYARRS_MASTER_KEY_FILE=<its path> để việc khôi phục kiểm tra theo khóa của bạn. restore --list cho biết tên các bản sao lưu mà nó thấy.

4. Khởi động HolyArrs. Bạn sẽ thấy thư viện và cài đặt của mình trở lại.

Đã khởi động bản cài mới trước khi sao chép khóa? Nếu trên đó không có gì đáng giữ, dừng HolyArrs, ghi đè khóa mới bằng khóa cũ với cùng lệnh docker cp, khôi phục, rồi khởi động.

Nếu không hoạt động

Triệu chứng: “Backups are off in this build”. Nguyên nhân: bản này chạy mà không có trình quản lý sao lưu. Cách khắc phục: không có cách nào trong ứng dụng; không có nút điều khiển sao lưu.

Triệu chứng: Tải xuống, xóa hoặc khôi phục yêu cầu mật khẩu của bạn. Nguyên nhân: các thao tác này cần một lần đăng nhập bằng mật khẩu gần đây. Cách khắc phục: đăng nhập lại bằng mật khẩu rồi thử lại.

Triệu chứng: việc khôi phục bị từ chối vì khóa chính. Nguyên nhân: khóa trong thư mục cấu hình không khớp với bản sao lưu. Cách khắc phục: đặt lại đúng holyarrs.key rồi thử lại.

Việc khôi phục cũng từ chối tệp zip quá lớn hoặc bị hỏng, chứa tệp không mong đợi, đến từ phiên bản cơ sở dữ liệu mới hơn, hoặc chứa dữ liệu mà khóa của bạn không đọc được.

Dành cho người dùng nâng cao

Một bản sao lưu chứa gì

Mỗi bản sao lưu là một tệp zip gồm cơ sở dữ liệu chính, cơ sở dữ liệu Events nếu có, và backup.json (phiên bản HolyArrs, phiên bản cơ sở dữ liệu, loại bản sao lưu, thời điểm tạo). Media, lượt tải xuống, ảnh bìa, nhật ký và khóa chính không nằm trong đó.

Khôi phục trước lần khởi động đầu tiên

docker cp dùng được cho named volume hoặc thư mục trên máy chủ; HolyArrs giao các tệp trong /config cho PUID và PGID của bạn khi khởi động. Với HOLYARRS_MASTER_KEY_FILE, hãy đặt khóa ở đường dẫn đó trên máy chủ, với quyền đọc cho PUID và PGID.

1. Đặt tệp zip, giữ nguyên tên, vào một thư mục tên backups và sao chép vào: docker cp backups holyarrs:/config/.
2. Chạy lệnh khôi phục một lần với cùng image:
   • Compose: docker compose run --rm holyarrs restore <zip name>
   • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
3. Nếu dùng đường dẫn tệp khóa, thêm -e HOLYARRS_MASTER_KEY_FILE=<its path> để việc khôi phục kiểm tra theo khóa của bạn.
4. Khởi động HolyArrs.

restore --list cho biết tên các bản sao lưu mà nó thấy.

Liên quan

• Cập nhật
• Cài đặt
• Kiểm tra tình trạng