Talpinkite Kroki Managed VPS serveryje: diagramos generuojamos jūsų serveryje

Kroki talpinimas Managed VPS serveryje reiškia, kad savo PlantUML, Mermaid, GraphViz, D2, BPMN ar Excalidraw diagramas generuojate savo mašinoje, kurią mūsų komandos prižiūri atnaujintą ir stebi dieną bei naktį. Kroki yra laisva programinė įranga su MIT licencija. Šis gidas seka oficialią jos dokumentaciją: šliuzą ir jo pagalbinius konteinerius, diegimą su Docker Compose, konfigūraciją, HTTPS, viešo egzemplioriaus apsaugą, Asciidoctor ir MkDocs prijungimą, atsargines kopijas ir atnaujinimus.

Simon Vasconcelos Lee Autorius: Paskelbta 2026 m. lapkričio 20 d.Skaitymo trukmė: 14 min.

Visi gidai

Svarbiausia

  1. MIT licencija leidžia laisvai naudoti, keisti ir platinti Kroki, tiek įmonėje, tiek kitur, jei išlaikote jos autorių teisių pranešimą.
  2. Kroki tekstu aprašytą diagramą paverčia vaizdu per vieną HTTP API: PlantUML, GraphViz, D2, Structurizr ir daugelis kitų jau yra atvaizde yuzutech/kroki.
  3. Mermaid, BPMN, Excalidraw ir diagrams.net kiekvienai reikia savo pagalbinio konteinerio, prijungto prie šliuzo per kintamuosius KROKI_*_HOST: Docker Compose juos paleidžia kartu.
  4. Kroki neturi nei paskyrų, nei duomenų bazės. Ji paleidžiama SECURE režimu, kuris neleidžia jai skaityti failų ar tinklo; prieiga prie viešo egzemplioriaus valdoma atvirkštiniame tarpiniame serveryje.
  5. Darykite konfigūracijos, compose.yaml ir tarpinio serverio, atsargines kopijas, o atnaujinkite su docker compose pull, prieš tai perskaitę kiekvienos versijos pastabas.

Ką daro Kroki

Kroki teikia vieningą HTTP API, kuris priima tekstu aprašytą diagramą ir grąžina vaizdą. Jūsų dokumentacija, wiki ar kodo platforma siunčia diagramos šaltinį; Kroki atsako SVG, o priklausomai nuo diagramos tipo, PNG, PDF ar JPEG. Jos README išvardija BlockDiag, BPMN, Bytefield, C4 su PlantUML, D2, DBML, diagrams.net, Ditaa, Erd, Excalidraw, GoAT, GraphViz, Lini, Mermaid, Nomnoml, Pikchr, PlantUML, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom ir WireViz.

Plėtinio Asciidoctor Kroki dokumentacija nurodo tris priežastis paleisti savo serverį vietoj viešo egzemplioriaus kroki.io: įmonės ugniasienę, kuri jį blokuoja, delsą, kai esate toli nuo šio Europos egzemplioriaus, ir privatumą, kai diagramų šaltiniai turi likti jūsų infrastruktūroje.

Ką leidžia MIT licencija

Kroki platinama pagal MIT licenciją. Ji nemokamai suteikia teisę naudoti, kopijuoti, keisti, sujungti, skelbti, platinti, sublicencijuoti ir parduoti programinės įrangos kopijas. Taigi galite ją naudoti savo įmonei, komandai ar klientams, nepirkdami jokios licencijos.

Vienintelė sąlyga yra išlaikyti autorių teisių pranešimą ir licencijos tekstą visose programinės įrangos kopijose ar esminėse jos dalyse. Tekstas programinę įrangą teikia „tokią, kokia yra“, be garantijos. Į Kroki įtrauktos diagramų bibliotekos išlaiko kiekviena savo licenciją.

Šliuzas ir jo pagalbiniai konteineriai

