ส่วนต่าง ๆ และเซฟโหมด

ปิดส่วนที่ไม่ได้ใช้ เริ่มในเซฟโหมดเมื่อมีอะไรพัง และรีสตาร์ต HolyArrs จากเบราว์เซอร์

เปิดหรือปิดส่วนต่าง ๆ

HolyArrs มี 5 ส่วน: Movies (ภาพยนตร์), TV shows (ซีรีส์), Music (เพลง), Subtitles (คำบรรยาย) และ Requests (คำขอ) คุณเลือกครั้งแรกในวิซาร์ดการเปิดใช้ครั้งแรก

1. เปิด Settings > Parts (การตั้งค่า > ส่วน)
2. กด Turn on (เปิด) หรือ Turn off (ปิด) ข้างส่วนนั้น จะเห็นรายการเมนูของส่วนนั้นปรากฏหรือหายไป

ไม่มีอะไรถูกลบ เปิดส่วนนั้นอีกครั้งแล้วจะทำต่อจากที่ค้างไว้

เริ่มในเซฟโหมด

เซฟโหมดเริ่มเฉพาะส่วนพื้นฐาน ใช้เมื่อมีบางอย่างทำให้ HolyArrs เริ่มหรือทำงานไม่ได้ คุณล็อกอิน ดูคลัง เปลี่ยนการตั้งค่า และสร้างหรือกู้คืน Backup ได้ การค้นหา การเพิ่ม การรีเฟรช การดาวน์โหลด และการนำเข้าจะรอจนกว่าจะเริ่มแบบปกติครั้งถัดไป

1. เปิด Settings > Danger zone (การตั้งค่า > โซนอันตราย)
2. กด Restart in safe mode (รีสตาร์ตในเซฟโหมด) จะเห็นแบนเนอร์ในทุกหน้า
3. แก้ปัญหา แล้วกด Restart HolyArrs (รีสตาร์ต HolyArrs) การเริ่มครั้งถัดไปจะเป็นแบบปกติ

ถ้าเข้าหน้านั้นไม่ได้ ให้ตั้ง HOLYARRS_SAFE_MODE=1 ใน Compose หรือเริ่มด้วย -safe-mode เอาออกหลังแก้เสร็จ เพราะทั้งสองแบบจะทำให้ทุกครั้งที่เริ่มเป็นเซฟโหมด

ตัวเลือก

อะไรหยุดเมื่อปิดส่วนหนึ่ง

ส่วน	หยุด	ทำต่อ
Movies	หน้าและรายการเมนูของภาพยนตร์ การเพิ่ม การค้นหา การรีเฟรช	งานดาวน์โหลดที่อยู่ในตัวดาวน์โหลดแล้วยังถูกติดตามอยู่ ไฟล์ยังอยู่
TV shows	หน้าของซีรีส์ การเพิ่ม การค้นหา การค้นหาระดับซีซัน การรีเฟรช	เหมือน Movies
Music	หน้าของศิลปินและอัลบั้ม การตั้งค่าเพลง การรีเฟรชศิลปิน การค้นหาอัลบั้ม	เหมือน Movies
Subtitles	การตั้งค่าคำบรรยาย หน้าคำบรรยายที่ขาด การค้นหาและการตรวจ	ไฟล์คำบรรยายที่อยู่ข้างวิดีโอของคุณยังอยู่
Requests	หน้าคำขอและการขอรายการ	คำขอที่มีอยู่ยังอยู่และกลับมาเมื่อเปิดอีกครั้ง

เปิดอยู่เสมอ: การล็อกอินและบัญชี โฟลเดอร์คลัง แหล่งค้นหา ตัวดาวน์โหลดและงานดาวน์โหลด การแจ้งเตือน ประวัติ Backup การตรวจสุขภาพ การตั้งค่า และ API

• Subtitles ต้องมี Movies หรือ TV shows Requests ต้องมี Movies, TV shows หรือ Music HolyArrs จะปฏิเสธการเปลี่ยนที่ทำให้ขัดกัน และบอกว่าต้องเปลี่ยนอะไรก่อน
• งานที่อยู่ในคิวของส่วนที่ปิดอยู่จะรอ และรันเมื่อเปิดส่วนนั้น
• การปิดส่วนไม่ได้ช่วยประหยัดหน่วยความจำ ทุกอย่างรันอยู่ในโปรแกรมเดียว

รีสตาร์ต หยุดชั่วคราว และปิดเครื่อง

Settings > Danger zone (เจ้าของและแอดมิน) มี Restart HolyArrs, Restart in safe mode และ Shut down (ปิด HolyArrs) รวมถึง Pause (หยุดชั่วคราว), Resume (ทำต่อ) และ Restart (รีสตาร์ต) ของแต่ละงานเบื้องหลัง เช่น Backup หรือการซิงก์งานดาวน์โหลด

• ปุ่มควบคุมที่ทำให้บางอย่างหยุดจะขอให้ยืนยันภายใน 60 วินาที
• ทุกปุ่มที่ใช้จะถูกบันทึกลงประวัติพร้อมชื่อของคุณ
• ต้องล็อกอินด้วยรหัสผ่าน การล็อกอินแบบไม่ใช้รหัสผ่านในเครือข่ายภายในจะถูกปฏิเสธ

