Kroki majutamine Managed VPS-is: teie diagrammid teie enda serveris

Kroki majutamine Managed VPS-is tähendab, et renderdate oma PlantUML-, Mermaid-, GraphViz-, D2-, BPMN- või Excalidraw-diagramme masinas, mis on teie enda ning mida meie meeskonnad hoiavad ajakohasena ja jälgivad päeval ja öösel. Kroki on MIT-litsentsiga vabatarkvara. See juhend järgib selle ametlikku dokumentatsiooni: lüüs ja selle kaaskonteinerid, paigaldus Docker Compose’iga, konfiguratsioon, HTTPS, avaliku instantsi kaitsmine, Asciidoctori ja MkDocsi ühendamine, varukoopiad ja uuendused.

Simon Vasconcelos Lee Autor: Avaldatud 20. novembril 2026Lugemisaeg: 14 minutit

Kõik juhendid

Lühidalt

  1. MIT-litsents lubab Krokit vabalt kasutada, muuta ja edasi levitada, ettevõttes ja mujal, tingimusel et säilitate selle autoriõiguse teate.
  2. Kroki muudab tekstina kirjutatud diagrammi pildiks ühe HTTP API kaudu: PlantUML, GraphViz, D2, Structurizr ja paljud teised tulevad kaasa tõmmisega yuzutech/kroki.
  3. Mermaid, BPMN, Excalidraw ja diagrams.net vajavad igaüks oma kaaskonteinerit, mis ühendatakse lüüsiga muutujate KROKI_*_HOST kaudu: Docker Compose käivitab need koos.
  4. Krokil ei ole kontosid ega andmebaasi. See käivitub režiimis SECURE, mis takistab tal faile või võrku lugemast; ligipääsu avalikule instantsile kontrollitakse pöördproksis.
  5. Varundage konfiguratsioon, compose.yaml ja proksi oma, ning uuendage seejärel käsuga docker compose pull, lugedes enne iga versiooni märkmeid.

Mida Kroki teeb

Kroki pakub ühtset HTTP API-t, mis võtab vastu tekstina kirjeldatud diagrammi ja tagastab pildi. Teie dokumentatsioon, viki või koodiplatvorm saadab diagrammi lähteteksti; Kroki vastab SVG-ga ja olenevalt diagrammi tüübist PNG, PDF või JPEG-failiga. Selle README loetleb BlockDiagi, BPMN-i, Bytefieldi, C4 PlantUML-iga, D2, DBML-i, diagrams.neti, Ditaa, Erdi, Excalidraw, GoAT-i, GraphVizi, Lini, Mermaidi, Nomnomli, Pikchri, PlantUML-i, Svgbobi, Symbolatori, UMLeti, Vega, Vega-Lite, WaveDromi ja WireVizi.

Asciidoctor Kroki laienduse dokumentatsioon toob kolm põhjust käitada oma serverit avaliku instantsi kroki.io asemel: ettevõtte tulemüür, mis selle blokeerib, latentsus, kui olete sellest Euroopa instantsist kaugel, ja privaatsus, kui diagrammide lähtetekst peab jääma teie taristu sisse.

Mida MIT-litsents lubab

Kroki avaldatakse MIT-litsentsi all. See annab tasuta õiguse tarkvara kasutada, kopeerida, muuta, ühendada, avaldada, levitada, all-litsentsida ja selle koopiaid müüa. Seega võite seda käitada oma ettevõtte, meeskonna või klientide jaoks, ilma et peaksite litsentsi ostma.

Ainus tingimus on säilitada autoriõiguse teade ja litsentsi tekst kõigis tarkvara koopiates või olulistes osades. Tekst pakub tarkvara „sellisena, nagu see on”, ilma garantiita. Kroki kaasatud diagrammiteekidel on igaühel oma litsents.

Lüüs ja selle kaaskonteinerid

Krokil on modulaarne arhitektuur. Javas Vert.x-i peale kirjutatud lüüs võtab vastu iga päringu ja suunab selle õigele teegile. Kohustuslik on ainult tõmmis yuzutech/kroki: dokumentatsioon märgib, et olenevalt teie diagrammidest võib sellest piisata.