Kroki turi modulinę architektūrą. Java kalba ant Vert.x parašytas šliuzas priima kiekvieną užklausą ir nukreipia ją į tinkamą biblioteką. Privalomas tik atvaizdas yuzutech/kroki: dokumentacija pažymi, kad, priklausomai nuo jūsų diagramų, jo gali pakakti.

AtvaizdasKą generuojaPrivalomas
yuzutech/krokiŠliuzą, taip pat ActDiag, BlockDiag, Bytefield, D2, Ditaa, Erd, GoAT, GraphViz, Lini, Nomnoml, NwDiag, PacketDiag, Pikchr, PlantUML ir C4, RackDiag, SeqDiag, Structurizr, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom ir WireVizTaip
yuzutech/kroki-mermaidMermaid: srauto, sekų ir Ganto diagramosNe
yuzutech/kroki-bpmnBPMN, su bpmn-jsNe
yuzutech/kroki-excalidrawExcalidraw, ranka pieštas stiliusNe
yuzutech/kroki-diagramsnetdiagrams.net, dar eksperimentinisNe

Serverio dydžio parinkimas

Dokumentacija nepateikia skaičių apie atmintį ar procesorių. Tačiau ji nurodo, kas apkrauna labiausiai: pagalbiniai konteineriai Mermaid, BPMN, Excalidraw ir diagrams.net kiekvieną diagramą generuoja Chromium naršyklėje be grafinės sąsajos (headless). Kad konversijų antplūdis neviršytų konteinerio atminties, kiekvienas iš jų riboja vienu metu vykdomų generavimų skaičių: numatytai 6 Mermaid, BPMN ir diagrams.net, 4 Excalidraw. Tolesnės užklausos laukia savo eilės.

Naudodami Managed VPS, papasakokite mums apie savo diagramas, joms reikalingus pagalbinius konteinerius ir tikėtiną srautą, o mes rekomenduosime tinkamą dydį.

Diegimas su Docker Compose

Dokumentacija rekomenduoja konteinerius, Docker arba Podman, kad nereikėtų kiekvienos bibliotekos diegti rankiniu būdu. Serveryje, kuriame įdiegtas Docker, sukurkite katalogą ir įdėkite į jį šį iš dokumentacijos paimtą compose.yaml:

compose.yaml
services:
  kroki:
    image: yuzutech/kroki:0.36.0
    restart: unless-stopped
    depends_on:
      - mermaid
      - bpmn
      - excalidraw
    environment:
      - KROKI_MERMAID_HOST=mermaid
      - KROKI_BPMN_HOST=bpmn
      - KROKI_EXCALIDRAW_HOST=excalidraw
    ports:
      - "127.0.0.1:8000:8000"
    # If you mount /tmp yourself, keep the exec option
    tmpfs:
      - /tmp:exec
  mermaid:
    image: yuzutech/kroki-mermaid:0.36.0
    restart: unless-stopped
    expose:
      - "8002"
  bpmn:
    image: yuzutech/kroki-bpmn:0.36.0
    restart: unless-stopped
    expose:
      - "8003"
  excalidraw:
    image: yuzutech/kroki-excalidraw:0.36.0
    restart: unless-stopped
    expose:
      - "8004"
Terminal
docker compose up -d

Dar eksperimentiniam diagrams.net README prideda ketvirtą pagalbinį konteinerį. Pridėkite šią paslaugą ir kintamąjį KROKI_DIAGRAMSNET_HOST=diagramsnet į paslaugos kroki skiltį environment:

compose.yaml, pridedama paslauga
  diagramsnet:
    image: yuzutech/kroki-diagramsnet:0.36.0
    restart: unless-stopped
    expose:
      - "8005"

Patikrinimas, ar viskas atsako

Serveryje maršrutas /health grąžina šliuzo būseną ir jame esančių bibliotekų versijas. Kitos dvi užklausos sugeneruoja GraphViz diagramą per šliuzą, tada Mermaid diagramą per jos pagalbinį konteinerį:

