משתני סביבה

מומחה

כל המשתנים שהקונטיינר של HolyArrs קורא. ברוב ההתקנות מגדירים רק את PUID, PGID ו-TZ.

נפוצים

משתנה	מה הוא עושה	ברירת מחדל	דוגמה
`PUID`, `PGID`	המשתמש והקבוצה ש-HolyArrs רץ תחתיהם. הם צריכים להיות הבעלים של `/config` ושל תיקיות המדיה שלך.	`1000`, `1000`	`PUID=1000`
`TZ`	אזור הזמן ללוחות זמנים וללוגים.	`Etc/UTC`	`TZ=Europe/Amsterdam`
`UMASK`	ביטי ההרשאה שקבצים חדשים לא מקבלים. משפיע רק על קבצים חדשים.	`022`	`UMASK=002`
`HOLYARRS_SAVE_PATH`	תיקיית השמירה של המוריד, כפי שהמוריד רואה אותה. נשלחת עם כל הורדה.	אין	`/data/downloads`
`HOLYARRS_URL_BASE`	מגיש את HolyArrs תחת נתיב, מאחורי reverse proxy. הערך `/` מתעלם מנתיב ששמור בהגדרות.	אין	`/holyarrs`
`HOLYARRS_ALLOWED_HOSTS`	שמות מארח נוספים שבהם אנשים נכנסים ל-HolyArrs, מופרדים בפסיקים.	כתובות IP ו-`localhost`	`holyarrs.example.com`
`HOLYARRS_TRUSTED_PROXIES`	הכתובת או הרשת של ה-reverse proxy שלך, מופרדות בפסיקים. נדרש כדי לקבל כתובות אמיתיות של לקוחות.	אין	`172.18.0.0/16`
`HOLYARRS_MASTER_KEY_FILE`	קורא את המפתח הראשי של הכספת מקובץ משלו. המשתמש של `PUID` חייב להיות מסוגל לקרוא אותו.	`/config/holyarrs.key`	`/keys/holyarrs.key`

ערכים מקבצים

הוסף FILE__ לפני כל משתנה כדי לקרוא את הערך שלו מקובץ, למשל Docker secret.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

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

שחזור ופתרון בעיות

משתנה	מה הוא עושה	ברירת מחדל	דוגמה
`HOLYARRS_SAFE_MODE`	מפעיל רק את הליבה: התחברות, ספרייה, הגדרות, גיבויים ובדיקת תקינות. הסר אותו אחרי התיקון.	כבוי	`1`
`HOLYARRS_LOW_MEMORY`	`1` מכריח מצב זיכרון נמוך להיות פעיל, `0` מכריח אותו להיות כבוי. אם לא הוגדר, הוא נדלק במחשב עם כ-2.5 GiB RAM או פחות.	לפי גודל המחשב	`1`
`HOLYARRS_FOLLOW_LINKS`	`1` מאפשר לסריקת הספרייה ולייבוא להשתמש בקבצי וידאו ומוזיקה שהם symlinks (ספריות שבנויות מקישורים לדיסק מעוגן). הורדה מקושרת מוצבת בספרייה כקישור.	כבוי	`1`
`GOMEMLIMIT`	עוקף את יעד הזיכרון ש-HolyArrs קובע לעצמו.	נקבע על ידי HolyArrs	`1GiB`
`HOLYARRS_SKIP_SPACE_CHECK`	מדלג על בדיקת המקום הפנוי לפני עדכון של מסד הנתונים.	כבוי	`yes`
`HOLYARRS_CONFIG_IN_MEMORY`	מאפשר ל-`/config` לשבת בתיקייה שנתמכת בזיכרון. למחשבי בדיקה; הנתונים אובדים בהפעלה מחדש.	כבוי	`yes`
`HOLYARRS_ALLOW_DESKTOP_FOLDER`	מתחיל כש-`/config` נמצא בתיקייה משותפת של Docker Desktop ב-Mac, אחרי שבדקת שנעילת קבצים עובדת שם. HolyArrs מזהיר בכל הפעלה.	כבוי	`1`
`HOLYARRS_READONLY_DOWNLOADERS`	מורידים ש-HolyArrs אסור לו לשנות לעולם, לפי מזהה או כתובת, מופרדים בפסיקים.	אין	`3,http://qbit:8080`
`HOLYARRS_HEALTH_URL`	הכתובת שבדיקת התקינות של הקונטיינר קוראת אליה.	`http://127.0.0.1:6262`	`http://127.0.0.1:6262/holyarrs`

משתני הדלקה וכיבוי מקבלים 1, true, yes או on.

כניסה יחידה

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

