Довідник налаштувань тунелю
На цій сторінці 15 розділів
- Відкрийте налаштування тунелю
- Відкрийте сторінку типу тунелю
- Оберіть «Налаштування» в рядку тунелю
- Змініть налаштування
- Як застосовуються зміни
- Які налаштування є в яких типів тунелів
- Що робить кожне налаштування
- Деталі тунелю
- Нотатка тунелю
- Локальний HTTPS?
- Протокол PROXY?
- Застаріле підключення?
- IP локального сервера
- IP тунелю
- Налаштування у списку тунелів
- Змініть сервер
- Змініть AuthToken
- Брандмауер вебзастосунків
- Ті самі налаштування через API
- Усунення несправностей
- Пов’язані сторінки
Кожен тунель має панель налаштувань на панелі керування. На цій сторінці показано, де її відкрити, перелічено всі налаштування, зазначено, які типи тунелів їх мають, і додано посилання на сторінку з докладним поясненням.
Відкрийте налаштування тунелю #
-
Відкрийте сторінку типу тунелю #
У меню панелі керування відкрийте Мої тунелі та оберіть тип: Мої тунелі › HTTP, TCP - UDP, TLS, Файловий сервер, Проксі-сервер, Ротаційний проксі або MCP-шлюз.
-
Оберіть «Налаштування» в рядку тунелю #
Знайдіть тунель у списку Ваші тунелі і виберіть Налаштування у стовпці Дії. Збоку сторінки відкриється панель Налаштування тунелю.
-
Змініть налаштування #
Панель складається з таких частин:
- Деталі тунелю: відомості про тунель, як-от його адреса, дата створення й назва AuthToken, а також значення, які можна змінити, натиснувши на них: заголовок у тунелях будь-якого типу, а також локальна адреса й локальний порт у тунелях HTTP, TCP - UDP і TLS.
- Цілі балансування навантаження тунелю, для типів тунелів, що їх підтримують. Дивіться Балансування навантаження.
- Показати SSH-команду для типів тунелів, які можна запустити через звичайний SSH. Дивіться SSH без встановлення.
- Налаштування: один рядок на кожне налаштування. У рядку є або перемикач Так / Ні, або кнопка (Керувати, Змінити, Показати чи Очистити), що відкриває діалогове вікно. Значок інформації поруч із назвою пояснює налаштування одним реченням.
Більшість перемикачів просять підтвердити дію перед зміною, наприклад Увімкнути режим «лише HTTPS»? з кнопками Увімкнути і Скасувати. Увімкнення Базова автентифікація? або Перезапис шляху? натомість відкриває діалогове вікно, а увімкнення Зарезервований порт? у запущеному тунелі резервує порт без запитань.
Як застосовуються зміни #
Деякі налаштування застосовуються до запущеного тунелю без перерви в роботі. Інші зупиняють тунель і запускають його знову з новим значенням: це займає трохи часу й розриває відкриті з’єднання.
| Застосовується без перезапуску | Перезапускає запущений тунель |
|---|---|
| Лише HTTPS?, Перезапис шляху?, HTTP/3 активний?, Зарезервований порт?, Заголовки, HTTP-таймаут, Нотатка тунелю, IP-обмеження, Термін дії, Вихідний порт, Ліміт трафіку, Використання трафіку, перемикач WAF | Заголовок, локальна адреса та локальний порт у Деталі тунелю, Базова автентифікація?, Локальний HTTPS?, Протокол PROXY?, Застаріле підключення?, Порт сервера, Аргументи, IP локального сервера, Обмеження швидкості, зміна сервера, зміна AuthToken |
Налаштування, що перезапускає тунель, можна зберегти для запущеного тунелю лише тоді, коли застосунок Localtonet на його пристрої підключений. Інакше панель керування відповість «Перевірте підключення пристрою.» і збереже старе значення. Для зупиненого тунелю значення зберігається й застосовується під час наступного запуску.
Які налаштування є в яких типів тунелів #
Назви відповідають тим, що показує розділ Налаштування. «Так» означає, що тип тунелю має такий рядок.
| Налаштування | HTTP | TCP - UDP | TLS | Файловий сервер | Проксі-сервер | Ротаційний проксі | MCP-шлюз |
|---|---|---|---|---|---|---|---|
| Лише HTTPS? | Так | – | – | – | – | – | Так |
| Перезапис шляху? | Так | – | – | – | – | – | – |
| Базова автентифікація? | Так | – | – | Так, тип Default | – | – | Так |
| Локальний HTTPS? | Так | Так, крім UDP | Так | – | – | – | – |
| HTTP/3 активний? | Так | – | – | – | – | – | Так |
| Зарезервований порт? | – | Так | – | – | Так | Так | – |
| Протокол PROXY? | – | Так, крім UDP | – | – | – | – | – |
| Застаріле підключення? | Так | Так | Так | Так | Так | – | Так |
| Режим SSL | – | – | Так | – | – | – | – |
| SSO-провайдери | Так, крім командних тунелів | – | – | – | – | – | – |
| Токен шлюзу | – | – | – | – | – | – | Так |
| Заголовки | Так | – | – | – | – | – | – |
| HTTP-таймаут | Так | – | – | – | – | – | Так |
| Порт сервера | – | Так | – | – | Так, крім VLESS | Так | – |
| Нотатка тунелю | Так | Так | Так | Так | Так | Так | Так |
| IP локального сервера | Лише локальний сервер | Лише локальний сервер | Лише локальний сервер | – | Лише локальний сервер | – | Лише локальний сервер |
| Аргументи | Так | Так | Так | – | Так | – | – |
| IP-обмеження | Так | Так | Так | Так | Так | Так | Так |
| Термін дії | Так | Так | Так | Так | Так | – | Так |
| Обмеження швидкості | Так | Так | Так | Так | Так | – | Так |
| Вихідний порт | Так | Так | Так | Так | Так | Так | Так |
| Ліміт трафіку | Так | Так | Так | Так | Так | – | Так |
| Трафік тунелю | Так | Так | Так | Так | Так | Так | Так |
| Використання трафіку | Так | Так | Так | Так | Так | – | Так |
| IP тунелю | – | Так | Так | – | Так | Так | – |
| Журнал запитів | Так | Так | Так | Так | Так | – | Так |
| Журнал активності | Так | Так | Так | Так | Так | Так | Так |
| Стан тунелю | Так | Так | Так | – | Так | Так | Так |
Сторінки «Проксі-сервер» і «Ротаційний проксі» мають власні додаткові рядки, як-от Автентифікація проксі, Контроль доступу, Налаштування upstream-проксі, VPN-доступ, Тест швидкості, Токен тунелю і Лише IPv4?. Їх описано в розділах Проксі-сервер і Ротаційний проксі. Тунель, що використовує сервер Локальна, не має рядка Вихідний порт. «Лише локальний сервер» стосується також тунелю, у стовпці Сервер якого вказано VPN.
Що робить кожне налаштування #
| Налаштування | Що робить | Докладніше |
|---|---|---|
| Лише HTTPS? | Віддає публічну URL-адресу лише через HTTPS. | Заголовки та перезаписи |
| Перезапис шляху? | Додає шлях перед кожним запитом, перш ніж він потрапить до вашого локального сервісу. | Заголовки та перезаписи |
| Базова автентифікація? | Запитує в відвідувачів ім’я користувача й пароль. | Контроль доступу |
| Локальний HTTPS? | Повідомляє тунелю, що ваш локальний сервіс сам використовує HTTPS або TLS. | Ця сторінка |
| HTTP/3 активний? | Дозволяє клієнтам відкривати публічну URL-адресу через HTTP/3. | Заголовки та перезаписи |
| Зарезервований порт? | Зберігає той самий порт сервера під час перезапуску тунелю. | Порти |
| Протокол PROXY? | Передає вашому сервісу початкову адресу клієнта в заголовку протоколу PROXY. | Ця сторінка |
| Застаріле підключення? | Альтернативний спосіб підключення, який варто спробувати, коли тунель не може підключитися звичайним способом. | Ця сторінка |
| Режим SSL | Визначає, чи Localtonet обробляє HTTPS для тунелю TLS, чи передає зашифрований трафік до вашого сервісу без змін. | TLS |
| SSO-провайдери | Вимагає від відвідувачів увійти через одного з ваших провайдерів ідентифікації, перш ніж вони зможуть відкрити тунель. | Єдиний вхід |
| Токен шлюзу | Показує токен, який ваші MCP-клієнти надсилають для підключення до шлюзу. | MCP-шлюз |
| Заголовки | Додає фіксовані заголовки запитів і відповідей. | Заголовки та перезаписи |
| HTTP-таймаут | Визначає, як довго тунель чекає на відповідь вашого сервісу на запит. | Заголовки та перезаписи |
| Порт сервера | Змінює порт, до якого підключаються користувачі на сервері Localtonet. | Порти |
| Нотатка тунелю | Особисте нагадування про призначення тунелю. | Ця сторінка |
| IP локального сервера | Адреси, за якими доступний ваш локальний сервер. | Ця сторінка |
| Аргументи | Спрямовує тунель через певну мережу пристрою. | Вибір мережі |
| IP-обмеження | Визначає, з яких IP-адрес можна підключатися до тунелю. | Контроль доступу |
| Термін дії | Зупиняє тунель у вказану дату. | Ліміти та термін дії |
| Обмеження швидкості | Обмежує швидкість вивантаження й завантаження. | Ліміти та термін дії |
| Вихідний порт | Фіксує порти, до яких підключається застосунок Localtonet, для суворих брандмауерів. | Порти |
| Ліміт трафіку | Зупиняє тунель, коли через нього пройде вказаний обсяг даних. | Ліміти та термін дії |
| Трафік тунелю | Показує на графіку дані, що пройшли через тунель. | Ліміти та термін дії |
| Використання трафіку | Обнуляє лічильник даних тунелю. | Ліміти та термін дії |
| IP тунелю | Показує IP-адреси сервера, на якому працює тунель. | Ця сторінка |
| Журнал запитів | Показує запити або з’єднання, записані для тунелю. | Журнали та перевірка |
| Журнал активності | Перелічує запуски, зупинки та зміни налаштувань. | Журнали та перевірка |
| Стан тунелю | Показує результати регулярних перевірок стану. | Журнали та перевірка |
Деталі тунелю #
Натисніть значення в розділі Деталі тунелю, щоб змінити його. Збереження будь-якого з трьох значень перезапускає запущений тунель. Локальну адресу й локальний порт можна змінювати тут у тунелях HTTP, TCP - UDP і TLS; інші типи тунелів показують лише заголовок.
| Діалогове вікно | Що вводити | Правила |
|---|---|---|
| Перейменувати тунель | Назва, яку ви легко впізнаєте у списку тунелів, наприклад «Office NAS». | Обов’язково. До 30 символів: діалогове вікно рахує до 100, але заголовок довший за 30 символів буде відхилено з повідомленням «Заголовок не може бути довшим за 30 символів.» |
| Локальна адреса | Де застосунок Localtonet знаходить ваш сервіс. Вкажіть 127.0.0.1, якщо сервіс працює на тому самому пристрої, що й застосунок. Щоб дістатися до іншого пристрою у вашій мережі, введіть його адресу, наприклад 192.168.1.20. | Адреса IPv4, адреса IPv6 або ім’я хоста. Без http://, без шляху, без порту. |
| Локальний порт | Порт, який слухає ваш сервіс на пристрої, де він працює. | Число від 1 до 65535. |
Нотатка тунелю #
Нотатка тунелю › Керувати відкриває діалогове вікно Нотатка. Нотатка — це нагадування про призначення тунелю, і бачить її лише ваш обліковий запис.
- Нотатка може містити до 499 символів. Діалогове вікно рахує їх під час введення.
- Варіанти під Мітка додають мітку на початок нотатки: Продакшн, Staging, Тестування, Демо або Тимчасовий. Тоді нотатка починається, наприклад, так:
Staging -. Вибір іншої мітки замінює наявну.
Локальний HTTPS? #
Увімкніть Локальний HTTPS?, коли ваш локальний сервіс сам використовує HTTPS або TLS, наприклад сервер розробки, що слухає лише https://localhost. Залиште вимкненим для сервісу зі звичайним HTTP або звичайним TCP. Перемикач є в тунелів HTTP, TCP і TLS; у тунелю UDP його немає.
Протокол PROXY? #
Коли Протокол PROXY? увімкнено, тунель передає вашому сервісу початкову адресу клієнта в заголовку протоколу PROXY. Вмикайте його лише тоді, коли сервіс налаштовано на читання цього заголовка: інакше він побачить невідомі байти на початку кожного з’єднання. Перемикач є в тунелів TCP; у тунелю UDP його немає.
Застаріле підключення? #
Застаріле підключення? перемикає тунель на альтернативний спосіб підключення. Спробуйте його, якщо тунель не може підключитися звичайним способом, і вимкніть знову, якщо це не допомогло.
IP локального сервера #
Цей рядок з’являється лише в тунелів, у стовпці Сервер яких вказано Локальна або VPN. Діалогове вікно IP локального сервера містить адреси, за якими доступний ваш локальний сервер: Адреса IPv4 і, за бажання, Адреса IPv6. Залиште IPv6 порожнім, якщо ви його не використовуєте. Потрібна щонайменше одна адреса. Адресу, що працює лише на самому пристрої, наприклад 127.0.0.1, 0.0.0.0 або ::1, буде відхилено з повідомленням «IP локального сервера має бути доступним ззовні.»
IP тунелю #
IP тунелю › Показати відкриває діалогове вікно IP сервера з адресою IPv4 і, якщо вона є в сервера, адресою IPv6 сервера, на якому працює тунель. Клієнти можуть підключатися до тунелю за цією адресою замість доменного імені.
IP-адреси серверів можуть змінюватися. Використовуйте доменне ім’я в застосунках і скриптах, коли це можливо.
Налаштування у списку тунелів #
Два налаштування змінюються зі списку тунелів, а не з панелі.
Змініть сервер #
Виберіть код сервера у стовпці Сервер, оберіть інший сервер у діалоговому вікні Змінити сервер і натисніть Надіслати. Запущений тунель буде перезапущено на новому сервері.
- Для зміни сервера потрібен баланс. Без нього панель керування відповість «Щоб користуватися цією функцією, поповніть баланс.»
- Якщо порт сервера тунелю вже зайнятий на новому сервері, ви побачите «Порт вашого тунелю (PORT) недоступний на вибраному сервері. Спочатку змініть порт.» Змініть порт, як описано в розділі Порти, і повторіть спробу.
- Тунелі, у стовпці Сервер яких вказано Локальна або VPN, перенести не можна.
Після зміни сервера оновлення DNS може тривати до 3 годин.
Змініть AuthToken #
Виберіть назву токена у стовпці AuthToken, щоб відкрити Змінити AuthToken, оберіть інший AuthToken і натисніть Надіслати. Тунель буде перенесено на пристрій, де працює застосунок Localtonet із цим токеном.
- Запущений тунель зупиняється, чекає 2 секунди, а потім запускається знову з вибраним AuthToken. Зупинений тунель залишається зупиненим.
- Якщо застосунок із новим токеном не підключений, токен усе одно буде змінено, і ви побачите «AuthToken оновлено, але тунель не вдалося перезапустити. Підключіть застосунок Localtonet з вибраним токеном і запустіть тунель.»
- Тунелі «Ротаційний проксі» використовують групи AuthToken. Змінюйте групи.
Про AuthToken розповідається в розділі AuthToken.
Брандмауер вебзастосунків #
Тунелі HTTP і MCP-шлюз також мають кнопку-щит у стовпці Дії. Вона відкриває брандмауер тунелю. Дивіться Брандмауер вебзастосунків.
Ті самі налаштування через API #
Більшість налаштувань також можна переглядати й змінювати через API за шляхом тунелю. Автентифікацію та повний довідник наведено в розділі API.
| Налаштування | Шлях після /api/v2/tunnels/<TUNNEL_ID>/ |
|---|---|
| IP-обмеження | ip-restrictions |
| Заголовки | headers, host-header |
| Базова автентифікація | authentication |
| Термін дії | expiration |
| Порт сервера | server-port |
| HTTP-таймаут | http-timeout |
| Обмеження швидкості | rate-limit |
| Ліміт і використання трафіку | bandwidth-limit, bandwidth-usage, bandwidth-usage/reset |
| Аргументи | arguments |
| Лише HTTPS?, HTTP/3 активний?, Перезапис шляху? | https-only, http3, path-rewrite |
| Локальний HTTPS?, Протокол PROXY?, Режим SSL | ssl-stream, proxy-protocol, pass-through |
| Нотатка тунелю | note |
| Сервер | server |
Усунення несправностей #
«Перевірте підключення пристрою.»
Налаштування перезапускає тунель, а застосунок Localtonet на пристрої тунелю не підключений. Запустіть застосунок на пристрої, зачекайте, доки у стовпці Підключення з’явиться УВІМК, і збережіть знову. Також можна спершу зупинити тунель: для зупиненого тунелю значення зберігається без перезапуску.
«Щоб користуватися цією функцією, поповніть баланс.»
Налаштування потребує баланс на обліковому записі. Це стосується зарезервованих портів, власного порту сервера, фіксованих вихідних портів, IP-обмежень і зміни сервера. Дивіться Тарифи та баланс.
«У вас немає прав на зміну цього тунелю.»
Ви працюєте в команді, і ваша роль не передбачає зміни тунелів. Попросіть власника команди надати вам цей дозвіл. Дивіться Керування командою.
У моїй панелі бракує рядка з таблиці
Панель показує лише рядки для типу тунелю, а деякі рядки залежать від самого тунелю: для IP локального сервера потрібен сервер Локальна або VPN, SSO-провайдери не показуються в командних тунелях, а в тунелю UDP немає Локальний HTTPS? і Протокол PROXY?.