TõmmisMida see renderdabKohustuslik
yuzutech/krokiLüüs, lisaks ActDiag, BlockDiag, Bytefield, D2, Ditaa, Erd, GoAT, GraphViz, Lini, Nomnoml, NwDiag, PacketDiag, Pikchr, PlantUML ja C4, RackDiag, SeqDiag, Structurizr, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom ja WireVizJah
yuzutech/kroki-mermaidMermaid: vooskeemid, jada- ja Gantti diagrammidEi
yuzutech/kroki-bpmnBPMN, bpmn-js-igaEi
yuzutech/kroki-excalidrawExcalidraw, käsitsi joonistatud stiilEi
yuzutech/kroki-diagramsnetdiagrams.net, endiselt eksperimentaalneEi

Serveri mõõtmine

Dokumentatsioon ei anna mälu ega protsessori kohta ühtegi arvu. See ütleb aga, mis kaalub kõige rohkem: kaaskonteinerid Mermaid, BPMN, Excalidraw ja diagrams.net renderdavad iga diagrammi liideseta Chromiumi brauseris. Et teisenduste puhang ei ületaks konteineri mälu, piirab igaüks oma samaaegseid renderdusi: vaikimisi 6 Mermaidi, BPMN-i ja diagrams.neti puhul, 4 Excalidraw’ puhul. Järgmised päringud ootavad järjekorras oma korda.

Managed VPS-is rääkige meile oma diagrammidest, nende vajatavatest kaaskonteineritest ja oodatavast liiklusest, ning me soovitame teile õige suuruse.

Paigaldus Docker Compose’iga

Dokumentatsioon soovitab konteinereid, Dockerit või Podmani, et te ei peaks iga teeki käsitsi paigaldama. Looge serveris, kuhu on paigaldatud Docker, kaust ja pange sinna see dokumentatsioonist võetud 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

Endiselt eksperimentaalse diagrams.neti jaoks lisab README neljanda kaaskonteineri. Lisage see teenus ning muutuja KROKI_DIAGRAMSNET_HOST=diagramsnet teenuse kroki plokki environment:

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

Kontrollige, et kõik vastab

Serverist tagastab tee /health lüüsi oleku ja selles sisalduvate teekide versioonid. Järgmised kaks päringut renderdavad GraphVizi diagrammi lüüsi kaudu ja seejärel Mermaidi diagrammi selle kaaskonteineri kaudu:

Terminal, serveris
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'

Ilma Dockerita: iseseisev jar

Dokumentatsiooni teine tee on iseseisev server, mis avaldatakse hoidla väljalasete lehel nimega kroki-standalone-server-v0.36.0.jar. See nõuab Java 21 või uuemat ega sisalda ühtegi diagrammiteeki: igaüks paigaldatakse eraldi ja selle tee antakse muutujaga nagu KROKI_DOT_BIN_PATH, kui käivitatav fail ei ole PATH-is. Kuulamisaadressi jaoks eelistage KROKI_LISTEN, sest konfiguratsiooni dokumentatsioon teatab, et KROKI_PORT eemaldatakse:

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

Konfiguratsioon: muutujad, ilma kontode ja andmebaasita

Krokil ei ole halduslehte, kasutajakontosid ega andmebaasi: selle konfiguratsioon on keskkonnamuutujate kogum, jari puhul Java süsteemiomadused. Docker Compose’is lähevad need vastava teenuse plokki environment, seejärel loob docker compose up -d konteineri uuesti. Serveri jaoks kõige olulisemad sätted:

