PUID na PGID katika Docker Compose ni nini?
PUID na PGID si mipangilio ya Docker bali ni kanuni za picha za linuxserver.io. Jifunze kwa nini faili zako zinamilikiwa na 911 na jinsi ya kurekebisha ruhusa hizo.
PUID na PGID ni nini hasa
PUID na PGID ni vigezo viwili vya mazingira (environment variables) ambavyo picha (images) fulani za container husoma wakati wa kuanza. Docker yenyewe haviangalii kamwe. Hizi ni makubaliano ya kawaida yanayotumiwa na picha za linuxserver.io na nyingine chache, kwa hivyo picha ambayo haikuandikwa kuvitambua itavipuuza kimya kimya.
Ndani ya picha ya linuxserver.io kuna mtumiaji anayeitwa abc, aliyeundwa wakati wa ujenzi (build time) akiwa na UID (user ID) 911 na GID (group ID) 911. Container huanza kama root, huendesha hati zake za kuanzisha (init scripts), na moja ya hati hizo hubadilisha namba ya mtumiaji huyo kabla ya programu kuanza:
groupmod -o -g "${PGID}" abc
usermod -o -u "${PUID}" abcFlag ya -o inaruhusu ID ambayo tayari inatumika mahali pengine. Baada ya hapo, mchakato wa init huacha mamlaka ya juu (privileges) na kuendesha programu kama abc. Kwa hivyo, Docker hupitisha PUID=1000 ndani ya container kama kigezo kingine chochote cha mazingira na haifanyi kazi yoyote juu yake. Kigezo hiki hubadilisha namba ya mtumiaji ndani ya container kabla ya programu kuanza, jambo ambalo linamaanisha kuwa kwenye daemon ya kawaida ya rootful bila user namespace remapping, faili mpya zinazoundwa kwa kawaida huishia kwenye diski yako zikiwa na umiliki wa 1000. Kuandika kwenye faili iliyopo ambayo inaweza kuandikika hakubadilishi mmiliki wake. Rootless Docker hubadilisha namba hiyo, kama ilivyoelezwa hapo chini. Acha PUID bila kuwekwa na abc itabaki kuwa 911, ndiyo maana bind mount isiyosanidiwa hujaza faili zinazomilikiwa na 911:911.
Pata namba zako mbili ukitumia id
Tekeleza amri hii kwenye seva, ukiwa kama mtumiaji anayemiliki saraka za data:
iduid=1000(deploy) gid=1000(deploy) groups=1000(deploy),27(sudo),988(docker)uid ndiyo PUID yako na gid ndiyo PGID yako. Kwa ajili ya hati (script), id -u na id -g huchapisha namba hizo pekee. Kwenye picha nyingi za VPS mpya, akaunti ya kwanza ya binadamu huwa ni 1000:1000, lakini usichukulie kuwa ni hivyo kila wakati. Ugawaji hutegemea akaunti na usanidi uliopo: seva iliyojengwa upya inaweza kugawa 1000 tena, wakati akaunti inayofuata hupata ID ya juu zaidi inayopatikana. Ikiwa huduma zako zinaendeshwa chini ya akaunti maalum ya huduma badala ya akaunti yako ya kuingia, tekeleza id thatuser na uchukue namba kutoka hapo.
Kwa nini faili zako zinaonekana kama 911:911
ls -l huchapisha namba ya kitambulisho (numeric ID) badala ya jina wakati hakuna akaunti ya seva inayolingana na kitambulisho hicho. Ikiwa hakuna akaunti ya seva inayolingana na UID 911, hakuna jina la kuchapishwa. Tumia ls -ln ili kuona namba kila wakati na kuondoa utata:
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.xmlMatokeo hayo yanaendana na chaguo-msingi za ndani ya container, lakini faili zilizopo pekee hazithibitishi mtumiaji anayeendesha programu hiyo kwa sasa. config.xml katika orodha hiyo pia ni faili inayohifadhi mipangilio ya uthibitishaji, jambo ambalo ni muhimu wakati wa kufungua web UI kwa mara ya kwanza na kugundua kuwa Sonarr na Radarr haziji na jina la mtumiaji au nenosiri la awali. Thibitisha hili ukiwa ndani ya container badala ya kukisia:
docker exec sonarr id abc
docker compose logs sonarr | head -n 25Init ya linuxserver huchapisha matokeo yake katika logi ya kuanza (startup log) kama mistari miwili:
User UID: 911
User GID: 911Ikiwa mistari hiyo inasoma 911 baada ya kuweka PUID=1000 katika faili yako ya Compose, container inayoendelea haitumii thamani uliyoweka. Sababu ya kawaida ni kwamba ulihariri docker-compose.yml kisha ukaendesha docker compose restart, ambayo hutumia tena container iliyopo na mazingira yake ya awali. Mabadiliko ya mazingira yanahitaji docker compose up -d, ambayo huunda upya container. Sababu nyingine ni ya makusudi: wakati image inapoendeshwa katika hali ya read-only au isiyo ya root, init huruka ubadilishaji wa namba kabisa, hata kama variable ipo ndani ya container. Katika hali ya read-only, bango huripoti kitambulisho kisichobadilika cha abc; katika hali isiyo ya root, huripoti mmiliki wa /run.
Kwa nini huwezi kufuta faili iliyoandikwa na container
Kernel hulinganisha namba, si majina. Shell yako inaendeshwa kama UID 1000. Faili hiyo inamilikiwa na UID 911. Saraka (directory) inayoshikilia faili hiyo ni drwxr-xr-x na pia inamilikiwa na 911, kwa hivyo kundi na watumiaji wengine wana ruhusa ya kusoma na kutekeleza (read and execute) lakini si kuandika (write). Kufuta faili kunahitaji ruhusa ya kuandika kwenye saraka yake, si kwenye faili yenyewe, kwa hivyo unapata kosa hili hata wakati faili yenyewe inaonekana haina madhara:
rm: cannot remove '/srv/appdata/sonarr/config.xml': Permission deniedContainer inayojaribu kuandika inakumbana na kikwazo hicho hicho kutoka upande wa pili. Ikiwa saraka ya host inamilikiwa na mtumiaji wako kwa mode 755 na programu inaendeshwa kama 911, jaribio lake la kwanza la kuandika litafeli kwa Permission denied na programu itaripoti kosa hilo kwa maneno yake yenyewe. Katika programu ya .NET kama Sonarr au Radarr, kosa hili huonekana kama UnauthorizedAccessException: Access to the path '/data/downloads' is denied. Mfuatano wa ruhusa mbele ya faili hukuambia ni seti ipi kati ya tatu unayohukumiwa kwayo, na kusoma drwxr-xr-x kwa usahihi ndiko kunakofanya kosa hilo kutoka kuwa la ajabu hadi kuwa dhahiri.
Hili ni tatizo la bind mount hasa. Wakati Docker inapotengeneza named volume tupu na kuiweka juu ya njia (path) iliyopo kwenye image, inanakili yaliyomo kwenye njia hiyo kwenda kwenye volume, ikijumuisha umiliki na bits za ruhusa, kwa hivyo programu hupata saraka ambayo tayari inaimiliki. Bind mount haipati matibabu hayo: Docker huweka saraka yako ya host kama ilivyo. Tofauti hiyo ni moja ya sababu za kiutendaji za kujua wakati bind mount inapozidi named volume na wakati haifanyi hivyo.
Kurekebisha saraka ambayo tayari ina makosa
Kuweka PUID na PGID hubadilisha utendaji wa programu kuanzia sasa. Hii hairekebishi kiotomatiki kila faili iliyopo kwenye diski, ingawa mchakato wa init hurekebisha umiliki kwenye njia mahususi zilizoelezwa hapa chini. Simamisha stack, rekebisha umiliki wewe mwenyewe, kisha uianzishe tena:
docker compose down
sudo chown -R 1000:1000 /srv/appdata/sonarr
docker compose up -dTumia sudo chown -R "$(id -u):$(id -g)" /srv/appdata/sonarr ikiwa hutaki kuandika namba hizo. Fanya hivi wakati container imesimama, kwa sababu programu inayofanya kazi na kuandika data wakati wa chown ya recursive inaweza kusababisha muundo wa saraka kurekebishwa nusu na kuleta mzunguko wa pili wa makosa yanayochanganya.
Mambo ambayo PUID na PGID hayatatui
Hii ndiyo sehemu inayowatatiza watumiaji ambao wamefanya kila kitu kwa usahihi. Hati ya usanidi wa mtumiaji katika base image ya linuxserver hufanya chown kwenye njia tatu wakati wa kuanza: /app, /config na /defaults. Mount zako za media hazimo kwenye orodha hiyo. /data, /downloads na /tv hupewa programu bila kubadilishwa, kwa hivyo ikiwa upande wa host wa mount hizo una umiliki ambao mtumiaji wa container hawezi kuandikia, container huanza vizuri, huonyesha UID sahihi kwenye banner yake, kisha hushindwa wakati wa import ya kwanza.
Hiyo ndiyo tabia sahihi. Kufanya chown ya recursive kwenye maktaba ya media ya terabyte kumi na mbili kila wakati container inapoanza itakuwa janga. Hii inamaanisha kuwa saraka za media ni jukumu lako, na ndizo mount ambazo ruhusa (permissions) hukosewa mara nyingi. Kwa sababu aina hiyo ya hitilafu hujitokeza kimya kimya kwenye log ya programu saa kadhaa baada ya container kuonekana kuwa na afya, jaribio la mara kwa mara la kuandika data lililounganishwa kwenye ntfy kwenye VPS yako mwenyewe, inayotuma arifa kwenye simu yako ni njia rahisi ya kupata taarifa kuhusu tatizo hilo kabla ya wiki nzima ya vipindi vilivyokosekana kukupa ishara.
Njia tatu za kudhibiti mtumiaji, na wakati kila moja inapotumika
Vigezo vya mazingira vya PUID na PGID
Hii inafanya kazi tu kwenye image ambazo entrypoint yake inavisoma. Ni maarufu kwa sababu container bado huanza kama root, hufanya usanidi wake, hurekebisha /config, na ndipo hupunguza marupurupu. Docker Mods na hati za init za kawaida huendelea kufanya kazi. Gharama yake ni kwamba unategemea mkataba badala ya kipengele cha jukwaa, na majina ya vigezo si sanifu katika miradi yote.
Ufunguo wa user: katika Compose
Hii ni kipengele halisi cha Docker na hufanya kazi kwenye kila image, kwa sababu runtime ya container huitumia kabla ya msimbo wa image yenyewe kuanza:
services:
sonarr:
image: lscr.io/linuxserver/sonarr:latest
user: "1000:1000"Mchakato hauwahi kuendeshwa kama root, hata kwa muda mfupi, jambo ambalo ni faida halisi ya kiusalama. Pia huvunja chochote katika entrypoint kilichohitaji root. Kwenye image za linuxserver, mradi huu unasaidia hili kwa msingi wa juhudi zinazofaa na kwa image tu ambazo imezijaribu, na tahadhari ni mahususi: PUID na PGID huacha kuwa na athari yoyote, Docker Mods hazitaendeshwa, huduma za kawaida hazitaendeshwa, na unawajibika kwa ruhusa kwenye kila volume iliyopachikwa. Muundo wao uliorekodiwa huoanisha flag hiyo na /run inayoweza kuandikwa:
user: 1000:1000
tmpfs:
- /run:uid=1000,gid=1000,exec
security_opt:
- no-new-privileges=trueAthari moja ya mapambo huwashangaza watu. user: ya nambari ambayo haina ingizo linalolingana katika /etc/passwd ya container huwafanya zana ndani kuripoti whoami: cannot find name for user ID 1000. Kitambulisho ni halali na ufikiaji wa faili hufanya kazi kama kawaida. Utafutaji wa jina pekee ndio hushindwa.
Rootless Docker
Rootless Docker huendesha daemon yenyewe kama mtumiaji wako asiye na marupurupu, kwa hivyo daemon na container huendeshwa bila marupurupu ya root ya seva. Inabadilisha hesabu ya umiliki kabisa. UID 0 ya container hulingana na UID ya seva ya mtumiaji anayeendesha rootless Docker, na UID n ya container kwa n yoyote ya 1 au zaidi hulingana na subuid + (n - 1), ambapo subuid ni msingi wa masafa yaliyotengwa kwako katika /etc/subuid; vitambulisho vya kikundi hufuata sheria hiyo hiyo kwa kutumia /etc/subgid. Docker inatarajia angalau vitambulisho 65,536 vya chini hapo.
Soma ramani hiyo tena, kwa sababu inageuza ushauri wa kawaida. Chini ya rootless Docker, container inayotengeneza faili kama root kwa kawaida hutoa faili inayomilikiwa na wewe. Container inayotengeneza faili kama UID 1000 kwa kawaida hutoa faili inayomilikiwa na subordinate ID, kama vile 100999 wakati masafa yanaanzia 100000. Ufikiaji wa shell yako unategemea ruhusa na ACLs; ufutaji kwa kawaida hutegemea saraka iliyo nayo, kwa hivyo unaweza kufuta faili hiyo kutoka kwa saraka unayoidhibiti. Kwa hivyo thamani ya PUID ambayo ni sahihi kwenye daemon ya rootful ni ile isiyo sahihi hapa. Njia hizi mbili hubadilisha umiliki katika matabaka tofauti, na kuzipanga bila kuangalia kunaweza kukuacha usiweze kuandika kwenye data iliyopachikwa. Ikiwa utatumia rootless, jaribu umiliki wa faili moja iliyoandikwa kwenye seva yako mwenyewe kabla ya kuhamisha maktaba ndani yake.
Kwa stack nyingi za self-hosted kwenye VPS moja, PUID na PGID kwenye daemon ya rootful ndiyo chaguo la kiutendaji, kwa sababu ndivyo image zinavyojengwa na kuandikwa. Tumia user: wakati README ya image inasema kuwa image hiyo imejaribiwa kwa ajili yake, au unapoiendesha image rasmi ya upstream ambayo haina msaada wa PUID hata kidogo. Eneo la kazi la hati kama instance ya AFFiNE iliyojiendesha kwenye VPS moja huangukia katika kesi hiyo ya mwisho, kwa sababu hakuna hata moja ya container zake inayosoma PUID na umiliki wa saraka yake ya database na faili zilizopakiwa huamuliwa na runtime badala ya kitu chochote katika block ya mazingira. Vivyo hivyo kwa dawati la msaada la Chatwoot lililojiendesha, ambapo container ya Rails na mfanyakazi wake wa Sidekiq wote huandika kwenye saraka moja ya uploads na hakuna hata mmoja wao anayesoma PUID, kwa hivyo saraka hiyo lazima ilingane na mtumiaji yeyote ambaye image tayari inaendeshwa kama yeye. Hakuna kati ya hayo yanayobadilika kwa stack mpya pia, kwa hivyo kumpa kila mtu kwenye timu wakala wake wa OneCLI uliotengwa huacha saraka za kazi za kila mtu na saraka ya data ya Postgres ikimilikiwa na mtumiaji ambaye kila image tayari inaendeshwa kama yeye, jambo ambalo hufanya iwe tatizo la user: na chown badala ya tatizo la PUID. Weka API moja iliyojiendesha mbele ya Codex, Claude Code na Hermes na entrypoint yake hudhibiti utambulisho kadhaa: container lazima ianze kama root, console na gateway huendeshwa kama mtumiaji asiye na marupurupu, na kila kikao cha wakala huendeshwa kama mtumiaji wake mwenyewe. Usiongeze user: kwenye deployment hiyo; entrypoint yake hushughulikia umiliki wa volume ya data.
Mfumo wa media: kundi moja linaloshirikiwa kati ya kontena
Mfumo wa media wa arr wenye Sonarr, Radarr na mteja wa kupakua ni mahali ambapo nadharia hii inakuwa vitendo. Mteja wa kupakua huandika faili iliyokamilika kwenye /data/downloads. Kisha Sonarr hufanya hardlink au kuhamisha faili hiyo kwenda /data/media. Ili hardlink ifanye kazi, kontena zote mbili zinahitaji ruhusa ya kuandika kwenye saraka hiyo hiyo. Ikiwa mteja wa kupakua anaendeshwa kama 1000 wakati Sonarr anaendeshwa kama 1001 bila ruhusa za pamoja za kundi, mmoja wao anamiliki faili ambazo mwingine anaweza kuzisoma tu.
Suluhisho ni kundi la pamoja ambalo kila kontena kwenye mfumo huo hutumia kama PGID yake:
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 ya mwanzo katika 2775 ni setgid bit. Kwenye saraka, inamaanisha kila faili mpya na saraka ndogo inayoundwa ndani yake hurithi kundi media badala ya kundi kuu la muundaji. Hivyo, mpangilio huu hudumu kwa vipakuliwa vipya bila wewe kurudia chown. Ondoka kwenye mfumo na uingie tena, au endesha newgrp media, kabla ya kukagua ufikiaji wako: kundi lililoongezwa kwa usermod -aG halionekani kwenye kipindi cha shell kilicho wazi tayari.
Ndani ya kontena, groupmod -o -g 13000 abc hubadilisha namba ya kundi abc kuwa 13000, ili abc iandike kwa GID sawa na kundi lako la media kwenye host. Kila kontena la linuxserver linalofikia saraka hii huhifadhi PUID yake na kushiriki PGID hiyo moja. Hii inajumuisha kontena zilizo chini zaidi kwenye mnyororo ambazo husoma tu maktaba iliyokamilika, kama vile Jellyfin yenyewe. Front end kama Halcyon, inayohudumia maktaba hiyo kama duka la video la miaka ya 90 linaloweza kuvinjariwa, huunganishwa na Jellyfin kupitia HTTP kwa kutumia HALCYON_JELLYFIN_URL; usakinishaji wake wa kawaida hauhitaji PGID ya media ya pamoja wala mount ya saraka ya media.
Kisha weka UMASK=002 kwenye kila kontena la linuxserver kwenye mfumo huo. Hii ni hatua ambayo watu husahau. Ikiachwa bila kuwekwa, programu huhifadhi umask iliyorithi isipokuwa kitu kingine kibadilike, na thamani ya mfano inayoonyeshwa kwenye README za image ni UMASK=022. Kwa umask ya 022, programu inayoomba 0666 kwa faili mpya hupata 0644 wakati hakuna ACL chaguo-msingi: kundi lingine bado linaweza kuisoma lakini haliwezi kuibadilisha, jambo ambalo huharibu sehemu kubwa ya ushirikiano uliosanidi. Kwa 002 na bila ACL chaguo-msingi, programu inayoomba 0666 ya kawaida kwa faili na 0777 kwa saraka hupata faili za 0664 na, ndani ya saraka ya setgid, saraka za 2775, na kundi linaweza kuandika. Umask huondoa bits pekee, kwa hivyo programu inayoomba 0600 bado hupata 0600, na saraka yenye ACL chaguo-msingi hupuuza umask kabisa. Ongeza kigezo hiki kando ya PUID na 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-stoppedThamani hizo mbili ni za faili ya .env kando ya faili ya Compose, ili mfumo mzima usome ufafanuzi mmoja:
PUID=1000
PGID=13000Compose husoma faili hiyo kiotomatiki kwa ajili ya uingizwaji wa mtindo wa ${PUID}, ambao ni utaratibu uleule unaotumia kwa vitambulisho. Mazoea ya kuhifadhi thamani nje ya docker-compose.yml na ndani ya faili ya .env yanatumika hapa pia, kwa tofauti kwamba namba hizi mbili si siri.
Thibitisha kuanzia mwanzo hadi mwisho badala ya kuamini usanidi. Andika faili mpya kama mtumiaji wa programu, ukitumia umask iliyosanidiwa, na uisome kutoka kwa host. Tumia jina la faili la majaribio ambalo halipo tayari:
docker exec --user abc sonarr sh -c 'umask "$UMASK" && touch /data/downloads/permtest'
ls -ln /srv/media/downloads/permtestMatokeo mazuri yanaonyesha PUID yako kama mmiliki, 13000 kama kundi, na -rw-rw-r-- kama mode. Ikiwa kundi linasoma 1000, endesha ls -ldn /srv/media/downloads: aidha setgid bit (s katika drwxrwsr-x) haipo kwenye saraka hiyo, au saraka yenyewe bado ni ya kundi 1000 badala ya media, na amri za chown na chmod 2775 hapo juu hurekebisha yote mawili. Ikiwa mode inasoma -rw-r--r--, kagua thamani ya UMASK ya kontena na ACL chaguo-msingi ya saraka; unda upya kontena ikiwa mazingira yake yamepitwa na wakati. Jaribio hili hukagua uundaji kama abc na mask iliyosanidiwa; mode ya uundaji ya programu yenyewe na umask inayofanya kazi bado huamua faili zake. Ondoa faili ya majaribio kwa rm /srv/media/downloads/permtest ukimaliza.
Ni picha zipi zinazotumia vigezo vipi
Picha za linuxserver.io hutumia PUID, PGID na UMASK. Paperless-ngx hutumia majina tofauti kwa dhana hiyo hiyo: USERMAP_UID na USERMAP_GID, zote zikiwa na thamani chaguo-msingi ya 1000, na nyaraka zake zinakuelekeza kuzisoma kutoka id -u na id -g. Seva za picha zinaonyesha tofauti kama hizo: PhotoPrism ina jozi yake ya PHOTOPRISM_UID na PHOTOPRISM_GID, wakati Immich haitoi chaguo sawa na inamuachia mtumiaji wa container kutumia ufunguo wa user: wa Docker, kwa hivyo kuchagua kati ya PhotoPrism na Immich pia huamua ni utaratibu upi kati ya hii utakaokuwa ukiusimamia kwa ajili ya maktaba kubwa zaidi kwenye seva yako. Picha nyingi rasmi za upstream, zikiwemo picha za kawaida za database na web server, huja na mtumiaji maalum aliyewekwa ndani na hutegemea utumie user: au uache kama ulivyo. Utekelezaji wa programu moja ndogo huibua swali hilo hilo, kwa hivyo unapoweka openGym workout tracker inayojiendesha mwenyewe inafaa kuangalia ni mtumiaji yupi ambaye container yake anatumia kabla ya kuelekeza bind mount kwake, kwa sababu saraka inayoshikilia database yake hurithi jibu hilo bila kujali kama umeweka PUID au la. Relay ya ufikiaji wa mbali iko katika kundi hilo hilo, kwa hivyo unapokuwa unaendesha seva yako ya RustDesk relay jozi ya ufunguo wa Ed25519 ambayo hbbs huandika wakati wa kuanza kwa mara ya kwanza hufika kwenye bind mount yako ikiwa inamilikiwa na mtumiaji yeyote ambaye picha hiyo iliishia naye. Unaweza kurekebisha hilo baadaye kwa kutumia chown ya upande wa host, au kuchagua utambulisho tangu mwanzo kwa kutumia ufunguo wa user:, kwa sababu picha hiyo haiweki mtumiaji wake yeyote, mradi saraka iliyopachikwa iweze kuandikika na ID unayochagua. Hali hiyo inatumika kwa miundombinu unayoongeza baadaye, kwa hivyo kuweka Authentik mbele ya programu zako kwa ajili ya kuingia mara moja inamaanisha kuendesha picha rasmi za authentik na Postgres ambazo hazisomi PUID hata kidogo, na umiliki wa volume zao hutokana na watumiaji ambao michakato yao huendeshwa nao na usanidi ambao entrypoints zao hufanya. Authentik iliondoa utegemezi wake wa Redis katika toleo la 2025.10.
Kwa hivyo kagua README ya kila picha kabla ya kunakili kizuizi cha mazingira kati ya miradi. Docker hupitisha kigezo chochote cha mazingira unachoweka kwenye container yoyote, bila kujali kama kitu kilicho ndani kinakisoma au la, na PUID ambayo hakuna kinachoitumia haitoi kosa, onyo, wala athari yoyote. Container huanza kama mtumiaji aliyeteuliwa na mpangilio wa user: wa Docker au Dockerfile, na entrypoint yake inaweza kisha kupunguza mamlaka kabla ya kuanza programu. Fanya usomaji huo kabla ya kuongeza kitu chochote kipya kwenye seva, ikiwa ni pamoja na stack ya usalama ya open-kritt inayojiendesha mwenyewe, ambapo faili ya Compose inakuambia kama picha hizo zinaheshimu PUID au kama umiliki wa saraka unazopachika umewekwa na picha hizo zenyewe.
FAQ
Kwa nini faili zangu za Docker zinamilikiwa na 911:911?
911 ni UID na GID ya mtumiaji abc aliyejengwa ndani ya picha (images) za linuxserver.io. Kuona namba hizi ni kawaida kwa sababu zinaendana na chaguo-msingi, lakini faili zinaweza kubaki na umiliki huo baada ya kubadilisha PUID na PGID ya container. ls -l huonyesha namba ghafi wakati hakuna akaunti kwenye host yako inayolingana na ID hizo, kwa hivyo hakuna jina la kuonyesha. Weka PUID na PGID ziwe sawa na matokeo ya id, tengeneza upya container kwa kutumia docker compose up -d, kisha rekebisha faili zilizopo kwa kutumia sudo chown -R 1000:1000 kwenye saraka husika.
Je, PUID na PGID hufanya kazi kwenye kila picha ya Docker?
Hapana. Hizi si kipengele cha Docker na Docker haizisomi kamwe. Hufanya kazi tu kwenye picha ambazo entrypoint yake inazisoma na kuita usermod na groupmod kabla ya kuanzisha programu, kama ilivyo kwa familia ya linuxserver.io na miradi michache iliyonakili mfumo huo. Miradi mingine hutumia majina tofauti, kama vile USERMAP_UID na USERMAP_GID katika paperless-ngx. Kwenye picha isiyosoma yoyote kati ya hizo, vigezo (variables) hivyo hukubaliwa na kupuuza bila onyo lolote.
Je, nitumie PUID na PGID au ufunguo wa user: katika Docker Compose?
Tumia PUID na PGID wakati picha inazikubali, kwa sababu entrypoint bado huendeshwa kama root kwa muda wa kutosha kurekebisha /config na kuanzisha huduma zake kwa usahihi. Tumia user: wakati picha inaelekeza kuwa inasaidia mtumiaji uliyemchagua; kukosa msaada wa PUID pekee hakumaanishi kuwa entrypoint yake inafanya kazi bila root. Kwenye picha ya linuxserver, kuweka user: hufanya PUID na PGID kutofanya kazi, husimamisha Docker Mods na huduma maalum zisifanye kazi, na hufanya ruhusa za kila volume iliyopachikwa (mounted) kuwa jukumu lako.
Sonarr ina PUID sahihi lakini bado haiwezi kuhamisha faili. Nini tatizo?
Angalia mambo matatu kwa mpangilio. Kwanza, mount ya media yenyewe: hati ya usanidi wa mtumiaji ya picha ya msingi hufanya chown kwenye /app, /config na /defaults, kwa hivyo /data au /downloads hubaki na umiliki wowote ilionao kwenye host. Pili, kundi lililoshirikiwa (shared group): wape containers zinazofikia mti wa media (media tree) PGID sawa na ruhusa za kuandika za kundi (group write permissions). Tatu, umask: umask ya 022 hutoa faili za 0644 wakati programu inaomba 0666 na hakuna default ACL inayotumika, kwa hivyo containers nyingine kwenye kundi zinaweza kuzisoma lakini haziwezi kuzibadilisha. Kuacha UMASK bila kuwekwa hakuhakikishi mask au file mode fulani. Weka UMASK=002 na uweke setgid bit kwenye saraka kwa kutumia chmod 2775 ili faili mpya zirithi kundi hilo. Programu inayoomba 0600 bado hutengeneza faili za faragha, na default ACL hubadilisha jinsi ruhusa za utengenezaji zinavyotolewa.