פתרון בעיות

מצא את התסמין שלך, קרא את הסיבה ועקוב אחרי הפתרון. הדוגמאות משתמשות בשם הקונטיינר holyarrs; השתמש בשם שלך אם הוא שונה.

3 הבדיקות הראשונות

1. עקוב אחרי הלוג (log): docker logs -f holyarrs. סודות מוסתרים. לחץ Ctrl+C כדי להפסיק לעקוב; הקונטיינר ממשיך לרוץ.
2. הרץ את ה-doctor: docker exec holyarrs /holyarrs doctor. כל שורה אומרת OK, WARN או FAIL, וכל WARN או FAIL אומרת איך לתקן.
3. עדיין תקוע? הורד חבילת תמיכה ושאל. ראה קבלת תמיכה.

אי אפשר להגיע לדף ה-web

תסמין: הדפדפן לא מצליח להתחבר ל-http://your-server:6262.

סיבה: הקונטיינר עצור, הפורט לא ממופה, או שיש proxy בדרך.

פתרון:

1. הרץ docker ps. אתה אמור לראות את holyarrs עם 0.0.0.0:6262->6262.
2. אם הוא ממשיך לעלות מחדש, קרא את docker logs holyarrs כדי למצוא את הסיבה.
3. אם אתה משתמש בנתיב כמו /holyarrs, ראה Reverse proxy ו-URL base.

ההרשאה נדחתה

תסמין: ה-doctor אומר שאי אפשר לכתוב בתיקייה, או שייבוא נכשל בגלל שגיאת הרשאה.

סיבה: הבעלים של התיקייה במארח לא תואם ל-PUID ול-PGID.

פתרון: הרץ את ה-chown שה-doctor מציע, או הגדר את PUID ו-PGID לבעלים של התיקייה. ב-NAS, תן למשתמש הזה הרשאת קריאה וכתיבה במסך ההרשאות. ראה NAS, Synology ו-Unraid.

שום דבר לא יורד

תסמין: כותרים נשארים חסרים ושום דבר לא מגיע למוריד שלך.

סיבה: אף מקור לא עונה, המוריד לא מחובר, או שאף גרסת הפצה לא עוברת את כללי הבחירה שלך.

פתרון:

1. פתח Settings > Downloaders (הגדרות > מורידים) ולחץ על Test (בדיקה) במוריד שלך. הבדיקה אמורה לעבור.
2. פתח Settings > Sources (הגדרות > מקורות) ולחץ על Test בכל מקור.
3. בכותר, פתח Choose a release (בחירת גרסת הפצה) כדי לראות כל תוצאה ואת הסיבות שהיא לא נבחרה.

ראה מורידים ומקורות.

ירד אבל לא יובא

תסמין: ההורדה הסתיימה במוריד שלך, אבל הכותר לא בספרייה.

סיבה: HolyArrs לא רואה את הקובץ באותו נתיב, לא יכול לכתוב בתיקיית הספרייה, או שהייבוא דורש החלטה.

פתרון:

1. תן ל-HolyArrs ולמוריד אותה תיקיית הורדות באותו נתיב, כמו /downloads, או הגדר Downloader’s path (הנתיב של המוריד) ו-HolyArrs’ path (הנתיב של HolyArrs) במוריד.
2. הרץ את ה-doctor ותקן כל FAIL בתיקיות ההורדה או הספרייה.
3. בדוק ברשימת ההורדות אם יש פריטים מסומנים Needs a decision (דורש החלטה), ואשר או בטל את התוכנית.

ייבואים הם עותקים, לא hardlinks

תסמין: ה-doctor אומר ש-hardlinks (קישורים קשיחים) לא עובדים, או ששימוש הדיסק מוכפל אחרי ייבואים.

סיבה: תיקיות ההורדות והספרייה נמצאות על דיסקים או mounts שונים, או שהדיסק לא יכול ליצור hardlink (DrivePool, הרבה NAS ושיתופי SMB, Docker Desktop ב-Windows). כל קובץ עדיין נכתב פעם אחת. הורדות Usenet שהסתיימו מועברות כשהן על אותו דיסק עם הספרייה.

פתרון: עגן (mount) תיקיית אב משותפת אחת לקונטיינר במקום תיקיות נפרדות. ראה תיקיות.

