Kroki hosztolása Managed VPS-en: diagramjai a saját szerverén renderelve

A Kroki hosztolása Managed VPS-en azt jelenti, hogy PlantUML-, Mermaid-, GraphViz-, D2-, BPMN- vagy Excalidraw-diagramjait egy saját gépen rendereli, amelyet csapataink naprakészen tartanak, és éjjel-nappal felügyelnek. A Kroki MIT licenc alatt álló szabad szoftver. Ez az útmutató a hivatalos dokumentációját követi: az átjárót és kísérő konténereit, a telepítést Docker Compose-zal, a konfigurációt, a HTTPS-t, a nyilvános példány védelmét, az Asciidoctor és az MkDocs bekötését, a mentéseket és a frissítéseket.

Simon Vasconcelos Lee Szerző: Közzétéve 2026. november 20-ánOlvasási idő: 14 perc

Minden útmutató

A lényeg röviden

  1. Az MIT licenc lehetővé teszi, hogy a Krokit szabadon használja, módosítsa és továbbterjessze, munkában vagy bárhol máshol, amennyiben megtartja a szerzői jogi megjegyzését.
  2. A Kroki egyetlen HTTP API-n keresztül alakítja képpé a szövegként leírt diagramot: a PlantUML, a GraphViz, a D2, a Structurizr és még sok más a yuzutech/kroki image része.
  3. A Mermaidnak, a BPMN-nek, az Excalidraw-nak és a diagrams.net-nek egyenként saját kísérő konténer kell, amelyet a KROKI_*_HOST változók kötnek az átjáróhoz: a Docker Compose együtt indítja őket.
  4. A Krokinak nincsenek fiókjai és nincs adatbázisa. SECURE módban indul, amely megakadályozza, hogy fájlokat olvasson vagy a hálózathoz forduljon; a nyilvános példányhoz való hozzáférést a fordított proxyn szabályozza.
  5. Mentse a konfigurációt, a compose.yaml fájlt és a proxy beállításait, majd frissítsen a docker compose pull paranccsal, előtte minden kiadási megjegyzést elolvasva.

Mit csinál a Kroki

A Kroki egységes HTTP API-t kínál, amely szövegként leírt diagramot fogad, és képet ad vissza. Az Ön dokumentációja, wikije vagy kódkezelő platformja elküldi a diagram forrását; a Kroki SVG-vel, a diagram típusától függően PNG-vel, PDF-fel vagy JPEG-gel válaszol. A README-je a következőket sorolja fel: BlockDiag, BPMN, Bytefield, C4 a PlantUML-lel, D2, DBML, diagrams.net, Ditaa, Erd, Excalidraw, GoAT, GraphViz, Lini, Mermaid, Nomnoml, Pikchr, PlantUML, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom és WireViz.

Az Asciidoctor Kroki bővítmény dokumentációja három okot hoz fel arra, hogy saját szervert futtasson a nyilvános kroki.io példány helyett: egy vállalati tűzfal, amely blokkolja, a késleltetés, ha messze van ettől az európai példánytól, és a bizalmasság, ha a diagramok forrásának az Ön infrastruktúráján belül kell maradnia.

Mit enged meg az MIT licenc

A Kroki az MIT licenc alatt jelenik meg. Ez díjmentesen biztosítja a szoftver használatának, másolásának, módosításának, egyesítésének, közzétételének, terjesztésének, allicencelésének és a másolatok értékesítésének jogát. Futtathatja tehát vállalkozása, csapata vagy ügyfelei számára, licencvásárlás nélkül.

Az egyetlen feltétel a szerzői jogi megjegyzés és a licenc szövegének megtartása a szoftver minden másolatában vagy lényeges részében. A szöveg a szoftvert „ahogy van” állapotban, garancia nélkül adja. A Kroki által tartalmazott diagramkönyvtárak mindegyike megtartja a saját licencét.

Az átjáró és kísérő konténerei