Terminal, serveryje
curl http://127.0.0.1:8000/health
curl http://127.0.0.1:8000/graphviz/svg --data-raw 'digraph G {Hello->World}'
curl http://127.0.0.1:8000/mermaid/svg --data-raw 'graph TD; A-->B'

Be Docker: savarankiškas jar failas

Kitas dokumentacijos kelias yra savarankiškas serveris, skelbiamas saugyklos versijų puslapyje kaip kroki-standalone-server-v0.36.0.jar. Jam reikia Java 21 ar naujesnės versijos, ir jame nėra jokių diagramų bibliotekų: kiekviena diegiama atskirai, o jos kelias nurodomas kintamuoju, pavyzdžiui, KROKI_DOT_BIN_PATH, kai vykdomasis failas nėra PATH kelyje. Klausymosi adresui geriau naudokite KROKI_LISTEN, nes konfigūracijos dokumentacija skelbia, kad KROKI_PORT bus pašalintas:

Terminal
KROKI_LISTEN=127.0.0.1:8000 java -jar kroki-standalone-server-v0.36.0.jar

Konfigūracija: kintamieji, be paskyrų, be duomenų bazės

Kroki neturi nei administravimo puslapio, nei naudotojų paskyrų, nei duomenų bazės: jos konfigūracija yra aplinkos kintamųjų rinkinys arba, naudojant jar failą, Java sistemos savybės. Docker Compose faile jie rašomi atitinkamos paslaugos bloke environment, tada docker compose up -d iš naujo sukuria konteinerį. Serveriui svarbiausi nustatymai:

KintamasisNumatytoji reikšmėKą daro
KROKI_SAFE_MODEsecureSaugumo lygis, aprašytas toliau
KROKI_LISTENVisos sąsajos, prievadas 8000Klausymosi adresas ir prievadas; taip pat priima UNIX lizdą, unix:// ir kelią
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST127.0.0.1Kur šliuzas pasiekia kiekvieną pagalbinį konteinerį; atitinkami kintamieji _PORT nustato prievadą, o KROKI_DIAGRAMSNET_HOST skirtas diagrams.net
KROKI_COMMAND_TIMEOUT5 sekundėsIlgiausias laukimas diagramų vykdomajam failui, pavyzdžiui, dot
KROKI_CONVERT_TIMEOUT20 sekundžiųIlgiausias laukimas Java bibliotekai, pavyzdžiui, PlantUML
KROKI_DELEGATE_TIMEOUT_MS30 000Ilgiausias laukimas pagalbiniam konteineriui, milisekundėmis
KROKI_MAX_URI_LENGTH4096GET užklausai priimamas URL ilgis, kurį viršijus Kroki atsako 414
KROKI_CONTENT_SECURITY_POLICYscript-src 'none'; object-src 'none'Antraštė Content-Security-Policy, siunčiama su kiekvienu atsakymu
KROKI_CORS_ALLOWED_HEADERSJokių papildomųPapildomos antraštės, leidžiamos kreipiantis iš kitos svetainės

Excalidraw diagramos sukuria ilgus URL adresus. Jei padidinate KROKI_MAX_URI_LENGTH, dokumentacija rekomenduoja neviršyti 8192 simbolių, nors dauguma naršyklių žymoje <img> priima daugiau. Didžiausioms diagramoms POST užklausa šaltinį perduoda turinyje, o ne URL adrese.

Kroki veikimui nereikia jokios paslapties. Dviejuose neprivalomuose nustatymuose ji yra: žetonas KROKI_COMPANION_REGISTRATION_TOKEN, naudingas, jei įjungiate trečiųjų šalių pagalbinių konteinerių registraciją, aprašytą apsaugos skyriuje, ir sertifikato privatusis raktas, jei HTTPS leidžiate tvarkyti pačiai Kroki. Laikykite juos už bet kokios kodo saugyklos ribų.

HTTPS: atvirkštinis tarpinis serveris

