HandyCafe Docs
owner it-admin

Установка шлюза

Всё, что описано здесь, делается один раз, когда в клубе впервые появляется шлюз. Если вы ещё не читали раздел Шлюз, начните с него: там объясняется, что такое шлюз и где он находится.


Шаг 1: Выберите ПК

Шлюзу нужен один ПК с Windows, который работает всё время, пока открыт клуб. Есть два варианта, и оба нормальные.

Тот же ПК, на котором работает HandyCafe Server. Ничего не нужно докупать и искать для этого место, обслуживать приходится один компьютер. Минус в том, что перезагрузка ПК с Server отключает интернет во всём клубе, и в этот ПК нужна вторая сетевая карта.

Отдельный ПК. Интернет в клубе перестаёт зависеть от ПК с Server: его можно перезагрузить, обновить, он может даже сломаться, а все останутся в сети. Хватит старого офисного компьютера. Это лучший выбор для клуба, который может выделить отдельную машину.

В любом случае шлюзом управляют из HandyCafe Server. После настройки сидеть за ПК шлюза не нужно.


Шаг 2: Установите две сетевые карты

Это единственное требование, которое нельзя обойти. Шлюз принимает интернет через одну карту и раздаёт его клубу через другую. ПК с одной картой так не умеет.

У большинства ПК одна карта встроена в материнскую плату, поэтому нужно добавить вторую:

  • Сетевая карта PCIe, если в ПК есть свободный слот. Самый дешёвый вариант, и держится он надёжно.
  • USB-адаптер Ethernet, если слота нет. Он работает, и хлопот с ним гораздо меньше, чем с переносом клуба на другой ПК в будущем.

Wi-Fi не подходит в качестве карты, обращённой к клубу. Сторона клуба должна обслуживать все игровые ПК одновременно.


Шаг 3: Подключите кабели

Найдите кабель, который сейчас идёт от модема к коммутатору клуба. Этот кабель превращается в два.

  1. Модем подключается к первой карте ПК шлюза.
  2. Вторая карта ПК шлюза подключается к коммутатору клуба.

Всё остальное остаётся на месте. Игровые ПК, коммутатор и модем никуда не переносятся.

Если в клубе несколько интернет-линий, подключите сейчас первую, а остальные добавьте позже на вкладке WAN. См. Интернет-линии.


Шаг 4: Установите программу

В HandyCafe Server откройте Настройки > Шлюз.

На этот же ПК

Нажмите Установить на этот ПК. Server один раз спросит, уверены ли вы, ведь этот ПК станет роутером для всего клуба. Подтвердите, один раз разрешите Windows запрос прав, и дальше всё пройдёт само. Это занимает пару минут.

На другой ПК

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

Когда установка завершена

Установщик открывает в браузере на ПК шлюза две страницы: это руководство на языке Windows и собственную страницу шлюза. В сети пока ничего не изменилось. Шлюз не трогает сетевые карты, пока вы не выберете их на шаге 6.


Шаг 5: Войдите на страницу шлюза

Страница шлюза находится по адресу https://127.0.0.1:8443/ на ПК шлюза. Её также открывает значок в области уведомлений.

Сначала браузер предупредит о сертификате. Так и должно быть. Шлюз подписал сертификат сам, потому что никто за пределами этой машины не может поручиться за ПК в вашей собственной сети. На странице предупреждения откройте подробности или дополнительные параметры и выберите переход на сайт.

Войдите с начальными данными:

Имя пользователя Пароль
admin handycafe

Они одинаковы на каждом новом шлюзе и указаны здесь намеренно: это не секрет, а отправная точка. Затем страница попросит задать собственные имя пользователя и пароль, прежде чем делать что-либо ещё. HandyCafe Server входит с этими же данными с другого ПК. Любой, кто знает начальный пароль, может сделать то же самое.

Если пароль уже меняли, войдите с ним.