MuutujaVaikeväärtusMida see teeb
KROKI_SAFE_MODEsecureTurvatase, mida kirjeldatakse allpool
KROKI_LISTENKõik liidesed, port 8000Kuulamisaadress ja -port; aktsepteerib ka UNIX-i soklit, unix:// ja selle järel tee
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST127.0.0.1Kus lüüs iga kaaskonteinerini jõuab; vastavad muutujad _PORT määravad pordi ja KROKI_DIAGRAMSNET_HOST teenindab diagrams.neti
KROKI_COMMAND_TIMEOUT5 sekunditPikim ooteaeg diagrammi käivitatavale failile, näiteks dot
KROKI_CONVERT_TIMEOUT20 sekunditPikim ooteaeg Java teegile, näiteks PlantUML-ile
KROKI_DELEGATE_TIMEOUT_MS30 000Pikim ooteaeg kaaskonteinerile, millisekundites
KROKI_MAX_URI_LENGTH4096GET-i puhul lubatud URL-i pikkus, millest pikema korral vastab Kroki koodiga 414
KROKI_CONTENT_SECURITY_POLICYscript-src 'none'; object-src 'none'Päis Content-Security-Policy, mis saadetakse iga vastusega
KROKI_CORS_ALLOWED_HEADERSLisaks mitte ühtegiTäiendavad päised, mis on lubatud teiselt saidilt tehtud päringutele

Excalidraw’ diagrammid tekitavad pikki URL-e. Kui suurendate väärtust KROKI_MAX_URI_LENGTH, soovitab dokumentatsioon jääda 8192 märgi piiresse, kuigi enamik brausereid lubab sildis <img> rohkem. Kõige suuremate diagrammide puhul viib POST-päring lähteteksti kehas, mitte URL-is.

Kroki ei vaja töötamiseks ühtegi saladust. Kaks valikulist sätet sisaldavad seda: luba KROKI_COMPANION_REGISTRATION_TOKEN, mis on kasulik, kui lubate kolmandate osapoolte kaaskonteinerite registreerimise, millest räägib kaitset käsitlev jaotis, ja sertifikaadi privaatvõti, kui lasete Krokil HTTPS-i ise hallata. Hoidke neid väljaspool kõiki koodihoidlaid.

HTTPS: pöördproksi

Lüüs serveerib oma API-t HTTP kaudu. Selle ette pandud pöördproksi kuulab porte 80 ja 443, hangib Let’s Encrypti sertifikaadi, krüpteerib liikluse ja edastab selle Krokile aadressil 127.0.0.1:8000. Seal filtreeritakse ka ligipääsu, nagu näitab järgmine jaotis.

Caddy-ga

Caddy hangib ja uuendab antud nime sertifikaati ise ning selle direktiiv reverse_proxy edastab päised X-Forwarded-For, X-Forwarded-Proto ja X-Forwarded-Host ilma lisasätteta:

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

Nginxiga

See serveriplokk kuulab porti 80, et Certbot saaks HTTPS-i seadistada. Kaks Nginxi piirangut puutuvad kokku Kroki omadega: üle 1 MB suurune päringu keha lükatakse vaikimisi tagasi koodiga 413, mida client_max_body_size kohandab POST-iga saadetud suurte diagrammide jaoks; üle 8 KB pikkune päringurida saab koodi 414, mida large_client_header_buffers kohandab, kui suurendate väärtust KROKI_MAX_URI_LENGTH sellest suuremaks.

Nginxi plokk
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 ilma proksita

Dokumentatsioon kirjeldab ka krüpteerimist Kroki enda poolt: KROKI_SSL=true, sertifikaat ja privaatvõti PEM-vormingus, tekstina muutujate KROKI_SSL_CERT ja KROKI_SSL_KEY kaudu või failidena muutujate KROKI_SSL_CERT_PATH ja KROKI_SSL_KEY_PATH kaudu. Sertifikaadi uuendamine tehakse siis käsitsi, samas kui proksi ees hoolitsevad Caddy või Certbot selle eest ise.

Internetile avatud instantsi kaitsmine

Krokil ei ole autentimist: igaüks, kes API-ni jõuab, saab lasta sellel diagramme renderdada. Selle kaitse tugineb seega kolmele asjale, mida kirjeldavad dokumentatsioon ja väljalaskemärkmed: turvarežiim, suuruse ja aja piirangud ning see, mida proksi läbi laseb. Alustage sellest, et selgitate välja, kes peab teie serverini jõudma.

