ייבוא מפתחות מקובץ

הגדרה

מלא קובץ אחד עם המקורות, המורידים, שרתי המדיה, אתרי הכתוביות והמייל שלך, ייבא אותו, ותחסוך את ההקלדה של כל מפתח ב-Settings.

לפני שמתחילים

HolyArrs רץ ב-Docker עם תיקיית ההגדרות שלו ב-/config.
אתה יכול ליצור מפתח API של בעלים ב-Settings > API > API keys (הגדרות > API > מפתחות API).

לייבא את הקובץ

העתק את holyarrs-secrets.template.yaml ל-holyarrs-secrets.yaml.
מלא את מה שאתה משתמש בו. השאר את השאר ריק; ריק אומר לדלג.
הפוך אותו לקריא רק לך:
Terminal window
```
chmod 600 holyarrs-secrets.yaml
```

עגן אותו לקריאה בלבד בתוך הקונטיינר:

volumes:
  - /srv/holyarrs/config:/config
  - /srv/holyarrs/holyarrs-secrets.yaml:/run/secrets/holyarrs.yaml:ro

צור מפתח API של בעלים עם ה-scope admin ב-Settings > API > API keys. שים אותו בבלוק holyarrs של הקובץ, עם הכתובת http://127.0.0.1:6262.
נסה הרצת ניסיון. היא לא משנה כלום:
Terminal window
```
docker exec holyarrs /holyarrs import-secrets -file /run/secrets/holyarrs.yaml -dry-run
```
אתה אמור לראות שורת would set אחת לכל פריט.
הרץ באמת (אותה פקודה בלי -dry-run). אתה אמור לראות שורות set וקוד יציאה 0.
בדוק את המקורות והמורידים החדשים, ואז בטל את ההשהיה שלהם. בדוק שרתי מדיה והתראות חדשים, ואז הפעל אותם.
מחק את הקובץ במארח (ראה למחוק את הקובץ). מחק גם את מפתח ה-API אם אתה כבר לא צריך אותו.

למה כל בלוק הופך

בקובץ	הופך ל
`trakt.client_id`	מפתח האפליקציה של Trakt (Settings > Outside lists, הגדרות > רשימות חיצוניות).
`tmdb`, `tvdb`	מתקבלים מקבצים ישנים. מטא-דאטה לא צריך מפתחות.
`opensubtitles`, `subdl`	אתר כתוביות עם החשבון שלך.
`addic7ed`	אתר כתוביות של Addic7ed, לסדרות בלבד.
`indexers`	מקור אחד לכל רשומה, מושהה.
`jackett`, `prowlarr`	המפתח שלהם ממלא כל רשומת `indexers` באותה כתובת שאין לה מפתח.
`qbittorrent`, `sabnzbd`	מוריד, מושהה.
`nzbget`, `transmission`, `deluge`	מדולגים. הייבוא עוד לא יכול להגדיר אותם; הוסף אותם ב-Settings > Downloaders (הגדרות > מורידים).
`jellyfin`, `emby`, `plex`	שרת מדיה, כבוי עד שתבדוק אותו.
`smtp`, `discord`, `webhook`	ההתראות “Email”, “Discord” ו-“Webhook”, כבויות עד שתבדוק אותן.
`radarr`, `sonarr`, `lidarr`, `prowlarr`, `bazarr`, `seerr`	מפתח שנשמר בשביל Import from other apps (ייבוא מאפליקציות אחרות).
`holyarrs`	משמש רק כדי להגיע ל-HolyArrs בזמן שהוא רץ. אף פעם לא נשמר.

כל מפתח נכנס לכספת המוצפנת, בדיוק כמו אחד שהקלדת ב-Settings.

אפשרויות

מתג הרשת המקומית

כל בלוק עם כתובת יכול לקבל allow_local_network: true. הוא מאפשר לפריט להגיע למחשב הזה או לרשת הביתית שלך (192.168.x.x, 10.x.x.x, שם של קונטיינר). בלעדיו הפריט מגיע רק לאינטרנט, ולכן מוריד בבית לא יענה. HolyArrs אף פעם לא מנחש את זה מהכתובת. זה אותו מתג כמו May reach the local network (רשאי להגיע לרשת המקומית) ב-Settings.

כש-HolyArrs עצור

הרץ קונטיינר חד-פעמי על אותה תיקיית הגדרות. הוא שומר ישר בתיקיית ההגדרות ולא צריך בלוק holyarrs:

docker stop holyarrs
docker run --rm -e PUID=1000 -e PGID=1000 \
  -v /srv/holyarrs/config:/config \
  -v /srv/holyarrs/holyarrs-secrets.yaml:/run/secrets/holyarrs.yaml:ro \
  holyarrs/holyarrs:latest import-secrets -file /run/secrets/holyarrs.yaml
docker start holyarrs

השתמש באותם PUID ו-PGID של האפליקציה, אחרת תיקיית ההגדרות עוברת ל-1000:1000. המשתמש של PUID חייב להיות מסוגל לקרוא את הקובץ. אם אתה משתמש ב-HOLYARRS_MASTER_KEY_FILE, תן לקונטיינר החד-פעמי את אותו משתנה ואת אותו עיגון.

הרצה חוזרת

הרצה חוזרת בטוחה. פריטים תואמים אומרים unchanged; רק פריטים ששונו נשמרים.

פריט	מותאם לפי
מקורות	שם
מורידים, שרתי מדיה	סוג וכתובת
התראות	שם וסוג
אתרי כתוביות, אפליקציות קודמות	סוג