A Kroki moduláris felépítésű. Egy Javában, Vert.x-re írt átjáró fogad minden kérést, és a megfelelő könyvtárhoz irányítja. Csak a yuzutech/kroki image kötelező: a dokumentáció megjegyzi, hogy diagramjaitól függően ez akár elég is lehet.

ImageMit renderelKötelező
yuzutech/krokiAz átjárót, továbbá az ActDiag, BlockDiag, Bytefield, D2, Ditaa, Erd, GoAT, GraphViz, Lini, Nomnoml, NwDiag, PacketDiag, Pikchr, PlantUML és C4, RackDiag, SeqDiag, Structurizr, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom és WireViz diagramokatIgen
yuzutech/kroki-mermaidMermaid: folyamatábrák, szekvenciadiagramok és Gantt-diagramokNem
yuzutech/kroki-bpmnBPMN, a bpmn-js segítségévelNem
yuzutech/kroki-excalidrawExcalidraw, a kézzel rajzolt stílusNem
yuzutech/kroki-diagramsnetdiagrams.net, még kísérletiNem

A szerver méretezése

A dokumentáció nem ad meg számot sem a memóriára, sem a processzorra. Azt viszont megmondja, mi terhel a legjobban: a Mermaid, a BPMN, az Excalidraw és a diagrams.net kísérő konténerei minden diagramot egy grafikus felület nélküli (headless) Chromium böngészőben renderelnek. Hogy egy átalakítási hullám ne lépje túl a konténer memóriáját, mindegyik korlátozza az egyidejű renderelések számát: alapértelmezésben 6-ra a Mermaid, a BPMN és a diagrams.net, 4-re az Excalidraw esetében. A további kérések sorban várják, hogy rájuk kerüljön a sor.

Egy Managed VPS esetén elég leírnia nekünk a diagramjait, a hozzájuk szükséges kísérő konténereket és a várható forgalmat, és mi javasoljuk a megfelelő méretet.

Telepítés Docker Compose-zal

A dokumentáció konténereket ajánl, Dockert vagy Podmant, hogy ne kelljen minden könyvtárat kézzel telepítenie. Egy Dockerrel ellátott szerveren hozzon létre egy mappát, és tegye bele ezt a dokumentációból átvett compose.yaml fájlt:

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"
Terminál
docker compose up -d

A még kísérleti diagrams.net számára a README egy negyedik kísérő konténert ad hozzá. Vegye fel ezt a szolgáltatást, valamint a KROKI_DIAGRAMSNET_HOST=diagramsnet változót a kroki szolgáltatás environment részébe:

compose.yaml, hozzáadandó szolgáltatás
  diagramsnet:
    image: yuzutech/kroki-diagramsnet:0.36.0
    restart: unless-stopped
    expose:
      - "8005"

Annak ellenőrzése, hogy minden válaszol

A szerverről a /health útvonal visszaadja az átjáró állapotát és a benne lévő könyvtárak verzióit. A következő két kérés egy GraphViz-diagramot renderel az átjárón keresztül, majd egy Mermaid-diagramot a kísérő konténerén keresztül:

Terminál, a szerveren
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'

Docker nélkül: az önálló jar

A dokumentáció másik útja az önálló szerver, amely a tároló kiadási oldalán jelenik meg kroki-standalone-server-v0.36.0.jar néven. Java 21-et vagy újabbat igényel, és egyetlen diagramkönyvtárat sem tartalmaz: mindegyiket külön kell telepíteni, az elérési útját pedig egy változó adja meg, például a KROKI_DOT_BIN_PATH, ha a futtatható fájl nincs a PATH útvonalon. A figyelési címhez inkább a KROKI_LISTEN változót használja, mert a konfigurációs dokumentáció bejelenti a KROKI_PORT megszüntetését:

Terminál
KROKI_LISTEN=127.0.0.1:8000 java -jar kroki-standalone-server-v0.36.0.jar

Konfiguráció: változók, fiókok és adatbázis nélkül