Kes teie serverit kutsub?

Turvarežiim

KROKI_SAFE_MODE määrab kolm taset, millest igaüks sisaldab eelmise piiranguid. Dokumentatsioon selgitab, et mõned teegid võivad lugeda faile või URL-e, näiteks PlantUML-i direktiivid !include, ja et Kroki, mis nende koodi üle ei vaata, blokeerib sellise ligipääsu vaikimisi. See kutsub kõiki serveri käitajaid valima oma kasutusele sobivat taset.

TaseMida see teeb
SECURE, vaikimisiTakistab igasugust katset lugeda faile failisüsteemist või ressursse võrgust
SAFETugineb päringute puhastamisele, mida teeb iga teegi enda turvarežiim
UNSAFELülitab välja kõik turvafunktsioonid

Avalikus instantsis hoidke režiimi SECURE. Päis Content-Security-Policy, mida saadetakse vaikimisi alates versioonist 0.36.0, täiendab seda kaitset: SVG-sse poetatud skript ei käivitu Kroki päritolul isegi siis, kui pilt avatakse otse.

Suuruse ja aja piirangud

Konfiguratsioonitabeli ajalõpud piiravad iga teisendust. Kaaskonteinerid lisavad omad, mis on mõeldud ressursside ammendamise vastu:

Ligipääsu piiramine proksis

Kui Krokit kutsub ainult teie avaldamisahel, on lihtsaim lahendus lubada ainult selle IP-aadress. Caddy puhul valib sobitaja remote_ip välja teised aadressid ja respond saadab neile koodi 403:

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

Nginxi puhul teevad sama töö ploki location direktiivid allow ja deny, kusjuures kehtib esimene sobiv reegel:

Nginxi plokk, location / sees
allow 203.0.113.10;
deny all;

Proksi põhiautentimine on teine tee: Caddy puhul basic_auth, mille parool räsitakse käsuga caddy hash-password, Nginxi puhul auth_basic ja käsuga htpasswd loodud fail. See sobib klientidele, mis saadavad mandaadid iga kutsega, näiteks curl -u; dokumentatsiooniahela puhul kontrollige, kas selle tööriist suudab neid edastada. Avalikuks jääva instantsi puhul saab Nginx ka piirata päringute arvu IP-aadressi kohta mooduliga limit_req, mis häälestatakse teie lehtede diagrammide arvu järgi.

Kolmandate osapoolte kaaskonteinerid

Kroki saab majutada kolmandate osapoolte kaaskonteinereid, mis registreeruvad API /services kaudu. See avastamine on vaikimisi välja lülitatud ja jääb režiimis SECURE alati väljalülitatuks. Kui lülitate selle sisse muutujaga KROKI_ENABLE_COMPANION_DISCOVERY=true, palub dokumentatsioon hoida /services usaldusväärses võrgus ja soovitab tungivalt luba KROKI_COMPANION_REGISTRATION_TOKEN: ilma selleta hoiatab Kroki käivitumisel, et iga lüüsi klient saab kaaskonteineri registreerida.

Asciidoctori, MkDocsi ja muude tööriistade ühendamine

Asciidoctor Kroki ja MkDocsi plugin on vaikimisi suunatud aadressile https://kroki.io. Neile piisab teie serveri URL-ist koos eesliitega https://.

Asciidoctor ja Antora

Laiendus Asciidoctor Kroki loeb atribuuti kroki-server-url dokumendi päises, käsureal või Antora playbookis. Lisage kroki-fetch-diagram, et laadida pildid alla ehitamise ajal, selle asemel et HTML viitaks teie serverile; see valik nõuab Asciidoctori turvarežiimi server või madalamat.

AsciiDoc-dokumendi päis
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:

MkDocs

