avoice

Документация

Общий список серверов

Общий список - открытые серверы AVOICE, владельцы которых решили показать их всем. Он есть на странице Серверы и в клиенте во вкладке «Все серверы».

Добавить свой сервер

По умолчанию сервер никуда о себе не сообщает. Чтобы он появился в списке, добавьте в config.json и перезапустите сервер:

"listed": true,
"publicAddress": "voice.example.com"
  • publicAddress - адрес, по которому к серверу подключаются: домен или IP, с :порт, если он не 7700. Без него берётся внешний IP, с которого сервер сообщает о себе.
  • Мастер настройки спрашивает об этом сам.

Через минуту-другую сервер появится в списке с названием, описанием, аватаркой и числом людей.

Как это работает

Раз в 5 минут сервер отправляет сайту только «я здесь» и свой адрес. Сайту этого мало: он сам заходит к серверу по этому адресу и берёт название, описание, число людей, версию и аватарку из ответа сервера. Поэтому:

  • подделать или добавить чужой сервер нельзя - в ответе сервера должно быть его согласие ("listed": true);
  • сайт показывает отпечаток сертификата, который увидел сам, - по нему можно сверить сервер при первом подключении;
  • серверы с внутренними адресами (192.168…, 10…, localhost) в список не попадают;
  • серверы с паролем в список не попадают, даже с "listed": true: в общий список - только открытые серверы.

Убрать из списка

Поставьте "listed": false и перезапустите сервер - он пропадёт при следующей проверке. Сервер, который 15 минут не отвечает, тоже скрывается, а через 30 дней тишины забывается совсем.

Для разработчиков

Список доступен как JSON: /api/servers - название, описание, адрес с портом, число людей, версия, отпечаток и аватарка каждого сервера.