Mitināt Kroki Managed VPS serverī: jūsu diagrammas, ģenerētas jūsu serverī

Mitināt Kroki Managed VPS serverī nozīmē ģenerēt savas PlantUML, Mermaid, GraphViz, D2, BPMN vai Excalidraw diagrammas uz savas mašīnas, ko mūsu komandas uztur atjauninātu un uzrauga dienu un nakti. Kroki ir atvērtā koda programmatūra ar MIT licenci. Šis ceļvedis seko tā oficiālajai dokumentācijai: vārteja un tās pavadošie konteineri, uzstādīšana ar Docker Compose, konfigurācija, HTTPS, publiskas instances aizsardzība, Asciidoctor un MkDocs pievienošana, rezerves kopijas un atjauninājumi.

Simon Vasconcelos Lee Autors: Publicēts 2026. gada 20. novembrīLasīšanas laiks: 14 minūtes

Visi ceļveži

Galvenais

  1. MIT licence ļauj Kroki brīvi izmantot, mainīt un izplatīt tālāk, gan darbā, gan citur, ja vien saglabājat tā autortiesību paziņojumu.
  2. Kroki pārvērš tekstā aprakstītu diagrammu attēlā, izmantojot vienu HTTP API: PlantUML, GraphViz, D2, Structurizr un daudzi citi jau ir iekļauti attēlā yuzutech/kroki.
  3. Mermaid, BPMN, Excalidraw un diagrams.net katram vajadzīgs savs pavadošais konteiners, kas savienots ar vārteju ar mainīgajiem KROKI_*_HOST: Docker Compose tos palaiž kopā.
  4. Kroki nav ne kontu, ne datubāzes. Tas startē režīmā SECURE, kas neļauj tam lasīt failus vai tīklu; piekļuvi publiskai instancei kontrolē reversajā starpniekserverī.
  5. Veidojiet rezerves kopijas konfigurācijai, compose.yaml un starpniekservera iestatījumiem, pēc tam atjauniniet ar docker compose pull, vispirms izlasot katras versijas piezīmes.

Ko dara Kroki

Kroki nodrošina vienotu HTTP API, kas pieņem tekstā aprakstītu diagrammu un atgriež attēlu. Jūsu dokumentācija, wiki vai koda platforma nosūta diagrammas avotu; Kroki atbild ar SVG un atkarībā no diagrammas veida ar PNG, PDF vai JPEG. Tā README uzskaita BlockDiag, BPMN, Bytefield, C4 ar PlantUML, D2, DBML, diagrams.net, Ditaa, Erd, Excalidraw, GoAT, GraphViz, Lini, Mermaid, Nomnoml, Pikchr, PlantUML, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom un WireViz.

Paplašinājuma Asciidoctor Kroki dokumentācija min trīs iemeslus darbināt savu serveri publiskās instances kroki.io vietā: uzņēmuma ugunsmūri, kas to bloķē, aizkavi, ja atrodaties tālu no šīs Eiropas instances, un privātumu, ja diagrammu avotiem jāpaliek jūsu infrastruktūrā.

Ko atļauj MIT licence

Kroki tiek publicēts ar MIT licenci. Tā bez maksas piešķir tiesības izmantot, kopēt, mainīt, apvienot, publicēt, izplatīt, apakšlicencēt un pārdot programmatūras kopijas. Tāpēc varat to darbināt savam uzņēmumam, komandai vai klientiem, nepērkot nekādu licenci.

Vienīgais nosacījums ir saglabāt autortiesību paziņojumu un licences tekstu visās programmatūras kopijās vai tās būtiskās daļās. Teksts nodrošina programmatūru „tādu, kāda tā ir“, bez garantijas. Kroki iekļautās diagrammu bibliotēkas katra saglabā savu licenci.

Vārteja un tās pavadošie konteineri

Kroki ir modulāra arhitektūra. Java valodā uz Vert.x uzrakstīta vārteja saņem katru pieprasījumu un novirza to uz pareizo bibliotēku. Obligāts ir tikai attēls yuzutech/kroki: dokumentācija norāda, ka atkarībā no jūsu diagrammām ar to var pietikt.