A Krokinak nincs adminisztrációs oldala, nincsenek felhasználói fiókjai és nincs adatbázisa: a konfigurációja környezeti változók összessége, a jar esetében Java rendszertulajdonságoké. Docker Compose-ban ezek az adott szolgáltatás environment blokkjába kerülnek, majd a docker compose up -d újra létrehozza a konténert. A szerver szempontjából legfontosabb beállítások:

VáltozóAlapértelmezésMire szolgál
KROKI_SAFE_MODEsecureA biztonsági szint, lent részletezve
KROKI_LISTENMinden interfész, 8000-es portA figyelési cím és port; UNIX socketet is elfogad, unix:// után egy elérési úttal
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST127.0.0.1Hol éri el az átjáró az egyes kísérő konténereket; a megfelelő _PORT változók adják meg a portot, a KROKI_DIAGRAMSNET_HOST pedig a diagrams.net-et szolgálja
KROKI_COMMAND_TIMEOUT5 másodpercA leghosszabb várakozás egy diagramot készítő futtatható fájlra, például a dot programra
KROKI_CONVERT_TIMEOUT20 másodpercA leghosszabb várakozás egy Java-könyvtárra, például a PlantUML-re
KROKI_DELEGATE_TIMEOUT_MS30 000A leghosszabb várakozás egy kísérő konténerre, ezredmásodpercben
KROKI_MAX_URI_LENGTH4096A GET esetén elfogadott URL-hossz, amely felett a Kroki 414-es kóddal válaszol
KROKI_CONTENT_SECURITY_POLICYscript-src 'none'; object-src 'none'A minden válasszal elküldött Content-Security-Policy fejléc
KROKI_CORS_ALLOWED_HEADERSNincs továbbiMás webhelyről érkező hívásokhoz engedélyezett további fejlécek

Az Excalidraw-diagramok hosszú URL-eket hoznak létre. Ha megemeli a KROKI_MAX_URI_LENGTH értékét, a dokumentáció azt javasolja, hogy maradjon legfeljebb 8192 karakternél, még ha a legtöbb böngésző egy <img> címkében többet is elfogad. A legnagyobb diagramoknál a POST-kérés a forrást a törzsben viszi, nem az URL-ben.

A Krokinak a működéséhez nincs szüksége titkos adatra. Két opcionális beállítás tartalmaz ilyet: a KROKI_COMPANION_REGISTRATION_TOKEN token, amely akkor hasznos, ha engedélyezi harmadik féltől származó kísérő konténerek regisztrációját, erről a védelemről szóló rész szól, valamint egy tanúsítvány privát kulcsa, ha a HTTPS kezelését magára a Krokira bízza. Tartsa őket minden kódtárolón kívül.

HTTPS: a fordított proxy

Az átjáró HTTP-n szolgálja ki az API-ját. Az elé helyezett fordított proxy a 80-as és a 443-as porton figyel, beszerzi a Let’s Encrypt-tanúsítványt, titkosítja a forgalmat, és továbbítja azt a Krokinak a 127.0.0.1:8000 címre. Ugyanitt szűrhető a hozzáférés is, ahogy a következő rész mutatja.

Caddyvel

A Caddy maga szerzi be és újítja meg a megadott névre szóló tanúsítványt, a reverse_proxy direktívája pedig további beállítás nélkül továbbítja az X-Forwarded-For, az X-Forwarded-Proto és az X-Forwarded-Host fejlécet:

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

Nginxszel

Ez a szerverblokk a 80-as porton figyel, hogy a Certbot beállíthassa a HTTPS-t. Az Nginx két korlátja találkozik a Kroki korlátaival: az 1 MB-nál nagyobb kéréstörzset alapértelmezésben 413-as kóddal elutasítja, ezt a client_max_body_size igazítja a POST-tal küldött nagy diagramokhoz; a 8 KB-nál hosszabb kérési sor 414-es kódot kap, ezt a large_client_header_buffers igazítja, ha a KROKI_MAX_URI_LENGTH értékét e fölé emeli.

Nginx-blokk
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;
    }
}
Terminál
sudo nginx -t
sudo certbot --nginx

HTTPS proxy nélkül

