Näin hostaatte Krokin Managed VPS:llä: kaavionne omalla palvelimellanne

Krokin hostaus Managed VPS:llä tarkoittaa, että renderöitte PlantUML-, Mermaid-, GraphViz-, D2-, BPMN- tai Excalidraw-kaavionne koneella, joka on teidän ja jota tiimimme pitävät ajan tasalla ja valvovat yötä päivää. Kroki on MIT-lisenssillä julkaistu avoimen lähdekoodin ohjelma. Tämä opas seuraa sen virallista dokumentaatiota: yhdyskäytävä ja sen apukontit, asennus Docker Composella, konfiguraatio, HTTPS, julkisen instanssin suojaaminen, Asciidoctorin ja MkDocsin liittäminen, varmuuskopiot ja päivitykset.

Simon Vasconcelos Lee Kirjoittaja: Julkaistu 20. marraskuuta 2026Lukuaika: 14 minuuttia

Kaikki oppaat

Lyhyesti

  1. MIT-lisenssi sallii Krokin vapaan käytön, muokkaamisen ja edelleenjakelun yrityksessä ja muualla, kunhan säilytätte sen tekijänoikeusilmoituksen.
  2. Kroki muuttaa tekstinä kirjoitetun kaavion kuvaksi yhden HTTP-rajapinnan kautta: PlantUML, GraphViz, D2, Structurizr ja monet muut sisältyvät imageen yuzutech/kroki.
  3. Mermaid, BPMN, Excalidraw ja diagrams.net tarvitsevat kukin oman apukonttinsa, joka yhdistetään yhdyskäytävään muuttujilla KROKI_*_HOST: Docker Compose käynnistää ne yhdessä.
  4. Krokissa ei ole käyttäjätilejä eikä tietokantaa. Se käynnistyy tilassa SECURE, joka estää sitä lukemasta tiedostoja tai verkkoa; julkisen instanssin käyttöoikeutta hallitaan käänteisessä välityspalvelimessa.
  5. Varmuuskopioikaa konfiguraatio, compose.yaml ja välityspalvelimen asetukset, ja päivittäkää sitten komennolla docker compose pull luettuanne kunkin version julkaisutiedot.

Mitä Kroki tekee

Kroki tarjoaa yhtenäisen HTTP-rajapinnan, joka ottaa vastaan tekstinä kuvatun kaavion ja palauttaa kuvan. Dokumentaationne, wikinne tai koodialustanne lähettää kaavion lähdekoodin; Kroki vastaa SVG-kuvalla ja kaaviotyypin mukaan PNG-, PDF- tai JPEG-kuvalla. Sen README luettelee BlockDiagin, BPMN:n, Bytefieldin, C4:n PlantUML:llä, D2:n, DBML:n, diagrams.netin, Ditaan, Erdin, Excalidraw’n, GoAT:n, GraphVizin, Linin, Mermaidin, Nomnomlin, Pikchrin, PlantUML:n, Svgbobin, Symbolatorin, UMLetin, Vegan, Vega-Liten, WaveDromin ja WireVizin.

Asciidoctor Kroki -laajennuksen dokumentaatio antaa kolme syytä ajaa omaa palvelinta julkisen kroki.io-instanssin sijaan: yrityksen palomuuri, joka estää sen, viive, kun olette kaukana tästä eurooppalaisesta instanssista, ja luottamuksellisuus, kun kaavioiden lähdekoodin on pysyttävä omassa infrastruktuurissanne.

Mitä MIT-lisenssi sallii

Kroki julkaistaan MIT-lisenssillä. Se antaa maksutta oikeuden käyttää, kopioida, muokata, yhdistää, julkaista, levittää, alilisensoida ja myydä ohjelmiston kopioita. Voitte siis ajaa sitä yrityksellenne, tiimillenne tai asiakkaillenne ostamatta lisenssiä.

Ainoa ehto on säilyttää tekijänoikeusilmoitus ja lisenssin teksti kaikissa ohjelmiston kopioissa tai sen merkittävissä osissa. Teksti toimittaa ohjelmiston ”sellaisenaan”, ilman takuuta. Krokin mukana tulevilla kaaviokirjastoilla on kullakin oma lisenssinsä.