Šliuzas savo API teikia per HTTP. Priešais jį esantis atvirkštinis tarpinis serveris klausosi 80 ir 443 prievaduose, gauna Let’s Encrypt sertifikatą, šifruoja srautą ir perduoda jį Kroki adresu 127.0.0.1:8000. Ten taip pat filtruojama prieiga, kaip parodyta kitame skyriuje.

Su Caddy

Caddy pats gauna ir atnaujina sertifikatą nurodytam pavadinimui, o jo direktyva reverse_proxy be papildomų nustatymų perduoda antraštes X-Forwarded-For, X-Forwarded-Proto ir X-Forwarded-Host:

Caddyfile
diagrams.example.com {
	encode gzip
	reverse_proxy 127.0.0.1:8000
}

Su Nginx

Šis blokas server klausosi 80 prievade, kad Certbot galėtų sukonfigūruoti HTTPS. Du Nginx apribojimai susiduria su Kroki apribojimais: didesnis nei 1 MB užklausos turinys numatytai atmetamas su 413, ką client_max_body_size pakoreguoja didelėms POST siunčiamoms diagramoms; ilgesnė nei 8 KB užklausos eilutė gauna 414, ką large_client_header_buffers pakoreguoja, jei KROKI_MAX_URI_LENGTH padidinate daugiau.

Nginx blokas
server {
    listen 80;
    listen [::]:80;
    server_name diagrams.example.com;

    client_max_body_size 1m;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://127.0.0.1:8000;
    }
}
Terminal
sudo nginx -t
sudo certbot --nginx

HTTPS be tarpinio serverio

Dokumentacija taip pat aprašo šifravimą pačioje Kroki: KROKI_SSL=true, su sertifikatu ir privačiuoju raktu PEM formatu, tekstu per KROKI_SSL_CERT ir KROKI_SSL_KEY arba failais per KROKI_SSL_CERT_PATH ir KROKI_SSL_KEY_PATH. Tada sertifikatas atnaujinamas rankiniu būdu, o naudojant tarpinį serverį tuo pasirūpina Caddy ar Certbot.

Internetui atviro egzemplioriaus apsauga

Kroki neturi autentifikavimo: bet kas, pasiekęs API, gali priversti ją generuoti diagramas. Todėl jos apsauga remiasi trimis dalykais, aprašytais dokumentacijoje ir versijų pastabose: saugumo režimu, dydžio ir laiko apribojimais bei tuo, ką praleidžia tarpinis serveris. Pradėkite nuo to, kam reikia pasiekti jūsų serverį.

Kas kreipiasi į jūsų serverį?

Saugumo režimas

KROKI_SAFE_MODE nustato tris lygius, kurių kiekvienas apima ankstesniojo apribojimus. Dokumentacija paaiškina, kad kai kurios bibliotekos gali skaityti failus ar URL adresus, pavyzdžiui, PlantUML direktyvos !include, ir kad Kroki, kuri netikrina jų kodo, tokią prieigą numatytai blokuoja. Ji ragina kiekvieną serverį palaikantį asmenį pasirinkti jo naudojimui tinkamą lygį.

LygisKą daro
SECURE, numatytasisNeleidžia jokių bandymų skaityti failų iš failų sistemos ar išteklių iš tinklo
SAFERemiasi užklausų valymu, kurį atlieka kiekvienos bibliotekos saugus režimas
UNSAFEIšjungia visas saugumo funkcijas

Viešame egzemplioriuje palikite SECURE. Antraštė Content-Security-Policy, nuo 0.36.0 versijos siunčiama numatytai, papildo šią apsaugą: į SVG įterptas scenarijus nevykdomas Kroki kilmėje, net kai vaizdas atidaromas tiesiogiai.

Dydžio ir laiko apribojimai

Konfigūracijos lentelėje nurodyti laukimo laikai riboja kiekvieną konversiją. Pagalbiniai konteineriai prideda savų, skirtų apsaugoti nuo išteklių išeikvojimo:

Prieigos ribojimas tarpiniame serveryje

