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 baadhi ya picha za kontena (container images) husoma wakati wa kuanza. Docker yenyewe haviangalii kamwe. Hii ni kawaida inayotumiwa 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. Kontena huanza kama root, huendesha hati zake za kuanzisha (init scripts), na mojawapo ya hati hizo hubadilisha namba ya mtumiaji huyo kabla ya jambo lingine lolote kutokea:
groupmod -o -g "${PGID}" abc
usermod -o -u "${PUID}" abcBendera ya -o inaruhusu ID ambayo tayari inatumiwa mahali pengine. Baada ya hapo, mchakato wa kuanzisha huacha mamlaka ya juu (drop privileges) na kuendesha programu kama abc. Kwa hivyo, Docker hupitisha PUID=1000 ndani ya kontena kama kigezo kingine chochote cha mazingira na haichukui hatua yoyote juu yake. Kigezo hiki hubadilisha namba ya mtumiaji ndani ya kontena kabla ya programu kuanza, jambo linalomaanisha kuwa kwenye daemon ya kawaida ya rootful, kila faili inayoandikwa na programu hiyo huhifadhiwa kwenye diski yako ikiwa inamilikiwa na 1000. Rootless Docker hubadilisha namba hiyo, kama ilivyoelezwa hapa 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 ni PUID yako na gid ni PGID yako. Kwa ajili ya hati (script), id -u na id -g huchapisha namba hizo pekee. Kwenye mifumo mingi mipya ya VPS, akaunti ya kwanza ya binadamu huwa 1000:1000, lakini usikubali hilo bila kuthibitisha. Seva iliyojengwa upya, au akaunti ya pili iliyoongezwa baadaye, hutoa 1001 au zaidi, na namba isiyo sahihi hapa ndiyo chanzo cha hitilafu nzima. Ikiwa huduma zako zinaendeshwa chini ya akaunti maalum ya huduma badala ya akaunti yako ya kawaida ya kuingia, tekeleza id thatuser na uchukue namba kutoka hapo.
Kwa nini faili zako zinaonekana kama 911:911
ls -l huchapisha namba ya kitambulisho (ID) badala ya jina wakati hakuna akaunti ya seva inayolingana na ID hiyo. Hakuna kitu kwenye seva yako chenye UID 911, kwa hivyo 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 yanaonyesha kuwa container iliendeshwa kwa kutumia mipangilio chaguo-msingi iliyojengwa ndani. config.xml katika orodha hiyo pia ndiyo faili inayohifadhi mipangilio ya uthibitishaji, jambo ambalo ni muhimu wakati unafungua web UI kwa mara ya kwanza na kugundua kuwa Sonarr na Radarr haziji na jina la mtumiaji au nenosiri chaguo-msingi. 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 kama mistari miwili:
User UID: 911
User GID: 911Ikiwa mistari hiyo inasoma 911 baada ya kuweka PUID=1000 kwenye faili yako ya Compose, container inayofanya kazi 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 kusoma pekee (read-only) au isiyo ya root, init huruka ubadilishaji wa namba kabisa na kuchapisha ID isiyobadilishwa ya abc, ingawa variable hiyo ipo ndani ya container.
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 faili zilizopo kwenye diski. 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 mfululizo wa makosa mengine ya kutatanisha.
Mambo ambayo PUID na PGID hayatatui
Hii ndiyo sehemu inayowatatiza watu waliofanya kila kitu kwa usahihi. Script ya kuanzisha ya linuxserver hufanya chown kwenye njia tatu pekee 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 kwenye import ya kwanza.
Hiyo ndiyo tabia sahihi. Kufanya chown ya kurudia 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. 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 lililounganishwa kwenye ntfy kwenye VPS yako mwenyewe, inayotuma arifa kwenye simu yako ni njia rahisi ya kupata taarifa kuhusu hilo kabla ya wiki nzima ya vipindi vilivyokosekana haijakupa jibu.
Njia tatu za kudhibiti mtumiaji, na wakati wa kutumia kila moja
Variable za mazingira za PUID na PGID
Hii inafanya kazi tu kwenye image ambazo entrypoint yake inazisoma. Ni maarufu kwa sababu container bado huanza kama root, hufanya usanidi wake, hurekebisha /config, na ndipo hupunguza mamlaka. Docker Mods na hati za init za kawaida huendelea kufanya kazi. Gharama yake ni kwamba unategemea makubaliano badala ya kipengele cha jukwaa, na majina ya variable hayafanani katika miradi yote.
Ufunguo wa user: katika Compose
Hii ni kipengele halisi cha Docker na inafanya kazi kwenye kila image, kwa sababu runtime ya container inaitumia 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 inavunja chochote katika entrypoint kilichohitaji root. Kwenye image za linuxserver, mradi huu unaunga mkono hili kwa kadiri ya uwezo wake na kwa image zilizojaribiwa tu, na tahadhari zake ni mahususi: PUID na PGID huacha kuwa na athari yoyote, Docker Mods hazitaendeshwa, huduma za kawaida hazitaendeshwa, na unawajibika kwa ruhusa za kila volume iliyopachikwa (mounted). Muundo wao uliothibitishwa huoanisha flag hiyo na /run inayoweza kuandikika:
user: 1000:1000
tmpfs:
- /run:uid=1000,gid=1000,exec
security_opt:
- no-new-privileges=trueAthari moja ya kijuu-juu huwashangaza watu. user: ya namba ambayo haina ingizo linalolingana katika /etc/passwd ya container huwafanya zana za ndani kuripoti whoami: cannot find name for user ID 1000. ID hiyo ni sahihi 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 mamlaka ya juu, kwa hivyo hakuna kitu kwenye seva kinachoendeshwa kama root halisi. Inabadilisha hesabu ya umiliki kabisa. UID 0 ya container inalingana na UID ya mwenyeji (host) ya mtumiaji anayeendesha rootless Docker, na UID n ya container kwa n yoyote ya 1 au zaidi inalingana na subuid + (n - 1), ambapo subuid ni msingi wa masafa yaliyotengwa kwako katika /etc/subuid na /etc/subgid. Docker inatarajia angalau ID 65,536 ndogo hapo.
Soma ramani hiyo tena, kwa sababu inageuza ushauri wa kawaida. Chini ya rootless Docker, container inayoandika kama root hutengeneza faili zinazomilikiwa na wewe. Container inayoandika kama UID 1000 hutengeneza faili zinazomilikiwa na ID ndogo mahali fulani karibu na 100999, ambayo shell yako haiwezi kuigusa. Kwa hivyo thamani ya PUID ambayo ni sahihi kwenye daemon ya rootful ni ile isiyo sahihi hapa. Mifumo hii miwili hutatua tatizo moja katika matabaka tofauti, na kuyaweka pamoja bila kukagua ndivyo watu wanavyojikuta na saraka wanayohitaji sudo ili kuifuta. Ikiwa utatumia rootless, jaribu umiliki wa faili moja iliyoandikwa kwenye seva yako mwenyewe kabla ya kuhamishia 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 zilivyojengwa na kuandikiwa nyaraka. Tumia user: wakati README ya image inasema kuwa image hiyo imejaribiwa kwa ajili yake, au wakati unaendesha image rasmi ya upstream ambayo haina msaada wa PUID kabisa. 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 ya database yake na faili zilizopakiwa huamuliwa na runtime badala ya kitu chochote kilicho kwenye block ya mazingira. Hali hiyo ni kweli pia 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 hiyo tayari inaendeshwa kama yeye. Hakuna hata moja ya hayo yanayobadilika kwa stack mpya pia, kwa hivyo kumpa kila mtu kwenye timu wakala wao wa OneCLI uliotengwa huacha saraka za kazi za kila mtu na saraka ya data ya Postgres zikimilikiwa na mtumiaji ambaye kila image tayari inaendeshwa kama yeye, jambo linalolifanya kuwa tatizo la user: na chown badala ya tatizo la PUID. Weka API moja iliyojiendesha mbele ya Codex, Claude Code na Hermes na utarithi mpangilio uleule, kwa sababu image hiyo inaendeshwa kama mtumiaji wake wa ndani na bind mount inayoshikilia database yake na funguo zilizohifadhiwa huchukua umiliki wowote ambao mtumiaji huyo huleta nayo.
Kisa cha media stack: kundi moja linaloshirikiwa kati ya container
Arr media stack yenye Sonarr, Radarr na download client ni mahali ambapo nadharia hii inakuwa uhalisia. Download client huandika faili iliyokamilika ndani ya /data/downloads. Kisha Sonarr hufanya hardlink au kuhamisha faili hiyo kwenda /data/media. Ili hardlink ifanye kazi, container zote mbili zinahitaji ruhusa ya kuandika kwenye tree hiyo hiyo. Ikiwa download client inafanya kazi kama 1000 wakati Sonarr inafanya kazi kama 1001, mmoja wao atamiliki faili ambazo mwenzake anaweza kuzisoma tu.
Suluhisho ni kundi (group) moja linaloshirikiwa ambalo kila container kwenye stack hiyo inalitumia 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 directory, inamaanisha kila faili mpya na subdirectory inayotengenezwa ndani yake hurithi kundi media badala ya kundi kuu la mtumiaji aliyetengeneza faili hiyo. Hivyo, mpangilio huu hudumu hata kwa download mpya bila wewe kurudia kuendesha chown. Ondoka kwenye mfumo (log out) na uingie tena, au endesha newgrp media, kabla ya kukagua ruhusa zako: kundi lililoongezwa kwa usermod -aG halionekani kwenye shell session iliyo wazi tayari.
Ndani ya container, groupmod -o -g 13000 abc hubadilisha namba ya kundi abc kuwa 13000, ili abc iandike kwa kutumia GID sawa na kundi lako la media kwenye host. Kila container kwenye stack huweka PUID yake yenyewe na kushiriki PGID moja. Hii inajumuisha container zilizopo chini zaidi kwenye mnyororo ambazo husoma tu library iliyokamilika, kama vile Jellyfin yenyewe na front ends ambazo watu huziongeza kama Halcyon, inayohudumia library hiyo kama duka la video la miaka ya 90 linaloweza kuvinjariwa.
Kisha weka UMASK=002 kwenye kila container ya linuxserver katika stack hiyo. Hii ndiyo hatua ambayo watu husahau. Ikiachwa bila kuwekwa, image hizo hazitumii umask wowote wa kwazo, kwa hivyo programu huendelea kutumia umask wowote iliorithi, na thamani ya mfano inayotolewa kwenye README za image hizo ni UMASK=022. Umask wa 022 huondoa ruhusa ya kuandika ya kundi (group write bit), kwa hivyo faili huwekwa kama 0644: kundi lingine linaweza kuzisoma lakini haliwezi kuzibadilisha, jambo ambalo huharibu sehemu kubwa ya ushirikiano uliosanidi. Kwa 002, programu inayoomba 0666 ya kawaida kwa faili na 0777 kwa directory hupata faili za 0664 na, ndani ya tree yenye setgid, directory za 2775, na kundi linaweza kuandika. Umask huondoa bits pekee, kwa hivyo programu inayoomba 0600 bado hupata 0600, na directory yenye default ACL hupuuza umask kabisa. Ongeza variable hiyo karibu na 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 iliyo karibu na faili ya Compose, ili stack nzima isome ufafanuzi mmoja:
PUID=1000
PGID=13000Compose husoma faili hiyo kiotomatiki kwa ajili ya uingizwaji wa mtindo wa ${PUID}, ambao ni utaratibu uleule unaotumia kwa ajili ya credentials. Mazoea ya kueka thamani nje ya docker-compose.yml na ndani ya faili ya .env yanatumika hapa pia, isipokuwa namba hizi mbili si siri.
Thibitisha kuanzia mwanzo hadi mwisho badala ya kuamini usanidi tu. Andika faili kutoka ndani ya container moja na uisome kutoka kwenye host:
docker exec sonarr touch /data/downloads/permtest
ls -ln /srv/media/downloads/permtestMatokeo mazuri yataonyesha 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 (ile s katika drwxrwsr-x) haipo kwenye directory hiyo, au directory 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--, basi variable ya UMASK haikufanya kazi, kwa hivyo hakikisha umetengeneza upya container badala ya kuianzisha upya (restart). Ondoa faili ya majaribio kwa rm /srv/media/downloads/permtest utakapomaliza.
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 hiyo: PhotoPrism ina jozi yake yenyewe 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 seva za wavuti, huja na mtumiaji aliyewekwa ndani yake na hutegemea utumie user: au uachane nayo. Utekelezaji wa programu moja ndogo huibua swali hilo hilo, kwa hivyo unapoweka openGym workout tracker inayojiendesha inafaa kuangalia ni mtumiaji yupi ambaye container yake inatumia 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 huangukia katika kundi hilo hilo, kwa hivyo unapoendesha seva yako ya relay ya RustDesk jozi ya funguo za Ed25519 ambazo 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 mapema kwa kutumia ufunguo wa user:, kwa sababu picha hiyo haiweki mtumiaji wake yeyote, mradi tu saraka iliyopachikwa iweze kuandikika na ID unayochagua. Hali hiyo hiyo inatumika kwa miundombinu unayoongeza baadaye, kwa hivyo kuweka Authentik mbele ya programu zako kwa ajili ya login moja inamaanisha kuendesha picha rasmi za seva, Postgres na Redis ambazo hazisomi PUID hata kidogo, na umiliki wa volume zao hutokana na runtime badala ya entrypoint unayoweza kusanidi.
Kwa hivyo kagua README ya kila picha kabla ya kunakili block ya 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 kitu kinachoitumia haitoi kosa, onyo wala athari yoyote. Container huendeshwa kama mtumiaji yeyote ambaye Dockerfile yake iliishia naye, na unagundua hilo kupitia umiliki wa faili inazoandika. Fanya usomaji huo kabla ya kuongeza kitu chochote kipya kwenye seva, ikiwemo stack ya open-kritt ya kuchanganua usalama inayojiendesha, 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 zina umiliki wa 911:911?
911 ni UID na GID ya mtumiaji abc aliyejengwa ndani ya image za linuxserver.io. Kuona namba hizi inamaanisha kuwa container ilianza bila PUID na PGID kuwekwa, kwa hivyo hati yake ya kuanzia (init script) iliacha mipangilio chaguo-msingi iliyokuwepo. ls -l huonyesha namba ghafi kwa sababu hakuna akaunti kwenye host yako yenye ID 911, 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 image ya Docker?
Hapana. Sio kipengele cha Docker na Docker haisomi vigezo hivyo. Hufanya kazi tu kwenye image ambazo entrypoint yake inavisoma na kuita usermod na groupmod kabla ya kuanzisha programu, kama ilivyo kwa familia ya linuxserver.io na miradi michache iliyonakili muundo huo. Miradi mingine hutumia majina tofauti, kama vile USERMAP_UID na USERMAP_GID katika paperless-ngx. Kwenye image isiyosoma vigezo hivyo, variables hizo hukubaliwa lakini hupuuzwa bila onyo lolote.
Je, nitumie PUID na PGID au ufunguo wa user: katika Docker Compose?
Tumia PUID na PGID wakati image inavisaidia, kwa sababu entrypoint huendelea kufanya kazi kama root kwa muda wa kutosha kurekebisha /config na kuanzisha huduma zake kwa usahihi. Tumia user: wakati image haina msaada wa PUID, au wakati README ya image inasema kuwa imefanyiwa majaribio ya kufanya kazi bila root. Kwenye image ya linuxserver, kuweka user: hufanya PUID na PGID kutofanya kazi, husimamisha Docker Mods na huduma maalum zisifanye kazi, na kukufanya uwe na jukumu la vibali vya kila volume iliyopachikwa (mounted).
Sonarr ina PUID sahihi lakini bado haiwezi kuhamisha faili. Nini tatizo?
Angalia mambo matatu kwa mpangilio. Kwanza, mount ya media yenyewe: init hufanya chown kwa /app, /config na /defaults pekee, kwa hivyo /data au /downloads hubaki na umiliki wowote ilionao kwenye host. Pili, kundi lililoshirikiwa (shared group): ikiwa mteja wa kupakua (download client) na Sonarr vinafanya kazi chini ya GID tofauti, hakuna kinachoweza kurekebisha faili za mwenzake, kwa hivyo wape kila container kwenye stack hiyo PGID moja. Tatu, umask: ikiwa UMASK haijawekwa au imewekwa kuwa 022, faili mpya huja kama 0644 bila ruhusa ya kuandika kwa kundi (group write bit), kwa hivyo container nyingine kwenye kundi hilo zinaweza kuzisoma lakini haziwezi kuzirekebisha. Weka UMASK=002 na uweke setgid bit kwenye saraka kwa kutumia chmod 2775 ili faili mpya zirithi kundi hilo.