Yhdyskäytävä ja sen apukontit

Krokin arkkitehtuuri on modulaarinen. Javalla Vert.x:n päälle kirjoitettu yhdyskäytävä ottaa vastaan jokaisen pyynnön ja ohjaa sen oikealle kirjastolle. Vain image yuzutech/kroki on pakollinen: dokumentaatio huomauttaa, että se voi kaavioistanne riippuen riittää.

ImageMitä se renderöiPakollinen
yuzutech/krokiYhdyskäytävä sekä 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 WireVizKyllä
yuzutech/kroki-mermaidMermaid: vuokaaviot, sekvenssi- ja Gantt-kaaviotEi
yuzutech/kroki-bpmnBPMN, bpmn-js:lläEi
yuzutech/kroki-excalidrawExcalidraw, käsin piirretty tyyliEi
yuzutech/kroki-diagramsnetdiagrams.net, yhä kokeellinenEi

Palvelimen mitoitus

Dokumentaatio ei ilmoita muistin eikä suorittimen tarvetta. Se kertoo kuitenkin, mikä painaa eniten: Mermaidin, BPMN:n, Excalidraw’n ja diagrams.netin apukontit renderöivät jokaisen kaavion Chromium-selaimessa ilman käyttöliittymää. Jotta muunnosten ryöppy ei ylitä kontin muistia, kukin niistä rajoittaa samanaikaisia renderöintejään: oletuksena 6 Mermaidille, BPMN:lle ja diagrams.netille, 4 Excalidraw’lle. Muut pyynnöt odottavat vuoroaan jonossa.

Managed VPS -palvelimella kertokaa meille kaavioistanne, niiden tarvitsemista apukonteista ja odottamastanne liikenteestä, niin suosittelemme sopivaa kokoa.

Asennus Docker Composella

Dokumentaatio suosittelee kontteja, Dockeria tai Podmania, jotta kutakin kirjastoa ei tarvitse asentaa käsin. Luokaa palvelimelle, jolle Docker on asennettu, kansio ja tallentakaa siihen tämä dokumentaatiosta otettu 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"
Pääte
docker compose up -d

Yhä kokeellista diagrams.netiä varten README lisää neljännen apukontin. Lisätkää tämä palvelu sekä muuttuja KROKI_DIAGRAMSNET_HOST=diagramsnet palvelun kroki kohtaan environment:

compose.yaml, lisättävä palvelu
  diagramsnet:
    image: yuzutech/kroki-diagramsnet:0.36.0
    restart: unless-stopped
    expose:
      - "8005"

Tarkistakaa, että kaikki vastaa

Palvelimelta reitti /health palauttaa yhdyskäytävän tilan ja sen mukana tulevien kirjastojen versiot. Kaksi seuraavaa pyyntöä renderöivät GraphViz-kaavion yhdyskäytävän kautta ja sitten Mermaid-kaavion sen apukontin kautta:

Pääte, palvelimella
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'

Ilman Dockeria: itsenäinen jar-tiedosto

Dokumentaation toinen tapa on itsenäinen palvelin, joka julkaistaan repositorion julkaisusivulla nimellä kroki-standalone-server-v0.36.0.jar. Se vaatii Java 21:n tai uudemman, eikä siinä ole yhtään kaaviokirjastoa: kukin asennetaan erikseen, ja sen polku annetaan muuttujalla, kuten KROKI_DOT_BIN_PATH, kun ohjelma ei ole polussa PATH. Kuunteluosoitteelle käyttäkää mieluummin muuttujaa KROKI_LISTEN, sillä konfiguraatiodokumentaatio ilmoittaa, että KROKI_PORT poistetaan:

Pääte
KROKI_LISTEN=127.0.0.1:8000 java -jar kroki-standalone-server-v0.36.0.jar

Konfiguraatio: muuttujat, ei käyttäjätilejä eikä tietokantaa