A dokumentáció a Kroki által végzett titkosítást is leírja: KROKI_SSL=true, a tanúsítvánnyal és a privát kulccsal PEM formátumban, szövegként a KROKI_SSL_CERT és a KROKI_SSL_KEY, vagy fájlként a KROKI_SSL_CERT_PATH és a KROKI_SSL_KEY_PATH változón keresztül. A tanúsítvány megújítása ekkor kézzel történik, míg proxy mögött a Caddy vagy a Certbot magától gondoskodik róla.

Az internet felé nyitott példány védelme

A Krokinak nincs hitelesítése: bárki, aki eléri az API-t, diagramokat renderelhet vele. Védelme ezért három dologra épül, amelyeket a dokumentáció és a kiadási megjegyzések írnak le: a biztonsági módra, a méret- és időkorlátokra, valamint arra, amit a proxy átenged. Kezdje azzal, hogy tisztázza, kinek kell elérnie a szerverét.

Ki hívja a szerverét?

A biztonsági mód

A KROKI_SAFE_MODE három szintet határoz meg, amelyek mindegyike magában foglalja az előző korlátozásait. A dokumentáció elmagyarázza, hogy egyes könyvtárak képesek fájlokat vagy URL-eket olvasni, például a PlantUML !include direktívái, és hogy a Kroki, amely nem vizsgálja át a kódjukat, alapértelmezésben blokkolja az ilyen hozzáférést. Mindenkit, aki szervert üzemeltet, arra kér, hogy a használatának megfelelő szintet válassza.

SzintMit csinál
SECURE, az alapértelmezésMegakadályoz minden kísérletet fájlok olvasására a fájlrendszerből vagy erőforrások olvasására a hálózatról
SAFEAz egyes könyvtárak saját biztonságos módja által végzett kéréstisztításra támaszkodik
UNSAFEKikapcsol minden biztonsági funkciót

Nyilvános példányon tartsa meg a SECURE módot. A 0.36.0 óta alapértelmezésben küldött Content-Security-Policy fejléc kiegészíti ezt a védelmet: egy SVG-be csempészett szkript nem fut le a Kroki eredetén (origin), még akkor sem, ha a képet közvetlenül nyitják meg.

Méret- és időkorlátok

A konfigurációs táblázat időkorlátai minden átalakítást behatárolnak. A kísérő konténerek saját korlátokat is hozzáadnak, az erőforrások kimerítése ellen:

A hozzáférés korlátozása a proxyn

Ha a Krokit csak a közzétételi folyamata hívja, a legegyszerűbb, ha kizárólag annak IP-címét fogadja el. Caddyvel a remote_ip illesztő kiválasztja a többi címet, a respond pedig 403-as kódot küld nekik:

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

Nginxszel a location blokk allow és deny direktívái végzik ugyanezt, és az első illeszkedő szabály érvényes:

Nginx-blokk, a location / részen belül
allow 203.0.113.10;
deny all;

A másik út a proxy alapszintű hitelesítése: Caddyvel a basic_auth, amelynek jelszavát a caddy hash-password paranccsal kell hash-elni, Nginxszel az auth_basic és egy htpasswd segítségével létrehozott fájl. Olyan klienseknek való, amelyek minden hívással elküldik a hitelesítő adatokat, mint a curl -u; dokumentációs folyamatnál ellenőrizze, hogy az eszköze képes-e továbbítani őket. Nyilvános maradó példány esetén az Nginx a limit_req modullal az IP-címenkénti kérésszámot is korlátozhatja, az oldalain lévő diagramok számához igazítva.

Harmadik féltől származó kísérő konténerek

A Kroki képes befogadni harmadik féltől származó kísérő konténereket, amelyek a /services API-n keresztül regisztrálnak. Ez a felderítés alapértelmezésben ki van kapcsolva, és SECURE módban mindig kikapcsolva marad. Ha a KROKI_ENABLE_COMPANION_DISCOVERY=true beállítással bekapcsolja, a dokumentáció azt kéri, hogy a /services végpontot megbízható hálózaton tartsa, és nyomatékosan ajánlja a KROKI_COMPANION_REGISTRATION_TOKEN tokent: enélkül a Kroki indításkor figyelmeztet, hogy az átjáró bármely kliense regisztrálhat kísérő konténert.