משתנה	מה הוא עושה	ברירת מחדל
`HOLYARRS_OIDC_ENABLED`	מפעיל כניסה יחידה.	`false`
`HOLYARRS_OIDC_ISSUER`	ה-issuer המדויק של הספק, ב-HTTPS.	אין
`HOLYARRS_OIDC_CLIENT_ID`	מזהה הלקוח הרשום.	אין
`HOLYARRS_OIDC_CLIENT_SECRET_FILE`	קובץ שמכיל את הסוד של הלקוח, עד 4096 בייטים. השמט אותו עבור לקוח ציבורי.	אין
`HOLYARRS_OIDC_REDIRECT_URL`	כתובת החזרה המדויקת: הכתובת שלך, ה-URL base אם יש, ואז `/api/v1/auth/oidc/callback`.	אין
`HOLYARRS_OIDC_ALLOW_JOIN`	אנשים חדשים מצטרפים כחברים שיכולים רק לבקש.	`false`
`HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK`	מאפשר ספק ברשת הפרטית שלך.	`false`
`HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP`	מאפשר HTTP רגיל במחשב הזה, לבדיקות.	`false`
`HOLYARRS_FORWARD_AUTH_ENABLED`	מפעיל התחברות דרך proxy מהימן.	`false`
`HOLYARRS_FORWARD_AUTH_ISSUER`	שם HTTPS יציב ל-proxy.	אין
`HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS`	כתובות או טווחים של proxy שמותר להם לשלוח כותרות זהות, מופרדים בפסיקים.	אין
`HOLYARRS_FORWARD_AUTH_ALLOW_JOIN`	שמות חדשים מה-proxy מצטרפים כחברים שיכולים רק לבקש.	`false`

הגדרה שגויה עוצרת את HolyArrs מלהתחיל. השלבים נמצאים ב-התחברות וסיסמאות.

למומחים

מטא-דאטה

משתנה	מה הוא עושה	ברירת מחדל
`HOLYARRS_METADATA_URL`	הכתובת של שרת המטא-דאטה.	`https://api.holyarrs.com`
`HOLYARRS_TMDB_KEY`	token הקריאה של TMDB שלך. כשהוא מוגדר, קריאות TMDB הולכות ישר ל-TMDB ולא לשרת המטא-דאטה.	אין
`HOLYARRS_METADATA_SERVICE_TOKEN_FILE`	קובץ שמכיל את האישור של ההתקנה הזו מול שרת המטא-דאטה, נקרא בכל קריאה. אם לא הוגדר, האישור נשמר בכספת.	אין

מה שעדיין עובר דרך שרת המטא-דאטה עם מפתח ה-TMDB שלך, וכל כתובת חיצונית אחרת, נמצא בכתובות חיצוניות.

קיצורי דרך להפעלה ראשונה

כל אחד מוסיף פריט אחד בהפעלה. משמשים להדגמות ולבדיקות; אשף ההפעלה הראשונה עושה אותו דבר.

משתנה	מוסיף
`HOLYARRS_MOVIES`	תיקיית ספרייה לסרטים.
`HOLYARRS_QBITTORRENT_URL`	מוריד qBittorrent.
`HOLYARRS_SOURCE_URL`	מקור Torznab בלי מפתח.

משתני מפתחים ובדיקות

אלה מפנים את HolyArrs לתחליפים לצורכי בדיקות. השאר אותם לא מוגדרים בהתקנה אמיתית.

משתנה	מה הוא עושה
`HOLYARRS_FLAGS`	מתגים מופרדים בפסיקים ליכולות שכבויות כברירת מחדל בגרסה הזו. ראה עדכונים.
`HOLYARRS_DIRECT_SOURCES`	`1` מאפשר להתקנה הזו לפנות בעצמה למקורות מוזיקה וטלוויזיה במקום לשרת המטא-דאטה.
`HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL`	מאפשר שרת מטא-דאטה ברשת המקומית.
`HOLYARRS_METADATA_COUNT`	סופר ורושם בלוג את הבקשות למטא-דאטה.
`HOLYARRS_TMDB_TOKEN_FILE`, `HOLYARRS_TMDB_URL`	קובץ token של TMDB לבדיקות וכתובת של תחליף.
`HOLYARRS_TVMAZE_URL`, `HOLYARRS_MUSICBRAINZ_URL`, `HOLYARRS_DEEZER_URL`, `HOLYARRS_TRAKT_URL`, `HOLYARRS_PLEX_URL`, `HOLYARRS_PLEX_APP_URL`, `HOLYARRS_PLEX_DISCOVER_URL`, `HOLYARRS_PUSHOVER_URL`, `HOLYARRS_TELEGRAM_URL`, `HOLYARRS_YOUTUBE_URL`, `HOLYARRS_RELEASE_FEED`	כתובות של תחליפים לשירותים חיצוניים.
`HOLYARRS_TRAILER_PASS_FIRST`, `HOLYARRS_TRAILER_PASS_EVERY`	תזמון סבב הטריילרים כמשכי זמן, כמו `2s`.

קשור

HolyArrs חינמי. אם זה חסך לך זמן, תן לו כוכב ב-GitHub, תמוך בפרויקט או קנה לי קפה.