Skip to content

Использование

Установка

Существуют разные варианты установки компонентов на сервер, впс и т.д.

1. Автоматическая установка

shell
curl -sSLH "X-Key: _placeholder_key_" https://oxmix.net/api/nodes/connect | sudo sh -
shell
wget -qO- --header="X-Key: _placeholder_key_" https://oxmix.net/api/nodes/connect | sh
  • Команда загружает shell скрипт и запускает через оболочку sh
  • Скрипт проверит установлен ли Docker Engine, если отсутствует, тогда установит последнию версию
  • Скрипт проверит установлены ли компоненты Netip и доустановит необходимые или обновит

Замените ключ

Не забудьте заменить заглушку _placeholder_key_ на ваш ключ

Исходный код shell скрипта

Проверьте исходный код cкрипта https://oxmix.net/api/nodes/connect

shell

2. С помощью cloud-init

Runcmd

Это секция в CloudInit, которая принимает список команд и выполняет их последовательно после завершения других процессов инициализации системы

Замените ключ

Не забудьте заменить заглушку no-set-key на ваш ключ

yaml
Логи выполнения сценариев

Установка компонентов

shell
tail -f /var/log/cloud-init-netip.log

Общий лог cloud-init

shell
tail -f /var/log/cloud-init-output.log

3. Ручная установка

Выполните скрипт вручную в терминале

Требуется уже установленый Docker Engine >= 20.0

Замените ключ

Не забудьте заменить заглушку no-set-key на ваш ключ

Показать однострочный скрипт
shell

Отключение компонентов

Чтобы исключить компонент из установки, например device, достаточно добавить заголовок X-Off: device или несколько X-Off: network,device в URL curl -H "X-Off: device" https://oxmix.net/api/nodes/connect

core - компонент является обязательным

Чтобы исключить из других вариантов установок (2, 3), требуется вручную удалить запуски из скриптов

Настройка компонентов

Определенные компоненты можно дополнительно настроить.

netip.network компонент

По умолчанию после установки добавляется в группу Default, это можно изменить:

  • с помощью инсталлятор

Добавить заголовок в curl: -H "X-Fwg: Default,My custom group"

  • вручную

Можно дополнительно добавить еще в одну группу при первой установке компонента: -e FIREWALL_GROUPS='Default, My custom group'

Важно

Если ранее уже производилась установка на ноду компонента netip-network, то добавление в группы Default My custom group автоматический не произойдет, требуется добавить вручную

Не использовать firewall

Чтобы не добавлять ноду в какие-либо группы и фактически отключить файрвол на этапе установки, можно передать инсталлятору заголовок с пустым значением: -H "X-Fwg: "

Обновление компонентов

Аналогично команде установки, произведет обновление при запуске через терминал

shell
curl -sSLH "X-Key: _placeholder_key_" https://oxmix.net/api/nodes/connect | sudo sh -
shell
wget -qO- --header="X-Key: _placeholder_key_" https://oxmix.net/api/nodes/connect | sh

Удаление компонентов

Будут остановлены и удалены все компоненты

shell
curl -sSL https://oxmix.net/api/nodes/connect?purge | sudo sh -
shell
wget -qO- https://oxmix.net/api/nodes/connect?purge | sh