Az Asciidoctor, az MkDocs és más eszközök bekötése

Az Asciidoctor Kroki és az MkDocs-bővítmény alapértelmezésben a https://kroki.io címet célozza. Csak a szervere URL-jére van szükségük, a https:// előtaggal együtt.

Asciidoctor és Antora

Az Asciidoctor Kroki bővítmény a kroki-server-url attribútumot olvassa, a dokumentum fejlécében, a parancssorban vagy az Antora playbookban. Adja hozzá a kroki-fetch-diagram attribútumot, hogy a képek az összeállításkor letöltődjenek, ahelyett, hogy a HTML az Ön szerverére mutatna; ez a beállítás server vagy alacsonyabb Asciidoctor biztonsági módot igényel.

AsciiDoc-dokumentum fejléce
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:

MkDocs

A mkdocs-kroki-plugin bővítmény a server_url beállítást olvassa, amelynek alapértéke a KROKI_SERVER_URL környezeti változó. A http_method: POST beállítással a képek az összeállított webhelyen minden oldal mellé mentődnek, és két összeállítás között gyorsítótárban maradnak:

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

Egyéb integrációk

A dokumentáció harmadik féltől származó eszközökről szóló oldala felsorolja a GitLabet is, amely Markdownban, AsciiDocban, reST-ben és Textile-ban rendereli a Kroki-diagramokat, továbbá a Sphinxet, a Jekyllt, a Hugót, a Remarkot, a Python-Markdownt, a MediaWikit, a Visual Studio Code és az IntelliJ bővítményeit, valamint a Julia nyelvhez készült Kroki.jl-t. Bármely HTTP-kliens is működik, mint a dokumentáció alábbi példájában:

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

Mentések: konfiguráció, adat nélkül

A Kroki állapotmentes: két kérés között semmit sem őriz meg, és újraindítás után még a harmadik féltől származó kísérő konténerek nyilvántartása is eltűnik. Diagramjainak forrása a dokumentációs tárolóiban él, a képeik pedig az összeállított webhelyeken. A Kroki-szerveren a konfigurációt kell menteni:

ElemMit tartalmazMentendő
compose.yamlAz image-eket, a címkéiket és a KROKI_* változókatIgen
.env fájl, ha vanA compose.yaml fájlon kívül tartott változókat, például egy tokent vagy egy tanúsítványtIgen, biztonságos helyen
A proxy konfigurációjaA Caddyfile fájlt vagy az Nginx-blokkot, és a jelszófájltIgen
Docker image-ekMagát a szoftvertNem: a docker compose pull újra letölti őket
Terminál, a compose.yaml mappájában
tar -czf kroki-config-$(date +%F).tar.gz compose.yaml /etc/caddy/Caddyfile

Igazítsa a listát a proxyjához, minden konfigurációs változtatás után készítsen új másolatot, és küldje el a szerveren kívülre. A szerver lemezén tárolva az éjszakai mentéseibe is bekerül. A visszaállítás ezeknek a fájloknak a visszahelyezését és a docker compose up -d futtatását jelenti.

Frissítések

Rögzített címkék esetén módosítsa a négy image verzióját a compose.yaml fájlban, majd annak mappájából:

Terminál
docker compose pull
docker compose up -d

A Kroki a szemantikus verziózást követi, és minden verzió a CHANGELOG.md fájlban és a saját kiadási oldalán teszi közzé a változásait. Olvassa el ezeket frissítés előtt, különösen a „Security” részüket: a 2026. november 5-i 0.35.0 és a 2026. november 9-i 0.36.0 javítja a Bytefield- és TikZ-diagramokon keresztüli távoli kódfuttatást, a GoAT és a DBML XSS-hibáit, valamint a BlockDiagon és a kísérő konténereken keresztüli szerveroldali kéréshamisítást. Nyitott példányon telepítse ezeket a verziókat késlekedés nélkül.

