Backup

เก็บสำเนาของระบบที่ตั้งค่าไว้ เพื่อนำกลับมาวางหลังอัปเดตพัง ดิสก์เสีย หรือย้ายไปเครื่องใหม่

ก่อนเริ่ม

• Settings > Backups (การตั้งค่า > Backup) ต้องมีสิทธิ์ Change settings (เปลี่ยนการตั้งค่า) และมีเฉพาะเจ้าของเท่านั้นที่กู้คืนได้
• การดาวน์โหลด การลบ และการกู้คืนต้องล็อกอินด้วยรหัสผ่านภายในไม่กี่นาทีที่ผ่านมา

สร้าง Backup

1. เปิด Settings > Backups
2. กด Back up now (สำรองข้อมูลทันที) จะเห็น Backup ใหม่อยู่ใต้ Saved backups (Backup ที่บันทึกไว้)
3. กด Download (ดาวน์โหลด) ที่ข้างรายการนั้น เพื่อเก็บสำเนาไว้นอกเซิร์ฟเวอร์

เก็บคีย์หลัก

Backup ไม่มีคีย์หลักอยู่ข้างใน คีย์หลักใช้เปิดรหัสผ่านและ API key ในการตั้งค่าของคุณ ถ้าไม่มีคีย์ที่ตรงกัน Backup ที่กู้คืนแล้วจะอ่านค่าเหล่านั้นไม่ได้

1. ใต้ Master key (คีย์หลัก) เจ้าของกด Download key kit (ดาวน์โหลดชุดคีย์)
2. เก็บไฟล์ไว้ห่างจากเซิร์ฟเวอร์ และแยกจาก Backup คำเตือนชุดคีย์จะหายไปจาก Settings > Backups และจากการตรวจสุขภาพ

ถ้าจะใช้ในภายหลัง ให้เปลี่ยนชื่อเป็น holyarrs.key แล้ววางไว้ในโฟลเดอร์คอนฟิก ถ้าคุณไม่ใช่เจ้าของ ให้ขอให้เจ้าของดาวน์โหลดให้

กู้คืน Backup

อันตราย

การเปลี่ยนแปลงที่ทำหลังจาก Backup นั้นจะหายไป เตรียมคีย์หลักที่ตรงกันไว้ก่อน

1. กด Restore from a file (กู้คืนจากไฟล์) แล้วเลือกไฟล์ zip ของ Backup จาก HolyArrs
2. ยืนยัน
3. HolyArrs ตรวจไฟล์ จะเห็นข้อความ Restore ready. It applies on the next start. (พร้อมกู้คืนแล้ว จะมีผลเมื่อเริ่มครั้งถัดไป)
4. HolyArrs รีสตาร์ตและนำ Backup มาวางให้ ถ้าใช้นโยบายรีสตาร์ตของ Docker ที่แนะนำ ขั้นตอนนี้จะเกิดขึ้นเอง

ฐานข้อมูลปัจจุบันของคุณจะย้ายไปที่ /config/backups/before-restore-<time> จึงยกเลิกการกู้คืนได้

ตัวเลือก

ความถี่

ตัวเลือก	สำรองข้อมูล	เก็บไว้
Balanced (สมดุล, ค่าเริ่มต้น)	ทุกวัน	7 วันล่าสุด และสำเนารายสัปดาห์ 4 ชุด
Light (เบา)	สัปดาห์ละครั้ง	4 สัปดาห์ ใช้พื้นที่น้อยที่สุด
Careful (รอบคอบ)	ทุกวัน	ทุกสำเนาเป็นเวลา 30 วัน

Backup ตามตารางเวลาล่าสุดจะถูกเก็บไว้เสมอ กฎเหล่านี้ล้างเฉพาะ Backup ตามตารางเวลา Backup ที่คุณสร้างเองจะอยู่จนกว่าคุณจะลบ (ปุ่มถังขยะที่แถวนั้น ลบแล้วกู้คืนไม่ได้) HolyArrs ยังสำรองข้อมูลก่อนการอัปเดตที่เปลี่ยนข้อมูลที่เก็บไว้ และเก็บ 3 ชุดล่าสุด ดู การอัปเดต

ย้ายไปเครื่องใหม่

การติดตั้งใหม่จะสร้างคีย์หลักของตัวเองตอนเริ่มครั้งแรก คีย์นั้นเปิด Backup เก่าของคุณไม่ได้ การกู้คืนจึงถูกปฏิเสธ ให้วางคีย์เก่าไว้ก่อน ตัวอย่างเรียก container ว่า holyarrs ให้ใช้ชื่อของคุณเอง

