Начало работы | Seedex Documentation

Эта страница проводит от обычного роутера до роутера, который отправляет трафик через серверы, которыми владеете вы. Seedex работает с любым сервером WireGuard (WG), AmneziaWG (AWG) или sing-box: используйте клиентские конфиги, которые у вас уже есть, или разверните сервер с seedex-agent, и роутер будет забирать конфиги оттуда сам.

Перед началом

Вам понадобится:

Роутер на OpenWrt 24.10.2 или новее с выходом в интернет.
Сервер: любой сервер WG, AWG или sing-box с его клиентскими конфигами, либо сервер на Ubuntu 24.04 или новее с публичным IP-адресом и правами root для seedex-agent.

Минимальные требования к роутеру (предварительные): 256 МБ RAM и 100 МБ свободного места для установки пакетов.

Установите seedex-box

На роутере запустите установщик от root:

wget -O - https://feed.seedex.net/install.sh | sh

Установщик подключает фид пакетов Seedex и ставит seedex-box и luci-app-seedex для LuCI. Ничего не запускается, пока вы не примените первый конфиг. Чтобы обойтись без LuCI, запустите установщик с | sh -s -- --no-luci.

Установите seedex-agent

Если сервер есть, но на нём ещё ничего нет, seedex-agent его настроит. Если у вас уже есть клиентские конфиги, пропустите этот шаг.

На сервере запустите установщик от root:
```
wget -O - https://github.com/aggnostos/seedex-agent/releases/latest/download/install.sh | bash
```
Установщик скачивает последний релиз и ставит команду sdx, AWG, WG, sing-box и бинарник Link API. Он генерирует ключи сервера, открывает порты и включает сервисы. Пока ничего не запущено. Чтобы обновиться позже, запустите ту же команду ещё раз.
Добавьте VPN-клиентов для роутера и прокси-протокол. Например, клиента AWG, клиента WG и VLESS Reality на порту 443. В сети, где фильтруют WG, например в России, работает только клиент AWG; роутер сам выбирает самый быстрый живой туннель:
```
sdx vpn add awg router
sdx vpn add wg router
sdx proxy add vless 443
```
Запустите сервисы:
```
sdx start
```
Сервисы не работают, пока вы их не запустите. sdx start поднимает каждый протокол, у которого есть клиент или порт, поэтому выполните его после первого add; протокол, добавленный позже, запускается через sdx vpn start или sdx proxy start.
Соедините роутер:
```
sdx link add router
```
Команда печатает токен, отпечаток сертификата и одну строку для роутера. Сохраните вывод. Токен показывается один раз.

Выберите способ настройки роутера: CLI или LuCI.

CLI

Используйте свои серверы

Если сервер у вас уже есть, роутер принимает то, чем пользуются его клиенты: файл .conf WG или AWG, файл .json sing-box или ссылку вида vless://....

Скопируйте файлы конфигов на роутер или держите ссылки под рукой.
Импортируйте их:
```
sdx import awg.conf
sdx import wg.conf
sdx import sing-box.json
sdx import 'vless://...'
```
Имя файла становится именем конфига, ссылка приносит своё имя. Каталог импортирует все конфиги в нём, а текстовый файл, в котором по одной ссылке на строку, — все ссылки из него.
Примените изменения:
```
sdx apply
```
Команда сохраняет конфиги и запускает сервисы: поднимаются туннели, вместе с ними стартуют Router и DNS.

Переходите к разделу Проверьте статус. Несколько конфигов — нормально: роутер ведёт трафик через самый быстрый живой туннель и переключает его, когда туннель падает.

Подключите роутер к seedex-agent

На роутере вставьте строку, которую напечатал сервер:
```
sdx link add agent https://203.0.113.5:8282 <token> <fingerprint>
```
Команда открывает меню с конфигами, которые предлагает сервер. Перемещайтесь стрелками, отмечайте конфиги пробелом и подтвердите выбор клавишей Enter. Роутер импортирует выбранные конфиги как ожидающие изменения.
Примените изменения:
```
sdx apply
```
Команда сохраняет конфиги и запускает сервисы: поднимаются туннели, вместе с ними стартуют Router и DNS.

Дальше роутер забирает конфиги с сервера сам, а sdx link agent ... запускает sdx сервера с роутера.

Проверьте статус

Запустите sdx:

Uplink:
  [*] Internet                 118 ms
  [*] Overlay (ger1-proxy)     286 ms

[*] Router:
  Routing:      overlay
  Kill switch:  on
  Watchdog:     fastest
  Rules:
    [*] ads                block    list
    [*] tv                 direct   1 client

[*] VPN:
  Configs:
    [ ] ger1-awg-router    362 ms
    [ ] ger1-wg-router     324 ms

[*] Proxy:
  Configs:
    [*] ger1-proxy (vless) 286 ms

[*] DNS:
  Upstream:   encrypted
  Resolver:   cloudflare
  Intercept:  on
  Max TTL:    300s

Link:
  [*] agent      https://203.0.113.5:8282         2 vpn, 1 proxy, 4 min ago

Раздел Uplink показывает туннель, который несёт трафик. Работающий сервис отмечен [*].

Если что-то не работает

Если роутер не маршрутизирует трафик:

sdx logs показывает логи сервисов.
sdx restart перезапускает сервисы в правильном порядке.

LuCI

Настройка роутера выполняется в веб-интерфейсе.

Используйте свои серверы

Откройте веб-интерфейс роутера, перейдите в Services > Seedex.
Для WG или AWG откройте VPN > Add config. В поле File name укажите имя конфига, в Contents вставьте содержимое файла .conf. Нажмите Import.
Для прокси откройте Proxy > Add config. В Contents вставьте ссылку vless://... либо JSON-конфиг sing-box. Для JSON заполните File name; ссылка задаёт имя сама. Нажмите Import.
Нажмите Apply в блоке Unsaved changes на каждой вкладке, куда добавили конфиги: VPN, Proxy. Это сохранит настройки, запустит туннели. Router и DNS стартуют автоматически.

Для импорта файла откройте вкладку System в Services > Seedex. В поле Import config выберите файл .conf, .json или текстовый файл с прокси-ссылками, затем нажмите Import. После загрузки нажмите Apply на вкладке VPN или Proxy. Используйте кнопку Apply внутри Seedex: штатная Save & Apply OpenWrt эти изменения не видит.

Подключите роутер к seedex-agent

Откройте Services > Seedex > Link, нажмите Add link.
В Name укажите имя подключения, например agent. Заполните URL, Token, Fingerprint значениями из вывода sdx link add router на сервере. Нажмите Add.
В открывшемся окне отметьте нужные конфиги или Import everything the server offers. Нажмите Save.
Перейдите на вкладки VPN и Proxy, куда импортировались конфиги. На каждой нажмите Apply в блоке Unsaved changes. Туннели запустятся вместе с Router и DNS.

Дальше роутер забирает конфиги с сервера автоматически.

Проверьте статус

Откройте Services > Seedex > Status.

Раздел Uplink показывает туннель, который несёт трафик. Работающий сервис отмечен [*].

Если что-то не работает

Откройте Services > Seedex > System. В разделе Logs выберите сервис, нажмите Refresh. Перезапустить нужный сервис можно кнопкой Restart на вкладке Status.

Что дальше

seedex-box описывает правила, настройки DNS и LuCI.
seedex-agent описывает клиентов, протоколы и ротацию.