Krokissa ei ole ylläpitosivua, käyttäjätilejä eikä tietokantaa: sen konfiguraatio koostuu ympäristömuuttujista tai jar-tiedoston kanssa Javan järjestelmäominaisuuksista. Docker Composessa ne kirjoitetaan kyseisen palvelun lohkoon environment, minkä jälkeen docker compose up -d luo kontin uudelleen. Palvelimelle tärkeimmät asetukset:

MuuttujaOletusMitä se tekee
KROKI_SAFE_MODEsecureSuojaustaso, kuvattu alempana
KROKI_LISTENKaikki liitännät, portti 8000Kuunteluosoite ja portti; hyväksyy myös UNIX-socketin, unix:// ja sen perään polku
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST127.0.0.1Mistä yhdyskäytävä tavoittaa kunkin apukontin; vastaavat muuttujat _PORT asettavat portin, ja KROKI_DIAGRAMSNET_HOST palvelee diagrams.netiä
KROKI_COMMAND_TIMEOUT5 sekuntiaPisin odotusaika kaavio-ohjelmalle, kuten dot
KROKI_CONVERT_TIMEOUT20 sekuntiaPisin odotusaika Java-kirjastolle, kuten PlantUML
KROKI_DELEGATE_TIMEOUT_MS30 000Pisin odotusaika apukontille, millisekunteina
KROKI_MAX_URI_LENGTH4 096GET-pyynnössä hyväksytty URL-osoitteen pituus, jonka ylittyessä Kroki vastaa 414
KROKI_CONTENT_SECURITY_POLICYscript-src 'none'; object-src 'none'Otsake Content-Security-Policy, joka lähetetään jokaisen vastauksen mukana
KROKI_CORS_ALLOWED_HEADERSEi lisäotsakkeitaLisäotsakkeet, jotka sallitaan toiselta sivustolta tuleville kutsuille

Excalidraw-kaaviot tuottavat pitkiä URL-osoitteita. Jos nostatte arvoa KROKI_MAX_URI_LENGTH, dokumentaatio suosittelee pysymään enintään 8 192 merkissä, vaikka useimmat selaimet hyväksyvät enemmän tagissa <img>. Suurimmille kaavioille POST-pyyntö kuljettaa lähdekoodin rungossa URL-osoitteen sijaan.

Kroki ei tarvitse toimiakseen salaisuutta. Kaksi valinnaista asetusta sisältää sellaisen: tunniste KROKI_COMPANION_REGISTRATION_TOKEN, hyödyllinen, jos otatte käyttöön kolmansien osapuolten apukonttien rekisteröinnin, josta kerrotaan suojaamista käsittelevässä osiossa, sekä varmenteen yksityinen avain, jos annatte Krokin hoitaa HTTPS:n itse. Pitäkää ne erillään kaikista koodirepositorioista.

HTTPS: käänteinen välityspalvelin

Yhdyskäytävä tarjoaa rajapintansa HTTP:n kautta. Sen eteen sijoitettu käänteinen välityspalvelin kuuntelee portteja 80 ja 443, hankkii Let’s Encrypt -varmenteen, salaa liikenteen ja välittää sen Krokille osoitteeseen 127.0.0.1:8000. Siellä myös suodatetaan pääsy, kuten seuraava osio näyttää.

Caddyllä

Caddy hankkii ja uusii annetun nimen varmenteen itse, ja sen direktiivi reverse_proxy välittää otsakkeet X-Forwarded-For, X-Forwarded-Proto ja X-Forwarded-Host ilman lisäasetuksia:

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

Nginxillä

Tämä palvelinlohko kuuntelee porttia 80, jotta Certbot voi määrittää HTTPS:n. Kaksi Nginxin rajaa kohtaa Krokin rajat: yli 1 Mt:n pyynnön runko hylätään oletuksena koodilla 413, mitä client_max_body_size säätää POST-pyynnöllä lähetettäville suurille kaavioille; yli 8 kt:n pyyntörivi saa koodin 414, mitä large_client_header_buffers säätää, jos nostatte arvoa KROKI_MAX_URI_LENGTH tätä suuremmaksi.

Nginx-lohko
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;
    }
}
Pääte
sudo nginx -t
sudo certbot --nginx

HTTPS ilman välityspalvelinta