1. ก่อนเริ่มครั้งแรก สร้าง container โดยยังไม่เริ่ม: docker compose create หรือใช้บรรทัด docker run ของคุณโดยเปลี่ยน docker run -d เป็น docker create
2. คัดลอกคีย์เก่าเข้าไป: docker cp holyarrs.key holyarrs:/config/ ชุดคีย์ที่เปลี่ยนชื่อเป็น holyarrs.key ก็ใช้ได้ วิธีนี้ใช้ได้กับ named volume หรือโฟลเดอร์บนโฮสต์ HolyArrs จะส่งไฟล์ใน /config ให้ PUID และ PGID ของคุณตอนเริ่มทำงาน ถ้าใช้ HOLYARRS_MASTER_KEY_FILE ให้วางคีย์ไว้ที่พาธนั้นบนโฮสต์แทน และต้องให้ PUID และ PGID ของคุณอ่านได้
3. กู้คืน Backup เลือกวิธีใดวิธีหนึ่ง:

   • เริ่ม HolyArrs ทำ การเปิดใช้ครั้งแรก ให้เสร็จ แล้วใช้ Restore from a file ใน Settings > Backups

   • หรือกู้คืนก่อนเริ่มครั้งแรก วางไฟล์ zip โดยไม่เปลี่ยนชื่อไว้ในโฟลเดอร์ชื่อ backups แล้วคัดลอกเข้าไปด้วย docker cp backups holyarrs:/config/ จากนั้นรันการกู้คืนหนึ่งครั้งด้วย 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>

     ถ้าใช้พาธของไฟล์คีย์ ให้เพิ่ม -e HOLYARRS_MASTER_KEY_FILE=<its path> เพื่อให้การกู้คืนตรวจกับคีย์ของคุณ restore --list แสดงชื่อ Backup ที่มองเห็น

4. เริ่ม HolyArrs จะเห็นคลังและการตั้งค่ากลับมา

เริ่มการติดตั้งใหม่ไปแล้วก่อนคัดลอกคีย์? ถ้าในนั้นไม่มีอะไรต้องเก็บ ให้หยุด HolyArrs คัดลอกคีย์เก่าทับคีย์ใหม่ด้วย docker cp แบบเดิม กู้คืน แล้วค่อยเริ่ม

ถ้าไม่ทำงาน

อาการ: “Backups are off in this build” สาเหตุ: สำเนานี้รันโดยไม่มีตัวจัดการ Backup วิธีแก้: ไม่มีวิธีแก้ในแอป ไม่มีปุ่มควบคุม Backup

อาการ: การดาวน์โหลด ลบ หรือกู้คืนถามรหัสผ่าน สาเหตุ: ต้องล็อกอินด้วยรหัสผ่านเมื่อไม่นานมานี้ วิธีแก้: ล็อกอินด้วยรหัสผ่านอีกครั้งแล้วลองใหม่

อาการ: การกู้คืนถูกปฏิเสธเพราะคีย์หลัก สาเหตุ: คีย์ในโฟลเดอร์คอนฟิกไม่ตรงกับ Backup วิธีแก้: วาง holyarrs.key ที่ตรงกันกลับมา แล้วลองใหม่

การกู้คืนยังปฏิเสธไฟล์ zip ที่ใหญ่เกินไปหรือเสียหาย มีไฟล์ที่ไม่คาดคิด มาจากฐานข้อมูลเวอร์ชันใหม่กว่า หรือมีข้อมูลที่คีย์ของคุณอ่านไม่ได้

สำหรับผู้เชี่ยวชาญ

สิ่งที่อยู่ใน Backup

Backup แต่ละชุดเป็นไฟล์ zip ที่มีฐานข้อมูลหลัก ฐานข้อมูล Events ถ้ามี และ backup.json (เวอร์ชัน HolyArrs เวอร์ชันฐานข้อมูล ชนิดของ Backup เวลาที่สร้าง) สื่อ งานดาวน์โหลด ภาพประกอบ log และคีย์หลักไม่อยู่ในนั้น

กู้คืนก่อนเริ่มครั้งแรก

docker cp ใช้ได้กับ named volume หรือโฟลเดอร์บนโฮสต์ HolyArrs จะส่งไฟล์ใน /config ให้ PUID และ PGID ของคุณตอนเริ่มทำงาน ถ้าใช้ HOLYARRS_MASTER_KEY_FILE ให้วางคีย์ไว้ที่พาธบนโฮสต์นั้นแทน และให้ PUID และ PGID อ่านได้

1. วางไฟล์ zip โดยไม่เปลี่ยนชื่อไว้ในโฟลเดอร์ชื่อ backups แล้วคัดลอกเข้าไป: docker cp backups holyarrs:/config/
2. รันการกู้คืนหนึ่งครั้งด้วย 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. ถ้าใช้พาธของไฟล์คีย์ ให้เพิ่ม -e HOLYARRS_MASTER_KEY_FILE=<its path> เพื่อให้การกู้คืนตรวจกับคีย์ของคุณ
4. เริ่ม HolyArrs

restore --list แสดงชื่อ Backup ที่มองเห็น

หน้าที่เกี่ยวข้อง

• การอัปเดต
• การติดตั้ง
• การตรวจสุขภาพ