מהם PUID ו-PGID ב-Docker Compose ואיך להגדיר אותם
PUID ו-PGID אינם הגדרות של Docker אלא מוסכמה בתמונות של linuxserver.io. גלו מדוע קבצים ב-bind mount מופיעים כ-911:911 ואיך להגדיר הרשאות נכונות למשתמש שלכם.
מהם למעשה PUID ו־PGID
PUID ו־PGID הם שני משתני סביבה שדימויי מכולות (container images) מסוימים קוראים בעת העלייה. Docker עצמו אינו בוחן אותם כלל. מדובר במוסכמה המשמשת את הדימויים של linuxserver.io ועוד קומץ אחרים; לכן, דימוי שלא נכתב במטרה לקרוא אותם יתעלם מהם בשקט.
בתוך דימוי של linuxserver.io קיים משתמש בשם abc, שנוצר בזמן ה־build עם UID (מזהה משתמש) 911 ו־GID (מזהה קבוצה) 911. המכולה עולה כ־root, מריצה את סקריפטי ה־init שלה, ואחד מאותם סקריפטים משנה את המספר של אותו משתמש לפני שהיישום מתחיל:
groupmod -o -g "${PGID}" abc
usermod -o -u "${PUID}" abcהדגל -o מאפשר שימוש במזהה שכבר נמצא בשימוש במקום אחר. לאחר מכן, תהליך ה־init מוותר על הרשאות ומריץ את היישום כ־abc. לכן, Docker מעביר את PUID=1000 לתוך המכולה כמו כל משתנה סביבה אחר ואינו פועל לפיו. המשתנה משנה את המספר של משתמש בתוך המכולה לפני שהיישום מתחיל, מה שאומר שעל גבי daemon סטנדרטי עם הרשאות root וללא מיפוי מחדש של מרחב שמות משתמש (user namespace), קבצים שנוצרים זה עתה יופיעו על הדיסק שלכם בבעלות 1000. כתיבה לקובץ קיים שניתן לכתיבה אינה משנה את הבעלים שלו. Docker במצב rootless מסיט את המספר הזה, כפי שמוסבר בהמשך. השאירו את PUID ללא הגדרה ו־abc יישאר 911, וזו הסיבה ש־bind mount שלא הוגדר כראוי מתמלא בקבצים שבבעלות 911:911.
קבלת שני המספרים שלכם באמצעות id
הריצו פקודה זו על המארח, כמשתמש שבבעלותו נמצאות תיקיות הנתונים:
iduid=1000(deploy) gid=1000(deploy) groups=1000(deploy),27(sudo),988(docker)uid הוא ה-PUID שלכם ו-gid הוא ה-PGID שלכם. עבור תסריט, id -u ו-id -g מדפיסים את המספרים בלבד. ברוב תמונות ה-VPS החדשות, חשבון המשתמש האנושי הראשון הוא 1000:1000, אך אל תניחו זאת מראש. ההקצאה תלויה בחשבונות ובתצורה הקיימים: שרת שנבנה מחדש עשוי להקצות שוב 1000, בעוד חשבון שנוצר מאוחר יותר יקבל מזהה (ID) פנוי גבוה יותר. אם השירותים שלכם רצים תחת חשבון שירות ייעודי במקום תחת משתמש ההתחברות שלכם, הריצו את id thatuser וקחו את המספרים משם.
מדוע הקבצים מופיעים תחת 911:911
ls -l מציג מזהה מספרי במקום שם כאשר אין חשבון מארח התואם למזהה זה. אם אין חשבון מארח התואם ל-UID 911, אין שם להצגה. השתמשו ב-ls -ln כדי לראות מספרים בכל פעם ולהסיר את אי-הבהירות:
ls -ln /srv/appdata/sonarrdrwxr-xr-x 2 911 911 4096 Aug 7 09:12 Backups
-rw-r--r-- 1 911 911 512 Aug 7 09:12 config.xmlפלט זה תואם לברירות המחדל המובנות של המכולה, אך קבצים קיימים בלבד אינם מוכיחים תחת איזה משתמש היישום רץ כעת. ה-config.xml ברשימה זו הוא גם הקובץ שמחזיק את הגדרות האימות, דבר שחשוב בפעם הראשונה שפותחים את ממשק ה-web ומגלים ש-Sonarr ו-Radarr מגיעים ללא שם משתמש או סיסמה כברירת מחדל. אשרו זאת מתוך המכולה במקום לנחש:
docker exec sonarr id abc
docker compose logs sonarr | head -n 25תהליך ה-init של linuxserver מדפיס את התוצאה שלו בלוג העלייה כשתי שורות:
User UID: 911
User GID: 911אם שורות אלו מציגות 911 לאחר שהגדרתם את PUID=1000 בקובץ ה-Compose שלכם, המכולה הרצה אינה משתמשת בערך שהגדרתם. הסיבה הרגילה היא שערכתם את docker-compose.yml ולאחר מכן הרצתם את docker compose restart, אשר עושה שימוש חוזר במכולה הקיימת עם הסביבה המקורית שלה. שינויים בסביבה דורשים את docker compose up -d, אשר יוצר מחדש את המכולה. הסיבה האחרת היא מכוונת: כאשר אימג' רץ במצב לקריאה בלבד (read-only) או במצב שאינו root, ה-init מדלג על שינוי המספור לחלוטין, גם אם המשתנה קיים במכולה. במצב לקריאה בלבד, הבאנר מדווח על המזהה ללא שינוי של abc; במצב שאינו root הוא מדווח על הבעלים של /run.
מדוע לא ניתן למחוק קובץ שנכתב על ידי מכולה
הליבה (kernel) משווה מספרים, לעולם לא שמות. ה-shell שלכם רץ תחת UID 1000. הקובץ שייך ל-UID 911. הספרייה המכילה אותו היא drwxr-xr-x וגם היא שייכת ל-911, לכן לקבוצה (group) ולאחרים (other) יש הרשאות קריאה והרצה, אך לא כתיבה. מחיקת קובץ דורשת הרשאת כתיבה על הספרייה שלו, לא על הקובץ עצמו, לכן אתם מקבלים שגיאה זו גם כאשר הקובץ נראה תקין:
rm: cannot remove '/srv/appdata/sonarr/config.xml': Permission deniedמכולה המנסה לכתוב נתקלת באותה חומה מהצד השני. אם ספריית המארח שייכת למשתמש שלכם במצב 755 והיישום רץ כ-911, פעולת הכתיבה הראשונה שלו תיכשל עם Permission denied והיישום ידווח על כך בשפתו. ביישומי .NET כמו Sonarr או Radarr, הדבר מופיע כ-UnauthorizedAccessException: Access to the path '/data/downloads' is denied. מחרוזת ההרשאות שלפני הקובץ מציינת לפי איזה משלושת סטים של ההרשאות אתם נשפטים בפועל, ו-קריאה נכונה של drwxr-xr-x היא מה שהופך את השגיאה הזו ממסתורית למובנת מאליה.
זוהי בעיה ספציפית ל-bind mount. כאשר Docker יוצר named volume ריק ומעגן אותו מעל נתיב שקיים ב-image, הוא מעתיק את תוכן הנתיב לתוך ה-volume, כולל הבעלות וסיביות ההרשאות, כך שהיישום מוצא ספרייה שהוא כבר הבעלים שלה. bind mount לא מקבל טיפול כזה: Docker מעגן את ספריית המארח שלכם בדיוק כפי שהיא. הבדל זה הוא אחת הסיבות המעשיות לדעת מתי bind mount עדיף על named volume ומתי לא.
תיקון תיקייה שכבר הוגדרה באופן שגוי
הגדרת PUID ו-PGID משנה את התנהגות היישום מעתה ואילך. היא אינה מתקנת רטרואקטיבית כל קובץ שכבר נמצא על הדיסק, אף שה-init מתקן את הבעלות בנתיבים ספציפיים המתוארים להלן. עצרו את ה-stack, תקנו את הבעלות בעצמכם, ולאחר מכן הפעילו אותו שוב:
docker compose down
sudo chown -R 1000:1000 /srv/appdata/sonarr
docker compose up -dהשתמשו ב-sudo chown -R "$(id -u):$(id -g)" /srv/appdata/sonarr אם אינכם מעוניינים להקליד את המספרים. בצעו זאת כשהמכולה עצורה, כיוון שיישום רץ שנמצא באמצע כתיבה במהלך chown רקורסיבי עלול להסתיים עם עץ תיקיות מתוקן למחצה וסבב שני ומבלבל של שגיאות.
מה PUID ו־PGID לא פותרים
זהו החלק שמכשיל משתמשים שביצעו את כל השלבים כראוי. סקריפט הגדרת המשתמש של תמונת הבסיס מבית linuxserver מבצע chown לשלושה נתיבים בעת העלייה: /app, /config ו־/defaults. נקודות העיגון (mounts) של המדיה שלכם אינן ברשימה זו. הנתיבים /data, /downloads ו־/tv מועברים ליישום ללא שינוי; לכן, אם בצד המארח (host) של נקודות עיגון אלו קיימת בעלות שמשתמש המכולה אינו יכול לכתוב אליה, המכולה תעלה בצורה תקינה, תציג את ה־UID הנכון בבאנר שלה, אך תיכשל בניסיון הייבוא הראשון.
זוהי התנהגות תקינה. ביצוע chown רקורסיבי על ספריית מדיה בנפח 12 טרה-בייט בכל עלייה של מכולה יהיה אסון. המשמעות היא שניהול תיקיות המדיה הוא באחריותכם, ושם נמצאות נקודות העיגון שבהן הרשאות נוטות להשתבש. מכיוון שכשל מסוג זה מופיע בשקט בלוג של היישום שעות לאחר שהמכולה נראתה תקינה, ביצוע בדיקת כתיבה תקופתית המחוברת ל-ntfy על ה-VPS שלכם, ששולח התראות לטלפון הוא דרך זולה לקבל התראה על כך לפני שתגלו שחסרים פרקים של שבוע שלם.
שלוש דרכים לשליטה במשתמש, ומתי כל אחת מהן רלוונטית
משתני סביבה PUID ו-PGID
שיטה זו עובדת רק על אימג'ים שנקודת הכניסה (entrypoint) שלהם קוראת משתנים אלו. היא פופולרית מכיוון שהמכולה עדיין עולה כ-root, מבצעת אתחול עצמי, מתקנת את /config, ורק אז מוותרת על הרשאות. Docker Mods וסקריפטי אתחול מותאמים אישית ממשיכים לעבוד. החיסרון הוא שאתם מסתמכים על מוסכמה ולא על תכונה מובנית של הפלטפורמה, ושמות המשתנים אינם אחידים בין פרויקטים שונים.
המפתח user: ב-Compose
זוהי תכונה אמיתית של Docker והיא עובדת על כל אימג' מכיוון שסביבת הריצה של המכולה מיישמת אותה לפני שהקוד של האימג' עצמו רץ:
services:
sonarr:
image: lscr.io/linuxserver/sonarr:latest
user: "1000:1000"התהליך לעולם אינו רץ כ-root, אפילו לא לרגע, מה שמהווה יתרון אבטחה ממשי. עם זאת, זה משבש כל דבר ב-entrypoint שהיה זקוק להרשאות root. באימג'ים של linuxserver, הפרויקט תומך בכך על בסיס "מאמץ סביר" ורק עבור אימג'ים שנבדקו. הסייגים ספציפיים: PUID ו-PGID מפסיקים להשפיע, Docker Mods לא ירוצו, שירותים מותאמים אישית לא ירוצו, ואתם הופכים לאחראים על ההרשאות בכל volume שמחובר (mounted). התבנית המתועדת שלהם משלבת את הדגל עם /run שניתן לכתיבה:
user: 1000:1000
tmpfs:
- /run:uid=1000,gid=1000,exec
security_opt:
- no-new-privileges=trueתופעת לוואי קוסמטית אחת מפתיעה משתמשים. user: מספרי שאין לו התאמה ב-/etc/passwd של המכולה גורם לכלים בתוך המכולה לדווח על whoami: cannot find name for user ID 1000. המזהה תקין וגישה לקבצים עובדת כרגיל. רק חיפוש השם נכשל.
Rootless Docker
Rootless Docker מריץ את ה-daemon עצמו כמשתמש ללא הרשאות, כך שה-daemon והמכולות רצים ללא הרשאות root של המארח. זה משנה לחלוטין את החשבון של הבעלות. UID 0 במכולה ממופה ל-UID של המשתמש שמריץ את ה-rootless Docker במארח, ו-UID של מכולה n עבור כל n של 1 ומעלה ממופה ל-subuid + (n - 1), כאשר subuid הוא הבסיס של הטווח שהוקצה לכם ב-/etc/subuid; מזהי קבוצות (GID) פועלים לפי אותו כלל באמצעות /etc/subgid. Docker מצפה ללפחות 65,536 מזהים משניים שם.
קראו את המיפוי הזה שוב, כי הוא הופך את ההמלצה הרגילה. ב-rootless Docker, מכולה שיוצרת קובץ כ-root מייצרת בדרך כלל קובץ שבבעלותכם. מכולה שיוצרת קובץ כ-UID 1000 מייצרת בדרך כלל קובץ שבבעלות מזהה משני, כמו 100999 כאשר הטווח מתחיל ב-100000. הגישה של ה-shell שלכם תלויה בהרשאות וב-ACL; מחיקה תלויה בדרך כלל בספריית האב, כך שניתן למחוק את הקובץ מספרייה שאתם שולטים בה. לכן, ערך ה-PUID שנכון ב-daemon עם הרשאות root הוא הערך השגוי כאן. שני המנגנונים משנים בעלות בשכבות שונות, וערבוב ביניהם ללא בדיקה עלול להשאיר אתכם ללא יכולת כתיבה לנתונים המחוברים. אם אתם עוברים ל-rootless, בדקו את הבעלות על קובץ אחד שנכתב בשרת שלכם לפני שאתם מעבירים אליו ספרייה.
עבור רוב הסטאקים של אירוח עצמי ב-VPS בודד, PUID ו-PGID ב-daemon עם הרשאות root הם הבחירה הפרגמטית, כיוון שזה מה שהאימג'ים בנויים ומתועדים עבורו. פנו ל-user: כאשר ה-README של האימג' מציין שהוא נבדק עבורו, או כאשר אתם מריצים אימג' רשמי שאין לו תמיכה ב-PUID כלל. סביבת עבודה של מסמכים כמו מופע AFFiNE באירוח עצמי על VPS אחד נופלת למקרה האחרון, כיוון שאף אחת מהמכולות שלה לא קוראת PUID והבעלות על ספריית מסד הנתונים והקבצים שהועלו נקבעת על ידי סביבת הריצה ולא על ידי משהו בבלוק הסביבה. כך גם לגבי מוקד תמיכה Chatwoot באירוח עצמי, שבו מכולת ה-Rails וה-worker של Sidekiq כותבים שניהם לאותה ספריית העלאות ואף אחד מהם לא קורא PUID, לכן הספרייה חייבת להתאים למשתמש שהאימג' כבר רץ כמותו. שום דבר מזה לא משתנה גם עבור סטאק חדש יותר, לכן מתן סוכן OneCLI מבודד לכל אדם בצוות משאיר את ספריות העבודה האישיות ואת ספריית הנתונים של Postgres בבעלות המשתמש שהאימג' כבר רץ כמותו, מה שהופך את זה לבעיית user: ו-chown ולא לבעיית PUID. הציבו API יחיד באירוח עצמי לפני Codex, Claude Code ו-Hermes ונקודת הכניסה שלו תנהל זהויות מרובות: המכולה חייבת להתחיל כ-root, הקונסולה וה-gateway רצים כמשתמש ללא הרשאות, וכל סשן של סוכן רץ כמשתמש משלו. אל תוסיפו user: לפריסה הזו; ה-entrypoint שלה מנהל את הבעלות על ה-volume של הנתונים.
המקרה של מחסנית המדיה: קבוצה משותפת בין מכולות
מחסנית מדיה מסוג arr עם Sonarr, Radarr ולקוח הורדות היא המקום שבו הנושא מפסיק להיות תיאורטי. לקוח ההורדות כותב קובץ שהושלם לתוך /data/downloads. לאחר מכן, Sonarr מבצע hardlink או מעביר את הקובץ לתוך /data/media. כדי שה־hardlink יעבוד, שתי המכולות זקוקות להרשאות כתיבה לאותו עץ תיקיות. אם לקוח ההורדות מורץ כמשתמש 1000 בעוד Sonarr מורץ כמשתמש 1001 ללא הרשאות כתיבה קבוצתיות משותפות, אחד מהם יהיה הבעלים של קבצים שהשני יכול רק לקרוא.
הפתרון הוא קבוצה משותפת שכל מכולה במחסנית משתמשת בה כ־PGID שלה:
sudo groupadd -g 13000 media
sudo usermod -aG media deploy
sudo chown -R deploy:media /srv/media
sudo find /srv/media -type d -exec chmod 2775 {} +
sudo find /srv/media -type f -exec chmod 0664 {} +ה־2 בתחילת 2775 הוא ה־setgid bit. על תיקייה, המשמעות היא שכל קובץ חדש או תת-תיקייה שנוצרים בתוכה יורשים את הקבוצה media במקום את הקבוצה הראשית של היוצר, כך שההגדרה נשמרת גם עבור הורדות חדשות מבלי שתצטרכו להריץ שוב את chown. צאו מהמערכת והיכנסו מחדש, או הריצו את newgrp media, לפני שתבדקו את הגישה שלכם: קבוצה שנוספת באמצעות usermod -aG לא מופיעה ב-shell session שכבר פתוח.
בתוך המכולה, groupmod -o -g 13000 abc ממספר מחדש את הקבוצה abc ל-13000, כך ש-abc כותב עם אותו GID כמו הקבוצה media במארח שלכם. כל מכולת linuxserver שניגשת לעץ הזה שומרת על ה-PUID שלה ומשתפת את אותו ה-PGID. זה כולל מכולות בהמשך השרשרת שרק קוראות את הספרייה המוכנה, כמו Jellyfin עצמה. ממשק קדמי כמו Halcyon, שמגיש את הספרייה הזו כחנות וידאו שניתן לשוטט בה משנות ה-90, מתחבר ל-Jellyfin דרך HTTP באמצעות HALCYON_JELLYFIN_URL; הפריסה הסטנדרטית שלו אינה זקוקה ל-PGID המדיה המשותף או למיפוי של תיקיית המדיה.
לאחר מכן, הגדירו את UMASK=002 בכל מכולת linuxserver במחסנית. זהו הצעד שאנשים מפספסים. אם הוא נשאר ללא הגדרה, היישום שומר על ה-umask שירש אלא אם משהו אחר משנה אותו, וערך ברירת המחדל שהתמונות מציגות ב-README הוא UMASK=022. עם umask אפקטיבי של 022, יישום שמבקש 0666 עבור קובץ חדש מקבל 0644 כאשר אין ACL ברירת מחדל: שאר הקבוצה עדיין יכולה לקרוא אותו אך לא לשנות אותו, מה שמבטל את רוב השיתוף שהגדרתם זה עתה. עם 002 וללא ACL ברירת מחדל, יישום שמבקש את ה-0666 הרגיל לקבצים ו-0777 לתיקיות מקבל קובצי 0664, ובתוך עץ ה-setgid, תיקיות 2775, והקבוצה יכולה לכתוב. umask רק מסיר ביטים, לכן יישום שמבקש 0600 עדיין מקבל 0600, ותיקייה הנושאת ACL ברירת מחדל מתעלמת מה-umask לחלוטין. הוסיפו את המשתנה לצד PUID ו-PGID:
services:
sonarr:
image: lscr.io/linuxserver/sonarr:latest
container_name: sonarr
environment:
- PUID=${PUID}
- PGID=${PGID}
- UMASK=002
- TZ=Etc/UTC
volumes:
- /srv/appdata/sonarr:/config
- /srv/media:/data
restart: unless-stoppedשני הערכים הללו שייכים לקובץ .env לצד קובץ ה-Compose, כך שכל המחסנית קוראת הגדרה אחת:
PUID=1000
PGID=13000Compose קורא את הקובץ הזה אוטומטית עבור החלפת משתנים בסגנון ${PUID}, שזהו אותו מנגנון שבו אתם משתמשים עבור פרטי הזדהות. ההרגלים סביב שמירת ערכים מחוץ ל-docker-compose.yml ובתוך קובץ .env חלים גם כאן, עם ההבדל ששני המספרים הללו אינם סודיים.
אמתו זאת מקצה לקצה במקום לסמוך על התצורה. כתבו קובץ חדש כמשתמש של היישום, תוך החלת ה-umask המוגדר, וקראו אותו מהמארח. השתמשו בשם קובץ בדיקה שאינו קיים כבר:
docker exec --user abc sonarr sh -c 'umask "$UMASK" && touch /data/downloads/permtest'
ls -ln /srv/media/downloads/permtestתוצאה תקינה מציגה את ה-PUID שלכם כבעלים, 13000 כקבוצה, ו--rw-rw-r-- כמצב (mode). אם הקבוצה קוראת 1000, הריצו את ls -ldn /srv/media/downloads: או שה-setgid bit (ה-s ב-drwxrwsr-x) חסר מהתיקייה הזו, או שהתיקייה עצמה עדיין שייכת לקבוצה 1000 במקום ל-media, והפקודות chown ו-chmod 2775 לעיל מתקנות את שניהם. אם המצב קורא -rw-r--r--, בדקו את ערך ה-UMASK של המכולה ואת ה-ACL ברירת המחדל של התיקייה; צרו מחדש את המכולה אם הסביבה שלה מיושנת. בדיקה זו בודקת יצירה כ-abc עם המסכה המוגדרת; מצב היצירה של היישום עצמו וה-umask האפקטיבי שלו עדיין קובעים את הקבצים שלו. הסירו את קובץ הבדיקה עם rm /srv/media/downloads/permtest כשתסיימו.
אילו אימג'ים משתמשים באילו משתנים
אימג'ים של linuxserver.io משתמשים ב-PUID, PGID ו-UMASK. התוכנה Paperless-ngx משתמשת בשמות שונים לאותו רעיון: USERMAP_UID ו-USERMAP_GID, שניהם עם ערך ברירת מחדל של 1000, והתיעוד שלה מנחה לקרוא אותם מ-id -u ו-id -g. שרתי תמונות מציגים פיזור דומה: ל-PhotoPrism יש זוג משתנים משלו, PHOTOPRISM_UID ו-PHOTOPRISM_GID, בעוד ש-Immich אינה מספקת שום מקבילה ומשאירה את המשתמש בתוך הקונטיינר למפתח user: של Docker, לכן בחירה בין PhotoPrism ל-Immich קובעת גם איזה מהמנגנונים הללו תצטרכו לתחזק עבור הספרייה הגדולה ביותר בשרת. אימג'ים רשמיים רבים מהמקור, כולל אימג'ים נפוצים של מסדי נתונים ושרתי אינטרנט, מגיעים עם משתמש מובנה וקבוע ומצפים שתשתמשו ב-user: או שתשאירו אותו כפי שהוא. פריסות קטנות של אפליקציה בודדת מעלות את אותה שאלה, לכן כשאתם מקימים מעקב אימונים openGym באירוח עצמי כדאי לבדוק באיזה משתמש הקונטיינר באמת רץ לפני שמפנים אליו bind mount, כיוון שהספרייה שמחזיקה את מסד הנתונים שלו יורשת את הזהות הזו בין אם הגדרתם PUID ובין אם לא. ממסר גישה מרחוק נופל לאותה קטגוריה, לכן כשאתם מריצים שרת ממסר RustDesk משלכם, זוג המפתחות Ed25519 ש-hbbs כותב בהפעלה הראשונה מגיע ל-bind mount שלכם בבעלות המשתמש שאיתו האימג' סיים לעלות. ניתן לתקן זאת לאחר מכן באמצעות chown בצד המארח, או לבחור את הזהות מראש עם המפתח user:, כיוון שהאימג' הזה לא מגדיר משתמש משלו, כל עוד הספרייה המעוגנת ניתנת לכתיבה על ידי ה-ID שבחרתם. אותו הדבר תקף לתשתית שאתם מוסיפים מאוחר יותר, לכן הצבת Authentik לפני האפליקציות שלכם עבור התחברות יחידה משמעותה הרצת אימג'ים רשמיים של authentik ו-Postgres שאינם קוראים PUID כלל, והבעלות על ה-volumes שלהם נקבעת לפי המשתמשים שבהם התהליכים שלהם רצים ולפי ההגדרות שמבצעים ה-entrypoints שלהם. Authentik הסירה את התלות שלה ב-Redis בגרסה 2025.10.
לכן בדקו את ה-README של כל אימג' לפני שאתם מעתיקים בלוק משתני סביבה בין פרויקטים. Docker מעבירה כל משתנה סביבה שתגדירו לתוך כל קונטיינר, בין אם משהו בפנים קורא אותו ובין אם לא, ו-PUID שאף רכיב לא צורך לא מייצר שגיאה, לא אזהרה ולא השפעה. הקונטיינר עולה כמשתמש שנבחר על ידי הגדרת user: של Docker או ה-Dockerfile, וה-entrypoint שלו יכול לאחר מכן להוריד הרשאות לפני הפעלת האפליקציה. בצעו את הבדיקה הזו לפני שאתם מוסיפים משהו חדש לשרת, כולל מערך סריקת אבטחה open-kritt באירוח עצמי, שבו קובץ ה-Compose יגיד לכם אם האימג'ים מכבדים PUID או אם הבעלות על הספריות שאתם מעגנים נקבעת על ידי האימג'ים עצמם.
FAQ
מדוע הקבצים של ה-Docker שלי שייכים ל-911:911?
911 הוא ה-UID וה-GID של המשתמש abc המובנה בתמונות של linuxserver.io. הופעת המספר הזה מעידה על התאמה לברירות המחדל, אך קבצים עשויים לשמור על בעלות זו גם לאחר שינוי ה-PUID וה-PGID של המכולה. ls -l מציג את המספרים הגולמיים כאשר אין חשבון במערכת המארחת שתואם למזהים אלו, ולכן אין שם להצגה. הגדירו את PUID ואת PGID לפי הפלט של id, צרו מחדש את המכולה בעזרת docker compose up -d, ולאחר מכן תקנו את הבעלות על הקבצים הקיימים בעזרת sudo chown -R 1000:1000 בתיקייה הרלוונטית.
האם PUID ו-PGID עובדים בכל תמונת Docker?
לא. הם אינם תכונה של Docker ו-Docker לעולם אינו קורא אותם. הם עובדים רק בתמונות שנקודת הכניסה (entrypoint) שלהן קוראת אותם ומפעילה את usermod ואת groupmod לפני הפעלת היישום; זהו המקרה במשפחת התמונות של linuxserver.io ובמספר פרויקטים שהעתיקו את התבנית. פרויקטים אחרים משתמשים בשמות אחרים, כגון USERMAP_UID ו-USERMAP_GID ב-paperless-ngx. בתמונה שאינה קוראת אף אחד מהם, המשתנים יתקבלו אך יתעלמו מהם ללא אזהרה.
האם עלי להשתמש ב-PUID ו-PGID או במפתח user: ב-Docker Compose?
השתמשו ב-PUID וב-PGID כאשר התמונה תומכת בהם, כיוון שנקודת הכניסה רצה כ-root מספיק זמן כדי לתקן את /config ולהפעיל את השירותים שלה בצורה תקינה. השתמשו ב-user: כאשר התמונה מתעדת תמיכה במשתמש שנבחר; היעדר תמיכה ב-PUID בלבד אינו אומר שנקודת הכניסה תעבוד ללא הרשאות root. בתמונה של linuxserver, הגדרת user: תהפוך את ה-PUID וה-PGID ללא פעילים, תמנע הרצה של Docker Mods ושירותים מותאמים אישית, ותטיל עליכם את האחריות המלאה להרשאות בכל כרך (volume) שמופה.
ל-Sonarr יש את ה-PUID הנכון אך הוא עדיין לא מצליח להעביר קבצים. מה הבעיה?
בדקו שלושה דברים לפי הסדר. ראשית, את נקודת העיגון (mount) של המדיה עצמה: סקריפט הגדרת המשתמש של תמונת הבסיס מבצע chown ל-/app, ל-/config ול-/defaults, לכן /data או /downloads שומרים על הבעלות הקיימת שלהם במערכת המארחת. שנית, הקבוצה המשותפת: תנו למכולות שניגשות לעץ המדיה את אותו ה-PGID והרשאות כתיבה לקבוצה. שלישית, ה-umask: מסכה אפקטיבית של 022 מייצרת קבצי 0644 כאשר היישום מבקש 0666 ולא חל ACL ברירת מחדל, כך שהמכולות האחרות בקבוצה יכולות לקרוא אותם אך לא לשנות אותם. השארת UMASK ללא הגדרה אינה מבטיחה מסכה או מצב קובץ מסוים. הגדירו את UMASK=002 והגדירו את ה-setgid bit על התיקיות בעזרת chmod 2775 כדי שקבצים חדשים יירשו את הקבוצה. יישום שמבקש 0600 עדיין ייצור קבצים פרטיים, ו-ACL ברירת מחדל משנה את האופן שבו מוקצות הרשאות יצירה.