AttēlsKo tas ģenerēObligāts
yuzutech/krokiVārteju, kā arī ActDiag, BlockDiag, Bytefield, D2, Ditaa, Erd, GoAT, GraphViz, Lini, Nomnoml, NwDiag, PacketDiag, Pikchr, PlantUML un C4, RackDiag, SeqDiag, Structurizr, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom un WireVizJā
yuzutech/kroki-mermaidMermaid: blokshēmas, secību diagrammas un Ganta diagrammasNē
yuzutech/kroki-bpmnBPMN, ar bpmn-jsNē
yuzutech/kroki-excalidrawExcalidraw, ar roku zīmēts stilsNē
yuzutech/kroki-diagramsnetdiagrams.net, vēl eksperimentālsNē

Servera izmēra noteikšana

Dokumentācija nesniedz skaitļus par atmiņu vai procesoru. Tomēr tā norāda, kas noslogo visvairāk: pavadošie konteineri Mermaid, BPMN, Excalidraw un diagrams.net ģenerē katru diagrammu Chromium pārlūkā bez grafiskās saskarnes (headless). Lai pārveidojumu uzplūds nepārsniegtu konteinera atmiņu, katrs no tiem ierobežo vienlaicīgo ģenerēšanu skaitu: pēc noklusējuma 6 Mermaid, BPMN un diagrams.net, 4 Excalidraw. Nākamie pieprasījumi gaida savu kārtu rindā.

Ar Managed VPS pastāstiet mums par savām diagrammām, tām vajadzīgajiem pavadošajiem konteineriem un gaidāmo datplūsmu, un mēs ieteiksim piemērotu izmēru.

Uzstādīšana ar Docker Compose

Dokumentācija iesaka konteinerus, Docker vai Podman, lai katra bibliotēka nebūtu jāuzstāda ar roku. Serverī, kurā ir uzstādīts Docker, izveidojiet mapi un ievietojiet tajā šo no dokumentācijas ņemto 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"
Terminālis
docker compose up -d

Vēl eksperimentālajam diagrams.net README pievieno ceturto pavadošo konteineru. Pievienojiet šo pakalpojumu, kā arī mainīgo KROKI_DIAGRAMSNET_HOST=diagramsnet pakalpojuma kroki sadaļai environment:

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

Pārbaude, ka viss atbild

No servera maršruts /health atgriež vārtejas stāvokli un tajā iekļauto bibliotēku versijas. Nākamie divi pieprasījumi ģenerē GraphViz diagrammu caur vārteju, pēc tam Mermaid diagrammu caur tās pavadošo konteineru:

Terminālis, serverī
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'

Bez Docker: patstāvīgais jar fails

Otrs dokumentācijas ceļš ir patstāvīgais serveris, kas publicēts repozitorija versiju lapā kā kroki-standalone-server-v0.36.0.jar. Tam vajadzīga Java 21 vai jaunāka versija, un tajā nav nevienas diagrammu bibliotēkas: katra tiek uzstādīta atsevišķi, un tās ceļu norāda ar mainīgo, piemēram, KROKI_DOT_BIN_PATH, ja izpildāmais fails nav PATH ceļā. Klausīšanās adresei izvēlieties KROKI_LISTEN, jo konfigurācijas dokumentācija paziņo, ka KROKI_PORT tiks noņemts:

Terminālis
KROKI_LISTEN=127.0.0.1:8000 java -jar kroki-standalone-server-v0.36.0.jar

Konfigurācija: mainīgie, bez kontiem, bez datubāzes

Kroki nav ne administrēšanas lapas, ne lietotāju kontu, ne datubāzes: tā konfigurācija ir vides mainīgo kopums vai, izmantojot jar failu, Java sistēmas rekvizīti. Docker Compose tie tiek ierakstīti attiecīgā pakalpojuma blokā environment, pēc tam docker compose up -d no jauna izveido konteineru. Serverim svarīgākie iestatījumi:

MainīgaisNoklusējumsKo tas dara
KROKI_SAFE_MODEsecureDrošības līmenis, aprakstīts tālāk
KROKI_LISTENVisas saskarnes, ports 8000Klausīšanās adrese un ports; pieņem arī UNIX ligzdu, unix:// un aiz tā ceļu
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST127.0.0.1Kur vārteja sasniedz katru pavadošo konteineru; atbilstošie mainīgie _PORT nosaka portu, un KROKI_DIAGRAMSNET_HOST kalpo diagrams.net
KROKI_COMMAND_TIMEOUT5 sekundesIlgākā gaidīšana diagrammu izpildāmajam failam, piemēram, dot
KROKI_CONVERT_TIMEOUT20 sekundesIlgākā gaidīšana Java bibliotēkai, piemēram, PlantUML
KROKI_DELEGATE_TIMEOUT_MS30 000Ilgākā gaidīšana pavadošajam konteineram, milisekundēs
KROKI_MAX_URI_LENGTH4096GET pieprasījumam pieņemtais URL garums, kuru pārsniedzot Kroki atbild ar 414
KROKI_CONTENT_SECURITY_POLICYscript-src 'none'; object-src 'none'Galvene Content-Security-Policy, kas tiek sūtīta ar katru atbildi
KROKI_CORS_ALLOWED_HEADERSNav papilduPapildu galvenes, kas atļautas izsaukumiem no citas vietnes

Excalidraw diagrammas rada garas URL adreses. Ja palielināt KROKI_MAX_URI_LENGTH, dokumentācija iesaka palikt pie 8192 rakstzīmēm vai mazāk, lai gan lielākā daļa pārlūku tagā <img> pieņem vairāk. Lielākajām diagrammām POST pieprasījums nes avotu saturā, nevis URL adresē.

Kroki darbībai nav vajadzīgs neviens noslēpums. Divos neobligātos iestatījumos tāds ir: marķieris KROKI_COMPANION_REGISTRATION_TOKEN, kas noder, ja ieslēdzat trešo pušu pavadošo konteineru reģistrāciju, aprakstītu aizsardzības sadaļā, un sertifikāta privātā atslēga, ja ļaujat Kroki pašam apkalpot HTTPS. Glabājiet tos ārpus jebkura koda repozitorija.

HTTPS: reversais starpniekserveris

Vārteja apkalpo savu API ar HTTP. Reversais starpniekserveris tās priekšā klausās portos 80 un 443, iegūst Let’s Encrypt sertifikātu, šifrē datplūsmu un pārsūta to uz Kroki adresē 127.0.0.1:8000. Tur tiek filtrēta arī piekļuve, kā rāda nākamā sadaļa.

Ar Caddy

Caddy pats iegūst un atjauno sertifikātu norādītajam nosaukumam, un tā direktīva reverse_proxy bez papildu iestatījumiem nodod galvenes X-Forwarded-For, X-Forwarded-Proto un X-Forwarded-Host:

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

Ar Nginx

Šis bloks server klausās portā 80, lai Certbot varētu iestatīt HTTPS. Divi Nginx ierobežojumi saskaras ar Kroki ierobežojumiem: pieprasījuma saturs virs 1 MB pēc noklusējuma tiek noraidīts ar 413, ko client_max_body_size pielāgo lielām ar POST sūtītām diagrammām; pieprasījuma rinda, kas garāka par 8 KB, saņem 414, ko large_client_header_buffers pielāgo, ja palielināt KROKI_MAX_URI_LENGTH virs šīs vērtības.

Nginx bloks
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ālis
sudo nginx -t
sudo certbot --nginx

HTTPS bez starpniekservera

Dokumentācija apraksta arī šifrēšanu pašā Kroki: KROKI_SSL=true, ar sertifikātu un privāto atslēgu PEM formātā, kā tekstu caur KROKI_SSL_CERT un KROKI_SSL_KEY vai kā failus caur KROKI_SSL_CERT_PATH un KROKI_SSL_KEY_PATH. Sertifikāta atjaunošana tad notiek ar roku, savukārt ar starpniekserveri par to pašas parūpējas Caddy vai Certbot.

Internetam atvērtas instances aizsardzība

Kroki nav autentifikācijas: ikviens, kas sasniedz API, var likt tam ģenerēt diagrammas. Tāpēc tā aizsardzība balstās uz trim lietām, kas aprakstītas dokumentācijā un versiju piezīmēs: drošības režīmu, izmēra un laika ierobežojumiem un to, ko laiž cauri starpniekserveris. Sāciet, nosakot, kam jāsasniedz jūsu serveris.

Kas izsauc jūsu serveri?

Drošības režīms