Plugin mkdocs-kroki-plugin loeb sätet server_url, mille vaikeväärtus tuleb keskkonnamuutujast KROKI_SERVER_URL. Sättega http_method: POST salvestatakse pildid ehitatud saidil iga lehe kõrvale ja hoitakse kahe ehituse vahel vahemälus:

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

Muud integratsioonid

Dokumentatsiooni kolmandate osapoolte tööriistade leht loetleb ka GitLabi, mis renderdab Kroki diagramme Markdownis, AsciiDocis, reST-is ja Textile’is, samuti Sphinxi, Jekylli, Hugo, Remarki, Python-Markdowni, MediaWiki, laiendused Visual Studio Code’ile ja IntelliJ-le ning Kroki.jl-i Julia jaoks. Sobib ka iga HTTP-klient, nagu selles dokumentatsiooni näites:

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

Varukoopiad: konfiguratsioon, andmeid pole

Kroki on olekuta: see ei hoia kahe päringu vahel midagi alles ja isegi kolmandate osapoolte kaaskonteinerite register kaob pärast taaskäivitust. Teie diagrammide lähtetekst asub teie dokumentatsioonihoidlates ja nende pildid teie ehitatud saitidel. Kroki serveris varundatakse selle konfiguratsioon:

ElementMida see hoiabVarundada
compose.yamlTõmmised, nende sildid ja muutujad KROKI_*Jah
Fail .env, kui see on olemasVäljaspool faili compose.yaml hoitavad muutujad, näiteks luba või sertifikaatJah, turvalises kohas
Proksi konfiguratsioonCaddyfile või Nginxi plokk ja paroolifailJah
Dockeri tõmmisedTarkvara iseEi: docker compose pull laadib need uuesti alla
Terminal, compose.yaml-i kaustas
tar -czf kroki-config-$(date +%F).tar.gz compose.yaml /etc/caddy/Caddyfile

Kohandage loendit oma proksi järgi, tehke pärast iga konfiguratsioonimuudatust uus koopia ja saatke see serverist välja. Serveri kettal hoituna jõuab see ka selle öistesse varukoopiatesse. Taastamine tähendab nende failide tagasipanemist ja käsu docker compose up -d käivitamist.

Uuendused

Lukustatud siltide korral muutke failis compose.yaml nelja tõmmise versiooni ja seejärel käivitage selle kaustas:

Terminal
docker compose pull
docker compose up -d

Kroki järgib semantilist versioonimist ja iga versioon avaldab oma muudatused failis CHANGELOG.md ja oma väljalaskelehel. Lugege neid enne uuendamist, eriti nende jaotist „Security”: 5. novembril 2026 ilmunud 0.35.0 ja 9. novembril 2026 ilmunud 0.36.0 parandavad koodi kaugkäivitamise Bytefieldi ja TikZ-i diagrammide kaudu, XSS-turvaaugud GoAT-is ja DBML-is ning serveripoolse päringuvõltsingu BlockDiagi ja kaaskonteinerite kaudu. Avatud instantsis paigaldage need versioonid viivitamata.

Versioon 0.36.0 lisab ka vaikimisi päise Content-Security-Policy ja D2 jaoks paigutusmootori TALA. Käsitsi paigalduse jaoks dokumenteerib see minimaalse versioonina Java 21.

Kes mida teeb Managed VPS-is

Ise majutamine nõuab lisaks rakendusele ka serveri hoidmist. Managed VPS-is võtavad meie meeskonnad serveri enda hoole alla ja jälgivad teie instantsi proaktiivselt; Kroki jääb teie tarkvaraks oma konfiguratsiooni ja kaaskonteineritega.

TeemaMeie meeskonnadTeie
ServerSüsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatudHetk, mis sobib teie tegevusele
SeireServerit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamataTeie instantsi logide lugemine
KrokiProaktiivne jälgimine: vead, aeglus, kaaskonteinerite mälu ja kettaruum avastatakse, parandus soovitatakseSelle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent
Diagrammid ja ligipääsNeid renderdav server, jälgitud ja varundatudTurvarežiim, kaaskonteinerid, piirangud ja proksi ligipääsureeglid
VarukoopiadIgal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldubTeie konfiguratsiooni koopiad, mida hoiate mujal, ja taastamistaotlus, kui seda vajate
ÜleviimineTeie praeguse serveri üleviimine, tasutaÜmberlülitamise hetk