A 0.36.0-s verzió az alapértelmezett Content-Security-Policy fejlécet és a D2-höz a TALA elrendezőmotort is hozzáadja. A kézi telepítéshez a Java 21-et dokumentálja minimális verzióként.

Ki mit csinál egy Managed VPS-en

A saját üzemeltetés az alkalmazás mellett a szerver gondozását is megköveteli. Egy Managed VPS esetén csapataink átveszik a szervert, és proaktívan követik a példányát; a Kroki továbbra is az Ön szoftvere marad, a konfigurációjával és a kísérő konténereivel.

TémaCsapatainkÖn
A szerverRendszer- és biztonsági frissítések, a szerveren végzett beavatkozásokkal együttA tevékenységének megfelelő időpont
A felügyeletÉjjel-nappal, a hét minden napján követett szerver, beavatkozás a hívására való várakozás nélkülA példánya naplóinak olvasása
KrokiProaktív követés: a hibák, lassulások, a kísérő konténerek memóriájának és a lemezterületnek az észlelése, javítás ajánlásaA telepítése, a frissítései és a beállításai, amelyeket Ön vagy MI-asszisztense alkalmaz
A diagramok és a hozzáférésA szerver, amely rendereli őket, felügyelve és mentveA biztonsági mód, a kísérő konténerek, a korlátok és a proxy hozzáférési szabályai
A mentésekMinden éjjel, titkosítva és a gépen kívül őrizve; a visszaállítással együttA konfigurációjáról máshol őrzött másolatok, és a visszaállítási kérés, amikor szüksége van rá
Az átköltöztetésA jelenlegi szervere átköltöztetve, ingyenesenAz átállás időpontja

Ha inkább azt szeretné, hogy csapataink magában az alkalmazásban avatkozzanak be, ez a szolgáltatás óradíjban vagy átalánydíjban számlázódik, a beavatkozás előtt közölt árajánlattal.

A Kroki egy Ön helyett karbantartott szerveren

Egy Simafri Managed VPS esetében csapataink naprakészen tartják Kroki-példánya szerverét, éjjel-nappal felügyelik, és beavatkoznak anélkül, hogy a hívására várnának; proaktívan a példányát is követik, és javasolják a hasznos javításokat, amelyeket Ön vagy MI-asszisztense alkalmaz. A mentések minden éjjel titkosítva, a gépen kívül készülnek, a visszaállításuk a díj része, jelenlegi szervere átköltöztetése pedig ingyenes.

Tovább a Managed VPS oldalára

Gyakori kérdések

Ingyenes a Kroki egy vállalkozás számára?

Igen. A Kroki MIT licenc alatt áll: a munkahelyén licencvásárlás nélkül használhatja, módosíthatja és továbbterjesztheti, amennyiben megtartja a szerzői jogi megjegyzését. Ami marad, az a futtató szerver költsége.

Szükség van a Kroki kísérő konténereire?

Csak az általuk renderelt diagramokhoz. A yuzutech/kroki image elég a PlantUML, a GraphViz, a D2, a Structurizr és a legtöbb formátum számára. A Mermaidnak, a BPMN-nek, az Excalidraw-nak és a diagrams.net-nek egyenként saját kísérő konténer kell, amelyet a KROKI_MERMAID_HOST, a KROKI_BPMN_HOST, a KROKI_EXCALIDRAW_HOST vagy a KROKI_DIAGRAMSNET_HOST köt be.

Hogyan telepíthető a Kroki Docker Compose-zal?

Hozzon létre egy compose.yaml fájlt a yuzutech/kroki image-dzsel, a 127.0.0.1 címen közzétett 8000-es portjával és a szükséges kísérő konténerekkel, például a yuzutech/kroki-mermaid image-dzsel, a KROKI_*_HOST változókon keresztül bekötve. Futtassa a docker compose up -d parancsot, ellenőrizze a /health útvonalat, majd helyezzen egy HTTPS-t használó fordított proxyt a 8000-es port elé.

