Как работает скрипт
Скрипт использует учётные данные для доступа к веб-интерфейсу телефонов и отправляет команду на перезагрузку через HTTP. Для перезагрузки всех телефонов скрипт парсит файл dhcpd.leases, находит все IP-адреса, которые были арендованы, и пытается перезагрузить каждый из них.

Для чего нужен скрипт
Скрипт может быть полезен в ситуациях, когда необходимо массово перезагрузить IP-телефоны, например, после обновления настроек сети или для устранения неполадок. Это позволяет сэкономить время и упростить процесс перезагрузки большого количества устройств.

Важно!
Предварительно через файл provisioning необходимо передать параметры:

features.action_uri.enable = 1
features.show_action_uri_option = 0
features.action_uri_limit_ip = 192.168.0.*

Данные настройки предназначены для активации и управления функцией удалённого управления IP-телефоном Yealink, включая возможность его перезагрузки по сети.

GitHub Gist: DHCP_Phone_Reloader.sh

https://gist.github.com/telnex/910fbbcbed0e25eca15bafed6f44212c

1. Анализ RTP-потока:

rtpdump -i eth0 -F ascii > output.txt  # захват пакетов в ASCII формате
rtpdump -F hex -n -t <timestamp> -u <ip> < input.pcap > output.txt  # анализ записанного потока

2. Проверка статистики:

rtpdump -r input.pcap -s 0 -t <timestamp> -T s  # статистика потока

Основные параметры для проверки:

• Счетчики пакетов
• Тайминг и задержки
• Нагрузка на сеть
• Качество передачи данных

3. Воспроизведение записанного потока для тестирования:

rtpplay input.rtp  # простое воспроизведение
rtpplay -s 10 input.rtp  # с смещением на 10 секунд
rtpplay -T 50 input.rtp  # с ограничением скорости 50%

4. Отправка тестовых пакетов:

rtpsend -a <ip> -p <port> -F <format> -f <file>  # базовая отправка
rtpsend -a <ip> -p <port> -F <format> -f <file> -t <rtcp>  # с RTCP

Рекомендации по тестированию:

1. Записать небольшой участок RTP-потока
2. Проанализировать базовые параметры
3. Воспроизвести записанный поток
4. Проверить качество воспроизведения
5. При необходимости отправить тестовый поток

При анализе следует обращать внимание на:

• Стабильность потока
• Наличие потерь пакетов
• Задержки и вариацию задержки
• Качество передаваемых данных

1. Запросы SIP

Запросы (или методы) используются для выполнения различных действий, таких как начало, изменение или завершение сеансов.

Основные методы SIP:

1. INVITE - Инициализация сеанса. Используется для начала вызова или установления соединения.
   Пример: приглашение абонента на голосовой или видеозвонок.
2. ACK - Подтверждение успешного получения ответа на INVITE.
   Пример: завершение трехсторонней handshake-процедуры для установки соединения.
3. BYE - Завершение сеанса. Используется для окончания вызова.
   Пример: завершение звонка.
4. CANCEL - Отмена незавершенного запроса INVITE. Используется для прекращения вызова до его принятия.
   Пример: отмена вызова до того, как он был принят абонентом.
5. OPTIONS - Запрос информации о возможностях конечного устройства или сервера (например, поддерживаемые кодеки).
   Пример: определение возможностей устройства перед вызовом.
6. REGISTER - Регистрация устройства пользователя на SIP-сервере.
   Пример: устройство сообщает серверу о своем IP-адресе и порте для приема вызовов.
7. INFO - Передача дополнительной информации во время активного сеанса, не изменяя его состояние.
   Пример: передача DTMF-тонов или сигналов.
8. PRACK (Provisional Acknowledgment) - Подтверждение временного (1xx) ответа. Это опциональный метод.
   Пример: надежная доставка 1xx сообщений.
9. SUBSCRIBE - Запрос подписки на изменения состояния ресурса.
   Пример: подписка на уведомления о статусе пользователя (онлайн/офлайн).
10. NOTIFY - Уведомление об изменении состояния ресурса, на который подписан пользователь.
    Пример: уведомление об изменении статуса собеседника.
11. PUBLISH - Публикация информации о состоянии ресурса.
    Пример: устройство сообщает свой текущий статус (доступен/недоступен).
12. REFER - Направление получателя для выполнения действия, например, перенаправления вызова.
    Пример: переадресация звонка на другой номер.
13. MESSAGE - Отправка текстовых сообщений между участниками.
    Пример: обмен короткими текстовыми сообщениями через SIP.