KROKI_SAFE_MODE nosaka trīs līmeņus, no kuriem katrs ietver iepriekšējā ierobežojumus. Dokumentācija skaidro, ka dažas bibliotēkas var lasīt failus vai URL adreses, piemēram, PlantUML direktīvas !include, un ka Kroki, kas nepārbauda to kodu, pēc noklusējuma šādu piekļuvi bloķē. Tā aicina ikvienu, kas uztur serveri, izvēlēties tā lietojumam piemērotu līmeni.

LīmenisKo tas dara
SECURE, noklusējumsNovērš jebkādus mēģinājumus lasīt failus no failu sistēmas vai resursus no tīkla
SAFEPaļaujas uz pieprasījumu attīrīšanu, ko veic katras bibliotēkas drošais režīms
UNSAFEIzslēdz visas drošības funkcijas

Publiskā instancē saglabājiet SECURE. Galvene Content-Security-Policy, kas kopš 0.36.0 versijas tiek sūtīta pēc noklusējuma, papildina šo aizsardzību: SVG ievietots skripts netiek izpildīts Kroki izcelsmē, pat ja attēlu atver tieši.

Izmēra un laika ierobežojumi

Konfigurācijas tabulā norādītie gaidīšanas laiki ierobežo katru pārveidojumu. Pavadošie konteineri pievieno savus, kas paredzēti pret resursu izsmelšanu:

Piekļuves ierobežošana starpniekserverī

Ja Kroki izsauc tikai jūsu publicēšanas konveijers, vienkāršākais ir pieņemt tikai tā IP adresi. Ar Caddy atbilstības nosacījums remote_ip atlasa pārējās adreses, un respond tām nosūta 403:

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

Ar Nginx to pašu paveic bloka location direktīvas allow un deny, un spēkā ir pirmais atbilstošais noteikums:

Nginx bloks, location / iekšpusē
allow 203.0.113.10;
deny all;

Otrs ceļš ir starpniekservera pamata autentifikācija: basic_auth ar Caddy, kura paroli jaucē ar caddy hash-password, vai auth_basic un ar htpasswd izveidots fails ar Nginx. Tā der klientiem, kas pieteikšanās datus sūta ar katru izsaukumu, piemēram, curl -u; dokumentācijas konveijeram pārbaudiet, vai tā rīks var tos nodot. Instancei, kas paliek publiska, Nginx var arī ierobežot pieprasījumu skaitu no vienas IP adreses ar savu moduli limit_req, pielāgotu jūsu lapu diagrammu skaitam.

Trešo pušu pavadošie konteineri

Kroki var uzņemt trešo pušu pavadošos konteinerus, kas reģistrējas caur API /services. Šī atklāšana pēc noklusējuma ir izslēgta un režīmā SECURE vienmēr paliek izslēgta. Ja to ieslēdzat ar KROKI_ENABLE_COMPANION_DISCOVERY=true, dokumentācija lūdz turēt /services uzticamā tīklā un stingri iesaka marķieri KROKI_COMPANION_REGISTRATION_TOKEN: bez tā Kroki startējot brīdina, ka jebkurš vārtejas klients var reģistrēt pavadošo konteineru.

Asciidoctor, MkDocs un citu rīku pievienošana

Asciidoctor Kroki un MkDocs spraudnis pēc noklusējuma vēršas pie https://kroki.io. Tiem vajag tikai jūsu servera URL adresi, ieskaitot prefiksu https://.

Asciidoctor un Antora

Paplašinājums Asciidoctor Kroki lasa atribūtu kroki-server-url dokumenta galvenē, komandrindā vai Antora playbook failā. Pievienojiet kroki-fetch-diagram, lai attēlus lejupielādētu būvēšanas laikā, nevis HTML norādītu uz jūsu serveri; šai opcijai vajadzīgs Asciidoctor drošais režīms server vai zemāks.

AsciiDoc dokumenta galvene
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:

MkDocs

Spraudnis mkdocs-kroki-plugin lasa server_url, kura noklusējuma vērtība tiek ņemta no vides mainīgā KROKI_SERVER_URL. Ar http_method: POST attēli tiek glabāti blakus katrai uzbūvētās vietnes lapai un kešoti starp divām būvēšanām:

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

Citas integrācijas

