Додавання сайту Node.js у ServBay через зворотний проксі

ServBay — це потужне локальне середовище для веб-розробки, яке нативно підтримує різні технологічні стекі, включаючи Node.js. У цьому посібнику докладно пояснюється, як інтегрувати самостійно запущену Node.js-програму в систему управління сайтами ServBay за допомогою зворотного проксі. Такий підхід дозволяє зручно користуватися централізованим доступом ServBay (наприклад, через власний домен та SSL-сертифікат) для керування та доступу до ваших проектів Node.js.

Огляд

Хоча ServBay дозволяє безпосередньо запускати Node.js-додатки (наприклад, за допомогою встановленого через ServBay Node.js і запуску скриптів), інтеграція вже запущеного Node.js на визначеному порту через зворотний проксі — це зручний і гнучкий спосіб роботи. Це дозволяє використовувати мережеві можливості ServBay (наприклад, вирішення доменів, завершення SSL/TLS) для керування доступом до Node.js-додатків. Далі ви дізнаєтеся, як виконати цю конфігурацію.

Передумови

Перед початком переконайтесь, що:

1. Ви успішно встановили ServBay на macOS.
2. Ваш проект Node.js вже локально запущено та він слухає певний порт (наприклад, 8585).

Кроки конфігурації

Крок 1: Запустіть проект Node.js

Спершу переконайтеся, що ваш Node.js-проект локально запущений і слухає зазначений порт. Використовуйте звичний для вас спосіб запуску Node.js-програми.

Припустимо, ви зараз запускаєте сервер розробки для проекту Vue.js на порту 8585:

$ npm run dev -- --port 8585
Server running at http://localhost:8585/

Запам’ятайте IP-адресу (зазвичай це 127.0.0.1) та порт, на яких слухає ваш Node.js-додаток.

Крок 2: Відкрийте інтерфейс керування ServBay

Знайдіть у папці програм вашого macOS іконку ServBay та двічі клікніть для запуску додатку.

Крок 3: Перейдіть до розділу керування сайтами

Після запуску ServBay ви побачите головний інтерфейс. На панелі навігації зліва оберіть Сайти. Ви потрапите на сторінку керування сайтами, де можна налаштовувати всі сайти, якими керує або які проксуює ServBay.

Крок 4: Додайте новий сайт

У нижній частині сторінки керування сайтами знайдіть і натисніть на кнопку +. Відкриється форма для вводу налаштувань нового сайту.

Крок 5: Налаштування параметрів сайту

У формі додавання нового сайту для конфігурації зворотного проксі вкажіть наступні ключові параметри:

• Назва (Name): Вкажіть зрозумілу назву для сайту, наприклад My Node.js App. Це лише для відображення у інтерфейсі ServBay.
• Домен (Domain): Введіть локальний домен, через який ви хочете отримати доступ до Node.js-додатку. Рекомендується використовувати суфікс .servbay.demo, наприклад nodejs.servbay.demo. ServBay автоматично налаштує локальний DNS для маршрутизації на 127.0.0.1.
• Протокол (Protocol): Виберіть протокол для сайту. Зазвичай залишайте HTTP/HTTPS за замовчуванням (ServBay буде слухати і HTTP, і HTTPS-порт).
• Спосіб отримання SSL-сертифіката (SSL Certificate Method): Для локальної розробки наполегливо рекомендується вибрати ServBay CA. ServBay автоматично згенерує та встановить сертифікат від власного Root CA. Після встановлення цього кореневого сертифіката у систему та браузер, не буде попереджень при доступі по HTTPS. За бажанням можете вибрати ServBay Public CA або ACME (для публічних сертифікатів), але це більше потрібно для зовнішнього доступу.
• Тип сайту (Site Type): Обов’язково вибирайте Reverse Proxy (Зворотний проксі). Це повідомляє ServBay, що потрібно перенаправити всі запити до цього домену на іншу адресу, а не віддавати файли з файлової системи.
• IP-адреса (IP Address): Зазначте IP-адресу, на якій слухає ваш Node.js-додаток. Для локальних додатків це, як правило, 127.0.0.1 (локальний інтерфейс).
• Порт (Port): Вкажіть порт, який використовує ваш додаток, наприклад, 8585. ServBay буде перенаправляти відповідні запити на 127.0.0.1:8585.

Крок 6: Завершіть і збережіть

Після внесення всіх необхідних параметрів натисніть кнопку Додати (Add) під формою. ServBay збереже настроювання і автоматично оновить свою внутрішню конфігурацію (наприклад, веб-сервер та налаштування DNS).

Після успішного збереження ви побачите в списку сайтів новий запис, наприклад nodejs.servbay.demo. Тепер ви можете перейти у браузері за вказаним доменом (наприклад, http://nodejs.servbay.demo або https://nodejs.servbay.demo), щоб відкрити ваш Node.js-додаток. Клік по іконці браузера поряд із записом сайту відкриє сайт напряму.

Крок 7: Швидкі дії

ServBay пропонує перелік зручних кнопок поруч із кожним доданим сайтом у списку:

1. Відкрити кореневу папку сайту в IDE: Для сайтів-зворотних проксі ця кнопка може вести не безпосередньо до каталогу Node.js-проекту, а до стандартної кореневої папки ServBay, наприклад /Applications/ServBay/www чи іншого призначеного каталогу.
2. Відкрити сайт у браузері: Миттєво відкриває URL сайту у вашому браузері.
3. Переглянути логи сайту: Доступ до логів веб-сервера ServBay (наприклад, Caddy чи Nginx) для цього сайту. Дуже корисно для відлагодження помилок.
4. Призупинити/активувати сайт: Тимчасово відключає або знову вмикає доступ до сайту.
5. Видалити сайт: Видаляє налаштування сайту з ServBay.

Часті питання (FAQ)

• При переході за доменом відкривається стандартна сторінка ServBay або помилка?
  • Переконайтесь, що Node.js-додаток дійсно запущено на правильній IP-адресі та порту.
  • Перевірте, що IP-адреса та порт, вказані у налаштуваннях сайту в ServBay, збігаються з тими, на яких слухає ваш додаток.
  • Перевірте, що сам ServBay активний.
  • Якщо використовується домен .servbay.demo, переконайтесь, що DNS-служба ServBay працює і ваша мережева конфігурація дозволяє ServBay керувати розв’язанням цього домену.
• Попередження про небезпечний сертифікат під час доступу через HTTPS?
  • Якщо ви вибрали ServBay CA, перевірте, що кореневий сертифікат встановлено та довірено у системі і браузері. ServBay пропонує зручний інтерфейс для цього.
  • Якщо вибрано ServBay Public CA або ACME, переконайтеся, що сертифікат видано й підключено правильно.

Підсумок

Завдяки зворотному проксі ServBay забезпечує зручний спосіб інтеграції та керування локальними Node.js-додатками. Ви отримуєте всі переваги потужного веб-сервера ServBay (наприклад, власні домени, автоматичне управління SSL-сертифікатами) й єдину точку доступу та адміністрування для своїх проектів на Node.js. Дотримуючись інструкцій із цього посібника, ви швидко налаштуєте та відкриєте свій сайт на Node.js у середовищі ServBay.