Sandaran

Simpan salinan persediaan anda untuk diletakkan semula selepas kemas kini yang bermasalah, cakera rosak atau perpindahan ke komputer baharu.

Sebelum bermula

• Settings > Backups (Tetapan > Sandaran) memerlukan kebenaran Change settings (ubah tetapan). Hanya pemilik yang memulihkan.
• Muat turun, padam dan pulihkan memerlukan log masuk dengan kata laluan dalam beberapa minit yang lalu.

Buat sandaran

1. Buka Settings > Backups.
2. Tekan Back up now (sandar sekarang). Anda akan nampak sandaran baharu di bawah Saved backups (sandaran tersimpan).
3. Tekan Download (muat turun) di sebelahnya untuk menyimpan salinan di luar pelayan.

Simpan kunci induk

Sandaran tidak pernah mengandungi kunci induk, iaitu kunci yang membuka kata laluan dan kunci API dalam tetapan anda. Tanpa kunci yang sepadan, sandaran yang dipulihkan tidak dapat membacanya.

1. Di bawah Master key (kunci induk), pemilik menekan Download key kit (muat turun kit kunci).
2. Simpan fail itu jauh daripada pelayan dan berasingan daripada sandaran anda. Anda akan nampak peringatan kit kunci hilang daripada Settings > Backups dan semakan kesihatan.

Untuk menggunakannya kemudian, namakan semula fail itu kepada holyarrs.key dan letakkan dalam folder konfigurasi. Bukan pemilik? Minta pemilik memuat turunnya.

Pulihkan sandaran

Danger

Perubahan yang dibuat sejak sandaran itu akan hilang. Sediakan kunci induk yang sepadan terlebih dahulu.

1. Tekan Restore from a file (pulihkan daripada fail) dan pilih zip sandaran HolyArrs.
2. Sahkan.
3. HolyArrs menyemak fail itu. Anda akan nampak Restore ready. It applies on the next start.
4. HolyArrs mula semula dan meletakkan sandaran di tempatnya. Dengan polisi mula semula Docker yang disyorkan, ini berlaku dengan sendirinya.

Pangkalan data semasa anda dialihkan ke /config/backups/before-restore-<time>, jadi anda boleh membatalkan pemulihan.

Pilihan

Kekerapan

Pilihan	Disandarkan	Disimpan
Balanced (seimbang, lalai)	Setiap hari	7 hari terakhir dan 4 salinan mingguan
Light (ringan)	Seminggu sekali	4 minggu. Paling jimat ruang
Careful (berhati-hati)	Setiap hari	Setiap salinan selama 30 hari

Sandaran berjadual yang terbaharu sentiasa disimpan. Peraturan ini hanya membersihkan sandaran berjadual. Sandaran yang anda buat sendiri kekal sehingga anda memadamnya (butang tong sampah pada baris itu; ini tidak boleh dibatalkan). HolyArrs juga membuat sandaran sebelum kemas kini yang mengubah data tersimpan dan menyimpan 3 yang terbaharu; lihat Kemas kini.

Pindah ke komputer baharu

Pemasangan baharu menjana kunci induknya sendiri pada permulaan pertama. Kunci itu tidak dapat membuka sandaran lama anda, jadi pemulihan ditolak. Letakkan kunci lama di tempatnya dahulu. Contoh di sini menamakan kontena holyarrs; gunakan nama anda sendiri.

1. Sebelum permulaan pertama, cipta kontena tanpa memulakannya: docker compose create, atau baris docker run anda dengan docker create menggantikan docker run -d.
2. Salin kunci lama anda masuk: docker cp holyarrs.key holyarrs:/config/. Kit kunci yang dinamakan semula kepada holyarrs.key juga boleh. Ini berfungsi untuk volum bernama atau folder hos; HolyArrs menyerahkan fail dalam /config kepada PUID dan PGID anda apabila ia bermula. Jika anda menggunakan HOLYARRS_MASTER_KEY_FILE, letakkan kunci pada laluan itu di hos, boleh dibaca oleh PUID dan PGID anda.
3. Pulihkan sandaran. Pilih satu cara:

   • Mulakan HolyArrs, selesaikan larian pertama, kemudian gunakan Restore from a file dalam Settings > Backups.

   • Atau pulihkan sebelum permulaan pertama. Letakkan zip, dengan nama tidak berubah, dalam folder bernama backups dan salin masuk dengan docker cp backups holyarrs:/config/. Kemudian jalankan pemulihan sekali dengan imej yang sama:

     • 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>

     Jika kunci anda menggunakan laluan fail, tambah -e HOLYARRS_MASTER_KEY_FILE=<its path> supaya pemulihan menyemak dengan kunci anda. restore --list menunjukkan nama sandaran yang dapat dilihatnya.

4. Mulakan HolyArrs. Anda akan nampak Pustaka dan tetapan anda kembali.

Sudah memulakan pemasangan baharu sebelum menyalin kunci? Jika tiada apa-apa padanya yang perlu disimpan, hentikan HolyArrs, salin kunci lama anda menimpa kunci baharu dengan docker cp yang sama, pulihkan, kemudian mulakan.

Jika tidak berfungsi

Gejala: “Backups are off in this build”. Punca: salinan ini berjalan tanpa pengurus sandarannya. Penyelesaian: tiada dalam app; tiada kawalan sandaran.

Gejala: muat turun, padam atau pulihkan meminta kata laluan anda. Punca: semua ini memerlukan log masuk dengan kata laluan yang baharu. Penyelesaian: log masuk semula dengan kata laluan anda dan cuba lagi.

Gejala: pemulihan ditolak kerana kunci induk. Punca: kunci dalam folder konfigurasi tidak sepadan dengan sandaran. Penyelesaian: letakkan semula holyarrs.key yang sepadan dan cuba lagi.

Pemulihan juga menolak zip yang terlalu besar atau rosak, mengandungi fail yang tidak dijangka, datang daripada versi pangkalan data yang lebih baharu, atau mengandungi data yang tidak dapat dibaca oleh kunci anda.

Untuk pakar

Apa yang ada dalam sandaran

Setiap sandaran ialah zip dengan pangkalan data utama, pangkalan data Events jika ada, dan backup.json (versi HolyArrs, versi pangkalan data, jenis sandaran, masa dibuat). Media, muat turun, karya seni, log dan kunci induk tidak ada di dalamnya.

Pulihkan sebelum permulaan pertama

docker cp berfungsi untuk volum bernama atau folder hos; HolyArrs menyerahkan fail dalam /config kepada PUID dan PGID anda apabila ia bermula. Dengan HOLYARRS_MASTER_KEY_FILE, letakkan kunci pada laluan hos itu, boleh dibaca oleh PUID dan PGID.

1. Letakkan zip, dengan nama tidak berubah, dalam folder bernama backups dan salin masuk: docker cp backups holyarrs:/config/.
2. Jalankan pemulihan sekali dengan imej yang sama:
   • 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. Jika kunci menggunakan laluan fail, tambah -e HOLYARRS_MASTER_KEY_FILE=<its path> supaya pemulihan menyemak dengan kunci anda.
4. Mulakan HolyArrs.

restore --list menunjukkan nama sandaran yang dapat dilihatnya.

Berkaitan

• Kemas kini
• Pasang
• Semakan kesihatan