avoice

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

Личность и ID

В AVOICE нет аккаунтов и паролей. Вместо них у каждого есть личность - пара ключей, которая создаётся на вашем компьютере при первом запуске. По ней серверы узнают, что это именно вы.

Что такое ID

ID (UID) - это отпечаток публичного ключа вашей личности: 32 символа из цифр и букв a–f, например

1460bac4f4a6c0c6dcd80cbfeca27f66
  • ID один для всех серверов: с какой личностью вы зашли, такой ID и видят.
  • Подделать чужой ID нельзя. Подключаясь, клиент подписывает случайный вызов сервера своим закрытым ключом, и сервер проверяет подпись.
  • По ID на сервере закрепляются ники, роли, блокировки и личные сообщения.

Где посмотреть свой ID

Любой из способов:

  1. Настройки → Профиль (или кнопка с вашей аватаркой справа на верхней панели) → поле «ID этой личности (UID)» и кнопка «Скопировать ID».
  2. На сервере: правый клик по себе в списке людей → «Скопировать ID пользователя».

Так же копируется ID другого человека - правым кликом по нему.

Как стать владельцем своего сервера

Владелец сервера - это просто ID, записанный в поле ownerId в config.json сервера. Есть три способа его туда вписать.

Проще всего - пароль владельца. При первом запуске сервер печатает пароль владельца (он же лежит в config.json в поле ownerPassword). В клиенте в окне «Серверы» нажмите «Вход владельца», введите пароль и подключитесь. Если владельца у сервера ещё нет, сервер сам запишет ваш ID в ownerId. Больше ничего делать не нужно.

В мастере настройки. При первом запуске сервер задаёт вопросы. На вопрос «Владелец сервера» выберите «Я знаю свой ID из клиента» и вставьте ID, скопированный в «Настройки → Профиль».

Командой на машине сервера:

./avoice-server-linux-amd64 set-owner 1460bac4f4a6c0c6dcd80cbfeca27f66

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

Входить под владельцем нужно той же личностью, чей ID записан. Другая личность - это для сервера другой человек.

Сохраните ключ в файл

Ключ хранится только на этом компьютере. Если переустановить Windows или удалить профиль AVOICE без копии, вы станете для всех серверов новым человеком: без закреплённых ников, ролей и прав владельца, без истории личных сообщений.

Настройки → Профиль → «Сохранить ключ в файл». Храните этот файл как пароль: с ним можно войти под вашими никами и читать ваши личные сообщения. Чтобы перенести личность на другой компьютер - «Загрузить из файла» там.

Несколько личностей

Как в TeamSpeak, личностей может быть сколько угодно: «Основная», «Работа», «Тест». Для серверов каждая - отдельный человек со своим ID, ником и аватаркой.

  • Создать, загрузить из файла, удалить - Настройки → Профиль → Личности.
  • Выбрать, с какой зайти, - в окне «Серверы», поле «Личность».
  • Сервер в избранном запоминает, с какой личностью вы на него заходили, и в следующий раз подставит её сам.

Закрепить ник

Правый клик по себе → «Закрепить этот ник за мной». После этого никто с другим ключом не сможет зайти на этот сервер под вашим именем, а вы всегда будете входить под ним.

Аватарка

Настройки → Профиль → «Аватарка». Картинка уменьшается до 256×256, хранится вместе с ключом личности и сама загружается на каждый сервер, куда вы заходите.