Як користуватися Ngrok?

Ngrok — це інструмент, який дозволяє створювати захищені тунелі до локального сервера, що дуже зручно для тестування веб-додатків, інтеграції з іншими сервісами або для надання доступу до локальних сервісів з Інтернету. Ось покрокова інструкція з використання Ngrok:

1. Встановлення Ngrok

  1. Перейдіть на офіційний сайт Ngrok і зареєструйтеся, щоб отримати токен аутентифікації.
  2. Завантажте Ngrok для вашої операційної системи (Windows, macOS, Linux ).
  3. Розпакуйте завантажений архів.

Windows:

  • Розпакуйте архів у зручне місце, наприклад C:\ngrok.
  • Додайте шлях до ngrok.exe у змінну середовища PATH для зручного запуску з командного рядка.

macOS/Linux:

  • Розпакуйте архів:
    unzip /path/to/ngrok.zip
    
  • Перемістіть файл ngrok до /usr/local/bin:
    sudo mv ngrok /usr/local/bin
    

2. Аутентифікація

Запустіть Ngrok у командному рядку і аутентифікуйте його за допомогою вашого токена:

ngrok authtoken <ваш_токен>

Ваш токен можна знайти в особистому кабінеті на сайті Ngrok.

3. Запуск тунелю

Ngrok дозволяє створювати тунелі до локальних серверів. Наприклад, якщо у вас є локальний веб-сервер, який працює на порту 8000, ви можете створити тунель до нього наступним чином:

ngrok http 8000

Ця команда створить HTTP-тунель до локального сервера на порту 8000 і надасть вам публічний URL, який ви можете використовувати для доступу до вашого локального сервера з Інтернету.

4. Використання публічного URL

Після запуску команди ngrok http <порт> у командному рядку з’явиться інформація про тунель, включаючи публічний URL, який виглядає приблизно так:

Forwarding                    http://1234abcd.ngrok.io -> http://localhost:8000

Тепер ви можете використовувати цей URL для доступу до вашого локального сервера з будь-якого місця.

5. Додаткові налаштування

Ngrok підтримує багато додаткових налаштувань і опцій, які можна використовувати:

  • Subdomains: Використовуйте піддомени для ваших тунелів:

    ngrok http -subdomain=myapp 8000
    
  • Custom Domains: Використовуйте власні домени для тунелів (необхідно налаштувати DNS):

    ngrok http -hostname=example.com 8000
    
  • Tunnels Config File: Зберігайте налаштування тунелів у файлі конфігурації ngrok.yml для зручного запуску:

    tunnels:
      http:
        proto: http
        addr: 8000
    

Запустіть Ngrok з файлом конфігурації:

ngrok start --all

6. Перегляд трафіку

Ngrok надає веб-інтерфейс для моніторингу трафіку, що проходить через ваш тунель. Ви можете відкрити цей інтерфейс у браузері за адресою:

http://localhost:4040

Цей інтерфейс дозволяє переглядати всі запити та відповіді, що проходять через тунель, що дуже зручно для налагодження.

Це основні кроки для використання Ngrok. Інструмент дуже гнучкий і може бути налаштований для різних сценаріїв використання, тому рекомендується ознайомитися з офіційною документацією для отримання додаткової інформації.