SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor · Imeboreshwa 2026-10-26

Jinsi ya ku-self-host open-kritt kwenye VPS

Jifunze kuendesha open-kritt kwa Docker Compose kwenye VPS. Pata mwongozo wa kubandika toleo, kutumia SSH tunnel kwa port 5173, na kuweka bajeti kabla ya scan ya kwanza.

Kwa nini u-self-host open-kritt kwenye VPS badala ya laptop yako

Self-host open-kritt kwenye seva unayoweza kuifuta na kuijenga upya. Zana hii huendesha mawakala wake wa uchanganuzi kama root ndani ya kontena za muda za kazi, huipa kila moja nakala inayoweza kuandikwa ya msimbo wako na ufikiaji wa moja kwa moja wa Internet, na hu-mount Docker socket ya mwenyeji kwenye huduma yake ya injini. Huo ni uamuzi wa busara kwenye mashine iliyotengwa kwa ajili ya kazi hiyo. Ni uamuzi mbaya kwenye mashine inayohifadhi funguo zako za SSH.

Sifa nne za usanidi chaguo-msingi ndizo zinazosababisha ushauri huo, na zote nne zinatoka kwenye README na faili ya compose ya mradi wenyewe.

Mawakala wamekusudiwa kuwa na nguvu. README inasema mawakala walio na uwezo wa kutumia zana huendeshwa kama root ndani ya kontena za muda za kazi, wakiwa na nakala za hazina zinazoweza kuandikwa na ufikiaji wa moja kwa moja wa Internet, ili waweze kusakinisha zana, kukusanya malengo, kuendesha majaribio, na kujenga uthibitisho wa dhana. Uchanganuzi si linter inayosoma faili tu. Ni utekelezaji wa msimbo wa kiholela ambao wewe mwenyewe umeuomba. Ufikiaji huo wa Internet una pande mbili: chochote ambacho wakala huchota wakati wa kutafiti lengo ni maandishi yasiyoaminika yanayoingia kwenye prompt yake, hatari ileile unayokabiliana nayo unapompa wakala uwezo wa kutafuta kwenye wavuti.

Injini inashikilia Docker socket. docker-compose.yml hu-mount Docker socket ya mwenyeji kwenye huduma ya injini, kwa sababu injini hujenga na kuzindua kontena moja la uchanganuzi kwa kila kazi. Mchakato wowote unaoweza kufikia socket hiyo unaweza kuanzisha kontena inayoweza ku-mount mfumo wa faili wa mwenyeji. Kwa hivyo, injini kimsingi ni root kwenye mwenyeji wowote unaoiendesha.

Hakuna skrini ya kuingia. Backend inatolewa bila uthibitishaji wa programu. Ufikiaji wa port ni ufikiaji wa matokeo yako na mkopo wako wa mtoa huduma.

Msimbo unaouchanganua mara nyingi si wako. Kuelekeza mawakala kwenye hazina ya mtu mwingine kunamaanisha kuendesha ujenzi wa hazina hiyo kwenye mashine yako, kama root, na ufikiaji wa mtandao.

Ikiwa umesoma kwa nini mawakala wa uandishi wa msimbo wanapaswa kuwa kwenye VM ya muda, huu ni mfano wa tishio uleule, lakini ukiwa na nguvu zaidi. Ipe open-kritt VPS isiyo na kitu kingine chochote, na uendeshe VPS hiyo kutoka kwa akaunti tofauti ya mtumiaji yenye upendeleo mdogo badala ya root.

Kile ambacho open-kritt hufanya kwa hakika

open-kritt (repostiory yake ni Kritt-ai/open-kritt, yenye leseni ya AGPL-3.0) hugawanya utafiti wa udhaifu (vulnerability research) katika kazi ndogo, huendesha kazi hizo kupitia mawakala wa AI (AI agents) kwa sambamba, kisha huondoa nakala rudufu na kupanga matokeo yaliyopatikana. Unafafanua mtiririko wa kazi (workflow) kama mnyororo wa maelekezo (prompts) yaliyolenga lengo mahususi, na kila hatua hupokea muktadha uliopangwa kutoka kwa hatua zilizotangulia. Lengo la skani ni repository ya git ya mbali au ya ndani. Injini ya uchambuzi ni Codex au Claude Code. Baada ya mgombea (candidate) kujitokeza, hati za hiari za baada ya uchambuzi (post-scripts) zinaweza kujaribu kuhalalisha au kuunda uthibitisho wa dhana (proof of concept). Kubuni mnyororo huo ni kazi ya kawaida ya mawakala badala ya kazi ya usalama, kwa hivyo ikiwa maelekezo, zana, na upitishaji wa muktadha bado ni mambo mapya kwako, kujifunza jinsi mawakala wanavyounganishwa kutakupa matokeo bora zaidi kuliko mpangilio wowote katika mwongozo huu.