Dokumentaatio kuvaa myös Krokin itse tekemän salauksen: KROKI_SSL=true, varmenne ja yksityinen avain PEM-muodossa, tekstinä muuttujilla KROKI_SSL_CERT ja KROKI_SSL_KEY tai tiedostoina muuttujilla KROKI_SSL_CERT_PATH ja KROKI_SSL_KEY_PATH. Varmenteen uusiminen tehdään silloin käsin, kun taas välityspalvelimen edessä Caddy tai Certbot hoitavat sen itse.

Internetiin avoimen instanssin suojaaminen

Krokissa ei ole tunnistautumista: kuka tahansa rajapinnan tavoittava voi teettää sillä kaavioita. Sen suojaus perustuu siksi kolmeen asiaan, jotka kuvataan dokumentaatiossa ja julkaisutiedoissa: suojaustilaan, koko- ja aikarajoihin sekä siihen, mitä välityspalvelin päästää läpi. Selvittäkää ensin, kenen täytyy tavoittaa palvelimenne.

Kuka kutsuu palvelintanne?

Suojaustila

KROKI_SAFE_MODE määrittää kolme tasoa, joista kukin sisältää edellisen rajoitukset. Dokumentaatio selittää, että jotkin kirjastot voivat lukea tiedostoja tai URL-osoitteita, kuten PlantUML:n direktiivit !include, ja että Kroki, joka ei tarkasta niiden koodia, estää tällaisen pääsyn oletuksena. Se kehottaa jokaista palvelimen ylläpitäjää valitsemaan käyttöönsä sopivan tason.

TasoMitä se tekee
SECURE, oletusEstää kaikki yritykset lukea tiedostoja tiedostojärjestelmästä tai resursseja verkosta
SAFELuottaa siihen, että kunkin kirjaston oma turvatila puhdistaa pyynnöt
UNSAFEPoistaa kaikki suojaustoiminnot käytöstä

Julkisessa instanssissa pitäkää tila SECURE. Versiosta 0.36.0 alkaen oletuksena lähetettävä otsake Content-Security-Policy täydentää tätä suojausta: SVG-kuvaan ujutettu skripti ei suoritu Krokin alkuperässä, ei edes silloin, kun kuva avataan suoraan.

Koko- ja aikarajat

Konfiguraatiotaulukon aikakatkaisut rajaavat jokaisen muunnoksen. Apukontit lisäävät omansa, jotka on suunniteltu resurssien ehtymistä vastaan:

Pääsyn rajaaminen välityspalvelimessa

Kun vain julkaisuketjunne kutsuu Krokia, yksinkertaisinta on hyväksyä pelkästään sen IP-osoite. Caddyssä vastinehto remote_ip poimii muut osoitteet, ja respond lähettää niille koodin 403:

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

Nginxissä lohkon location direktiivit allow ja deny hoitavat saman tehtävän, ja ensimmäinen täsmäävä sääntö ratkaisee:

Nginx-lohko, location /-lohkon sisällä
allow 203.0.113.10;
deny all;

Välityspalvelimen perustunnistautuminen on toinen tapa: Caddyssä basic_auth, jonka salasana tiivistetään komennolla caddy hash-password, tai Nginxissä auth_basic ja komennolla htpasswd luotu tiedosto. Se sopii asiakasohjelmille, jotka lähettävät tunnukset jokaisen kutsun mukana, kuten curl -u; dokumentaatioketjun kohdalla tarkistakaa, että sen työkalu pystyy välittämään ne. Julkisena pysyvälle instanssille Nginx voi myös rajoittaa pyyntöjen määrää IP-osoitetta kohden moduulillaan limit_req, mitoitettuna sivujenne kaavioiden määrän mukaan.

Kolmansien osapuolten apukontit

Kroki voi ottaa vastaan kolmansien osapuolten apukontteja, jotka rekisteröityvät rajapinnan /services kautta. Tämä haku on oletuksena pois päältä ja pysyy aina pois päältä tilassa SECURE. Jos otatte sen käyttöön asetuksella KROKI_ENABLE_COMPANION_DISCOVERY=true, dokumentaatio pyytää pitämään /services-rajapinnan luotetussa verkossa ja suosittelee vahvasti tunnistetta KROKI_COMPANION_REGISTRATION_TOKEN: ilman sitä Kroki varoittaa käynnistyessään, että mikä tahansa yhdyskäytävän asiakas voi rekisteröidä apukontin.

