Hosting Kroki na Managed VPS oznacza, że Państwa diagramy PlantUML, Mermaid, GraphViz, D2, BPMN czy Excalidraw są renderowane na maszynie, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. Kroki to wolne oprogramowanie na licencji MIT. Ten poradnik podąża za jego oficjalną dokumentacją: brama i jej kontenery towarzyszące, instalacja przez Docker Compose, konfiguracja, HTTPS, ochrona instancji publicznej, podłączenie Asciidoctor i MkDocs, kopie zapasowe i aktualizacje.
Autor: Simon Vasconcelos Lee
Opublikowano 20 listopada 2026Czas czytania: 14 minut
yuzutech/kroki.KROKI_*_HOST: Docker Compose uruchamia je razem.SECURE, który nie pozwala mu odczytywać plików ani sięgać do sieci; dostęp do instancji publicznej kontroluje się w odwrotnym proxy.compose.yaml i konfiguracji proxy, a aktualizować poleceniem docker compose pull, po przeczytaniu informacji o każdym wydaniu.Kroki udostępnia ujednolicone API HTTP, które przyjmuje diagram opisany tekstem i zwraca obraz. Państwa dokumentacja, wiki czy platforma z repozytoriami kodu wysyła źródło diagramu; Kroki odpowiada plikiem SVG oraz, zależnie od typu diagramu, PNG, PDF lub JPEG. Jego README wymienia BlockDiag, BPMN, Bytefield, C4 z PlantUML, D2, DBML, diagrams.net, Ditaa, Erd, Excalidraw, GoAT, GraphViz, Lini, Mermaid, Nomnoml, Pikchr, PlantUML, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom i WireViz.
/plantuml/svg/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000. Strona internetowa wyświetla go wtedy jak każdy inny obraz./graphviz/svg, albo w treści JSON.Kroki-Diagram-Options-*.Dokumentacja rozszerzenia Asciidoctor Kroki podaje trzy powody, by uruchomić własny serwer zamiast publicznej instancji kroki.io: firmowa zapora sieciowa, która ją blokuje, opóźnienie, gdy znajdują się Państwo daleko od tej europejskiej instancji, oraz poufność, gdy źródła diagramów muszą pozostać w Państwa infrastrukturze.
Kroki jest udostępniany na licencji MIT. Przyznaje ona bezpłatnie prawo do używania, kopiowania, modyfikowania, łączenia, publikowania, rozpowszechniania, sublicencjonowania i sprzedawania kopii oprogramowania. Mogą więc Państwo uruchomić go dla swojej firmy, zespołu lub klientów, bez zakupu licencji.
Jedynym warunkiem jest zachowanie informacji o prawach autorskich i tekstu licencji we wszystkich kopiach lub istotnych częściach oprogramowania. Tekst dostarcza oprogramowanie „w stanie, w jakim jest”, bez gwarancji. Biblioteki diagramów dołączone do Kroki zachowują każda własną licencję.
Kroki ma architekturę modułową. Brama napisana w Javie, na Vert.x, przyjmuje każde żądanie i kieruje je do właściwej biblioteki. Obowiązkowy jest tylko obraz yuzutech/kroki: dokumentacja zaznacza, że zależnie od Państwa diagramów może on wystarczyć.
| Obraz | Co renderuje | Obowiązkowy |
|---|---|---|
yuzutech/kroki | Bramę, a także ActDiag, BlockDiag, Bytefield, D2, Ditaa, Erd, GoAT, GraphViz, Lini, Nomnoml, NwDiag, PacketDiag, Pikchr, PlantUML i C4, RackDiag, SeqDiag, Structurizr, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom i WireViz | Tak |
yuzutech/kroki-mermaid | Mermaid: schematy blokowe, diagramy sekwencji i wykresy Gantta | Nie |
yuzutech/kroki-bpmn | BPMN, za pomocą bpmn-js | Nie |
yuzutech/kroki-excalidraw | Excalidraw, styl odręczny | Nie |
yuzutech/kroki-diagramsnet | diagrams.net, wciąż eksperymentalny | Nie |
Dokumentacja nie podaje żadnej wartości dla pamięci ani procesora. Wskazuje natomiast, co obciąża najbardziej: kontenery towarzyszące Mermaid, BPMN, Excalidraw i diagrams.net renderują każdy diagram w przeglądarce Chromium działającej bez interfejsu (headless). Aby seria konwersji nie przekroczyła pamięci kontenera, każdy z nich ogranicza liczbę jednoczesnych renderowań: domyślnie 6 dla Mermaid, BPMN i diagrams.net, 4 dla Excalidraw. Kolejne żądania czekają na swoją kolej w kolejce.
yuzutech/kroki 0.36.0 waży około 1 GB po kompresji. Kroki nie zapisuje żadnych danych: niczego nie przechowuje między dwoma żądaniami.amd64 i arm64.depends_on i KROKI_*_HOST.Na Managed VPS wystarczy opisać nam swoje diagramy, potrzebne im kontenery towarzyszące i oczekiwany ruch, a polecimy odpowiedni rozmiar.
Dokumentacja zaleca kontenery, Docker lub Podman, aby nie trzeba było instalować każdej biblioteki ręcznie. Na serwerze z zainstalowanym Dockerem proszę utworzyć katalog i umieścić w nim ten compose.yaml, zaczerpnięty z dokumentacji:
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"
docker compose up -d
127.0.0.1: to pierwsza zmiana względem przykładu z dokumentacji, który publikuje 8000:8000. Kroki domyślnie nasłuchuje na wszystkich interfejsach, a Docker publikuje port na wszystkich adresach serwera, gdy żaden nie jest podany. Tutaj API jest osiągalne wyłącznie przez odwrotne proxy.expose: pozostaje on w wewnętrznej sieci Compose, gdzie brama dociera do nich po nazwie usługi. Zmienne KROKI_MERMAID_HOST, KROKI_BPMN_HOST i KROKI_EXCALIDRAW_HOST podają tę nazwę; ich domyślnych portów, 8002, 8003 i 8004, nie trzeba powtarzać.0.36.0 to druga zmiana: przykład z dokumentacji podąża za najnowszą wersją. Cztery obrazy są publikowane razem pod tym samym tagiem, co przypina spójną wersję i sprawia, że każda aktualizacja jest zamierzona.Dla diagrams.net, wciąż eksperymentalnego, README dodaje czwarty kontener towarzyszący. Proszę dodać tę usługę oraz zmienną KROKI_DIAGRAMSNET_HOST=diagramsnet do sekcji environment usługi kroki:
diagramsnet:
image: yuzutech/kroki-diagramsnet:0.36.0
restart: unless-stopped
expose:
- "8005"
Z poziomu serwera trasa /health zwraca stan bramy i wersje dołączonych do niej bibliotek. Kolejne dwa żądania renderują diagram GraphViz przez bramę, a następnie diagram Mermaid przez jego kontener towarzyszący:
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'
Druga droga z dokumentacji to samodzielny serwer, publikowany na stronie wydań repozytorium jako kroki-standalone-server-v0.36.0.jar. Wymaga Javy 21 lub nowszej i nie zawiera żadnych bibliotek diagramów: każdą instaluje się osobno, a jej ścieżkę ustawia się zmienną, taką jak KROKI_DOT_BIN_PATH, gdy plik wykonywalny nie znajduje się w PATH. Dla adresu nasłuchiwania lepiej użyć KROKI_LISTEN, ponieważ dokumentacja konfiguracji zapowiada usunięcie KROKI_PORT:
KROKI_LISTEN=127.0.0.1:8000 java -jar kroki-standalone-server-v0.36.0.jar
Kroki nie ma strony administracyjnej, kont użytkowników ani bazy danych: jego konfiguracja to zestaw zmiennych środowiskowych albo, w przypadku pliku jar, właściwości systemowych Javy. W Docker Compose umieszcza się je w bloku environment danej usługi, a następnie docker compose up -d odtwarza kontener. Ustawienia najważniejsze dla serwera:
| Zmienna | Wartość domyślna | Do czego służy |
|---|---|---|
KROKI_SAFE_MODE | secure | Poziom bezpieczeństwa, opisany niżej |
KROKI_LISTEN | Wszystkie interfejsy, port 8000 | Adres i port nasłuchiwania; przyjmuje też gniazdo UNIX, unix:// i ścieżkę |
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST | 127.0.0.1 | Adres, pod którym brama dociera do każdego kontenera towarzyszącego; odpowiadające im zmienne _PORT ustawiają port, a KROKI_DIAGRAMSNET_HOST obsługuje diagrams.net |
KROKI_COMMAND_TIMEOUT | 5 sekund | Maksymalny czas oczekiwania na plik wykonywalny diagramu, taki jak dot |
KROKI_CONVERT_TIMEOUT | 20 sekund | Maksymalny czas oczekiwania na bibliotekę Javy, taką jak PlantUML |
KROKI_DELEGATE_TIMEOUT_MS | 30 000 | Maksymalny czas oczekiwania na kontener towarzyszący, w milisekundach |
KROKI_MAX_URI_LENGTH | 4096 | Długość adresu URL akceptowana dla GET, powyżej której Kroki odpowiada kodem 414 |
KROKI_CONTENT_SECURITY_POLICY | script-src 'none'; object-src 'none' | Nagłówek Content-Security-Policy wysyłany z każdą odpowiedzią |
KROKI_CORS_ALLOWED_HEADERS | Brak dodatkowych | Dodatkowe nagłówki dozwolone dla wywołań z innej witryny |
Diagramy Excalidraw tworzą długie adresy URL. Jeśli podnoszą Państwo KROKI_MAX_URI_LENGTH, dokumentacja zaleca pozostanie przy 8192 znakach lub mniej, choć większość przeglądarek akceptuje więcej w znaczniku <img>. W przypadku największych diagramów żądanie POST przenosi źródło w treści, a nie w adresie URL.
Kroki nie potrzebuje do działania żadnego sekretu. Dwa opcjonalne ustawienia go zawierają: token KROKI_COMPANION_REGISTRATION_TOKEN, przydatny, jeśli włączą Państwo rejestrację zewnętrznych kontenerów towarzyszących, omówioną w części o ochronie, oraz klucz prywatny certyfikatu, jeśli powierzą Państwo obsługę HTTPS samemu Kroki. Proszę przechowywać je poza wszelkimi repozytoriami kodu.
Brama udostępnia swoje API przez HTTP. Odwrotne proxy umieszczone przed nią nasłuchuje na portach 80 i 443, uzyskuje certyfikat Let’s Encrypt, szyfruje ruch i przekazuje go do Kroki na 127.0.0.1:8000. To również w nim filtruje się dostęp, jak pokazuje następna część.
Caddy sam uzyskuje i odnawia certyfikat dla podanej nazwy, a jego dyrektywa reverse_proxy przekazuje nagłówki X-Forwarded-For, X-Forwarded-Proto i X-Forwarded-Host bez dodatkowych ustawień:
diagrams.example.com {
encode gzip
reverse_proxy 127.0.0.1:8000
}
Ten blok serwera nasłuchuje na porcie 80, aby Certbot mógł zainstalować HTTPS. Dwa limity Nginx spotykają się z limitami Kroki: treść żądania większa niż 1 MB jest domyślnie odrzucana z kodem 413, co client_max_body_size dostosowuje do dużych diagramów wysyłanych przez POST; wiersz żądania dłuższy niż 8 KB otrzymuje kod 414, co large_client_header_buffers dostosowuje, jeśli podniosą Państwo KROKI_MAX_URI_LENGTH powyżej tej wartości.
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;
}
}
sudo nginx -t
sudo certbot --nginx
Dokumentacja opisuje też szyfrowanie przez sam Kroki: KROKI_SSL=true, z certyfikatem i kluczem prywatnym w formacie PEM, jako tekst przez KROKI_SSL_CERT i KROKI_SSL_KEY albo jako pliki przez KROKI_SSL_CERT_PATH i KROKI_SSL_KEY_PATH. Odnawianie certyfikatu odbywa się wtedy ręcznie, podczas gdy przy proxy zajmują się nim samodzielnie Caddy lub Certbot.
Kroki nie ma uwierzytelniania: każdy, kto dotrze do API, może zlecić mu renderowanie diagramów. Jego ochrona opiera się więc na trzech elementach, opisanych w dokumentacji i informacjach o wydaniach: trybie bezpieczeństwa, limitach rozmiaru i czasu oraz tym, co przepuszcza proxy. Proszę zacząć od ustalenia, kto musi mieć dostęp do Państwa serwera.
kroki-fetch-diagram, wtyczka MkDocs dzięki http_method: POST: obrazy są zapisywane razem z witryną, a serwer Kroki nie musi już być publiczny.KROKI_SAFE_MODE ustala trzy poziomy, z których każdy obejmuje ograniczenia poprzedniego. Dokumentacja wyjaśnia, że niektóre biblioteki potrafią odczytywać pliki lub adresy URL, jak dyrektywy !include PlantUML, i że Kroki, który nie weryfikuje ich kodu, domyślnie blokuje taki dostęp. Zachęca każdego, kto prowadzi serwer, do wyboru poziomu odpowiedniego do swojego zastosowania.
| Poziom | Co robi |
|---|---|
SECURE, domyślny | Uniemożliwia wszelkie próby odczytu plików z systemu plików lub zasobów z sieci |
SAFE | Opiera się na oczyszczaniu żądań przez własny tryb bezpieczny każdej biblioteki |
UNSAFE | Wyłącza wszystkie funkcje bezpieczeństwa |
SECURE jego !include i !includeurl są odrzucane, a jego profil bezpieczeństwa to SANDBOX. W SAFE profil zmienia się na ALLOWLIST, a KROKI_PLANTUML_ALLOWLIST_URL lub KROKI_PLANTUML_ALLOWLIST_PATH wskazują, co można dołączać.UNSAFE ich przeglądarka ładuje wyłącznie zasoby lokalne. Aby dopuścić wewnętrzny bank obrazów bez opuszczania tego trybu, dokumentacja proponuje KROKI_ALLOWED_ORIGINS lub jego wariant dla poszczególnych kontenerów, na przykład KROKI_MERMAID_ALLOWED_ORIGINS, ustawiany w kontenerze towarzyszącym.UNSAFE: bez !include dla Structurizr, bez zewnętrznych obrazów dla BlockDiag, bez odczytu plików dla Lini.KROKI_STRUCTURIZR_SAFE_MODE lub KROKI_MERMAID_SAFE_MODE, zamiast obniżać poziom całego serwera.Na instancji publicznej proszę zachować SECURE. Nagłówek Content-Security-Policy, wysyłany domyślnie od wersji 0.36.0, uzupełnia tę obronę: skrypt przemycony do pliku SVG nie wykonuje się pod adresem Kroki, nawet gdy obraz zostanie otwarty bezpośrednio.
Limity czasu z tabeli konfiguracji ograniczają każdą konwersję. Kontenery towarzyszące dodają własne, pomyślane jako ochrona przed wyczerpaniem zasobów:
KROKI_MERMAID_MAX_TEXT_SIZE) lub z ponad 500 krawędziami, z kodem 400, i przerywa renderowanie po 10 sekundach, z kodem 408. Tych limitów nie można obejść parametrami żądania.KROKI_MAX_BODY_SIZE).Gdy Kroki wywołuje wyłącznie Państwa potok publikacji, najprostszą opcją jest dopuszczenie tylko jego adresu IP. W Caddy matcher remote_ip wyodrębnia pozostałe adresy, a respond odsyła im kod 403:
diagrams.example.com {
@external not remote_ip 203.0.113.10
respond @external 403
reverse_proxy 127.0.0.1:8000
}
W Nginx dyrektywy allow i deny bloku location wykonują to samo zadanie, przy czym obowiązuje pierwsza pasująca reguła:
allow 203.0.113.10;
deny all;
Drugą drogą jest uwierzytelnianie podstawowe w proxy: basic_auth w Caddy, którego hasło haszuje się poleceniem caddy hash-password, albo auth_basic i plik utworzony przez htpasswd w Nginx. Sprawdza się ono przy klientach, które wysyłają dane logowania z każdym wywołaniem, jak curl -u; w przypadku potoku dokumentacji proszę sprawdzić, czy jego narzędzie potrafi je przekazywać. Dla instancji, która pozostaje publiczna, Nginx może też ograniczyć liczbę żądań na adres IP modułem limit_req, dostosowanym do liczby diagramów na Państwa stronach.
Kroki może obsługiwać zewnętrzne kontenery towarzyszące, które rejestrują się przez API /services. To wykrywanie jest domyślnie wyłączone i zawsze pozostaje wyłączone w trybie SECURE. Jeśli włączą je Państwo przez KROKI_ENABLE_COMPANION_DISCOVERY=true, dokumentacja prosi o utrzymywanie /services w zaufanej sieci i stanowczo zaleca token KROKI_COMPANION_REGISTRATION_TOKEN: bez niego Kroki ostrzega przy starcie, że każdy klient bramy może zarejestrować kontener towarzyszący.
Asciidoctor Kroki i wtyczka MkDocs domyślnie kierują się na https://kroki.io. Wystarczy im adres URL Państwa serwera, z prefiksem https://.
Rozszerzenie Asciidoctor Kroki odczytuje atrybut kroki-server-url, w nagłówku dokumentu, w wierszu poleceń lub w playbooku Antora. Proszę dodać kroki-fetch-diagram, aby pobierać obrazy w czasie budowania, zamiast kierować HTML na Państwa serwer; ta opcja wymaga trybu bezpieczeństwa Asciidoctor server lub niższego.
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:
Wtyczka mkdocs-kroki-plugin odczytuje server_url, którego wartością domyślną jest zmienna środowiskowa KROKI_SERVER_URL. Z http_method: POST obrazy są zapisywane obok każdej strony w zbudowanej witrynie i buforowane między dwoma budowaniami:
plugins:
- kroki:
server_url: https://diagrams.example.com
http_method: POST
Strona dokumentacji o narzędziach zewnętrznych wymienia też GitLab, który renderuje diagramy Kroki w Markdown, AsciiDoc, reST i Textile, a także Sphinx, Jekyll, Hugo, Remark, Python-Markdown, MediaWiki, rozszerzenia do Visual Studio Code i IntelliJ oraz Kroki.jl dla Julii. Działa też każdy klient HTTP, jak w tym przykładzie z dokumentacji:
curl https://diagrams.example.com/erd/svg --data-binary '@project.erd'
Kroki jest bezstanowy: niczego nie przechowuje między dwoma żądaniami, a nawet rejestr zewnętrznych kontenerów towarzyszących znika po ponownym uruchomieniu. Źródła Państwa diagramów znajdują się w repozytoriach dokumentacji, a ich obrazy w zbudowanych witrynach. Na serwerze Kroki kopię zapasową wykonuje się z jego konfiguracji:
| Element | Co zawiera | Kopia zapasowa |
|---|---|---|
compose.yaml | Obrazy, ich tagi i zmienne KROKI_* | Tak |
Plik .env, jeśli istnieje | Zmienne trzymane poza compose.yaml, takie jak token czy certyfikat | Tak, w bezpiecznym miejscu |
| Konfiguracja proxy | Caddyfile lub blok Nginx oraz plik z hasłami | Tak |
| Obrazy Docker | Samo oprogramowanie | Nie: docker compose pull pobiera je ponownie |
tar -czf kroki-config-$(date +%F).tar.gz compose.yaml /etc/caddy/Caddyfile
Proszę dostosować listę do swojego proxy, wykonywać nową kopię po każdej zmianie konfiguracji i wysyłać ją poza serwer. Umieszczona na jego dysku, trafia także do jego nocnych kopii zapasowych. Przywrócenie polega na odłożeniu tych plików na miejsce i uruchomieniu docker compose up -d.
Przy przypiętych tagach proszę zmienić wersję czterech obrazów w compose.yaml, a następnie, z jego katalogu:
docker compose pull
docker compose up -d
Kroki stosuje wersjonowanie semantyczne, a każda wersja publikuje swoje zmiany w CHANGELOG.md i na swojej stronie wydania. Proszę je przeczytać przed aktualizacją, zwłaszcza część „Security”: wersje 0.35.0 z 5 listopada 2026 roku i 0.36.0 z 9 listopada 2026 roku naprawiają zdalne wykonanie kodu przez diagramy Bytefield i TikZ, luki XSS w GoAT i DBML oraz fałszowanie żądań po stronie serwera przez BlockDiag i kontenery towarzyszące. Na otwartej instancji proszę wdrożyć te wersje bez zwłoki.
Wersja 0.36.0 dodaje też domyślny nagłówek Content-Security-Policy i silnik układu TALA dla D2. Dla instalacji ręcznej dokumentuje Javę 21 jako wersję minimalną.
Samodzielny hosting wymaga prowadzenia serwera, oprócz samej aplikacji. Na Managed VPS nasze zespoły przejmują serwer i proaktywnie czuwają nad Państwa instancją; Kroki pozostaje Państwa oprogramowaniem, z jego konfiguracją i kontenerami towarzyszącymi.
| Temat | Nasze zespoły | Państwo |
|---|---|---|
| Serwer | Aktualizacje systemu i zabezpieczeń, w tym interwencje na serwerze | Moment dogodny dla Państwa działalności |
| Nadzór | Serwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefon | Czytanie dzienników Państwa instancji |
| Kroki | Proaktywna opieka: wychwytujemy błędy, spowolnienia, zużycie pamięci przez kontenery towarzyszące i brak miejsca na dysku oraz polecamy poprawkę | Instalacja, aktualizacje i ustawienia, które wdrażają Państwo sami albo Państwa asystent AI |
| Diagramy i dostęp | Serwer, który je renderuje, nadzorowany i objęty kopiami zapasowymi | Tryb bezpieczeństwa, kontenery towarzyszące, limity i reguły dostępu w proxy |
| Kopie zapasowe | Co noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenie | Kopie Państwa konfiguracji przechowywane w innym miejscu oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne |
| Migracja | Migracja Państwa obecnego serwera, bezpłatna | Moment przełączenia |
Jeśli wolą Państwo, aby nasze zespoły interweniowały w samej aplikacji, usługa ta jest rozliczana godzinowo lub ryczałtowo, z wyceną przekazaną przed interwencją.
Z Managed VPS od Simafri nasze zespoły utrzymują serwer Państwa instancji Kroki w aktualności, nadzorują go dniem i nocą i interweniują bez czekania na Państwa telefon; proaktywnie czuwają także nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami albo Państwa asystent AI. Kopie zapasowe są szyfrowane co noc i przechowywane poza maszyną, ich przywracanie jest w cenie, a migracja obecnego serwera jest bezpłatna.
Tak. Kroki jest udostępniany na licencji MIT: mogą Państwo używać go, modyfikować i rozpowszechniać w firmie bez zakupu licencji, pod warunkiem zachowania informacji o prawach autorskich. Pozostaje koszt serwera, na którym działa.
Tylko dla diagramów, które renderują. Obraz yuzutech/kroki wystarcza dla PlantUML, GraphViz, D2, Structurizr i większości formatów. Mermaid, BPMN, Excalidraw i diagrams.net potrzebują każdy własnego kontenera towarzyszącego, podłączonego przez KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST lub KROKI_DIAGRAMSNET_HOST.
Proszę utworzyć compose.yaml z obrazem yuzutech/kroki, jego portem 8000 opublikowanym na 127.0.0.1 oraz potrzebnymi kontenerami towarzyszącymi, takimi jak yuzutech/kroki-mermaid, podłączonymi przez zmienne KROKI_*_HOST. Proszę uruchomić docker compose up -d, sprawdzić /health, a następnie postawić przed portem 8000 odwrotne proxy z HTTPS.
Nie, Kroki nie ma kont, strony administracyjnej ani bazy danych. Jego konfiguracja to zestaw zmiennych środowiskowych KROKI_*, a dostęp do API kontroluje się w odwrotnym proxy, według adresu IP lub uwierzytelnianiem podstawowym.
Proszę zachować tryb SECURE, domyślnie włączony, który nie pozwala bibliotekom odczytywać plików ani sięgać do sieci. Proszę pozostawić limity czasu i rozmiaru, aktualizować, gdy tylko nowa wersja naprawia lukę, a jeśli Kroki wywołuje wyłącznie Państwa potok publikacji, dopuszczać w proxy tylko jego adres.
W Asciidoctor proszę ustawić atrybut kroki-server-url na adres URL swojego serwera, a kroki-fetch-diagram, aby pobierać obrazy w czasie budowania. W MkDocs proszę ustawić server_url w konfiguracji wtyczki kroki, a http_method: POST, aby zapisywać obrazy razem z witryną.
Tylko z jego konfiguracji: compose.yaml, ewentualnego pliku .env i konfiguracji odwrotnego proxy. Kroki nie przechowuje żadnych danych, a jego obrazy Docker pobiera się ponownie poleceniem docker compose pull.
Managed VPS obejmuje serwer: system, bezpieczeństwo, nadzór i kopie zapasowe. Nasze zespoły proaktywnie czuwają też nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami. Interwencja w aplikacji jest rozliczana godzinowo lub ryczałtowo.
Simafri
Porozmawiajmy o Państwa projekcie
Proszę powiedzieć nam w kilku słowach, czego Państwo potrzebują: odpowiemy szybko.
Dziękujemy! Państwa zapytanie zostało wysłane. Wkrótce się odezwiemy.
Wolą Państwo e-mail? Proszę napisać do nas na support@simafri.com.