Kai į Kroki kreipiasi tik jūsų publikavimo grandinė, paprasčiausia priimti tik jos IP adresą. Su Caddy atitikmuo remote_ip atrenka kitus adresus, o respond jiems siunčia 403:

Caddyfile
diagrams.example.com {
	@external not remote_ip 203.0.113.10
	respond @external 403
	reverse_proxy 127.0.0.1:8000
}

Su Nginx tą patį atlieka bloko location direktyvos allow ir deny, o galioja pirmoji atitikusi taisyklė:

Nginx blokas, location / viduje
allow 203.0.113.10;
deny all;

Kitas kelias yra tarpinio serverio bazinis autentifikavimas: basic_auth su Caddy, kurio slaptažodis maišomas su caddy hash-password, arba auth_basic ir su htpasswd sukurtas failas su Nginx. Jis tinka klientams, kurie prisijungimo duomenis siunčia su kiekviena užklausa, pavyzdžiui, curl -u; dokumentacijos grandinei patikrinkite, ar jos įrankis gali juos perduoti. Viešam egzemplioriui Nginx taip pat gali riboti užklausų skaičių vienam IP adresui savo moduliu limit_req, pritaikytu pagal diagramų skaičių jūsų puslapiuose.

Trečiųjų šalių pagalbiniai konteineriai

Kroki gali priimti trečiųjų šalių pagalbinius konteinerius, kurie registruojasi per API /services. Šis aptikimas numatytai išjungtas ir SECURE režimu visada lieka išjungtas. Jei jį įjungiate su KROKI_ENABLE_COMPANION_DISCOVERY=true, dokumentacija prašo /services laikyti patikimame tinkle ir primygtinai rekomenduoja žetoną KROKI_COMPANION_REGISTRATION_TOKEN: be jo Kroki paleidimo metu įspėja, kad bet kuris šliuzo klientas gali užregistruoti pagalbinį konteinerį.

Asciidoctor, MkDocs ir kitų įrankių prijungimas

Asciidoctor Kroki ir MkDocs įskiepis numatytai kreipiasi į https://kroki.io. Jiems tereikia jūsų serverio URL adreso, įskaitant priešdėlį https://.

Asciidoctor ir Antora

Plėtinys Asciidoctor Kroki skaito atributą kroki-server-url dokumento antraštėje, komandinėje eilutėje arba Antora playbook faile. Pridėkite kroki-fetch-diagram, kad vaizdai būtų atsisiunčiami svetainės generavimo metu, užuot HTML rodžius į jūsų serverį; šiai parinkčiai reikia Asciidoctor saugaus režimo server ar žemesnio.

AsciiDoc dokumento antraštė
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:

MkDocs

Įskiepis mkdocs-kroki-plugin skaito server_url, kurio numatytoji reikšmė imama iš aplinkos kintamojo KROKI_SERVER_URL. Su http_method: POST vaizdai saugomi šalia kiekvieno sugeneruotos svetainės puslapio ir išlaikomi podėlyje tarp dviejų generavimų:

mkdocs.yml
plugins:
  - kroki:
      server_url: https://diagrams.example.com
      http_method: POST

Kitos integracijos

Dokumentacijos trečiųjų šalių įrankių puslapyje taip pat išvardyti GitLab, kuris Kroki diagramas generuoja Markdown, AsciiDoc, reST ir Textile formatais, Sphinx, Jekyll, Hugo, Remark, Python-Markdown, MediaWiki, plėtiniai Visual Studio Code ir IntelliJ, bei Kroki.jl, skirtas Julia. Tinka ir bet kuris HTTP klientas, kaip šiame dokumentacijos pavyzdyje:

Terminal
curl https://diagrams.example.com/erd/svg --data-binary '@project.erd'

Atsarginės kopijos: konfigūracija, be duomenų