Asciidoctorin, MkDocsin ja muiden työkalujen liittäminen

Asciidoctor Kroki ja MkDocs-lisäosa osoittavat oletuksena palvelimeen https://kroki.io. Ne tarvitsevat vain palvelimenne URL-osoitteen etuliitteineen https://.

Asciidoctor ja Antora

Asciidoctor Kroki -laajennus lukee määritteen kroki-server-url asiakirjan otsakkeesta, komentoriviltä tai Antoran playbookista. Lisätkää kroki-fetch-diagram, niin kuvat ladataan sivuston koostamisen aikana sen sijaan, että HTML viittaisi palvelimeenne; tämä asetus vaatii Asciidoctorin turvatilaksi server tai sitä matalamman.

AsciiDoc-asiakirjan otsake
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:

MkDocs

Lisäosa mkdocs-kroki-plugin lukee asetuksen server_url, jonka oletusarvo on ympäristömuuttuja KROKI_SERVER_URL. Asetuksella http_method: POST kuvat tallennetaan koostetun sivuston kunkin sivun viereen ja välimuistitetaan kahden koostamisen välillä:

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

Muut integraatiot

Dokumentaation kolmansien osapuolten työkaluja käsittelevä sivu mainitsee myös GitLabin, joka renderöi Kroki-kaavioita Markdownissa, AsciiDocissa, reST:ssä ja Textilessä, sekä Sphinxin, Jekyllin, Hugon, Remarkin, Python-Markdownin, MediaWikin, laajennukset Visual Studio Codeen ja IntelliJ:hin sekä Kroki.jl:n Julialle. Mikä tahansa HTTP-asiakas toimii myös, kuten tässä dokumentaation esimerkissä:

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

Varmuuskopiot: konfiguraatio, ei tietoja

Kroki on tilaton: se ei säilytä mitään kahden pyynnön välillä, ja jopa kolmansien osapuolten apukonttien rekisteri katoaa uudelleenkäynnistyksessä. Kaavioidenne lähdekoodi on dokumentaationne repositorioissa ja niiden kuvat koostetuilla sivustoillanne. Kroki-palvelimelta varmuuskopioidaan sen konfiguraatio:

KohdeMitä se sisältääVarmuuskopioidaanko
compose.yamlImaget, niiden tagit ja muuttujat KROKI_*Kyllä
Tiedosto .env, jos sellainen onTiedoston compose.yaml ulkopuolella pidettävät muuttujat, kuten tunniste tai varmenneKyllä, turvallisessa paikassa
Välityspalvelimen konfiguraatioCaddyfile tai Nginx-lohko sekä salasanatiedostoKyllä
Docker-imagetItse ohjelmistoEi: docker compose pull lataa ne uudelleen
Pääte, compose.yaml-tiedoston kansiossa
tar -czf kroki-config-$(date +%F).tar.gz compose.yaml /etc/caddy/Caddyfile

Mukauttakaa luettelo välityspalvelimenne mukaan, tehkää uusi kopio jokaisen konfiguraatiomuutoksen jälkeen ja lähettäkää se palvelimen ulkopuolelle. Palvelimen levylle tallennettuna se sisältyy myös sen öisiin varmuuskopioihin. Palautus tarkoittaa näiden tiedostojen palauttamista paikoilleen ja komennon docker compose up -d suorittamista.

Päivitykset

Kiinnitettyjä tageja käyttäessänne vaihtakaa neljän imagen versio tiedostossa compose.yaml ja suorittakaa sitten sen kansiossa:

Pääte
docker compose pull
docker compose up -d