Шаг 6: Укажите, какая карта за что отвечает

Откройте вкладку Настройка сети. На ней перечислены сетевые карты ПК с их адресами и отметкой, подключён ли кабель. Там же шлюз предлагает, какая карта смотрит на модем, а какая на клуб.

  • Адаптер для интернета: карта, в которую подключён кабель от модема.
  • Адаптер для сети клуба: карта, в которую подключён кабель от коммутатора клуба.

Проверьте предложение, прежде чем его принять. Если обе карты одной модели, по названиям их не различить, а если на секунду отсоединить одну из них, станет понятно: отсоединённая покажется неподключённой.

Нажмите Применить.

Вопрос, который задаётся после

Смена назначения карт перестраивает сетевые настройки этого ПК. Если выбор неверный, клуб остаётся без интернета, и никто не сможет достучаться до шлюза, чтобы всё вернуть.

Поэтому шлюз не просто применяет изменение. Он применяет его, спрашивает, всё ли работает, и сам возвращает прежние настройки, если в течение минуты никто не ответил.

Прежде чем ответить Да, оставить эти параметры, проверьте две вещи: что этот ПК по-прежнему выходит в интернет и что один из ПК клуба тоже. Если хотя бы один не выходит, ответьте Нет, вернуть прежние или просто ничего не отвечайте и дождитесь окончания минуты.

Затем на вкладке Состояние отобразятся обе карты, адрес шлюза в сети клуба (192.168.10.1 при новой установке) и получают ли ПК клуба свои адреса. Если что-то не так, вкладка подскажет, в чём проблема и что делать.


Шаг 7: Подключите HandyCafe Server

В HandyCafe Server откройте Настройки > Шлюз и заполните поля:

  • Адрес шлюза: адрес шлюза в сети клуба, 192.168.10.1 при новой установке. Если шлюз работает на самом ПК с Server, подойдёт тот же адрес.
  • Порт: 8443.
  • Имя пользователя и Пароль: те, с которыми вы входили на шаге 5.

Нажмите Проверить подключение, затем Подключить. Server запоминает сертификат шлюза и откажется подключаться, если он когда-нибудь изменится.


Шаг 8: Проверьте результат

  • В главном меню HandyCafe Server появилась страница Интернет, и на её вкладке «Обзор» линия отображается как работающая.
  • Игровой ПК в сети клуба открывает веб-страницу.
  • В разделе Настройки > Шлюз шлюз отображается как подключённый.

Установка завершена. Всё дальнейшее относится к повседневной работе и находится на странице «Интернет».


Собственная страница шлюза

Страница, на которую вы входили на шаге 5, пригодится и после установки. Это запасной вход на случай, когда HandyCafe Server не запускается или не видит шлюз: там можно посмотреть состояние, заново пройти настройку сети, прочитать журнал, скачать файл диагностики для поддержки, перезапустить шлюз и сменить пароль. Всё остальное остаётся в HandyCafe Server.

Страница открывается только на самом ПК шлюза. Другой компьютер в вашей сети не получит ничего, даже формы входа.


Если пароль утерян

На ПК шлюза откройте командную строку от имени администратора и выполните эти три команды по очереди:

net stop HandyCafeGateway /y
"C:\Program Files\HandyCafe\Gateway\gatewayd.exe" --config "C:\Program Files\HandyCafe\Gateway\gatewayd.toml" reset-admin-password
net start HandyCafeGateway

Учётная запись вернётся к admin / handycafe. Войдите с ней и снова задайте свой пароль: на странице шлюза и в разделе Настройки > Шлюз. Пока шлюз остановлен, в клубе нет интернета. Сделать это по сети нельзя, и так задумано.


Перенос шлюза на другой ПК

Установите шлюз на новый ПК и подключите Server к новому адресу. Затем удалите его со старого ПК или хотя бы остановите его службу: два шлюза, раздающие адреса в одной сети, будут мешать друг другу.