14. UPDATE - Изменение параметров сеанса во время его активного состояния.
    Пример: изменение кодека во время звонка.
15. PING - Проверка доступности устройства или сервера.
    Пример: проверка активности удаленного SIP-устройства.

2. Ответы SIP

Ответы в SIP делятся на 6 классов (по коду состояния, аналогично HTTP). Каждый ответ содержит код и текстовое описание.

Классы ответов:

1. 1xx: Informational (Информационные)
   Уведомляют об обработке запроса.
• 100 Trying — запрос обрабатывается.
• 180 Ringing — вызываемое устройство звонит.
• 183 Session Progress — передача прогресса установления соединения (например, плейбэк звука ожидания).
2. 2xx: Success (Успех)
   Запрос выполнен успешно.
• 200 OK — успешное завершение запроса (например, вызов принят).
3. 3xx: Redirection (Перенаправление)
   Требуется дальнейшее действие.
• 301 Moved Permanently — конечный узел переехал на другой адрес.
• 302 Moved Temporarily — временный новый адрес.
4. 4xx: Client Error (Ошибка клиента)
   Проблема с запросом со стороны клиента.
• 400 Bad Request — некорректный запрос.
• 401 Unauthorized — требуется аутентификация.
• 403 Forbidden — доступ запрещен.
• 404 Not Found — пользователь не найден.
• 408 Request Timeout — запрос истек.
5. 5xx: Server Error (Ошибка сервера)
   Проблема на стороне сервера.
• 500 Server Internal Error — внутренняя ошибка сервера.
• 503 Service Unavailable — сервис недоступен.
6. 6xx: Global Failure (Глобальная ошибка)
   Запрос отклонен глобально.
• 600 Busy Everywhere — все устройства абонента заняты.
• 603 Decline — вызов отклонен.
• 604 Does Not Exist Anywhere — пользователь не существует.

Пример SIP-сообщения

Запрос INVITE:

INVITE sip:user@example.com SIP/2.0
Via: SIP/2.0/UDP 192.168.1.2:5060
From: "Caller" <sip:caller@domain.com>;tag=12345
To: <sip:user@example.com>
Call-ID: 1122334455@domain.com
CSeq: 1 INVITE
Contact: <sip:caller@192.168.1.2>
Content-Type: application/sdp
Content-Length: 129

v=0
o=- 1122334455 1122334455 IN IP4 192.168.1.2
s=Session SDP
c=IN IP4 192.168.1.2
t=0 0
m=audio 49170 RTP/AVP 0 101
a=rtpmap:0 PCMU/8000
a=rtpmap:101 telephone-event/8000

Ответ 200 OK:

SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.1.2:5060
From: "Caller" <sip:caller@domain.com>;tag=12345
To: <sip:user@example.com>;tag=67890
Call-ID: 1122334455@domain.com
CSeq: 1 INVITE
Contact: <sip:user@192.168.1.3>
Content-Type: application/sdp
Content-Length: 129

v=0
o=- 1122334455 1122334455 IN IP4 192.168.1.3
s=Session SDP
c=IN IP4 192.168.1.3
t=0 0
m=audio 49170 RTP/AVP 0 101
a=rtpmap:0 PCMU/8000
a=rtpmap:101 telephone-event/8000

Этот список покрывает основные типы сообщений и примеры их использования в SIP.

1. Основной синтаксис

tcpdump [опции] [выражение фильтра]

2. Основные опции

• -i <интерфейс> Указывает интерфейс для захвата (например, eth0, wlan0).
• -D Показывает список всех доступных интерфейсов.
• -n Не преобразует IP-адреса и порты в имена (ускоряет анализ).
• -nn Не преобразует IP-адреса, имена портов и протоколов.
• -c <число> Захватывает только указанное количество пакетов.
• -s <размер> Устанавливает размер захвата пакета (по умолчанию 262144).
• -w <файл> Сохраняет захваченные пакеты в файл для последующего анализа (формат pcap).
• -r <файл> Читает захваченные пакеты из файла pcap.
• -v, -vv, -vvv Увеличивает детализацию выводимой информации.
• -X Показывает содержимое пакетов в ASCII и HEX.
• -XX Показывает содержимое заголовков и данных пакета в HEX и ASCII.
• -A Показывает содержимое пакетов в ASCII (удобно для HTTP/SMTP).
• -C <размер> Делит захват на файлы размером не более указанного значения (в мегабайтах).
• -G <интервал> Делит захват на файлы с интервалом времени (в секундах).
• -z <команда> Указывает команду для выполнения после сохранения файла (например, компрессия).
• -E <ключ> Расшифровка трафика с использованием заданного ключа (например, для IPsec).
• -N Не отображает доменные имена хостов.
• -K Отключает проверку целостности.