Dokumentācijas trešo pušu rīku lapā uzskaitīti arī GitLab, kas ģenerē Kroki diagrammas Markdown, AsciiDoc, reST un Textile formātos, Sphinx, Jekyll, Hugo, Remark, Python-Markdown, MediaWiki, paplašinājumi Visual Studio Code un IntelliJ, kā arī Kroki.jl valodai Julia. Der arī jebkurš HTTP klients, kā šajā dokumentācijas piemērā:

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

Rezerves kopijas: konfigurācija, bez datiem

Kroki ir bez stāvokļa: starp diviem pieprasījumiem tas neko neglabā, un pat trešo pušu pavadošo konteineru reģistrs pēc restartēšanas pazūd. Jūsu diagrammu avoti atrodas jūsu dokumentācijas repozitorijos, bet to attēli jūsu uzbūvētajās vietnēs. Kroki serverī rezerves kopiju veido tā konfigurācijai:

ElementsKo tas saturRezerves kopija
compose.yamlAttēlus, to birkas un mainīgos KROKI_*Jā
Fails .env, ja tāds irMainīgos, kas glabāti ārpus compose.yaml, piemēram, marķieri vai sertifikātuJā, drošā vietā
Starpniekservera konfigurācijaCaddyfile vai Nginx bloku un paroļu failuJā
Docker attēliPašu programmatūruNē: docker compose pull tos lejupielādē no jauna
Terminālis, compose.yaml mapē
tar -czf kroki-config-$(date +%F).tar.gz compose.yaml /etc/caddy/Caddyfile

Pielāgojiet sarakstu savam starpniekserverim, pēc katras konfigurācijas izmaiņas izveidojiet jaunu kopiju un nosūtiet to ārpus servera. Glabāta servera diskā, tā tiek iekļauta arī tā nakts rezerves kopijās. Atjaunošana nozīmē atlikt šos failus vietā un palaist docker compose up -d.

Atjauninājumi

Ar nofiksētām birkām nomainiet četru attēlu versiju failā compose.yaml, pēc tam tā mapē palaidiet:

Terminālis
docker compose pull
docker compose up -d

Kroki ievēro semantisko versiju numurēšanu, un katra versija publicē savas izmaiņas failā CHANGELOG.md un savā versijas lapā. Izlasiet tās pirms atjaunināšanas, īpaši to sadaļu „Security“: 2026. gada 5. novembra versija 0.35.0 un 2026. gada 9. novembra versija 0.36.0 labo attālinātu koda izpildi caur Bytefield un TikZ diagrammām, XSS ievainojamības GoAT un DBML, kā arī servera puses pieprasījumu viltošanu caur BlockDiag un pavadošajiem konteineriem. Atvērtā instancē ieviesiet šīs versijas nekavējoties.

Versija 0.36.0 pievieno arī noklusējuma galveni Content-Security-Policy un D2 izkārtojuma dzinēju TALA. Manuālai uzstādīšanai tā norāda Java 21 kā minimālo versiju.

Kurš ko dara Managed VPS serverī

Mitināšana savā serverī prasa uzturēt serveri papildus lietojumprogrammai. Ar Managed VPS mūsu komandas uzņemas serveri un proaktīvi seko jūsu instancei; Kroki paliek jūsu programmatūra ar savu konfigurāciju un pavadošajiem konteineriem.

TematsMūsu komandasJūs
ServerisSistēmas un drošības atjauninājumi, ieskaitot iejaukšanos serverīBrīdis, kas der jūsu darbam
UzraudzībaServeris tiek uzraudzīts 24/7, iejaucoties, negaidot jūsu zvanuJūsu instances žurnālu lasīšana
KrokiProaktīva sekošana: kļūdas, palēninājumi, pavadošo konteineru atmiņa un diska vieta tiek pamanīti, labojums tiek ieteiktsTā uzstādīšana, atjauninājumi un iestatījumi, ko ieviešat jūs vai jūsu MI asistents
Diagrammas un piekļuveServeris, kas tās ģenerē, uzraudzīts un ar rezerves kopijāmDrošības režīms, pavadošie konteineri, ierobežojumi un starpniekservera piekļuves noteikumi
Rezerves kopijasKatru nakti, šifrētas un glabātas ārpus mašīnas; atjaunošana iekļautaJūsu konfigurācijas kopijas, ko glabājat citur, un atjaunošanas pieprasījums, kad tas vajadzīgs
MigrācijaJūsu pašreizējā servera migrācija, bez maksasPārslēgšanās brīdis

