Ngrok má konfiguračný súbor, ktorý obsahuje autorizačný token. Pri práci so softvérom je často potrebné spustiť príkaz, ktorý je pomerne dlhý, takže na skrátenie príkazu na spustenie tunela môžete použiť konfiguračný súbor.
Konfiguračný súbor vo formáte Yaml
Príkaz je možné v tomto súbore presne opísať a potom ho spustiť podľa názvu. Ngrok ukladá konfiguráciu vo formáte Yaml v domovskom priečinku v zložke .config. Nie je však potrebné súbor priamo upravovať. Na editáciu slúži nástroj config edit:
ngrok config edit
Do konfiguračného súboru je potrebné pridať časť Tunely.
Syntax pre popis tunelov je nasledujúca:
tunnels:
tunnel_name:
proto: protocol
addr: port
Tu sú k dispozícii aj ďalšie parametre, ktoré sa predtým odovzdávali v príkazovom riadku:
- basic_auth - pridanie autorizácie HTTP.
- host_header - nahradí hodnotu hlavičky Host.
- inspect - či sa majú požiadavky ukladať na kontrolu, v predvolenom nastavení je zapnuté.
- schémy - dostupné schémy: http a/alebo https.
- zadajte názov domény pre službu, k dispozícii len v platenom predplatnom.
Ak chcete vytvoriť vzorový tunel pre port 80 s hlavičkou Host nahradenou hodnotou example.local, pridajte tieto riadky do sekcie tunelov:
example:
proto: http
addr: 80
host_header: "example.local"

Teraz uložte zmeny a skontrolujte konfiguračný súbor pomocou tohto príkazu:
ngrok config check
Ak ste všetko urobili správne, v konfiguračnom súbore sa zobrazí správa:

Ďalej môžete spustiť nakonfigurovaný tunel podľa jeho názvu:
ngrok start example

Teraz viete, ako vytvoriť príkaz v konfiguračnom súbore.