3. Фильтрация пакетов

Фильтры позволяют захватывать только нужный трафик:

• Хосты host 192.168.1.1 - Захват трафика для определенного хоста.
• Источник src 192.168.1.1 - Трафик, исходящий от хоста.
• Назначение dst 192.168.1.1 - Трафик, направленный на хост.
• Сеть net 192.168.1.0/24 - Трафик для указанной сети.
• Порты port 80 или portrange 20-80 - Захват трафика для порта или диапазона.
• Протоколы tcp, udp, icmp, arp, ip, ipv6, и др. - Фильтрация по протоколу.
• Сложные условия src 192.168.1.1 and dst port 80 - Комбинация условий с and, or, not.

4. Примеры команд

Захват всего трафика на интерфейсе eth0:

tcpdump -i eth0

Фильтр HTTP-трафика:

tcpdump -i eth0 port 80

Захват и запись в файл:

tcpdump -i eth0 -w capture.pcap

Чтение файла pcap:

tcpdump -r capture.pcap

Захват ICMP-пакетов:

tcpdump -i eth0 icmp

Фильтрация трафика из подсети:

tcpdump net 192.168.1.0/24

Вывод в деталях (TCP/UDP):

tcpdump -vv tcp

Показ содержимого пакетов:

tcpdump -X port 80

1. Копирование QCOW2-образа:

Сначала вам нужно скопировать файл .qcow2 на целевой сервер. Это можно сделать с помощью SCP, rsync или любого другого метода передачи файлов. Например:

scp путь/к/образу.qcow2 пользователь@целевой_сервер:путь/к/папке/     

2. Установка необходимых компонентов:

Убедитесь, что на целевом сервере установлены QEMU и KVM (если вы планируете использовать виртуализацию). Это можно сделать с помощью пакетного менеджера. Например, для Ubuntu:

sudo apt update
sudo apt install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils    

3. Создание виртуальной машины:

После того как QCOW2-образ будет скопирован, вы можете создать виртуальную машину, указав этот образ в качестве диска. Это можно сделать через командную строку или с помощью графических интерфейсов, таких как virt-manager.

Пример команды для создания виртуальной машины с использованием virt-install:

virt-install 
     --name имя_виртуальной_машины 
     --ram 2048 
     --disk path=путь/к/образу.qcow2,format=qcow2 
     --vcpus 2 
     --os-type linux 
     --os-variant ubuntu20.04 
     --network network=default 
     --graphics none 
     --console pty,target_type=serial 
     --location 'http://archive.ubuntu.com/ubuntu/dists/focal/main/installer-amd64/' 
     --extra-args 'console=ttyS0,115200n8 serial'
   

4. Запуск виртуальной машины:

После создания виртуальной машины вы можете запустить её с помощью команды virsh:

virsh start имя_виртуальной_машины

Дополнительные советы

• Настройка сети: Убедитесь, что ваша виртуальная машина настроена на использование сети, чтобы иметь доступ к интернету или другим ресурсам.
• Проверка совместимости: Убедитесь, что версия QEMU/KVM на новом сервере совместима с версией, на которой был создан QCOW2-образ.
• Снимки и резервные копии: Если у вас есть снимки виртуальной машины, убедитесь, что они также перенесены и доступны на новом сервере.
• Следуя этим шагам, вы сможете успешно развернуть QCOW2-образ на другом сервере. Если у вас есть дополнительные вопросы или требуется помощь с конкретными шагами, дайте знать!

Шаги по созданию образа работающей ОС

1. Убедитесь, что у вас установлены необходимые пакеты и службы KVM работают:

sudo yum install qemu-kvm libvirt virt-install
sudo service libvirtd start
sudo chkconfig libvirtd on

2. Запустите вашу виртуальную машину, если она уже запущена, вы можете перейти к следующему шагу. Если нет, запустите её с помощью virsh или virt-manager.

3. Создайте образ диска. Используйте команду qemu-img для создания образа диска. Например, чтобы создать образ в формате QCOW2 (рекомендуемый формат), выполните:

qemu-img create -f qcow2 /var/lib/libvirt/images/my_image.qcow2 20G   

Это создаст новый образ размером 20 ГБ.