Kui eelistate, et meie meeskonnad sekkuksid rakendusse endasse, arveldatakse see teenus tunni- või kindlahinnaga, hinnapakkumine edastatakse enne sekkumist.

Kroki teie eest hoitud serveris

Simafri Managed VPS-iga hoiavad meie meeskonnad teie Kroki instantsi serveri ajakohasena, jälgivad seda päeval ja öösel ning sekkuvad ilma teie kõnet ootamata; nad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, mille rakendate ise või oma tehisintellekti assistendiga. Varukoopiad krüpteeritakse igal ööl ja hoitakse väljaspool masinat, nende taastamine sisaldub hinnas ning teie praeguse serveri üleviimine on tasuta.

Vaadake Managed VPS

Korduma kippuvad küsimused

Kas Kroki on ettevõttele tasuta?

Jah. Kroki on MIT-litsentsiga: võite seda ettevõttes kasutada, muuta ja edasi levitada, ilma et peaksite litsentsi ostma, tingimusel et säilitate selle autoriõiguse teate. Jääb ainult seda käitava serveri hind.

Kas ma vajan Kroki kaaskonteinereid?

Ainult nende renderdatavate diagrammide jaoks. Tõmmisest yuzutech/kroki piisab PlantUML-i, GraphVizi, D2, Structurizri ja enamiku vormingute jaoks. Mermaid, BPMN, Excalidraw ja diagrams.net vajavad igaüks oma kaaskonteinerit, mis ühendatakse muutujaga KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST või KROKI_DIAGRAMSNET_HOST.

Kuidas paigaldada Kroki Docker Compose’iga?

Looge compose.yaml tõmmisega yuzutech/kroki, mille port 8000 on avaldatud aadressil 127.0.0.1, ning vajalike kaaskonteineritega, näiteks yuzutech/kroki-mermaid, mis ühendatakse muutujatega KROKI_*_HOST. Käivitage docker compose up -d, kontrollige /health ja pange seejärel pordi 8000 ette HTTPS-iga pöördproksi.

Kas Krokil on administraatorikonto?

Ei, Krokil ei ole kontosid, halduslehte ega andmebaasi. Selle konfiguratsioon on keskkonnamuutujate KROKI_* kogum ja ligipääsu API-le kontrollitakse pöördproksis IP-aadressi järgi või põhiautentimisega.

Kuidas kaitsta avalikku Kroki instantsi?

Hoidke vaikimisi sisselülitatud režiimi SECURE, mis takistab teekidel faile või võrku lugemast. Jätke aja- ja suurusepiirangud kehtima, uuendage kohe, kui mõni versioon parandab turvaaugu, ja kui Krokit kutsub ainult teie avaldamisahel, lubage proksis ainult selle aadress.

Kuidas kasutada oma Kroki serverit Asciidoctori või MkDocsiga?

Asciidoctori puhul määrake atribuudile kroki-server-url oma serveri URL ja lisage kroki-fetch-diagram, et pildid ehitamise ajal alla laadida. MkDocsi puhul määrake plugina kroki konfiguratsioonis server_url ja lisage http_method: POST, et pildid saidiga koos salvestada.

Mida Kroki serveris varundada?

Ainult selle konfiguratsiooni: compose.yaml, võimalik fail .env ja pöördproksi konfiguratsioon. Kroki ei hoia andmeid ja selle Dockeri tõmmised laaditakse uuesti alla käsuga docker compose pull.

Kas Managed VPS katab Kroki?

Managed VPS katab serveri: süsteem, turvalisus, seire ja varukoopiad. Meie meeskonnad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, mille rakendate teie. Sekkumine rakendusse arveldatakse tunni- või kindlahinnaga.

Allikad ja ametlik dokumentatsioon

Võtke meiega ühendust