docs: add Zerotire VPN article (#295)

* docs: Added article about configuring zerotire VPN

* docs: Add paragraph about macos VPN connection

* docs: Fix md exeptions

* dosc: Fix orthography

* docs: Add eng version, some fix

* docs: Fix

* docs: Small fix

* docs: Add paragraph about QGC connection

* docs: Add images and fix md

* Update docs/en/zerotire_vpn.md

* Update docs/ru/zerotire_vpn.md

Co-authored-by: Oleg Kalachev <okalachev@gmail.com>
This commit is contained in:
Alamoris
2020-12-28 21:22:38 +03:00
committed by GitHub
parent fe71007ebd
commit bb3e4befe5
30 changed files with 370 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 84 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 57 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.4 KiB

View File

@@ -62,6 +62,7 @@
* [Model files for parts](models.md)
* [ROS Melodic installation](ros-install.md)
* [Camera calibration](camera_calibration.md)
* [VPN ZeroTire Connection](zerotire_vpn.md)
* [Quadcopter control with 4G communication](4g.md)
* [Clover and Jetson Nano](jetson_nano.md)
* [Remote control app](rc.md)

183
docs/en/zerotire_vpn.md Normal file
View File

@@ -0,0 +1,183 @@
# Creating a virtual network ZeroTire One and connecting to it
## Creating and configuring a ZeroTire network
1. Go to [ZeroTire](https://www.zerotier.com/) website.
<img src="../assets/zerotire/login_1.png" width=300 class="zoom border center">
2. Sign up on ZeroTire.
<img src="../assets/zerotire/login_2.png" width=300 class="zoom border center">
3. Go to your account.
4. Click on the *Create A Network*.
<img src="../assets/zerotire/network_1.png" width=300 class="zoom border center">
5. After that, you will see the network you created, its ID and name. Click on the network to configure it.
<img src="../assets/zerotire/network_2.png" width=300 class="zoom border center">
6. In the window that appears you can change the network name and connection privacy.
<img src="../assets/zerotire/network_3.png" width=300 class="zoom border center">
7. Scroll down to the *Members* column. It will say that there are no users on the network.
<img src="../assets/zerotire/network_4.png" width=300 class="zoom border center">
8. Devices connected to the network will be displayed in this column. To allow them to connect to the network, activate the *Auth?* checkbox. The connected device will automatically be given an internal IP address, which will then be used to communicate with this device.
<div class="image-group">
<img src="../assets/zerotire/network_5.png" width=300 class="zoom border">
<img src="../assets/zerotire/network_6.png" width=300 class="zoom border">
</div>
> **Hint** specify names for new devices, it will help you distinguish them from each other in the future.
9. Repeat the last step for all the devices that you want to connect.
> **Info** ZeroTire network supports up to 50 users simultaneously for free use.
## Setup on Windows
### Installing the app
1. Go to the ZeroTire website.
<img src="../assets/zerotire/download_1.png" width=300 class="zoom border center">
2. Click on the Windows icon.
<img src="../assets/zerotire/download_2.png" width=300 class="zoom border center">
3. Download and run the `Zero Tare One.msi` file.
<div class="image-group">
<img src="../assets/zerotire/windows_1.png" width=300 class="zoom border">
<img src="../assets/zerotire/windows_2.png" width=300 class="zoom border">
</div>
### Network connection
1. Run ZeroTire One.
2. Click on the ZeroTire One icon in the taskbar.
3. Click on the *Join Network...* to connect to the network.
<img src="../assets/zerotire/windows_3.png" width=300 class="zoom border center">
4. In the window that appears, enter your network ID and click *Join*.
<img src="../assets/zerotire/windows_4.png" width=300 class="zoom border center">
5. Allow using the new network.
## Setup on iOS
### Installing the app
1. Go to the ZeroTire website.
<img src="../assets/zerotire/download_1.png" width=300 class="zoom border center">
2. Click on the iOS icon.
<img src="../assets/zerotire/download_2.png" width=300 class="zoom border center">
3. Install the *ZeroTire One* app.
### Network connection
1. Run ZeroTire One app.
2. Click on *+* to add a new connection.
<img src="../assets/zerotire/ios_1.png" width=300 class="zoom border center">
3. Confirm the privacy policy.
<img src="../assets/zerotire/ios_2.png" width=300 class="zoom border center">
4. Enter your network ID and click *Add Network*.
<img src="../assets/zerotire/ios_3.png" width=300 class="zoom border center">
5. Confirm adding the new VPN configuration.
6. Connect to the VPN network by sliding the network activation slider.
<div class="image-group">
<img src="../assets/zerotire/ios_4.png" width=300 class="zoom border">
<img src="../assets/zerotire/ios_5.png" width=300 class="zoom border">
</div>
## Setup on Linux (PC, Raspberry Pi)
### Installing the app
1. Open the console by pressing the keyboard shortcut *ctrl + alt + t* or type *terminal* in the program search bar.
2. Enter the Zero Tare installation command.
```bash
curl -s  https://install.zerotier.com  | sudo bash
```
### Network connection
1. Open the console.
2. Enter the command `sudo zerotire-cli join network-id`, where `network-id` is your network ID.
<img src="../assets/zerotire/linux_1.png" width=300 class="zoom border center">
3. If the connection is successful, the corresponding message will be displayed in the console.
## Installing and configuring on macOS
### Installing the app
1. Go to the ZeroTire website.
<img src="../assets/zerotire/download_1.png" width=300 class="zoom border center">
2. Click on the macOS icon.
<img src="../assets/zerotire/download_2.png" width=300 class="zoom border center">
3. Download and run `ZeroTire One.pkg` file.
4. Install the ZeroTire One app.
### Network connection
1. Run ZeroTire One app.
2. Click on the ZeroTire One icon in the taskbar .
3. In the window that appears, click on *Join Network...*.
<img src="../assets/zerotire/macos_1.png" width=300 class="zoom border center">
4. In the *Enter Network ID* field, enter your network ID.
<img src="../assets/zerotire/macos_2.png" width=300 class="zoom border center">
## Connecting to the copter
1. Make sure that ZeroTire is working and connected to the network on the drone and control device. To do this, make sure that these have an *Online* status.
<img src="../assets/zerotire/qgc_1.png" width=300 class="zoom border center">
2. Make sure that all devices have local IP addresses - *Managed IPs*.
3. Open GQC and in the *Comm Links* tab add a TCP connection specifying the IP of the drone. Read more about remote connection [here](gcs_bridge.md).
<div class="image-group">
<img src="../assets/zerotire/qgc_2.png" width=300 class="zoom border">
<img src="../assets/zerotire/qgc_3.png" width=300 class="zoom border">
</div>

View File

@@ -63,6 +63,7 @@
* [Docker-контейнер с симулятором](sitl_docker.md)
* [Установка ROS Melodic](ros-install.md)
* [Калибровка камеры](camera_calibration.md)
* [Подключение к VPN ZeroTire](zerotire_vpn.md)
* [Подключение к VPN Hamachi](hamachi_vpn.md)
* [Управление мультикоптером при помощи 4G связи](4g.md)
* [Пакеты Клевера на Jetson Nano](jetson_nano.md)

185
docs/ru/zerotire_vpn.md Normal file
View File

@@ -0,0 +1,185 @@
# Создание виртуальной сети ZeroTire и подключение к ней
## Создание и настройка сети ZeroTire
1. Зайдите на сайт [ZeroTire](https://www.zerotier.com/).
<img src="../assets/zerotire/login_1.png" width=300 class="zoom border center">
2. Зарегистрируйтесь в ZeroTire.
<img src="../assets/zerotire/login_2.png" width=300 class="zoom border center">
3. Зайдите в свой аккаунт.
4. Нажмите кнопку *Create A Network*.
<img src="../assets/zerotire/network_1.png" width=300 class="zoom border center">
5. После этого вы увидите созданную вами сеть, ее ID и название. Для настройки сети нажмите на нее.
<img src="../assets/zerotire/network_2.png" width=300 class="zoom border center">
6. В открывшемся окне можно изменить имя сети и приватность подключения.
<img src="../assets/zerotire/network_3.png" width=300 class="zoom border center">
7. Пролистайте ниже, до графы *Members*. В ней будет написано о том, что в сети нету пользователей.
<img src="../assets/zerotire/network_4.png" width=300 class="zoom border center">
8. Устройства подключенные к сети будут отображаться в данной графе, для того, чтобы позволить им подключиться к сети, активируйте чекбокс *Auth?*. При этом, подключенному устройству автоматически выдастся внутренний IP адрес, в дальнейшем он будет использоваться для связи с данным устройством.
<div class="image-group">
<img src="../assets/zerotire/network_5.png" width=300 class="zoom border">
<img src="../assets/zerotire/network_6.png" width=300 class="zoom border">
</div>
> **Hint** Указывайте имена для новых устройств, этом поможет вам в дальнейшем отличать их друг от друга.
9. Повторите последний шаг для всех подключаемых устройств.
> **Info** Сеть ZeroTire в случае бесплатного использования поддерживает до 50 пользователей одновременно.
## Настройка на Windows
### Установка приложения
1. Перейдите на сайт ZeroTire.
<img src="../assets/zerotire/download_1.png" width=300 class="zoom border center">
2. Нажмите на иконку Windows.
<img src="../assets/zerotire/download_2.png" width=300 class="zoom border center">
3. Скачайте и запустите файл `ZeroTire One.msi`.
<div class="image-group">
<img src="../assets/zerotire/windows_1.png" width=300 class="zoom border">
<img src="../assets/zerotire/windows_2.png" width=300 class="zoom border">
</div>
### Подключение к сети
1. Запустите ZeroTire One.
2. Нажмите на иконку ZeroTire One в панели задач.
3. Нажмите на кнопку *Join Network...* для подключения к сети.
<img src="../assets/zerotire/windows_3.png" width=300 class="zoom border center">
4. В появившемся окне введите ID вашей сети и нажмите кнопку *Join*.
<img src="../assets/zerotire/windows_4.png" width=300 class="zoom border center">
5. Разрешите использование новой сети.
<img src="../assets/zerotire/windows_5.png" width=300 class="zoom border center">
## Настройка на iOS
### Установка приложения
1. Перейдите на сайт ZeroTire.
<img src="../assets/zerotire/download_1.png" width=300 class="zoom border center">
2. Нажмите на иконку iOS.
<img src="../assets/zerotire/download_2.png" width=300 class="zoom border center">
3. Установите приложение *ZeroTire One*.
### Подключение к сети
1. Запустите приложение *ZeroTire One*.
2. Нажмите на *+* для добавления нового подключения.
<img src="../assets/zerotire/ios_1.png" width=300 class="zoom border center">
3. Подтвердите политику конфиденциальности.
<img src="../assets/zerotire/ios_2.png" width=300 class="zoom border center">
4. Введите ID вашей сети и нажмите кнопку *Add Network*.
<img src="../assets/zerotire/ios_3.png" width=300 class="zoom border center">
5. Подтвердите добавление новой конфигурации VPN.
6. Подключитесь к VPN сети, сдвинув ползунок активации сети.
<div class="image-group">
<img src="../assets/zerotire/ios_4.png" width=300 class="zoom border">
<img src="../assets/zerotire/ios_5.png" width=300 class="zoom border">
</div>
## Настройка на Linux (PC, Raspberry Pi)
### Установка приложения
1. Откройте консоль, для этого нажмите сочетание клавиш *Ctrl* + *Alt* + *T* или в строке поиска программ введите *Terminal*
2. Введите команду установки ZeroTire.
```bash
curl -s https://install.zerotier.com | sudo bash
```
### Подключение к сети
1. Откройте консоль.
2. Введите команду `sudo zerotire-cli join network-id`, где `netwirk-id` это ID вашей сети.
<img src="../assets/zerotire/linux_1.png" width=300 class="zoom border center">
3. При успешном подключении, в консоль будет выведено соответствующее сообщение.
## Установка и настройка на macOS
### Установка приложения
1. Перейдите на сайт ZeroTire.
<img src="../assets/zerotire/download_1.png" width=300 class="zoom border center">
2. Нажмите на иконку macOS.
<img src="../assets/zerotire/download_2.png" width=300 class="zoom border center">
3. Скачайте и запустите файл `ZeroTire One.pkg`.
4. Установите приложение ZeroTire One.
### Подключение к сети
1. Запустите приложение ZeroTire One.
2. В панеле задач нажмите на иконку ZeroTire One.
3. В открывшемся окне нажмите *Join Network...*.
<img src="../assets/zerotire/macos_1.png" width=300 class="zoom border center">
4. В поле *Enter Network ID* введите ID вашей сети.
<img src="../assets/zerotire/macos_2.png" width=300 class="zoom border center">
## Подключение к коптеру
1. Убедитесь, что ZeroTire работает и имеет соединение с сетью на дроне и управляющем устройстве. Для этого убедитесь, что интересующие вас устройства имеют статус *Online*.
<img src="../assets/zerotire/qgc_1.png" width=300 class="zoom border center">
2. Убедитесь, что у всех устройств есть локальные IP адреса - *Managed IPs*.
3. Откройте GQC и во вкладке *Comm Links* добавьте TCP подключение, указав IP дрона. Подробнее про удаленное подключение читайте [тут](gcs_bridge.md).
<div class="image-group">
<img src="../assets/zerotire/qgc_2.png" width=300 class="zoom border">
<img src="../assets/zerotire/qgc_3.png" width=300 class="zoom border">
</div>