4. Если вы хотите сделать снимок текущего состояния вашей работающей ОС, вы можете использовать virt-clone, чтобы создать клон виртуальной машины, или воспользоваться функцией создания снимков (snapshot) в libvirt.

Для создания снимка с использованием virsh, выполните:

virsh snapshot-create-as --domain <имя_вашей_ВМ> --name <имя_снимка> --description "Описание снимка"  

5. Чтобы создать образ работающей ОС, используйте команду dd для копирования данных с диска вашей виртуальной машины. Например, если ваша виртуальная машина называется myvm, выполните:

dd if=/dev/vda of=/var/lib/libvirt/images/my_vm_backup.img bs=4M  

Замените /dev/vda на соответствующий диск вашей виртуальной машины.

6. Если вы хотите конвертировать созданный образ в другой формат, используйте qemu-img:

qemu-img convert -f raw -O qcow2 /var/lib/libvirt/images/my_vm_backup.img /var/lib/libvirt/images/my_vm_backup_converted.qcow2   

7. После завершения процесса проверьте созданный образ:

qemu-img info /var/lib/libvirt/images/my_vm_backup.qcow2   

Теперь у вас есть образ работающей ОС, созданный с помощью QEMU в CentOS 6 KVM. Вы можете использовать этот образ для восстановления или создания новых виртуальных машин.

Структура проекта

/WebApp
├── flask/
│   ├── __init__.py
│   ├── app.py
│   ├── templates/
│   ├── routes/
│   │    └── hello.py
│   └── static/
│       
└── tests/
    ├── conftest.py
    └── test_hello.py

Tests

conftest.py

import sys
import os

#SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
#sys.path.append(os.path.dirname(SCRIPT_DIR))

import pytest
from flask import create_app

@pytest.fixture()
def app():
    app = create_app()
    app.config.update({
        "TESTING": True,
    })
    # other setup can go here
    yield app
    # clean up / reset resources here

@pytest.fixture()
def client(app):
    return app.test_client()

@pytest.fixture()
def runner(app):
    return app.test_cli_runner()

test_hello.py

def test_hello(client):
    response = client.get('/')
    assert response.status_code == 200, f'Код ответа сервера: {response.status_code}'

Flask

Использовать шаблон построения "application factory" (Blueprint).

__init__.py

В корневом каталоге Flask.

from flask import Flask

def create_app():
    app = Flask(__name__)

    from WebApp.routes.hello import mainPage
    app.register_blueprint(mainPage)

    return app

app.py

from flask import Flask
from route.hello import mainPage

app = Flask(__name__)
app.register_blueprint(mainPage)
if __name__ == "__main__":
    app.run()

/routes/hello.py

from flask import Blueprint

mainPage = Blueprint('mainPages', __name__)

@mainPage.route('/')
def hello():
    return "Hello, World!"

Pytest

Запуск из каталога WebApp командой pytest

Такая схема используется для того, чтобы в Grafana выставить уведомление на различные события, например, низкий заряд батареи или когда маяк начал движение.

Сервер на Python

Запускать через Supervisor.

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

GitHub Gist: Socket-сервер на Python и Influx

https://gist.github.com/telnex/8aa003055062b4c5f142321fe6da31d6

Клиент

В нашем случае клиент нужен только для отладки, т.к. на практике в роли клиента будет наш SinoTrack маяк.

import socket

HOST = 'localhost'
PORT = 30200        
with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
    s.connect((HOST, PORT))
    s.sendall(b'*HQ,7028702252,V1,182350,A,4740.7697,N,04950.0711,E,0.00,0,250324,fbfffbff,250,02,3039,23394,55#')
    data = s.recv(1024)
print('Received', repr(data))

Настройка маяка через СМС

Стандартные команды для настройки SinoTrack.

Команда: 804paswd IP PORT. 
Пример: 8040000 45.112.204.217 8090 
Ответ: SET OK

Настройка базы данных Influx

не актуально

На данном этапе InfluxDB версии 1.х уже должна быть установлена.

CREATE DATABASE GPS
USE DATABASE GPS
SHOW RETENTION POLICIES
CREATE RETENTION POLICY "Month" ON "GPS" DURATION 720h REPLICATION 1;
ALTER RETENTION POLICY "Month" ON "GPS" DEFAULT

Уведомление о начале движения

Плагин: Time series

Evaluate every 1m For 2m

WHEN last() OF query (A, 5m, now) IS ABOVE 1

Проблемы