Kroki neturi būsenos: tarp dviejų užklausų ji nieko nesaugo, ir net trečiųjų šalių pagalbinių konteinerių registras po paleidimo iš naujo dingsta. Jūsų diagramų šaltiniai yra jūsų dokumentacijos saugyklose, o jų vaizdai jūsų sugeneruotose svetainėse. Kroki serveryje atsargine kopija saugoma jos konfigūracija:

ElementasKą apimaDaryti kopiją
compose.yamlAtvaizdus, jų žymas ir kintamuosius KROKI_*Taip
Failas .env, jei yraKintamuosius, laikomus už compose.yaml ribų, pavyzdžiui, žetoną ar sertifikatąTaip, saugioje vietoje
Tarpinio serverio konfigūracijaCaddyfile arba Nginx bloką ir slaptažodžių failąTaip
Docker atvaizdaiPačią programinę įrangąNe: docker compose pull juos atsisiunčia iš naujo
Terminal, compose.yaml kataloge
tar -czf kroki-config-$(date +%F).tar.gz compose.yaml /etc/caddy/Caddyfile

Pritaikykite sąrašą savo tarpiniam serveriui, po kiekvieno konfigūracijos pakeitimo darykite naują kopiją ir siųskite ją už serverio ribų. Laikoma serverio diske, ji taip pat patenka į jo naktines atsargines kopijas. Atkūrimas reiškia šių failų grąžinimą į vietą ir komandą docker compose up -d.

Atnaujinimai

Naudodami užfiksuotas žymas, pakeiskite keturių atvaizdų versiją faile compose.yaml, tada jo kataloge paleiskite:

Terminal
docker compose pull
docker compose up -d

Kroki laikosi semantinio versijavimo, ir kiekviena versija skelbia savo pakeitimus faile CHANGELOG.md bei savo versijos puslapyje. Perskaitykite juos prieš atnaujindami, ypač jų skyrių „Security“: 2026 m. lapkričio 5 d. 0.35.0 versija ir 2026 m. lapkričio 9 d. 0.36.0 versija ištaiso nuotolinį kodo vykdymą per Bytefield ir TikZ diagramas, XSS spragas GoAT ir DBML bei serverio pusės užklausų klastojimą per BlockDiag ir pagalbinius konteinerius. Atvirame egzemplioriuje šias versijas įdiekite nedelsdami.

0.36.0 versija taip pat prideda numatytąją antraštę Content-Security-Policy ir D2 išdėstymo variklį TALA. Rankiniam diegimui ji nurodo Java 21 kaip mažiausią versiją.

Kas ką daro Managed VPS serveryje

Talpinant savo serveryje, be programos reikia prižiūrėti ir patį serverį. Naudojant Managed VPS, mūsų komandos perima serverį ir proaktyviai stebi jūsų egzempliorių; Kroki lieka jūsų programa su savo konfigūracija ir pagalbiniais konteineriais.

TemaMūsų komandosJūs
ServerisSistemos ir saugumo atnaujinimai, įskaitant įsikišimą serveryjeJūsų veiklai tinkamas momentas
StebėsenaServeris stebimas 24 val. per parą, 7 dienas per savaitę, įsikišant nelaukiant jūsų skambučioJūsų egzemplioriaus žurnalų skaitymas
KrokiProaktyvi stebėsena: klaidos, sulėtėjimai, pagalbinių konteinerių atmintis ir disko vieta pastebimi, rekomenduojamas pataisymasJos diegimas, atnaujinimai ir nustatymai, kuriuos pritaikote jūs arba jūsų DI asistentas
Diagramos ir prieigaJas generuojantis serveris, stebimas ir saugomas atsarginėmis kopijomisSaugumo režimas, pagalbiniai konteineriai, apribojimai ir tarpinio serverio prieigos taisyklės
Atsarginės kopijosKiekvieną naktį, šifruotos ir saugomos už mašinos ribų; atkūrimas įskaičiuotasJūsų konfigūracijos kopijos, laikomos kitur, ir atkūrimo prašymas, kai jo prireikia
PerkėlimasJūsų dabartinis serveris perkeliamas nemokamaiPerjungimo momentas