HolyArrs לא עולה

תסמין: הקונטיינר נעצר או עולה מחדש מיד.

סיבה: הלוג נותן אותה. הנפוצות: /config על שיתוף רשת או נתיב FUSE, או חלק שבור.

פתרון:

1. העבר את /config לדיסק מקומי אם הלוג אומר כך. HolyArrs לא מריץ את מסד הנתונים שלו על שיתוף.
2. אחרת, הפעל במצב בטוח, תקן מתוך Settings, והפעל מחדש כרגיל.

חסרה יכולת

תסמין: יכולת שקראת עליה לא נמצאת באפליקציה.

סיבה: ייתכן שהיא שמורה בגרסה הזו.

פתרון: ראה יכולות שמורות.

בדפים אין שמות או תמונות

תסמין: כותרים מופיעים בלי פוסטרים או פרטים.

סיבה: אי אפשר להגיע לשרת המטא-דאטה.

פתרון: בדוק את ה-DNS והחומת האש. החלק Network ב-doctor מראה אם השרת עונה.

למומחים

בדיקות ה-doctor ואפשרויות

ה-doctor רץ בתוך הקונטיינר באותו משתמש ש-HolyArrs רץ בשמו, ולכן הוא נתקל במה ש-HolyArrs נתקל בו.

חלק	מה הוא מראה
App	גרסה, משתמש וקבוצה, umask, והאם הוא רץ בקונטיינר.
Config folder	בעלים, הרשאות, מקום פנוי, והאם הוא על דיסק מקומי.
Library and download folders	קיימת, בעלים, ניתנת לכתיבה, מקום פנוי, hardlinks בין תיקיות ההורדה והספרייה.
Network	האם השם של שרת המטא-דאטה מתורגם לכתובת והשרת עונה.
Clock	שעה, אזור זמן (TZ), ואזהרה כשהשעון שגוי בבירור.

אפשרות	מה היא עושה
-config <folder>	בודק תיקיית הגדרות אחרת של HolyArrs במקום /config.
-json	מדפיס את הדוח כ-JSON.

קוד יציאה 0 אומר שדבר לא נכשל; 1 אומר ששורה אחת אומרת FAIL. הדוח אף פעם לא מציג מפתחות, סיסמאות או tokens. הוא רק קורא, חוץ מקובץ בדיקה קטן שהוא כותב ומוחק. כשמפעילים אותו כ-root, הוא גם מעביר את תיקיית ההגדרות ל-PUID:PGID, כמו בהפעלה רגילה.

אם HolyArrs ממשיך לעלות מחדש, docker exec נכשל. הרץ את ה-doctor בקונטיינר חדש עם אותן תיקיות:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

עם Compose: docker compose run --rm holyarrs doctor.

בדיקת תיקיות בהפעלה

בהפעלה, HolyArrs בודק את התיקיות שלו ורושם בלוג שורת סיכום אחת, כמו folders: 4 ok, 1 not writable, ואז שורה אחת לכל תיקייה בעייתית עם פתרון. הבדיקה נעצרת אחרי 3 שניות, כדי שההפעלה לא תיתקע אף פעם. תיקייה שעונה לאט מדי נחשבת כלא נבדקה; לרוב זה דיסק שמתעורר ממצב שינה או שיתוף רשת איטי. ה-doctor בודק אותה בלי הגבלת זמן. ראה לוגים.

אין shell באימג'

האימג’ מכיל רק את התוכנית של HolyArrs, כך שהוא נשאר קטן ומשאיר פחות לתוקף. docker exec holyarrs sh נכשל בכוונה. כדי להסתכל מקרוב, הפעל עוזר זמני לידו:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

הוא רואה את התהליך של HolyArrs, חולק איתו את הרשת ויש לו את אותן תיקיות באותם נתיבים. הוא רץ כ-root, אז אפשר להסתכל אבל לא לשנות: קובץ שנכתב כ-root עשוי להיות בלתי קריא ל-HolyArrs. כדי לבדוק כמשתמש של HolyArrs, הוסף --user <PUID>:<PGID>.

איך למצוא את הגרסה

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

החלק App ב-doctor מראה את אותו דבר.

קשור

• קבלת תמיכה
• לוגים
• בדיקות תקינות