Unachopata mwishoni ni orodha iliyopangwa ya wagombea. Ichukulie kama foleni ya triage, si kama ripoti.

Unachohitaji kabla ya kuanza

  • VPS inayoendesha Ubuntu 24.04, Debian 12 au Rocky Linux 9. Nyaraka za usakinishaji zinaorodhesha mifumo hiyo kama iliyojaribiwa, kwenye x86_64 na ARM64.
  • Docker Engine pamoja na Compose plugin.
  • Node.js 20 au mpya zaidi kwenye host, kwa sababu ./kritt CLI huendeshwa kwenye host badala ya ndani ya container.
  • Mtoa huduma mmoja wa model: akaunti ya Codex, au OPENAI_API_KEY, CODEX_API_KEY, ANTHROPIC_API_KEY au OPENROUTER_API_KEY.
  • GITHUB_TOKEN ikiwa tu unapanga kuchanganua hazina (repositories) za faragha. .env.example iliyosafirishwa inasema wazi: token ya GitHub pekee haiwezi kuendesha uchanganuzi.

Sakinisha Docker na Node 20 kwanza

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

Ondoka kwenye mfumo (log out) na uingie tena ili uanachama wa kundi jipya uanze kufanya kazi, kisha thibitisha kuwa Compose plugin inapatikana.

docker compose version

Mfuatano wa herufi za toleo (version string) unamaanisha kuwa Compose imesakinishwa kama plugin. docker: 'compose' is not a docker command inamaanisha kuwa una binary ya zamani ya pekee ya docker-compose, na open-kritt inaita docker compose. Uanachama wa kundi la docker ni sawa na kuwa root kwenye seva, kwa hivyo weka akaunti inayotumia open-kritt pekee kwenye kundi hilo. Kwa maelezo zaidi ya usanidi huo, angalia kuendesha Docker kwenye VPS.

Ubuntu 24.04 inakuja na Node 18 katika hazina zake (repository), na CLI inakataa toleo lolote chini ya 20. Node 20 yenyewe imefikia mwisho wa maisha yake na haipokei tena masasisho, kwa hivyo sakinisha Node 22 kutoka NodeSource. Inakidhi mahitaji yaleyale ya ukaguzi wa toleo la 20 au zaidi.

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v

node -v lazima ichapishe v22. hapa, na toleo lolote chini ya v20. litakataliwa na CLI. Kwenye Rocky Linux 9, hatua inayolingana na hii ni sudo dnf module enable nodejs:22 -y ikifuatiwa na sudo dnf install -y nodejs.

Clone open-kritt na uweke alama kwenye release iliyochaguliwa

git clone https://github.com/Kritt-ai/open-kritt
cd open-kritt
git fetch --tags
git tag --list
git checkout v1.4.1

main husogea kufuata wewe. Tag haisogei. Kufikia tarehe 12 Oktoba 2026, tag mpya zaidi ni v1.4.1, iliyochapishwa tarehe 16 Agosti 2026, na git tag --list inaonyesha kilichopo siku unayofanya clone. v1.4.0 (12 Agosti 2026) iliongeza runner admission inayotambua kumbukumbu (memory-aware) iliyoelezwa chini ya sehemu ya sizing, na v1.4.1 ilirekebisha mdudu (bug) ambapo ranker ilipuuza sheria za ranking zilizotolewa na mtumiaji. Kufanya checkout ya tag huacha repository katika hali ya detached HEAD, jambo ambalo ni sahihi hapa: unachukulia clone hii kama deployment iliyofungwa (pinned), si kama branch unayofanyia commit. Ili kupandisha toleo (upgrade) baadaye, soma maelezo ya release, kisha endesha git fetch --tags, fanya checkout ya tag mpya, na uendeshe ./kritt start tena, kwa sababu start hujenga upya images.