Jei norite, kad mūsų komandos įsikištų į pačią programą, ši paslauga apmokestinama valandomis arba fiksuota kaina, o skaičiavimas pateikiamas prieš įsikišimą.

Kroki serveryje, kurį prižiūrime už jus

Su Simafri Managed VPS mūsų komandos palaiko jūsų Kroki egzemplioriaus serverį atnaujintą, stebi jį dieną ir naktį ir įsikiša nelaukdamos jūsų skambučio; jos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs arba jūsų DI asistentas. Atsarginės kopijos kiekvieną naktį šifruojamos ir saugomos už mašinos ribų, jų atkūrimas įskaičiuotas, o jūsų dabartinio serverio perkėlimas nemokamas.

Žiūrėti Managed VPS

Dažni klausimai

Ar Kroki nemokama įmonei?

Taip. Kroki platinama pagal MIT licenciją: įmonėje ją galite naudoti, keisti ir platinti nieko nepirkdami dėl licencijos, jei išlaikote jos autorių teisių pranešimą. Lieka tik ją vykdančio serverio kaina.

Ar man reikia Kroki pagalbinių konteinerių?

Tik toms diagramoms, kurias jie generuoja. Atvaizdo yuzutech/kroki pakanka PlantUML, GraphViz, D2, Structurizr ir daugumai formatų. Mermaid, BPMN, Excalidraw ir diagrams.net kiekvienai reikia savo pagalbinio konteinerio, prijungto per KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST ar KROKI_DIAGRAMSNET_HOST.

Kaip įdiegti Kroki su Docker Compose?

Sukurkite compose.yaml su atvaizdu yuzutech/kroki, jo prievadu 8000, paskelbtu adresu 127.0.0.1, ir reikalingais pagalbiniais konteineriais, pavyzdžiui, yuzutech/kroki-mermaid, prijungtais per kintamuosius KROKI_*_HOST. Paleiskite docker compose up -d, patikrinkite /health, tada priešais 8000 prievadą pastatykite HTTPS atvirkštinį tarpinį serverį.

Ar Kroki turi administratoriaus paskyrą?

Ne, Kroki neturi nei paskyrų, nei administravimo puslapio, nei duomenų bazės. Jos konfigūracija yra aplinkos kintamųjų KROKI_* rinkinys, o prieiga prie API valdoma atvirkštiniame tarpiniame serveryje, pagal IP adresą arba baziniu autentifikavimu.

Kaip apsaugoti viešą Kroki egzempliorių?

Palikite numatytai įjungtą SECURE režimą, kuris neleidžia bibliotekoms skaityti failų ar tinklo. Palikite laiko ir dydžio apribojimus, atnaujinkite, kai tik versija ištaiso spragą, o jei į Kroki kreipiasi tik jūsų publikavimo grandinė, tarpiniame serveryje priimkite tik jos adresą.

Kaip naudoti savo Kroki serverį su Asciidoctor ar MkDocs?

Su Asciidoctor atributui kroki-server-url nurodykite savo serverio URL adresą, o kroki-fetch-diagram, kad vaizdai būtų atsisiunčiami svetainės generavimo metu. Su MkDocs įskiepio kroki konfigūracijoje nurodykite server_url, o http_method: POST, kad vaizdai būtų saugomi kartu su svetaine.

Ką reikia kopijuoti Kroki serveryje?

Tik jos konfigūraciją: compose.yaml, galimą failą .env ir atvirkštinio tarpinio serverio konfigūraciją. Kroki duomenų nesaugo, o jos Docker atvaizdai iš naujo atsisiunčiami su docker compose pull.

Ar Managed VPS apima Kroki?

Managed VPS apima serverį: sistemą, saugumą, stebėseną ir atsargines kopijas. Mūsų komandos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs. Darbai pačioje programoje apmokestinami valandomis arba fiksuota kaina.

Šaltiniai ir oficiali dokumentacija

Susisiekite su mumis