netais/README.ru-RU.md

Exchange AIS-like messages via the Internet to watch position members of your private group. SignalK implementation.

[In English](README.md)
# netAIS плагин для Signal K [![License: CC BY-NC-SA 4.0](screenshots/Cc-by-nc-sa_icon.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.en)

## версия 1.
Обмен AIS-подобными сообщениями с координатами и сопутствующей информацией через Интрнет между участниками выделенной частной группы. Для взаимодействия не требуется интернет-сервер с реальным адресом.

Удобно для организации коллективного плавания, соревнований, рыбалки.

![scheme_netAIS](screenshots/art.png)   

Плагин использует [TOR](https://ru.wikipedia.org/wiki/Tor) как среду коммуникации, и функционирует и через мобильный интернет и через публичные точки доступа wi-fi без дополнительных настроек.  

## Возможности
* Создание одной выделенной группы
* Участие в любом количестве выделенных групп
* Рассылается в группу: положение, стандартная информация о состоянии (в движении, на якоре, и т.п.), произвольная информация о состоянии, цель следования и время прибытия, аварийная ситуация и ситуация "человек за бортом". Разумеется, обычные средства отображения AIS не смогут отобразить нестандартную информацию, но [GaladrielMap](http://galadrielmap.hs-yachten.at/) показывает всё.

## Технические детали
Плагин содержит клиентскую часть -- собственно для обмена сообщениями, и серверную часть, обеспечивающую эту возможность. Один сервер обслуживает одну выделенную группу и обычно является скрытым сервисом TOR.  Если вы хотите организовать собственную группу, .onion адрес этого сервиса надо передать потенциальным членам группы каким-нибудь сторонним способом -- в sms, электронной или голубиной почтой. Каждый член вашей группы указывает этот адрес в своём клиенте, и клиент получает возможность обмениваться информацией с сервером через сеть TOR. В адресах обычного интернета нет необходимости.

## Демо
Общедоступная группа netAIS для тестовых целей:  
**2q6q4phwaduy4mly2mrujxlhpjg7el7z2b4u6s7spghylcd6bv3eqvyd.onion**  Этот адрес является умолчальным в настройках плагина.  
![экран настройки выделенных групп](screenshots/s2.png)   
~~Все активные участники группы видны в демонстрационной версии](http://130.61.159.53/map/) [GaladrielMap](https://hub.mos.ru/v.kalachihin/GaladrielMap)~~.  
К сожалению, Oracle Inc оказались жуликами, поэтому демо не работает.
![использование](screenshots/s1.jpg)   

## Совместимость
Сервер Signal K 

## Установка и конфигурирование:
У вас должна быть установлена [служба TOR](https://community.torproject.org/onion-services/setup/install/).  
Установите плагин с именем **netais** обычным образом из Signal K Appstore.   
![appstore_screenshot](screenshots/s4.png)   
Перезапустите Signal K.  
В меню Server -> Plugin Config настройте плагин.   
Не забывайте нажимать Submit для сохранения настроек.

### Скрытый сервис TOR

Если TOR находится на той же машине, что и SignalK, [настройте скрытый сервис TOR](https://community.torproject.org/onion-services/setup/) на 
адрес localhost:3100. Для этого добавьте строки  

```
HiddenServiceDir /var/lib/tor/hidden_service_netAIS/   
HiddenServicePort 80 localhost:3100  
```

в раздел location-hidden services" файла `/etc/tor/torrc`.  
Перезапустите TOR и посмотрите адрес скрытого сервиса в файле /var/lib/tor/hidden_service_netAIS/hostname, например, путём   
```
sudo cat /var/lib/tor/hidden_service_netAIS/hostname  
```

![screenshot](screenshots/s3.png)   

Если TOR находится на другой машине -- укажите вместо `localhost` адрес машины с SignalK.

Не нужно настраивать скрытый сервис TOR, если вы не собираетесь держать свою группу netAIS, а хотите быть только членом других групп. Но сам TOR, конечно, должен быть.

## Использование
Любой картплотер Signal K будет показывать цели netAIS обычным образом.
 
## Поддержка
[Форум](https://github.com/VladimirKalachikhin/Galadriel-map/discussions)

Форум будет живее, если вы сделаете пожертвование [через PayPal](https://paypal.me/VladimirKalachikhin) по адресу [galadrielmap@gmail.com](mailto:galadrielmap@gmail.com) или на [ЮМани](https://yasobe.ru/na/galadrielmap).

Вы можете получить [индивидуальную платную консультацию](https://kwork.ru/training-consulting/20093293/konsultatsii-po-ustanovke-i-ispolzovaniyu-galadrielmap) по вопросам установки и использования netAIS.