Usiendeshe ./kritt ukiwa na sudo. Nyaraka ziko wazi kuhusu hili. CLI husimamia saraka za vitambulisho (credential directories) za mradi ndani ya .data/, kwa hivyo ukiendesha kama root, saraka hizo zitamilikiwa na root na uendeshaji wa kawaida unaofuata hautaweza kuziandikia.

Sanidi ufikiaji wa modeli kwa kutumia ./kritt setup

./kritt setup

Amri hii hutengeneza .env kutoka kwa .env.example pale ambapo haipo, huchapisha hali ya kila kitambulisho (credential), na hukuruhusu kukisanidi au kukiondoa. Haiwahi kuchapisha thamani hizo kwenye terminal. Faili zote mbili, .env na faili ya kitambulisho cha injini, huandikwa kwa mode 0600.

Ikiwa unapendelea kufanya hivyo kwa mikono:

cp .env.example .env
chmod 600 .env
mkdir -p .data/codex
chmod 700 .data/codex

Kisha hariri ufunguo wa mtoa huduma (provider key) ndani ya .env na uache faili hiyo ikiwa katika mode 0600. Kwa njia yoyote ile, kitambulisho cha mtoa huduma kinachofanya kazi sasa kipo kwenye seva hiyo, jambo ambalo ni sababu nyingine kwa nini seva hiyo haipaswi kuwa na kitu kingine chochote. Tengeneza ufunguo kwa ajili ya mradi huu pekee, ili kuufuta baadaye kusiathiri chochote unachokijali. Kuweka siri mbali na mawakala wa AI kunashughulikia tabia hii kwa mapana zaidi.

Weka kikomo cha matumizi kwa mtoa huduma kabla ya scan ya kwanza

open-kritt imeundwa kufanya kazi kwa mtindo wa fan-out, na wewe ndiye unayelipia kazi hiyo ya fan-out. Mipangilio chaguo-msingi katika .env.example kwenye toleo la v1.4.1 ni ya tahadhari: ENGINE_WORKER_COUNT=2, ambayo imefafanuliwa kwenye faili kama chaguo-msingi la tahadhari kwa mashine ndogo ya 2-vCPU, na ENGINE_MAX_CONCURRENT_SCANS=1. Juu ya hayo kuna ENGINE_WORKERS_PER_ACCOUNT=15, idadi ya juu zaidi ya miito ya root model inayoweza kufanyika kwa wakati mmoja kwenye akaunti ya mtoa huduma, na ENGINE_CODEX_MAX_SUBAGENTS_PER_SESSION=5, kwa sababu kipindi cha Codex kinaweza kuendesha hadi mawakala watano (child agents). Ongeza idadi ya wafanyakazi (worker count) kwenye VPS kubwa zaidi na idadi ya miito ya model inayotekelezwa itaongezeka sambamba na hiyo.

Hakuna chochote katika hazina (repository) kinachoweka kikomo cha kile unachotumia. Hakuna mpangilio wa bajeti katika .env.example. Masharti ya kusimamisha injini hiyo ni mipaka hiyo ya wafanyakazi pamoja na ENGINE_HARNESS_TIMEOUT_SECONDS, ambayo chaguo-msingi lake ni sekunde 7200 kwa kila mzunguko wa harness. Harness hapa ni kitanzi kinachoendelea kuita model kwa kutumia zana na muktadha hadi kitu fulani kimalize mzunguko huo, kwa hivyo muda huo wa timeout ni kipimo cha saa kwenye programu iliyofungwa kuzunguka model na si kikomo cha kile ambacho model inatumia ndani yake. Kwa hivyo, kikomo cha juu lazima kiwekwe kwa mtoa huduma. Fungua dashibodi ya mtoa huduma wako na uweke kikomo cha juu cha kila mwezi kabla ya scan ya kwanza, si baada yake. Kudhibiti gharama za wakala wa AI kwenye VPS inaelezea hatua kwa hatua mipangilio ya kila mtoa huduma.

Kuna breki ya ndani pia. Kuweka ENGINE_WORKER_COUNT=0 husitisha uchukuaji wa kazi mpya, na thamani zilezile za wafanyakazi zinaweza kubadilishwa katika skrini ya Settings mara tu stack inapokuwa inaendeshwa.