การรีสตาร์ตจะหยุด HolyArrs อย่างเรียบร้อยแล้วให้ Docker เริ่มให้ใหม่ จึงควรตั้ง restart: unless-stopped

นโยบายรีสตาร์ต	รีสตาร์ต	ปิดการทำงาน
unless-stopped หรือ always	กลับมา	กลับมาด้วย
on-failure	กลับมา	ดับอยู่
no	ดับอยู่	ดับอยู่

ถ้าไม่ทำงาน

อาการ	สาเหตุ	วิธีแก้
HolyArrs ปิดส่วนหนึ่งไม่ได้	ส่วนอื่นต้องใช้มัน	ปิดส่วนนั้นก่อน ตามที่ข้อความบอก
รีสตาร์ตแล้ว HolyArrs ดับถาวร	นโยบายรีสตาร์ตเป็น no	เริ่ม container และตั้ง restart: unless-stopped
ปุ่มควบคุมถูกปฏิเสธ	ล็อกอินในเครือข่ายภายในโดยไม่ใช้รหัสผ่าน หรือคีย์ไม่มี control	ล็อกอินด้วยรหัสผ่าน
งานหนึ่งค้างสถานะล้มเหลว	ต้องให้คุณจัดการ	อ่านเหตุผลที่ /health แก้ไข แล้วกด Restart ของงานนั้น

วิธีแก้เพิ่มเติม: การแก้ปัญหา

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

สถานะสุขภาพระบบ

/health, Settings > Parts และ GET /api/v1/health/states แสดงงานเบื้องหลัง ส่วน และแอปที่เชื่อมต่อแต่ละรายการ พร้อมสถานะและเหตุผล

สถานะ	ความหมาย
off	ปิดอยู่ หยุดชั่วคราว หรือไม่ได้เริ่มในเซฟโหมด
starting	กำลังเริ่ม หรือยังไม่ได้ตรวจ
running	ทำงานปกติ
retrying	ล้มเหลว HolyArrs ลองใหม่ โดยรอนานขึ้นทุกครั้ง
failed	ล่ม ค้าง หรือต้องให้คุณจัดการ เหตุผลบอกว่าต้องทำอะไร

งานที่ล่มจะขึ้น failed แล้ว retrying แล้วเริ่มใหม่ ระหว่างนั้นการล็อกอิน คลัง และ Backup ยังใช้งานได้ งานที่ค้างจะหายเมื่อรีสตาร์ตทั้งระบบ

หน่วยความจำและโหมดประหยัดหน่วยความจำ

HolyArrs ตั้งเป้าใช้ไม่เกิน 384 MiB ซึ่งอยู่ในขีดจำกัด container 500 MB ถ้าจะตั้งเป้าเอง ให้ตั้ง GOMEMLIMIT ที่ประมาณ 80 เปอร์เซ็นต์ของหน่วยความจำของ container

โหมดประหยัดหน่วยความจำเก็บข้อมูลในหน่วยความจำน้อยลงและอ่านจากฐานข้อมูลมากขึ้น บางหน้าจะช้าลงเล็กน้อย และงานเบื้องหลัง เช่น การคัดลอกแคตตาล็อกเพลง จะทำงานไม่บ่อยเท่าเดิม

ค่าที่ตั้ง	ผล
(ค่าเริ่มต้น, Linux)	เปิดเองเมื่อหน่วยความจำประมาณ 2.5 GiB หรือน้อยกว่า
HOLYARRS_LOW_MEMORY=1	เปิดเสมอ
HOLYARRS_LOW_MEMORY=0	ปิดเสมอ

บรรทัดแรกของ log บอกว่าเปิดอยู่หรือไม่ และเพราะอะไร

ขอบเขตของ API key

สร้างคีย์ใน Settings > API > API keys แล้วส่งใน header X-Api-Key

ขอบเขต	เข้าถึง
read	คลัง งานเบื้องหลัง งานดาวน์โหลด ประวัติ สุขภาพระบบ การตั้งค่า ความลับถูกปิดบัง
health_read	เฉพาะสถานะสุขภาพระบบ สำหรับเครื่องมือเฝ้าระวัง
write	ทุกการเปลี่ยนแปลง ยกเว้นเส้นทางแอดมินและปุ่มควบคุม
admin	ผู้คน คำเชิญ โควตาคำขอ API key รหัสผ่านและการยืนยันสองขั้นตอน การตั้งค่าการล็อกอิน Backup
control	ปุ่มควบคุมในหน้านี้ เฉพาะเจ้าของและแอดมินที่ให้สิทธิ์นี้ได้
all	read, write และ admin ไม่รวม control

คีย์ไม่เคยทำได้มากกว่าผู้ที่สร้างมัน เปลี่ยนขอบเขตภายหลังไม่ได้ ให้สร้างคีย์ใหม่ ดูทุกเส้นทางและขอบเขตได้ที่ /api/v1/openapi.json

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

• การตรวจสุขภาพ
• Backup
• เส้นทาง API