Docker Compose-ல் PUID மற்றும் PGID என்றால் என்ன?
PUID மற்றும் PGID என்பவை Docker அமைப்புகள் அல்ல. இவை linuxserver.io images-ல் கோப்பு உரிமையாளர் சிக்கலைத் தவிர்க்கப் பயன்படும் ஒரு மரபு. உங்கள் கோப்புகள் ஏன் 911:911 என மாறுகின்றன
PUID மற்றும் PGID என்றால் என்ன
PUID மற்றும் PGID என்பவை சில container images தொடங்கும் போது வாசிக்கும் இரண்டு environment variables ஆகும். Docker இவற்றை ஒருபோதும் கவனிப்பதில்லை. இவை linuxserver.io images மற்றும் சில குறிப்பிட்ட images-ல் பயன்படுத்தப்படும் ஒரு மரபு (convention). எனவே, இவற்றை வாசிக்கும்படி எழுதப்படாத ஒரு image, இந்த variables-ஐ அமைதியாகப் புறக்கணித்துவிடும்.
ஒரு linuxserver.io image-க்குள் abc என்ற பயனர் இருப்பார். இவர் build செய்யப்படும்போது UID (user ID) 911 மற்றும் GID (group ID) 911 உடன் உருவாக்கப்படுகிறார். Container root பயனர் உரிமையுடன் தொடங்குகிறது, அதன் init scripts-ஐ இயக்குகிறது. அந்த scripts-ல் ஒன்று, application தொடங்குவதற்கு முன்பாக அந்தப் பயனரின் ID-ஐ மாற்றியமைக்கிறது:
groupmod -o -g "${PGID}" abc
usermod -o -u "${PUID}" abc-o flag ஏற்கனவே பயன்பாட்டில் உள்ள ஒரு ID-ஐப் பயன்படுத்த அனுமதிக்கிறது. அதன் பிறகு, init scripts உரிமைகளைக் குறைத்து (drops privileges), application-ஐ abc பயனராக இயக்குகிறது. எனவே, Docker மற்ற environment variables-ஐப் போலவே PUID=1000-ஐயும் container-க்குள் அனுப்புகிறது, ஆனால் அதன் மீது எந்தச் செயல்பாட்டையும் மேற்கொள்வதில்லை. இந்த variable, application தொடங்குவதற்கு முன்பாக container-க்குள் இருக்கும் ஒரு பயனரின் ID-ஐ மாற்றுகிறது. இதன் பொருள், user namespace remapping இல்லாத ஒரு standard rootful daemon-ல், புதிதாக உருவாக்கப்படும் கோப்புகள் உங்கள் வட்டில் 1000 என்ற UID-உடன் சேமிக்கப்படும். ஏற்கனவே உள்ள ஒரு கோப்பைத் திருத்தும்போது அதன் உரிமையாளர் (owner) மாறமாட்டார்கள். Rootless Docker இந்த எண்ணை மாற்றியமைக்கும், அது கீழே விளக்கப்பட்டுள்ளது. PUID-ஐ அமைக்காமல் விட்டால், abc அதன் 911 என்ற மதிப்பிலேயே இருக்கும். இதனால்தான், சரியாக configure செய்யப்படாத bind mount-ல் உருவாகும் கோப்புகள் 911:911 என்ற உரிமையாளரைக் கொண்டிருக்கின்றன.
id மூலம் உங்கள் இரண்டு எண்களைப் பெறுதல்
தரவு அடைவுகளை (data directories) வைத்திருக்கும் பயனராக, host-ல் இதை இயக்கவும்:
iduid=1000(deploy) gid=1000(deploy) groups=1000(deploy),27(sudo),988(docker)uid என்பது உங்கள் PUID மற்றும் gid என்பது உங்கள் PGID ஆகும். ஒரு script-க்கு, id -u மற்றும் id -g ஆகியவை வெறும் எண்களை மட்டும் அச்சிடும். பெரும்பாலான புதிய VPS images-ல் முதல் பயனர் கணக்கு 1000:1000 ஆக இருக்கும், ஆனால் அதை அப்படியே எடுத்துக்கொள்ள வேண்டாம். கணக்குகள் மற்றும் கட்டமைப்பைப் பொறுத்தே ஒதுக்கீடு அமையும்: ஒரு server-ஐ மீண்டும் உருவாக்கும்போது 1000 மீண்டும் ஒதுக்கப்படலாம், அதேசமயம் அடுத்தடுத்த கணக்குகளுக்கு அதிக ID-க்கள் கிடைக்கலாம். உங்கள் சேவைகள் உங்கள் சொந்த login பயனருக்குப் பதிலாக ஒரு பிரத்யேக service கணக்கின் கீழ் இயங்கினால், id thatuser-ஐ இயக்கி அங்கிருந்து எண்களைப் பெறவும்.
உங்கள் கோப்புகள் ஏன் 911:911 என்று காட்டுகின்றன
அந்த ID-க்கு இணையான host account எதுவும் இல்லாதபோது, ls -l ஒரு பெயருக்குப் பதிலாக எண்ணியல் ID-யைக் காட்டுகிறது. UID 911-க்கு எந்த host account-ம் இல்லையென்றால், காட்டுவதற்குப் பெயர் இருக்காது. ஒவ்வொரு முறையும் எண்களைப் பார்க்கவும், குழப்பத்தைத் தவிர்க்கவும் 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அந்த வெளியீடு container-ன் இயல்புநிலை அமைப்புகளுடன் ஒத்துப்போகிறது, ஆனால் தற்போது application எந்த user-ஆக இயங்குகிறது என்பதை வெறும் கோப்புகள் மட்டும் நிரூபிக்காது. அந்தப் பட்டியலில் உள்ள config.xml, authentication அமைப்புகளைக் கொண்ட கோப்பும் ஆகும்; நீங்கள் முதல்முறை web UI-ஐத் திறந்து Sonarr மற்றும் Radarr இயல்பாகவே பயனர் பெயர் அல்லது கடவுச்சொல் இன்றி வருகின்றன என்பதைக் காணும்போது இது முக்கியமானது. ஊகிப்பதற்குப் பதிலாக, container-க்குள் இருந்தே இதை உறுதிப்படுத்தவும்:
docker exec sonarr id abc
docker compose logs sonarr | head -n 25linuxserver init அதன் முடிவை startup log-ல் இரண்டு வரிகளாகக் காட்டுகிறது:
User UID: 911
User GID: 911உங்கள் Compose கோப்பில் PUID=1000-ஐ அமைத்த பிறகும் அந்த வரிகள் 911 என்று காட்டினால், இயங்கும் container நீங்கள் அமைத்த மதிப்பை உபயோகிக்கவில்லை என்று அர்த்தம். பொதுவாக, நீங்கள் docker-compose.yml-ஐத் திருத்திவிட்டு docker compose restart-ஐ இயக்கியிருப்பதே இதற்குக் காரணம்; இது ஏற்கனவே உள்ள container-ஐ அதன் பழைய environment-உடன் மீண்டும் பயன்படுத்துகிறது. Environment மாற்றங்களுக்கு docker compose up -d தேவை, இது container-ஐ மீண்டும் உருவாக்கும். மற்றொரு காரணம் திட்டமிட்டது: ஒரு image அதன் read-only அல்லது non-root mode-ல் இயங்கும்போது, variable இருந்தாலும் init மறுஎண்ணிடுதல் (renumbering) செய்வதைத் தவிர்க்கிறது. Read-only mode-ல், banner மாற்றப்படாத abc-ன் ID-யைக் காட்டுகிறது; non-root mode-ல், அது /run-ன் உரிமையாளரைக் காட்டுகிறது.
container உருவாக்கிய கோப்பை உங்களால் ஏன் நீக்க முடியவில்லை
Kernel கோப்புகளின் பெயர்களை ஒப்பிடுவதில்லை, எண்களை மட்டுமே ஒப்பிடும். உங்கள் shell UID 1000-ஆக இயங்குகிறது. அந்த கோப்பு UID 911-க்கு சொந்தமானது. அதை உள்ளடக்கிய directory drwxr-xr-x என்பதும் 911-க்கு சொந்தமானது, எனவே group மற்றும் பிற பயனர்களுக்கு read மற்றும் execute அனுமதி மட்டுமே உண்டு, write அனுமதி இல்லை. ஒரு கோப்பை நீக்க, அந்த கோப்பின் மீது அல்ல, அதன் directory மீது write அனுமதி தேவை. எனவே, கோப்பு பார்ப்பதற்கு பாதிப்பில்லாதது போலத் தெரிந்தாலும், உங்களுக்கு இந்த பிழை வரும்:
rm: cannot remove '/srv/appdata/sonarr/config.xml': Permission deniedஒரு container கோப்பை எழுத முயலும்போது, இதே சிக்கல் மறுபக்கத்தில் நிகழ்கிறது. Host directory உங்கள் பயனருக்கு சொந்தமாக இருந்து, mode 755-ல் இருந்தால், application 911-ஆக இயங்கும்போது, அதன் முதல் write முயற்சி Permission denied பிழையுடன் தோல்வியடையும். அந்த application தனது சொந்த மொழியில் இதைத் தெரிவிக்கும். Sonarr அல்லது Radarr போன்ற .NET application-களில் இது UnauthorizedAccessException: Access to the path '/data/downloads' is denied என்று காட்டப்படும். கோப்பிற்கு முன்னால் உள்ள permission string, நீங்கள் எந்த மூன்று permission தொகுப்புகளால் கட்டுப்படுத்தப்படுகிறீர்கள் என்பதைத் தெரிவிக்கும். drwxr-xr-x என்பதைச் சரியாக வாசிப்பது எப்படி என்பதைத் தெரிந்துகொண்டால், இந்த பிழை ஏன் ஏற்படுகிறது என்பது தெளிவாகிவிடும்.
இது குறிப்பாக ஒரு bind mount சிக்கலாகும். Docker ஒரு empty named volume-ஐ உருவாக்கி, அதை image-ல் உள்ள ஒரு path-ன் மீது mount செய்யும்போது, அது அந்த path-ல் உள்ள உள்ளடக்கங்களை, ownership மற்றும் permission bits-உடன் சேர்த்து volume-க்குள் நகலெடுக்கும். இதனால் application தனக்குச் சொந்தமான directory-யைக் கண்டறியும். Bind mount-க்கு இந்த வசதி கிடையாது: Docker உங்கள் host directory-யை அப்படியே mount செய்யும். இந்த வேறுபாடுதான் எப்போது bind mount-ஐப் பயன்படுத்த வேண்டும், எப்போது named volume-ஐப் பயன்படுத்த வேண்டும் என்பதைத் தெரிந்துகொள்வதற்கான நடைமுறை காரணங்களில் ஒன்றாகும்.
ஏற்கனவே தவறாக உள்ள directory-ஐ சரிசெய்தல்
PUID மற்றும் PGID-ஐ அமைப்பது, அந்த application இனிமேல் செயல்படும் விதத்தை மட்டுமே மாற்றும். இது வட்டில் ஏற்கனவே உள்ள கோப்புகளைப் பின்னோக்கிச் சென்று சரிசெய்யாது, இருப்பினும் init செயல்முறை கீழே விவரிக்கப்பட்டுள்ள குறிப்பிட்ட பாதைகளில் உள்ள உரிமையாளர் (ownership) விவரங்களைச் சரிசெய்யும். 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-ஐப் பயன்படுத்தவும். Container-ஐ நிறுத்திய பிறகு இதைச் செய்யவும், ஏனெனில் இயங்கிக்கொண்டிருக்கும் ஒரு application, recursive chown செயல்பாட்டின் போது கோப்புகளை எழுதிக்கொண்டிருந்தால், directory tree பாதியளவு மட்டுமே சரிசெய்யப்பட்டு, குழப்பமான இரண்டாம் கட்டப் பிழைகள் ஏற்பட வாய்ப்புள்ளது.
PUID மற்றும் PGID சரிசெய்யாதவை
எல்லாம் சரியாகச் செய்த பிறகும் சிக்கலை எதிர்கொள்பவர்களுக்கான பகுதி இது. linuxserver base image-ன் user setup script, தொடக்கத்தின்போது /app, /config மற்றும் /defaults ஆகிய மூன்று பாதைகளுக்கு chown செய்கிறது. உங்கள் media mounts அந்தப் பட்டியலில் இல்லை. /data, /downloads மற்றும் /tv ஆகியவை மாற்றப்படாமல் application-க்கு வழங்கப்படுகின்றன. எனவே, அந்த mounts-ன் host பக்கத்தில் உள்ள கோப்புகளின் உரிமையாளர் (ownership), container பயனர் எழுத முடியாதபடி இருந்தால், container சரியாகத் தொடங்கும், அதன் banner-ல் சரியான UID-ஐக் காட்டும், ஆனால் முதல் import-ன் போது தோல்வியடையும்.
இது சரியான செயல்பாடே. ஒவ்வொரு முறை container தொடங்கும்போதும், பன்னிரண்டு terabyte media library முழுவதும் recursive chown செய்வது பேரழிவாக முடியும். இதன் பொருள், media directories-ன் பொறுப்பு உங்களுடையது என்பதாகும்; அங்கேதான் அனுமதிகள் (permissions) தவறாகப் போக வாய்ப்புள்ளது. இத்தகைய தோல்விகள், container ஆரோக்கியமாகத் தெரிந்த பல மணிநேரங்களுக்குப் பிறகு application log-ல் மெதுவாகவே வெளிப்படும் என்பதால், உங்கள் சொந்த VPS-ல் ntfy-ஐப் பயன்படுத்தி, உங்கள் தொலைபேசிக்கு எச்சரிக்கைகளை அனுப்பும் ஒரு காலமுறை write test-ஐ அமைப்பது சிறந்தது. ஒரு வாரம் அத்தியாயங்கள் பதிவிறக்கம் ஆகாமல் இருப்பதை அறிவதற்கு முன்பே, இது குறித்த தகவலைப் பெற இது ஒரு எளிய வழியாகும்.
பயனரைக் கட்டுப்படுத்துவதற்கான மூன்று வழிகள் மற்றும் அவை ஒவ்வொன்றும் பொருந்தும் சூழல்கள்
PUID மற்றும் PGID environment variables
இது அதன் entrypoint-ல் இந்த மாறிகளை வாசிக்கும் images-ல் மட்டுமே செயல்படும். கண்டெய்னர் root-ஆகத் தொடங்கி, தனது சொந்த அமைப்புகளைச் செய்து, /config-ஐச் சரிசெய்து, அதன் பிறகு மட்டுமே சலுகைகளைக் குறைத்துக் கொள்வதால் இது பிரபலமானது. Docker Mods மற்றும் custom init scripts தொடர்ந்து செயல்படும். இதன் குறைபாடு என்னவென்றால், நீங்கள் ஒரு platform வசதியை விட ஒரு மரபையே நம்புகிறீர்கள், மேலும் இந்த மாறிப் பெயர்கள் அனைத்துத் திட்டங்களிலும் ஒரே மாதிரியாக இருப்பதில்லை.
Compose-ல் உள்ள user: key
இது ஒரு உண்மையான Docker வசதியாகும். கண்டெய்னரின் சொந்தக் குறியீடு இயங்குவதற்கு முன்பே கண்டெய்னர் runtime இதைச் செயல்படுத்துவதால், இது அனைத்து images-லும் வேலை செய்யும்:
services:
sonarr:
image: lscr.io/linuxserver/sonarr:latest
user: "1000:1000"செயல்முறை (process) ஒருபோதும் root-ஆக இயங்காது, ஒரு நொடி கூட இயங்காது, இது ஒரு உண்மையான பாதுகாப்பு நன்மையாகும். இது entrypoint-ல் root தேவைப்படும் எதையும் செயலிழக்கச் செய்யும். linuxserver images-ல், இந்தத் திட்டம் இதைச் சோதிக்கப்பட்ட images-க்கு மட்டுமே மற்றும் நியாயமான முயற்சிகளின் அடிப்படையில் ஆதரிக்கிறது. இதன் நிபந்தனைகள் குறிப்பிட்டவை: PUID மற்றும் PGID எந்த விளைவையும் ஏற்படுத்தாது, Docker Mods இயங்காது, custom services இயங்காது, மேலும் mounted volume-களின் அனுமதிகளுக்கு (permissions) நீங்களே பொறுப்பாவீர்கள். அவர்களின் ஆவணப்படுத்தப்பட்ட முறை, இந்த flag-ஐ ஒரு writable /run உடன் இணைக்கிறது:
user: 1000:1000
tmpfs:
- /run:uid=1000,gid=1000,exec
security_opt:
- no-new-privileges=trueஒரு cosmetic பக்கவிளைவு மக்களை ஆச்சரியப்படுத்துகிறது. கண்டெய்னரின் /etc/passwd-ல் பொருந்தக்கூடிய entry இல்லாத ஒரு எண்ணியல் user:, உள்ளே இருக்கும் கருவிகள் whoami: cannot find name for user ID 1000 என்று காட்டச் செய்யும். ID செல்லுபடியாகும் மற்றும் கோப்பு அணுகல் (file access) சாதாரணமாக வேலை செய்யும். பெயர் தேடல் (name lookup) மட்டுமே தோல்வியடையும்.
Rootless Docker
Rootless Docker, daemon-ஐ உங்கள் சலுகையற்ற (unprivileged) பயனராக இயக்குகிறது, எனவே daemon மற்றும் கண்டெய்னர்கள் host root சலுகைகள் இன்றி இயங்குகின்றன. இது ownership கணக்கீட்டை முழுமையாக மாற்றுகிறது. கண்டெய்னர் UID 0, rootless Docker-ஐ இயக்கும் பயனரின் host UID-க்கு map ஆகும். 1 அல்லது அதற்கு மேற்பட்ட ஏதேனும் n-க்கான கண்டெய்னர் UID n, subuid + (n - 1)-க்கு map ஆகும்; இங்கே subuid என்பது /etc/subuid-ல் உங்களுக்கு ஒதுக்கப்பட்ட வரம்பின் அடிப்படையாகும்; group ID-களும் /etc/subgid-ஐப் பயன்படுத்தி அதே விதியைப் பின்பற்றுகின்றன. Docker அங்கு குறைந்தது 65,536 subordinate ID-களை எதிர்பார்க்கிறது.
அந்த mapping-ஐ மீண்டும் படிக்கவும், ஏனெனில் இது வழக்கமான ஆலோசனையைத் தலைகீழாக மாற்றுகிறது. Rootless Docker-ன் கீழ், root-ஆக ஒரு கோப்பை உருவாக்கும் கண்டெய்னர், பொதுவாக உங்களால் சொந்தமாக்கப்பட்ட (owned) ஒரு கோப்பை உருவாக்குகிறது. UID 1000-ஆக ஒரு கோப்பை உருவாக்கும் கண்டெய்னர், பொதுவாக 100000-ல் தொடங்கும் வரம்பில் 100999 போன்ற ஒரு subordinate ID-ஆல் சொந்தமாக்கப்பட்ட கோப்பை உருவாக்குகிறது. உங்கள் shell-ன் அணுகல் அனுமதிகள் மற்றும் ACL-களைப் பொறுத்தது; நீக்குதல் பொதுவாக அது இருக்கும் கோப்பகத்தைப் (directory) பொறுத்தது, எனவே நீங்கள் கட்டுப்படுத்தும் கோப்பகத்திலிருந்து அந்த கோப்பை நீக்கலாம். எனவே, rootful daemon-ல் சரியான PUID மதிப்பு இங்கே தவறானது. இந்த இரண்டு வழிமுறைகளும் வெவ்வேறு அடுக்குகளில் ownership-ஐ மாற்றுகின்றன, மேலும் சரிபார்க்காமல் அவற்றை அடுக்கி வைப்பது, mounted data-வில் உங்களால் எழுத முடியாத நிலையை ஏற்படுத்தலாம். நீங்கள் rootless-க்கு மாறினால், ஒரு library-ஐ அதற்கு மாற்றும் முன், உங்கள் சொந்த server-ல் எழுதப்பட்ட ஒரு கோப்பின் ownership-ஐச் சோதிக்கவும்.
ஒரே VPS-ல் பெரும்பாலான self-hosted stacks-க்கு, rootful daemon-ல் PUID மற்றும் PGID-ஐப் பயன்படுத்துவதே நடைமுறைக்குச் சிறந்த தேர்வாகும், ஏனெனில் இதற்காகவே images உருவாக்கப்பட்டு ஆவணப்படுத்தப்பட்டுள்ளன. அந்த image-க்கு இது சோதிக்கப்பட்டதாக README-ல் இருந்தால், அல்லது PUID ஆதரவே இல்லாத ஒரு official upstream image-ஐ நீங்கள் இயக்கினால், user:-ஐப் பயன்படுத்தவும். ஒரு VPS-ல் self-hosted AFFiNE instance போன்ற ஒரு ஆவண workspace அந்த கடைசி வகையைச் சேர்ந்தது, ஏனெனில் அதன் கண்டெய்னர்கள் எவையும் PUID-ஐ வாசிப்பதில்லை, மேலும் அதன் database directory மற்றும் பதிவேற்றப்பட்ட கோப்புகளின் ownership, environment block-ல் உள்ள எதையும் விட runtime-ஆலேயே தீர்மானிக்கப்படுகிறது. ஒரு self-hosted Chatwoot support desk-க்கும் இதுவே பொருந்தும், அங்கு Rails கண்டெய்னரும் அதன் Sidekiq worker-ம் ஒரே uploads directory-ல் எழுதுகின்றன, மேலும் அவை இரண்டும் PUID-ஐ வாசிப்பதில்லை, எனவே அந்த directory image ஏற்கனவே இயங்கும் பயனருடன் பொருந்த வேண்டும். புதிய stack-க்கும் இதில் மாற்றம் இல்லை, எனவே குழுவில் உள்ள ஒவ்வொரு நபருக்கும் அவர்களின் சொந்த sandboxed OneCLI agent-ஐ வழங்குவது, ஒவ்வொரு நபரின் workspace directories மற்றும் Postgres data directory-ஐ அந்தந்த image ஏற்கனவே இயங்கும் பயனரின் ownership-ல் வைத்திருக்கிறது, இது PUID சிக்கலை விட ஒரு user: மற்றும் chown சிக்கலாகிறது. Codex, Claude Code மற்றும் Hermes-க்கு முன்னால் ஒரு self-hosted API-ஐ வைக்கவும், அதன் entrypoint பல அடையாளங்களை நிர்வகிக்கிறது: கண்டெய்னர் root-ஆகத் தொடங்க வேண்டும், console மற்றும் gateway சலுகையற்ற பயனராக இயங்க வேண்டும், மேலும் ஒவ்வொரு agent session-ம் அதன் சொந்த பயனராக இயங்க வேண்டும். அந்த deployment-ல் user:-ஐச் சேர்க்க வேண்டாம்; அதன் entrypoint data volume-ன் ownership-ஐ நிர்வகிக்கிறது.
மீடியா ஸ்டாக் சூழல்: கன்டெய்னர்களுக்கு இடையே பகிரப்பட்ட ஒரு குழு
Sonarr, Radarr மற்றும் ஒரு டவுன்லோட் கிளையன்ட் கொண்ட arr மீடியா ஸ்டாக் என்பது இது வெறும் கோட்பாடு மட்டுமல்ல என்பதை உணர்த்தும் இடமாகும். டவுன்லோட் கிளையன்ட் ஒரு கோப்பை /data/downloads-ல் பதிவிறக்கம் செய்து முடிக்கும். அதன் பிறகு Sonarr அந்த கோப்பை /data/media-க்கு hardlink செய்யும் அல்லது நகர்த்தும். இந்த hardlink சரியாகச் செயல்பட, இரண்டு கன்டெய்னர்களுக்கும் ஒரே கோப்பக அமைப்பில் எழுதும் அனுமதி (write access) தேவை. டவுன்லோட் கிளையன்ட் 1000 என்ற பயனராகவும், Sonarr 1001 என்ற பயனராகவும் இயங்கி, பகிரப்பட்ட குழு அனுமதி (shared group write permissions) இல்லையென்றால், ஒரு கன்டெய்னர் உருவாக்கும் கோப்புகளை மற்றொன்றால் படிக்க மட்டுமே முடியும்.
இதற்கான தீர்வு, ஸ்டாக்கில் உள்ள அனைத்து கன்டெய்னர்களும் தங்களின் 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 {} +2775-ல் உள்ள முன்னொட்டான 2 என்பது setgid பிட் ஆகும். ஒரு கோப்பகத்தில் இது இருந்தால், அதற்குள் உருவாக்கப்படும் ஒவ்வொரு புதிய கோப்பும், துணைக்கோப்பகமும் உருவாக்கியவரின் முதன்மைக் குழுவிற்குப் பதிலாக media குழுவையே மரபுரிமையாகப் பெறும். இதனால், நீங்கள் மீண்டும் chown கட்டளையை இயக்க வேண்டிய அவசியமின்றி, புதிய பதிவிறக்கங்கள் தானாகவே இந்த அமைப்பிற்குள் பொருந்தும். உங்கள் அணுகலைச் சரிபார்க்கும் முன், லாக் அவுட் செய்து மீண்டும் லாக் இன் செய்யவும் அல்லது newgrp media கட்டளையை இயக்கவும்: usermod -aG மூலம் சேர்க்கப்பட்ட ஒரு குழு, ஏற்கனவே திறந்திருக்கும் ஷெல் அமர்வில் (shell session) உடனடியாகத் தெரியாது.
கன்டெய்னருக்குள், groupmod -o -g 13000 abc என்பது abc குழுவை 13000 என மறுஎண் இடுகிறது. இதனால் abc, உங்கள் ஹோஸ்ட் media குழுவின் அதே GID-ஐப் பயன்படுத்தி கோப்புகளை எழுதும். இந்த கோப்பகத்தை அணுகும் ஒவ்வொரு linuxserver கன்டெய்னரும் அதன் சொந்த PUID-ஐ வைத்திருக்கும், ஆனால் அந்த ஒரு PGID-ஐப் பகிர்ந்து கொள்ளும். இதில் Jellyfin போன்ற, முடிக்கப்பட்ட லைப்ரரியை வாசிப்பதற்காக மட்டும் பயன்படுத்தப்படும் கன்டெய்னர்களும் அடங்கும். Halcyon, இது அந்த லைப்ரரியை 90-களின் வீடியோ ஸ்டோர் போலக் காட்டும் போன்ற ஒரு முன்பக்க மென்பொருள் (front end), HALCYON_JELLYFIN_URL-ஐப் பயன்படுத்தி HTTP வழியாக Jellyfin-உடன் இணைகிறது; அதன் வழக்கமான வரிசைப்படுத்தலுக்கு (deployment) பகிரப்பட்ட மீடியா PGID-யோ அல்லது மீடியா-கோப்பக மவுண்டோ தேவையில்லை.
பிறகு, ஸ்டாக்கில் உள்ள ஒவ்வொரு linuxserver கன்டெய்னரிலும் UMASK=002-ஐ அமைக்கவும். இதுவே பலரும் தவறவிடும் படிநிலை. இதை அமைக்கவில்லை என்றால், அந்த அப்ளிகேஷன் அதன் இயல்பான umask-ஐயே வைத்திருக்கும். இமேஜ் README-களில் காட்டப்படும் உதாரண மதிப்பு UMASK=022 ஆகும். 022 என்ற பயனுள்ள umask-உடன், ஒரு புதிய கோப்பிற்கு 0666 அனுமதி கோரும் அப்ளிகேஷன், இயல்புநிலை ACL இல்லாதபோது 0644 அனுமதியையே பெறும்: இதனால் குழுவின் மற்ற உறுப்பினர்களால் கோப்பைப் படிக்க மட்டுமே முடியும், மாற்ற முடியாது. இது நீங்கள் செய்த பகிர்தல் அமைப்பைச் செயலிழக்கச் செய்யும். 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இந்த இரண்டு மதிப்புகளும் Compose கோப்பிற்கு அருகில் உள்ள ஒரு .env கோப்பில் இருக்க வேண்டும். அப்போதுதான் முழு ஸ்டாக்கும் ஒரே வரையறையைப் படிக்கும்:
PUID=1000
PGID=13000${PUID} பாணி மாற்றீட்டிற்காக (style substitution) Compose இந்த கோப்பைத் தானாகவே படிக்கும். இதுவே நீங்கள் நற்சான்றிதழ்களுக்குப் (credentials) பயன்படுத்தும் அதே நுட்பமாகும். மதிப்புகளை 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 பிட் (drwxrwsr-x-ல் உள்ள s) விடுபட்டிருக்கலாம், அல்லது அந்த கோப்பகம் media குழுவிற்குப் பதிலாக 1000 குழுவிற்குச் சொந்தமாக இருக்கலாம். மேலே உள்ள chown மற்றும் chmod 2775 கட்டளைகள் இரண்டையும் சரிசெய்யும். பயன்முறை -rw-r--r-- என்று இருந்தால், கன்டெய்னரின் UMASK மதிப்பு மற்றும் கோப்பகத்தின் இயல்புநிலை ACL-ஐச் சரிபார்க்கவும்; சூழல் பழையதாக இருந்தால் கன்டெய்னரை மீண்டும் உருவாக்கவும். இந்தச் சோதனை abc பயனராக, அமைக்கப்பட்ட மாஸ்க்குடன் கோப்பு உருவாக்கப்படுவதைச் சரிபார்க்கிறது; அப்ளிகேஷனின் சொந்த உருவாக்க முறை மற்றும் பயனுள்ள umask ஆகியவை அதன் கோப்புகளைத் தீர்மானிக்கும். முடித்ததும் rm /srv/media/downloads/permtest கட்டளையைப் பயன்படுத்தி சோதனை கோப்பை நீக்கவும்.
எந்தெந்த images எந்தெந்த variable-களைப் பயன்படுத்துகின்றன
linuxserver.io images-கள் PUID, PGID மற்றும் UMASK ஆகியவற்றைப் பயன்படுத்துகின்றன. Paperless-ngx இதே நோக்கத்திற்காக வெவ்வேறு பெயர்களைப் பயன்படுத்துகிறது: USERMAP_UID மற்றும் USERMAP_GID. இவை இரண்டுமே இயல்பாக 1000 என அமையும். இவற்றை id -u மற்றும் id -g ஆகியவற்றிலிருந்து வாசிக்குமாறு அதன் ஆவணங்கள் கூறுகின்றன. புகைப்பட சேவையகங்களும் (photo servers) இதே போன்ற வேறுபாடுகளைக் கொண்டுள்ளன: PhotoPrism தனக்கென PHOTOPRISM_UID மற்றும் PHOTOPRISM_GID ஜோடியைக் கொண்டுள்ளது. Immich இதற்கு இணையான எதையும் கொண்டிருக்கவில்லை; அது container user-ஐ Docker-ன் user: key-க்கு விட்டுவிடுகிறது. எனவே, PhotoPrism மற்றும் Immich-க்கு இடையே தேர்ந்தெடுப்பது என்பது, உங்கள் சேவையகத்தில் உள்ள மிகப்பெரிய library-க்காக எந்த நிர்வாக முறையை நீங்கள் பின்பற்றப் போகிறீர்கள் என்பதையும் தீர்மானிக்கிறது. பொதுவான database மற்றும் web server images உட்பட பல அதிகாரப்பூர்வ upstream images-கள், ஒரு நிலையான built-in user-ஐக் கொண்டுள்ளன. அவை நீங்கள் user:-ஐப் பயன்படுத்த வேண்டும் அல்லது அதை மாற்றாமல் அப்படியே விட வேண்டும் என்று எதிர்பார்க்கின்றன. சிறிய single-app deployments-களிலும் இதே கேள்வி எழுகிறது. எனவே, நீங்கள் self-hosted openGym workout tracker-ஐ நிறுவும்போது, bind mount-ஐ அதற்குச் சுட்டிக்காட்டுவதற்கு முன்பாக, அந்த container எந்த user-ஆக இயங்குகிறது என்பதைச் சரிபார்ப்பது அவசியம். ஏனெனில், அதன் database-ஐக் கொண்டிருக்கும் directory, நீங்கள் PUID-ஐ அமைத்தாலும் இல்லாவிட்டாலும் அந்த user-ன் உரிமையையே (ownership) பெறும். ஒரு remote access relay-ம் இதே வகையைச் சார்ந்தது. எனவே, நீங்கள் சொந்தமாக RustDesk relay server-ஐ இயக்கும்போது, முதல்முறை தொடங்கும் போது hbbs உருவாக்கும் Ed25519 key pair, அந்த image எந்த user-ஆக முடிகிறதோ அந்த user-ன் உரிமையிலேயே உங்கள் bind mount-ல் அமையும். இதை நீங்கள் host side-ல் chown மூலம் பின்னர் சரிசெய்யலாம் அல்லது user: key மூலம் தொடக்கத்திலேயே அடையாளத்தைத் தேர்வு செய்யலாம். ஏனெனில், நீங்கள் தேர்ந்தெடுக்கும் ID-க்கு அந்த mounted directory எழுதும் வசதி (writable) இருக்கும் வரை, அந்த image தனக்கென எந்த user-ஐயும் அமைப்பதில்லை. இது நீங்கள் பின்னர் சேர்க்கும் உள்கட்டமைப்பிற்கும் பொருந்தும். எனவே, உங்கள் apps-க்கு முன்னால் Authentik-ஐ ஒற்றை login-க்காக வைப்பது என்பது, PUID-ஐ வாசிக்காத அதிகாரப்பூர்வ authentik மற்றும் Postgres images-களை இயக்குவதைக் குறிக்கும். அவற்றின் volume ownership, அந்த processes இயங்கும் user-கள் மற்றும் அவற்றின் entrypoints செய்யும் அமைப்புகளைப் பொறுத்தே அமையும். Authentik தனது 2025.10 release-ல் Redis dependency-ஐ நீக்கிவிட்டது.
எனவே, ஒரு project-லிருந்து மற்றொரு project-க்கு environment block-ஐ நகலெடுக்கும் முன், ஒவ்வொரு image-ன் README-ஐயும் சரிபார்க்கவும். Docker-ல் நீங்கள் அமைக்கும் எந்தவொரு environment variable-ம், உள்ளே இருக்கும் ஏதேனும் ஒரு நிரல் அதை வாசிக்கிறதா இல்லையா என்பதைப் பொருட்படுத்தாமல், அந்த container-க்குள் அனுப்பப்படும். எதையும் பயன்படுத்தாத ஒரு PUID எந்தப் பிழையையும், எச்சரிக்கையையும் தராது, எந்த விளைவையும் ஏற்படுத்தாது. Docker-ன் user: அமைப்பு அல்லது Dockerfile மூலம் தேர்ந்தெடுக்கப்பட்ட user-ஆகவே container தொடங்கும். அதன் entrypoint, application-ஐத் தொடங்குவதற்கு முன் privileges-ஐக் குறைக்கலாம். self-hosted open-kritt security scanning stack உட்பட, எதைப் புதிதாகச் சேர்ப்பதற்கு முன்பும் இந்த வாசிப்பைச் செய்யுங்கள். அந்த images PUID-ஐ மதிக்கின்றனவா அல்லது நீங்கள் mount செய்யும் directories-ன் ownership அந்த images-களாலேயே நிலையாக நிர்ணயிக்கப்படுகிறதா என்பதை அதன் Compose file உங்களுக்குத் தெரிவிக்கும்.
FAQ
எனது Docker கோப்புகள் ஏன் 911:911 உரிமையில் உள்ளன?
911 என்பது linuxserver.io images-ல் உள்ள abc பயனரின் UID மற்றும் GID ஆகும். இது இயல்புநிலை அமைப்புகளுடன் ஒத்துப்போவதால் இவ்வாறு தெரிகிறது, ஆனால் container-ன் PUID மற்றும் PGID-ஐ மாற்றிய பிறகும் கோப்புகள் பழைய உரிமையையே கொண்டிருக்கலாம். உங்கள் host-ல் அந்த ID-களுக்கு இணையான கணக்கு எதுவும் இல்லாதபோது, ls -l அந்த எண்களை மட்டுமே காட்டும், ஏனெனில் காண்பிக்க பெயர் எதுவும் இருக்காது. PUID மற்றும் PGID ஆகியவற்றை id-ன் வெளியீட்டிற்கு ஏற்ப அமைக்கவும், docker compose up -d மூலம் container-ஐ மீண்டும் உருவாக்கவும், பின்னர் பாதிக்கப்பட்ட கோப்பகத்தில் sudo chown -R 1000:1000-ஐப் பயன்படுத்தி கோப்புகளின் உரிமையைச் சரிசெய்யவும்.
PUID மற்றும் PGID அனைத்து Docker images-லும் வேலை செய்யுமா?
இல்லை. இவை Docker-ன் அம்சம் அல்ல, Docker இவற்றை ஒருபோதும் வாசிப்பதில்லை. இவை அந்தந்த image-ன் entrypoint-ல் PUID/PGID-ஐ வாசித்து, application-ஐத் தொடங்குவதற்கு முன் usermod மற்றும் groupmod-ஐ அழைக்கும் images-ல் மட்டுமே வேலை செய்யும்; linuxserver.io குடும்பம் மற்றும் இந்த முறையைப் பின்பற்றும் சில திட்டங்கள் மட்டுமே இதற்குள் அடங்கும். பிற திட்டங்கள் வெவ்வேறு பெயர்களைப் பயன்படுத்துகின்றன, உதாரணமாக paperless-ngx-ல் USERMAP_UID மற்றும் USERMAP_GID பயன்படுத்தப்படுகின்றன. இவற்றை வாசிக்காத ஒரு image-ல், இந்த மாறிகள் ஏற்றுக்கொள்ளப்படும், ஆனால் எந்த எச்சரிக்கையும் இன்றி புறக்கணிக்கப்படும்.
நான் PUID மற்றும் PGID-ஐப் பயன்படுத்த வேண்டுமா அல்லது Docker Compose-ல் உள்ள user:-ஐப் பயன்படுத்த வேண்டுமா?
Image அவற்றை ஆதரிக்கும்போது PUID மற்றும் PGID-ஐப் பயன்படுத்தவும், ஏனெனில் entrypoint root-ஆக இயங்கி /config-ஐச் சரிசெய்து அதன் சேவைகளைச் சரியாகத் தொடங்கும். ஒரு image குறிப்பிட்ட பயனரை ஆதரிப்பதாக ஆவணப்படுத்தப்பட்டிருந்தால் மட்டுமே user:-ஐப் பயன்படுத்தவும்; PUID ஆதரவு இல்லை என்பதற்காகவே அந்த entrypoint root இன்றி இயங்கும் என்று அர்த்தமல்ல. ஒரு linuxserver image-ல், user:-ஐ அமைப்பது PUID மற்றும் PGID-ஐச் செயலிழக்கச் செய்யும், Docker Mods மற்றும் custom services-ஐ நிறுத்திவிடும், மேலும் அனைத்து mounted volume-களின் அனுமதிகளையும் நீங்களே நிர்வகிக்க வேண்டியிருக்கும்.
Sonarr சரியான PUID-ஐக் கொண்டிருந்தும் கோப்புகளை நகர்த்த முடியவில்லை. என்ன தவறு?
மூன்று விஷயங்களை வரிசையாகச் சரிபார்க்கவும். முதலாவதாக, media mount: base image-ன் பயனர் அமைப்பு script /app, /config மற்றும் /defaults ஆகியவற்றை மட்டுமே chown செய்யும், எனவே /data அல்லது /downloads ஆகியவை host-ல் என்ன உரிமையைக் கொண்டுள்ளதோ அதையே வைத்திருக்கும். இரண்டாவதாக, பகிரப்பட்ட குழு: media tree-ஐ அணுகும் containers-க்கு ஒரே மாதிரியான PGID மற்றும் group write அனுமதிகளை வழங்கவும். மூன்றாவதாக, umask: application 0666-ஐக் கோரும்போது, 022-ன் பயனுள்ள mask 0644 கோப்புகளை உருவாக்கும் (default ACL இல்லாத பட்சத்தில்), இதனால் குழுவில் உள்ள பிற containers-ஆல் அவற்றைப் படிக்க மட்டுமே முடியும், மாற்ற முடியாது. UMASK-ஐ அமைக்காமல் விடுவது குறிப்பிட்ட mask அல்லது file mode-ஐ உறுதிப்படுத்தாது. UMASK=002-ஐ அமைக்கவும், புதிய கோப்புகள் குழுவை மரபுரிமையாகப் பெற chmod 2775 மூலம் கோப்பகங்களில் setgid bit-ஐ அமைக்கவும். ஒரு application 0600-ஐக் கோரும்போது அது தனிப்பட்ட கோப்புகளை உருவாக்கும், மேலும் default ACL உருவாக்கும் அனுமதிகள் ஒதுக்கப்படும் முறையை மாற்றும்.