Mwongozo huu hautoi bei kwa kila scan, kwa sababu gharama inategemea ukubwa wa repository, mtiririko wa kazi unaojenga, na model iliyo nyuma yake. Endesha scan moja dhidi ya repository moja ndogo, kisha soma ukurasa wa matumizi wa mtoa huduma wako kabla ya kuielekeza kwenye kitu chochote kikubwa.

Anzisha stack na uhakikishe kuwa iko sawa

./kritt start

Hiyo hukagua .env na angalau kitambulisho kimoja, kisha huendesha docker compose up --build. Build ya kwanza ni ya polepole, kwa sababu inajenga images za frontend, backend, engine, executor view na database. Pia inaendeshwa mbele (foreground), kwa hivyo kufunga session ya SSH kutasimamisha stack. Ianzishe ndani ya tmux, au iendeshe kwa nyuma (detached) baada ya build ya kwanza kufanikiwa. Hakuna kati ya hizo inayobaki ikiwa hai baada ya reboot, kwa hivyo ikiwa unataka stack iwake tena baada ya seva kuanza upya, muundo wa systemd unit katika kudumisha agent inayojiendesha wakati wa reboot unaweza kutumika moja kwa moja.

docker compose up -d --build
docker compose ps

docker compose ps inapaswa kuorodhesha open-kritt-frontend, open-kritt-backend, open-kritt-engine, open-kritt-executor-view na open-kritt-db. Kisha hakikisha kuwa backend inajibu kwenye seva yenyewe.

curl -s http://127.0.0.1:3002/api/health

Jibu la JSON linamaanisha kuwa backend iko juu. Failed to connect to 127.0.0.1 port 3002: Connection refused inamaanisha haiko juu, na docker compose logs backend itaeleza sababu. Simamisha kila kitu kwa kutumia docker compose down ukiwa ndani ya saraka ya repository.

Ziada moja ya hiari: docker compose exec backend npm run seed hupakia data ya demo, ambayo ni njia rahisi ya kuangalia interface kabla ya kutumia gharama yoyote kwa scan halisi.

Fikia UI kwenye port 5173 kupitia SSH tunnel

Kila huduma katika faili ya compose hufungwa kwenye 127.0.0.1 kwa chaguo-msingi: frontend kwenye 5173, backend kwenye 3002, executor view kwenye 8090 na Postgres kwenye 5432. Acha vifungo hivyo kama vilivyo na uelekeze port hiyo kupitia SSH kutoka kwenye mashine yako.

ssh -N -L 5173:127.0.0.1:5173 you@your-server-ip

Fungua http://localhost:5173 kwenye kivinjari chako cha ndani wakati amri hiyo ikiwa inaendelea. -N inamaanisha kuwa muunganisho hubeba uelekezaji (forward) na si shell. Ongeza -L 8090:127.0.0.1:8090 ya pili kwenye amri hiyo hiyo unapotaka pia kuona executor view.

Jaribu ni kuweka FRONTEND_BIND_ADDRESS=0.0.0.0 na kuruka hatua ya tunnel. Usifanye hivyo. Backend haina ukurasa wa kuingia (login screen), kwa hivyo mtu yeyote anayefikia ukurasa huo anaweza kuanza skani na kutumia mkopo wako wa mtoa huduma. Kwa kulinganisha, Vaultwarden imeundwa kukabili Internet, na kuimarisha usalama wake bado kunategemea admin token na faili ya backup, ambazo ni njia ambazo open-kritt haikupi. Kuna mtego wa pili uliofichika: port ya container iliyochapishwa hushughulikiwa kabla ya sera ya chaguo-msingi ya ufw kutumika, kwa hivyo sheria ya ufw deny 5173 inaonekana sahihi lakini haizuii chochote. Docker ports zinazokwepa ufw inaonyesha mnyororo wa sheria unaosababisha hili.

Kupima ukubwa wa VPS