Kroki noudattaa semanttista versiointia, ja jokainen versio julkaisee muutoksensa tiedostossa CHANGELOG.md ja julkaisusivullaan. Lukekaa ne ennen päivitystä, erityisesti niiden osio ”Security”: 5. marraskuuta 2026 julkaistu 0.35.0 ja 9. marraskuuta 2026 julkaistu 0.36.0 korjaavat etäkoodin suorittamisen Bytefield- ja TikZ-kaavioiden kautta, XSS-haavoittuvuudet GoAT:ssa ja DBML:ssä sekä palvelinpuolen pyyntöjen väärentämisen BlockDiagin ja apukonttien kautta. Avoimessa instanssissa ottakaa nämä versiot käyttöön viipymättä.

Versio 0.36.0 lisää myös oletusotsakkeen Content-Security-Policy ja D2:n asettelumoottorin TALA. Manuaalista asennusta varten se dokumentoi vähimmäisversioksi Java 21:n.

Kuka tekee mitä Managed VPS:llä

Oma hostaus vaatii palvelimen ylläpitoa sovelluksen lisäksi. Managed VPS -palvelimella tiimimme huolehtivat palvelimesta ja seuraavat instanssianne proaktiivisesti; Kroki pysyy teidän ohjelmananne konfiguraatioineen ja apukontteineen.

AiheTiimimmeTe
PalvelinJärjestelmä- ja tietoturvapäivitykset, toimenpiteet palvelimella mukaan lukienToimintaanne sopiva ajankohta
ValvontaPalvelinta seurataan ympäri vuorokauden joka päivä, ja puututaan asiaan odottamatta yhteydenottoanneInstanssinne lokien lukeminen
KrokiProaktiivinen seuranta: virheet, hitaus, apukonttien muisti ja levytila havaitaan, ja korjausta suositellaanSen asennus, päivitykset ja asetukset, jotka toteutatte itse tai tekoälyavustajanne kanssa
Kaaviot ja pääsyNe renderöivä palvelin, valvottuna ja varmuuskopioitunaSuojaustila, apukontit, rajat ja välityspalvelimen pääsysäännöt
VarmuuskopiotJoka yö, salattuina ja koneen ulkopuolella säilytettyinä; palautus sisältyyMuualla säilyttämänne konfiguraation kopiot sekä palautuspyyntö, kun tarvitsette sitä
SiirtoNykyinen palvelimenne siirretään, veloituksettaKäyttöönoton ajankohta

Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.

Kroki palvelimella, jota ylläpidetään puolestanne

Simafrin Managed VPS -palvelussa tiimimme pitävät Kroki-instanssinne palvelimen ajan tasalla, valvovat sitä yötä päivää ja toimivat odottamatta yhteydenottoanne; ne seuraavat myös instanssianne proaktiivisesti ja suosittelevat teille hyödyllisiä korjauksia, jotka toteutatte itse tai tekoälyavustajanne kanssa. Varmuuskopiot salataan joka yö ja säilytetään koneen ulkopuolella, niiden palautus sisältyy, ja nykyisen palvelimenne siirto tehdään veloituksetta.

Katso Managed VPS

Usein kysytyt kysymykset

Onko Kroki yritykselle maksuton?

Kyllä. Kroki on MIT-lisenssin alainen: voitte käyttää, muokata ja jakaa sitä edelleen yrityksessä ostamatta lisenssiä, kunhan säilytätte sen tekijänoikeusilmoituksen. Jäljelle jää sitä ajavan palvelimen kustannus.

Tarvitsenko Krokin apukontteja?

Vain niiden renderöimiä kaavioita varten. Image yuzutech/kroki riittää PlantUML:lle, GraphVizille, D2:lle, Structurizrille ja useimmille muodoille. Mermaid, BPMN, Excalidraw ja diagrams.net tarvitsevat kukin apukonttinsa, joka liitetään muuttujalla KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST tai KROKI_DIAGRAMSNET_HOST.

Miten Kroki asennetaan Docker Composella?

Luokaa compose.yaml, jossa on image yuzutech/kroki, sen portti 8000 julkaistuna osoitteeseen 127.0.0.1, sekä tarvitsemanne apukontit, kuten yuzutech/kroki-mermaid, liitettyinä muuttujilla KROKI_*_HOST. Suorittakaa docker compose up -d, tarkistakaa /health ja sijoittakaa sitten HTTPS:llä toimiva käänteinen välityspalvelin portin 8000 eteen.