Ja vēlaties, lai mūsu komandas iejaucas pašā lietojumprogrammā, šis pakalpojums tiek rēķināts par stundu vai par fiksētu summu, ar novērtējumu, kas paziņots pirms iejaukšanās.

Kroki serverī, ko uzturam jūsu vietā

Ar Simafri Managed VPS mūsu komandas uztur jūsu Kroki instances serveri atjauninātu, uzrauga to dienu un nakti un iejaucas, negaidot jūsu zvanu; tās arī proaktīvi seko jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs paši vai jūsu MI asistents. Rezerves kopijas katru nakti tiek šifrētas un glabātas ārpus mašīnas, to atjaunošana ir iekļauta, un jūsu pašreizējā servera migrācija ir bez maksas.

Skatīt Managed VPS

Biežāk uzdotie jautājumi

Vai Kroki uzņēmumam ir bez maksas?

Jā. Kroki ir ar MIT licenci: varat to izmantot, mainīt un izplatīt tālāk darbā, nepērkot nekādu licenci, ja vien saglabājat tā autortiesību paziņojumu. Paliek tikai servera izmaksas, uz kura tas darbojas.

Vai man vajag Kroki pavadošos konteinerus?

Tikai tām diagrammām, ko tie ģenerē. Attēls yuzutech/kroki ir pietiekams PlantUML, GraphViz, D2, Structurizr un lielākajai daļai formātu. Mermaid, BPMN, Excalidraw un diagrams.net katram vajadzīgs savs pavadošais konteiners, kas savienots ar KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST vai KROKI_DIAGRAMSNET_HOST.

Kā uzstādīt Kroki ar Docker Compose?

Izveidojiet compose.yaml ar attēlu yuzutech/kroki, tā portu 8000, kas publicēts adresē 127.0.0.1, un vajadzīgajiem pavadošajiem konteineriem, piemēram, yuzutech/kroki-mermaid, kas savienoti ar mainīgajiem KROKI_*_HOST. Palaidiet docker compose up -d, pārbaudiet /health, pēc tam novietojiet HTTPS reverso starpniekserveri porta 8000 priekšā.

Vai Kroki ir administratora konts?

Nē, Kroki nav ne kontu, ne administrēšanas lapas, ne datubāzes. Tā konfigurācija ir vides mainīgo KROKI_* kopums, un piekļuvi API kontrolē reversajā starpniekserverī, pēc IP adreses vai ar pamata autentifikāciju.

Kā aizsargāt publisku Kroki instanci?

Saglabājiet pēc noklusējuma ieslēgto režīmu SECURE, kas neļauj bibliotēkām lasīt failus vai tīklu. Atstājiet laika un izmēra ierobežojumus, atjauniniet, tiklīdz kāda versija labo ievainojamību, un, ja Kroki izsauc tikai jūsu publicēšanas konveijers, starpniekserverī pieņemiet tikai tā adresi.

Kā izmantot savu Kroki serveri ar Asciidoctor vai MkDocs?

Ar Asciidoctor atribūtam kroki-server-url norādiet sava servera URL adresi, bet kroki-fetch-diagram, lai attēlus lejupielādētu būvēšanas laikā. Ar MkDocs spraudņa kroki konfigurācijā norādiet server_url, bet http_method: POST, lai attēlus glabātu kopā ar vietni.

Kam Kroki serverī jāveido rezerves kopija?

Tikai tā konfigurācijai: compose.yaml, iespējamajam failam .env un reversā starpniekservera konfigurācijai. Kroki neglabā datus, un tā Docker attēli tiek lejupielādēti no jauna ar docker compose pull.

Vai Managed VPS aptver Kroki?

Managed VPS aptver serveri: sistēmu, drošību, uzraudzību un rezerves kopijas. Mūsu komandas arī proaktīvi seko jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs. Darbs pašā lietojumprogrammā tiek rēķināts par stundu vai par fiksētu summu.

Avoti un oficiālā dokumentācija

Sazinieties ar mums