ENGINE_MIN_FREE_STORAGE_GB ina thamani chaguo-msingi ya 20, na injini hukataa kuanzisha kontena jipya la skani kwa kila kazi wakati hifadhi ya bure inaposhuka chini ya thamani hiyo. Picha zilizojengwa, akiba ya checkout, data ya Postgres na nafasi za kazi zote hukaa kwenye diski moja, kwa hivyo VPS ya 20 GB haitaanzisha skani yoyote. Zingatia 40 GB kama kiwango cha chini, na ongeza zaidi ikiwa unachanganua hazina kubwa. Epuka hamu ya kufidia gharama za seva kwa kuweka huduma inayotumia hifadhi nyingi kando yake, kwa sababu RAM na diski zilizopimwa katika ulinganisho huu wa PhotoPrism na Immich zinaonyesha jinsi maktaba ya media inavyoweza kumaliza haraka nafasi inayohitajika na skani. Hali hiyo inatumika kwa nyongeza za mapambo zinazoonekana kutokuwa na uzito kando ya skana: kiolesura cha kivinjari kinachobadilisha muonekano wa maktaba ya Jellyfin kama duka la kukodisha la miaka ya 90 bado huvuta seva nzima ya media na transcode zake kwenye diski iliyo nyuma yake, kwa hivyo iweke kwenye seva tofauti.

Kumbukumbu hufuata hesabu rahisi, na mipangilio iliyo nyuma yake ilianza katika v1.4.0, kwa hivyo inatumika kwa tag iliyowekwa hapo juu lakini si kwa zile za zamani. ENGINE_MEMORY_RESERVE_GB=2 huhifadhi kumbukumbu kwa ajili ya injini, hifadhidata, API na matumizi ya muda mfupi. Kila mkimbiaji wa skani (scan runner) hubeba hifadhi laini ya ENGINE_SCAN_RUNNER_MEMORY_RESERVATION_MB=1536 na kikomo kigumu cha ENGINE_SCAN_RUNNER_MEMORY_MB=1536. Kwa hivyo, wafanyakazi wawili huhitaji takriban 5 GB kabla ya kitu kingine chochote kuendeshwa. Injini hukubali tu wakimbiaji wanaotoshea kwenye bajeti iliyobaki, kwa hivyo kwenye seva ndogo skani hupangwa kwenye foleni badala ya kufeli, hali ambayo ni bora zaidi kuliko kuua mchakato kwa sababu ya kukosa kumbukumbu (out-of-memory killer). Hesabu hiyo hiyo huweka kiwango cha chini kwa zana yoyote inayopatia kila kitengo cha kazi kontena lake, ndiyo sababu kontena moja na kivinjari kimoja kwa kila mfanyakazi wa AI wa OpenBot hufikia kikomo cha RAM muda mrefu kabla ya kufikia kikomo cha CPU.

Mipangilio miwili ya kupunguza (prune) ina thamani chaguo-msingi ya kweli: ENGINE_AUTO_PRUNE_DOCKER_BUILD_CACHE na ENGINE_AUTO_PRUNE_UNUSED_DOCKER_IMAGES. Baada ya kazi kukamilika, injini huondoa akiba ya ujenzi isiyotumika, picha zisizotumika na kontena za skani zilizosimamishwa. Picha zinazorejelewa na kontena yoyote, kontena za huduma, bind mounts, data ya hifadhidata, vitambulisho na volumu huhifadhiwa. Hii ni sababu nyingine ya kutoshiriki seva: kiondoa akiba (pruner) ambacho hukukisanidi kinafanya kazi dhidi ya Docker daemon hiyo.