Onko Krokissa ylläpitäjän tiliä?

Ei, Krokissa ei ole käyttäjätilejä, ylläpitosivua eikä tietokantaa. Sen konfiguraatio koostuu ympäristömuuttujista KROKI_*, ja rajapinnan käyttöoikeutta hallitaan käänteisessä välityspalvelimessa IP-osoitteen perusteella tai perustunnistautumisella.

Miten julkinen Kroki-instanssi suojataan?

Pitäkää oletuksena päällä oleva tila SECURE, joka estää kirjastoja lukemasta tiedostoja tai verkkoa. Jättäkää aika- ja kokorajat paikoilleen, päivittäkää heti, kun versio korjaa haavoittuvuuden, ja jos vain julkaisuketjunne kutsuu Krokia, hyväksykää välityspalvelimessa vain sen osoite.

Miten käytän Kroki-palvelintani Asciidoctorin tai MkDocsin kanssa?

Asciidoctorissa asettakaa määritteen kroki-server-url arvoksi palvelimenne URL-osoite ja lisätkää kroki-fetch-diagram, jotta kuvat ladataan sivuston koostamisen aikana. MkDocsissa asettakaa server_url kroki-lisäosan konfiguraatioon ja http_method: POST, jotta kuvat tallennetaan sivuston mukana.

Mitä Kroki-palvelimelta varmuuskopioidaan?

Vain sen konfiguraatio: compose.yaml, mahdollinen tiedosto .env ja käänteisen välityspalvelimen konfiguraatio. Kroki ei säilytä tietoja, ja sen Docker-imaget ladataan uudelleen komennolla docker compose pull.

Kattaako Managed VPS Krokin?

Managed VPS kattaa palvelimen: järjestelmän, tietoturvan, valvonnan ja varmuuskopiot. Tiimimme seuraavat myös instanssianne proaktiivisesti ja suosittelevat hyödyllisiä korjauksia, jotka toteutatte itse. Toimenpide sovelluksessa laskutetaan tuntiveloituksella tai kiinteällä hinnalla.

Lähteet ja virallinen dokumentaatio

Aiheeseen liittyvät oppaat

Näin hostaatte BookStackin Managed VPS:llä: dokumentaationne omalla palvelimellaKun hostaatte BookStackin Managed VPS:llä, dokumentaationne on koneella, joka on teidän ja jota tiimimme pitävät ajan tasalla ja valvovat yötä päivää. BookStack on MIT-lisenssillä julkaistu avoimen lähdekoodin ohjelma, joka on helppo ajaa: PHP, MySQL tai MariaDB ja verkkopalvelin, ilman Dockeria. Tämä opas seuraa sen virallista dokumentaatiota: asennus, HTTPS, tiedot, sähköpostit, tietoturva, varmuuskopiot ja päivitykset.Paljonko RAM-muistia VPS tarvitsee: laskusääntö käyttötarkoituksittainMuisti on se resurssi, joka useimmiten ratkaisee palvelimen koon: se loppuu ensimmäisenä, ja kun se loppuu, palvelin ei hidastu vaan pysäyttää palveluja. Tämä opas selvittää, paljonko RAM-muistia VPS tarvitsee: se antaa laskusäännön, kertoo, mitä sovelluksen kukin osa kuluttaa, esittelee tyypilliset profiilit ja näyttää, miten jo käynnissä olevan palvelimen muistinkäyttö mitataan.Hallinnoidun ja hallinnoimattoman VPS:n ero: kuka tekee mitäHallinnoidun ja hallinnoimattoman VPS:n ero palautuu yhteen kysymykseen: kuka huolehtii palvelimesta, kun se on käynnissä. Sanalla ”hallinnoitu” ei kuitenkaan ole virallista määritelmää, ja palveluntarjoajasta riippuen se kattaa kaiken järjestelmän pelkästä asennuksesta palvelimen täyteen ylläpitoon. Tämä opas näyttää rivi riviltä, kuka tekee mitäkin, myös tuetulla välitasolla, ja antaa kysymykset, jotka poistavat epäselvyydet ennen allekirjoitusta.
Ota yhteyttä