Периодически возникали проблемы с недоступностью скрипта: не отвечал на запросы. Ошибок не было, порт также прослушивался. Искусственно воспроизвести ошибку не получалось. По этой причине код был переписан на Twisted. На данном фреймворке описанная проблема не наблюдалась.

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

1. docs.python.org/3/library/socketserver.html
2. https://flespi.com/protocols
3. https://help.influxcloud.net/getting_started_cli/
4. https://docs.twisted.org/en/stable/core/examples/index.html

Вся предоставленная ниже информация взята на сайте проекта и основана на установке Home Assistant для Raspberry Pi.

Подключаемся к системе, на которой у нас будет крутиться Home Assistant по SSH и обновляем систему до актуального состояния.

sudo apt-get update
sudo apt-get upgrade -y

После обновления системы устанавливаем необходимые компоненты и зависимости.

sudo apt-get install python3 python3-dev python3-venv python3-pip libffi-dev libssl-dev autoconf build-essential

Создаем нового системного пользователя с домашней папкой для запуска и работы ядра Home Assistant, назовем его homeassistant. Добавим его в группу dialout для взаимодействия с устройствами Z-Wave и ZigBee.

sudo useradd -rm homeassistant -G dialout

Далее создаем папку для ядра Home Assistant и устанавливаем пользователя homeassistant для неё владельцем.

cd /srv
sudo mkdir homeassistant
sudo chown homeassistant:homeassistant /srv/homeassistant

Теперь создаем виртуальное окружение для ядра Home Assistant, делаем это для учетной записи homeassistant.

sudo -u homeassistant -H -s
cd /srv/homeassistant
python3 -m venv .
source bin/activate

После активации виртуальной среды выполняем установку необходимого пакета Python.

python3 -m pip install wheel

По завершении установки пакета Python приступаем к установке Home Assistant.

pip3 install homeassistant

Запускаем наш Home Assistant в первый раз. При первом запуске в домашнем каталоге пользователя homeassistant (/home/homeassistant) будет создана папка .homeassistant, в которой будут находится конфигурационные файлы системы.

hass

Первый запуск может занимать 5-10 минут, после чего проверяем доступность установленной системы через браузер.

http://ha_ip_address:8123

Прерываем работу запущенной системы.

Ctrl+C

Выходим из учетной записи пользователя homeassistant.

Создаем файл для запуска сервиса при старте системы.

sudo nano /etc/systemd/system/homeassistant@homeassistant.service

Заполняем его.

[Unit]
Description=Home Assistant
After=network-online.target

[Service]
Type=simple
User=%i
WorkingDirectory=/home/%i/.homeassistant
ExecStart=/srv/homeassistant/bin/hass -c "/home/%i/.homeassistant"
RestartForceExitStatus=100

[Install]
WantedBy=multi-user.target

Запускаем сервис.

$ sudo systemctl --system daemon-reload
$ sudo systemctl enable homeassistant@homeassistant.service
$ sudo systemctl start homeassistant@homeassistant.service

Проверяем работу сервиса.

sudo systemctl status homeassistant@homeassistant.service

Через Web браузер проверяем работу Home Assistant.

http://ha_ip_address:8123

Обновление Home Assistant

Для обновления до последней версии необходимо выполнить следующие три команды.

sudo -u homeassistant -H -s
source /srv/homeassistant/bin/activate
pip3 install --upgrade homeassistant

После обновления выполняем перезапуск службы homeassistant@homeassistant.service

sudo systemctl restart homeassistant@homeassistant.service

Обратите внимание, что первый запуск после обновления может занять некоторое время.

Если надо перекинуть один файл между серверами, я использую scp:

scp -P 22777 user@10.1.4.4:/mnt/data/BackUp/onlyoffice.tar.gz /backup

Сразу привёл пример с нестандартным портом, там как тут используется заглавная -P. Я долго не мог запомнить это, используя маленькую -p, как в ssh.

Если файлов много, использую rsync:

rsync -avz -e "ssh -p 1234 -i /root/.ssh/id_rsa" user@10.1.4.22:/data/mail /data

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

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

cd /var/log
python3 -m http.server 8080

А вот простой трюк, когда надо перекинуть файл с одного сервера на другой, но при этом подключение между серверами не настроено, но я со своего ноута или jump сервера могу подключиться к обоим. Тогда можно сделать вот так:

ssh user01@10.1.4.4 'cat /home/user01/file.tar.gz' | ssh user02@10.1.5.10 'cat > /home/user02/file.tar.gz'