Mipangilio ya injini ambayo watu wengi hubadilisha
  • ENGINE_WORKER_COUNT: jumla ya nafasi za wafanyakazi zinazoshirikiwa na hatua za skani na uchakataji wa baada ya kazi. Iweke kuwa 0 ili kusitisha uchukuaji wa kazi mpya.
  • ENGINE_MAX_CONCURRENT_SCANS: ni skani ngapi zinazokubaliwa kwa wakati mmoja. Skani zilizopangwa kwenye foleni husubiri hadi dimbwi la kazi zinazoendelea liwe tupu.
  • ENGINE_MAX_WORKERS_PER_SCAN: 0 hugawa nafasi za jumla kwa usawa kati ya skani.
  • ENGINE_HARNESS_TIMEOUT_SECONDS: 7200 kama chaguo-msingi. Hii ndiyo muda mrefu zaidi ambao kazi moja inayotoka nje ya udhibiti inaweza kudumu. Injini hukubali thamani kuanzia 60 hadi 86400, na thamani yoyote nje ya masafa hayo, ikijumuisha 0, hurudi kwenye 7200.
  • ENGINE_MIN_FREE_STORAGE_GB: kiwango cha chini cha hifadhi. ENGINE_IGNORE_LOW_STORAGE=true huzima kinga hii, na faili huonya kuwa hii inaweza kujaza diski ya seva.
  • ENGINE_SCAN_RUNNER_MEMORY_MB: kikomo kigumu cha kumbukumbu kwa kila mkimbiaji. 0 huondoa kikomo.
  • ENGINE_SCAN_RUNNER_MEMORY_RESERVATION_MB: hifadhi laini kwa kila mkimbiaji ambayo hesabu ya uingiaji hutumia. Kuipunguza huweka kumbukumbu nyingi zaidi kuliko inayopatikana wakati wa kutokuwa na kazi, huku kikomo kigumu bado kikizuia ongezeko la ghafla.

Kuchanganua hazina ya ndani bila kuivujisha

LOCAL_REPOS_PATH hutumia ./local_repos kama chaguo-msingi na huwekwa kwa njia ya bind-mount ya kusoma pekee (read-only) ndani ya kontena za backend na engine, kwa hivyo hazina unayoiweka kwenye folda hiyo kwenye host huonekana ndani ya kontena mara moja. Tumia clone mpya, si working tree yako. Kontena la kazi hupata nakala inayoweza kuandikwa (writable), inakuwa na root ndani yake, na ina uwezo wa kufikia Internet, jambo linalomaanisha kuwa chochote kilichomo kwenye nakala hiyo kinaweza kubadilishwa au kutumwa nje ya seva. Ondoa faili za .env na funguo za siri (private keys) kabla ya kunakili mradi ndani yake.

Unachopata na usichopata

Unapata matokeo ya wagombea yaliyopangwa kwa daraja. Hupati udhaifu uliothibitishwa. Upangaji na uondoaji wa nakala huamua mpangilio wa foleni yako ya triage. Haziwezi kuthibitisha kuwa ingizo ni la kweli. Hati za baada ya uchanganuzi (post-scripts) zinaweza kujaribu uthibitishaji na kuunda uthibitisho wa dhana (proof of concept), na hiyo ndiyo ishara yenye nguvu zaidi inayotolewa na zana hii, lakini hati inayoshindwa haimaanishi kuwa matokeo hayo ni ya uongo. Mtu bado anasoma kila mgombea. Pengo hilo kati ya mgombea na uthibitisho ndilo linalofanya kuomba wakala uthibitisho unaoweza kuujaribu mwenyewe kuwa jambo la busara hapa: matokeo unayoweza kuyazalisha upya unapohitaji yana thamani zaidi kuliko yale yaliyopangwa kwa daraja ambayo lazima uyaamini bila shaka.

Mwongozo huu hautoi madai yoyote kuhusu idadi ya mende (bugs) halisi ambazo open-kritt inazipata, kwa sababu hatujapima hilo. Mtu yeyote anayenukuu kiwango cha ugunduzi kwa ajili ya codebase yako haijaiendesha dhidi ya codebase yako. Changanua hazina (repository) unayoijua vyema kwanza: matokeo unayoweza kuyahukumu mwenyewe ndiyo njia rahisi zaidi ya urekebishaji inayopatikana.

Idhini ni muhimu zaidi hapa kuliko ilivyo kwa zana nyingi zinazojiendesha (self-hosted). Mawakala hukusanya na kutekeleza msimbo na kufikia mtandao, kwa hivyo hatua ya uthibitisho wa dhana inaweza kugusa mifumo iliyo hai. Ielekeze kwenye msimbo unaomiliki au ambao umepewa mkataba wa kuujaribu, na uandike upeo wa lengo (target scope) kabla ya kuendesha chochote. Ikiwa utasanidi ANTHROPIC_API_KEY na kutumia injini ya Claude Code, mazoea ya kutumia sanduku la mchanga (sandboxing) katika kuendesha Claude Code kwa usalama kwenye VPS yanatumika kwa mawakala hawa pia.

FAQ

Kwa nini open-kritt inahitaji VPS yake yenyewe?