מקור או מוריד שהכתובת או המפתח שלו השתנו מושהה שוב. אחרי שביטלת בעצמך את ההשהיה של אחד, הרצה חוזרת משאירה אותו פועל. api_key ריק ברשומת indexers שומר את המפתח השמור; הוסף clear_key: true כדי להסיר אותו.

למחוק את הקובץ

עם -delete, הפקודה דורסת את הקובץ באפסים ומסירה אותו, רק אחרי הרצה שבה שום דבר לא נכשל. אי אפשר למחוק עיגון לקריאה בלבד מתוך הקונטיינר, ולכן מחק אותו במארח:

מערכת	פקודה
Linux	`shred -u holyarrs-secrets.yaml`
macOS	`rm -P holyarrs-secrets.yaml`
Windows	`Remove-Item holyarrs-secrets.yaml`, ואז רוקן את סל המיחזור.

ב-SSD ובמערכות קבצים עם copy-on-write, בלוקים ישנים עלולים להישאר בדיסק. המפתחות עצמם נמצאים עכשיו בכספת המוצפנת.

אם זה לא עובד

תסמין	סיבה	פתרון
הקובץ קריא למשתמשים אחרים	ההרשאות פתוחות מדי.	הרץ `chmod 600`. ב-Windows, שמור אותו בתיקייה שרק אתה יכול לפתוח.
מפתח לא מוכר עצר את הייבוא	שגיאת כתיב או טאב בשורה שצוינה.	תקן את השורה. שום דבר לא נשמר.
http רגיל נדחה	הכתובת `holyarrs` היא לא במחשב הזה.	הרץ בתוך הקונטיינר עם `http://127.0.0.1:6262`, או השתמש ב-https.
מוריד בבית לא עונה	אין הרשאה לרשת מקומית.	קבע `allow_local_network: true` בבלוק הזה.
הקונטיינר החד-פעמי שינה בעלים של תיקיות	`PUID`/`PGID` שונים.	השתמש ב-`PUID` וב-`PGID` של האפליקציה.
`-delete` לא עשה כלום	משהו נכשל, או שהעיגון לקריאה בלבד.	מחק אותו במארח.

למומחים

דגלים וקודי יציאה

דגל	מה הוא עושה	ברירת מחדל
`-file <path>`	קובץ הסודות.	אין
`-dry-run`	רק אומר מה היה נקבע.	כבוי
`-config <folder>`	תיקיית ההגדרות.	`/config`
`-delete`	אחרי הרצה בלי כשלים, דורס את הקובץ באפסים ומוחק אותו.	כבוי
`-forget-move-credentials`	מוחק כל מפתח שמור של אפליקציה קודמת, ואז עוצר.	כבוי
`-allow-http-lan`	מתיר `http://` רגיל לכתובת ברשת הביתית. מדפיס אזהרה.	כבוי
`-allow-readable-file`	מקבל קובץ שמשתמשים אחרים יכולים לקרוא. Docker Desktop ב-Windows מציג כל קובץ כקריא.	כבוי

הכתובת holyarrs חייבת להיות https://, או http:// רגיל למחשב הזה בלבד (127.0.0.1, ::1, localhost). ב-http רגיל מפתח הבעלים שלך והקובץ כולו עוברים בלי הצפנה.

קוד יציאה	משמעות
`0`	כל הפריטים עברו בהצלחה.
`1`	פריט נכשל. תקן את הקובץ והרץ שוב.
`2`	שורת פקודה או קובץ לא תקינים.

פלט

שורה אחת לכל פריט: set (או would set בהרצת ניסיון, לפעמים עם הערה), unchanged, skipped (empty), skipped (why) או failed: why. הוא אף פעם לא מדפיס מפתח, סיסמה, token או כתובת. ב-History מופיע אירוע אחד עם ספירות בלבד. שגיאה שהייתה מציגה ערך מהקובץ שלך מציגה [hidden] במקומו.

פורמט הקובץ

חלק קטן וקפדני של YAML:

בלוקים לפי הזחה ברווחים, אף פעם לא בטאבים; רשימות עם - ,
ערכים רגילים, ב-"double quotes" או ב-'single quotes' (בתוך גרשיים בודדים, כתוב ' פעמיים),
# פותח הערה בתחילת שורה או אחרי רווח מחוץ למרכאות, ולכן שים בין מרכאות סיסמה שמכילה #,
שים בין מרכאות ערך שמתחיל ב-&, *, !, |, >, [, {, %, @ או backquote, או שמכיל : .

מפתח לא מוכר או קובץ מעל 256 KB עוצרים את כל הייבוא לפני ששום דבר נשמר; ההודעה מציינת את המפתח ואת השורה. קישור לקובץ נדחה.

שדות מיוחדים

שדה	כלל
SABnzbd	צריך את ה-`api_key` המלא. `nzb_key`, שם משתמש או סיסמה מדולגים ואף פעם לא נשמרים.
`tvdb.api_key`, `tvdb.unique_user_key`, `trakt.redirect_urls`	מתקבלים ומדולגים.
`smtp.host`	שם שרת בלבד, בלי scheme ובלי פורט.
`smtp.port`	1 עד 65535. ברירת מחדל `587`.
`smtp.from`	כתובת אימייל פשוטה אחת.
בלוקים של אפליקציות קודמות	משמשים ב-Import from other apps עם Use the saved key (השתמש במפתח השמור). אף פעם לא מוצגים, לבעלים בלבד, נמחקים אחרי קריאה מוצלחת אחת.

קשור

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