Van a Krokinak adminisztrátori fiókja?

Nincs, a Krokinak nincsenek fiókjai, nincs adminisztrációs oldala és nincs adatbázisa. A konfigurációja KROKI_* környezeti változók összessége, az API-hoz való hozzáférést pedig a fordított proxyn szabályozza, IP-cím szerint vagy alapszintű hitelesítéssel.

Hogyan védhető egy nyilvános Kroki-példány?

Tartsa meg az alapértelmezésben bekapcsolt SECURE módot, amely megakadályozza, hogy a könyvtárak fájlokat olvassanak vagy a hálózathoz forduljanak. Hagyja érvényben az idő- és méretkorlátokat, frissítsen, amint egy verzió sérülékenységet javít, és ha a Krokit csak a közzétételi folyamata hívja, a proxyn csak annak címét fogadja el.

Hogyan használható a saját Kroki-szerver az Asciidoctorral vagy az MkDocsszal?

Az Asciidoctorban állítsa a kroki-server-url attribútumot a szervere URL-jére, a kroki-fetch-diagram attribútummal pedig a képek az összeállításkor töltődnek le. Az MkDocsban a kroki bővítmény konfigurációjában adja meg a server_url beállítást, a http_method: POST beállítással pedig a képek a webhellyel együtt mentődnek.

Mit kell menteni egy Kroki-szerveren?

Csak a konfigurációját: a compose.yaml fájlt, az esetleges .env fájlt és a fordított proxy konfigurációját. A Kroki nem őriz adatot, a Docker image-ei pedig a docker compose pull paranccsal újra letölthetők.

Egy Managed VPS lefedi a Krokit?

Egy Managed VPS a szervert fedi le: a rendszert, a biztonságot, a felügyeletet és a mentéseket. Csapataink proaktívan a példányát is követik, és javasolják a hasznos javításokat, amelyeket Ön alkalmaz. Az alkalmazáson belüli beavatkozás óradíjban vagy átalánydíjban számlázódik.

Források és hivatalos dokumentáció

Kapcsolódó útmutatók

BookStack hosztolása Managed VPS-en: dokumentációja a saját szerverénA BookStack hosztolása Managed VPS-en azt jelenti, hogy a dokumentációját egy saját gépen tartja, amelyet csapataink naprakészen tartanak, és éjjel-nappal felügyelnek. A BookStack MIT licenc alatt álló szabad szoftver, egyszerűen üzemeltethető: PHP, MySQL vagy MariaDB és egy webszerver, Docker nélkül. Ez az útmutató a hivatalos dokumentációját követi: a telepítést, a HTTPS-t, az adatokat, az e-maileket, a biztonságot, a mentéseket és a frissítéseket.Mennyi RAM kell egy VPS-hez: a szabály, felhasználás szerintMennyi RAM kell egy VPS-hez? A memória az az erőforrás, amely a leggyakrabban meghatározza egy szerver méretét: ez fogy el elsőként, és amikor elfogy, a szerver nem lelassul, hanem szolgáltatásokat állít le. Ez az útmutató megadja a számítási szabályt, azt, hogy egy alkalmazás egyes elemei mennyi memóriát használnak, tipikus profilokat, valamint a mérés módját egy már futó szerveren.Menedzselt és nem menedzselt VPS közötti különbség: ki mit végezA menedzselt és a nem menedzselt VPS közötti különbség egyetlen kérdésen múlik: ki gondoskodik a szerverről, miután az már fut. A „menedzselt” szónak ugyanakkor nincs hivatalos meghatározása: szolgáltatónként a rendszer egyszerű telepítésétől a szerver teljes üzemeltetéséig terjedhet a jelentése. Ez az útmutató megmutatja, ki mit végez, feladatról feladatra, a támogatás köztes szintjével együtt, és megadja azokat a kérdéseket, amelyek aláírás előtt eloszlatják a kétértelműséget.
Kapcsolatfelvétel