Kwa sababu mawakala wake wa uchanganuzi huendeshwa kama root ndani ya container za muda za kazi, wakiwa na nakala za msimbo wako zinazoweza kuhaririwa na ufikiaji wa moja kwa moja wa Internet, na kwa sababu huduma ya injini hu-mount Docker socket ya mwenyeji ili iweze kuanzisha container moja kwa kila kazi. Mchakato wowote unaofikia socket hiyo unaweza kuanzisha container inayoweza ku-mount mfumo wa faili wa mwenyeji, kwa hivyo stack nzima inapaswa kuchukuliwa kama root kwenye mwenyeji wake. Kwenye VPS iliyojitolea, huo ni ubadilishaji unaokubalika, na kujenga upya mashine hiyo hakukugharimu chochote. Kwenye workstation yako ya kila siku, inaiweka funguo zako za SSH na profaili za kivinjari ndani ya mipaka ileile ya uaminifu kama msimbo unaochanganua.

Je, ninaweza kufungua port 5173 badala ya kutumia SSH tunnel?

Hupaswi kufanya hivyo. Backend husafirishwa bila uthibitishaji wa programu, kwa hivyo port ndiyo kitu pekee kilichopo kati ya Internet na matokeo yako pamoja na mkopo wa mtoa huduma. Faili ya compose hufunga kila huduma kwenye 127.0.0.1 kwa sababu hiyo. Endesha ssh -N -L 5173:127.0.0.1:5173 you@your-server-ip na uvinjari kwenda http://localhost:5173 ndani ya mfumo wako. Sheria ya ufw si mbadala, kwa sababu port ya Docker iliyochapishwa hushughulikiwa kabla ya sera ya kawaida ya ufw kutumika.

Ninawezaje kuzuia open-kritt isitumie pesa zaidi ya nilivyopanga?

Weka kikomo kigumu kwenye dashibodi ya mtoa huduma wako wa modeli kabla ya uchanganuzi wa kwanza, kwa sababu open-kritt haina mpangilio wa bajeti wake yenyewe. Dumisha mipangilio chaguo-msingi ya concurrency iliyosafirishwa kwa ajili ya majaribio ya kwanza, ENGINE_WORKER_COUNT=2 na ENGINE_MAX_CONCURRENT_SCANS=1, na kumbuka kuwa akaunti moja ya mtoa huduma inaruhusu hadi wito 15 wa modeli za root kwa wakati mmoja kwa chaguo-msingi, wakati kikao cha Codex kinaweza kuendesha hadi mawakala watoto watano. ENGINE_WORKER_COUNT=0 husitisha uchukuaji wa kazi mpya na ndiyo njia ya haraka zaidi ya kusimamisha ndani ya mfumo.

Ni toleo gani ninalopaswa kuchagua?

Tag, kamwe usitumie main. git fetch --tags ikifuatiwa na git tag --list huonyesha kile kinachopatikana, na v1.4.1, iliyochapishwa tarehe 16 Agosti 2026, ndiyo mpya zaidi kufikia tarehe 12 Oktoba 2026. Kuweka toleo maalum (pinning) kunamaanisha kuwa ujenzi upya miezi baadaye utazalisha stack ileile, na hufanya uboreshaji kuwa uamuzi unaoufanya baada ya kusoma maelezo ya toleo badala ya kuwa matokeo ya cloning siku tofauti.

Uchanganuzi hauanzi kamwe. Nini ninapaswa kukikagua?

Kagua nafasi ya diski kwanza, kwa sababu injini haitaanzisha container ya uchanganuzi kwa kila kazi wakati hifadhi iliyo wazi iko chini ya ENGINE_MIN_FREE_STORAGE_GB, ambayo chaguo-msingi ni 20 GB. Kisha kagua kuwa ENGINE_WORKER_COUNT si 0, kwa sababu thamani hiyo husitisha uchukuaji wa kazi mpya. Kisha thibitisha kuwa kitambulisho cha modeli kimesanidiwa kikweli kwa kuendesha ./kritt setup, kwa sababu GITHUB_TOKEN pekee haiwezi kuendesha uchanganuzi. docker compose logs engine hutaja sababu iliyoifanya iruke kazi hiyo.

Je, makala hii ilikusaidia?