Скрипт zerotier-setup.sh устанавливает и настраивает
ZeroTier на OpenWrt одной командой: ставит пакет,
прописывает сеть в UCI, включает автозапуск, создаёт зону firewall и выполняет
join.
Сеть по умолчанию: 8d1c312afa6d0fe8. Другую сеть можно указать
параметром --network.
uclient-fetch -O /tmp/zerotier-setup.sh \
https://raw.githubusercontent.com/fackerghost/openwrt-zerotier-setup/main/zerotier-setup.sh
sh /tmp/zerotier-setup.shС доступом из ZeroTier в локальную сеть:
sh /tmp/zerotier-setup.sh --lanПосле запуска скрипт покажет ID узла. Его нужно авторизовать в ZeroTier Central, иначе узел не получит IP-адрес.
- устанавливает пакет
zerotierчерезopkgилиapk; - поддерживает оба формата конфига: OpenWrt 23.05+ (
config network) и 22.03 и старше (list join); - прописывает сеть, включает службу и генерирует/сохраняет identity узла;
- создаёт зону
fw4для интерфейсовzt+(input/output/forward, masq, MTU fix); - ждёт запуск демона, выполняет join и показывает ID узла;
- опционально разрешает трафик между ZeroTier и LAN;
- проверяет целостность зависимостей и пытается починить частичную установку
через
apk fix; - можно запускать повторно — существующие секции и правила переиспользуются.
- OpenWrt 22.03 или новее (на 21.02 шаг с firewall пропускается);
- root-доступ;
- интернет на роутере (для
opkg/apkи связи с контроллером ZeroTier); - немного свободного места во flash.
Пакеты для aarch64_cortex-a53 (OpenWrt 25.12):
| Пакет | Сжатый размер |
|---|---|
zerotier |
463 КБ |
libstdcpp6 |
628 КБ |
libminiupnpc |
22 КБ |
libnatpmp1 |
4 КБ |
libatomic1 |
8 КБ |
kmod-tun |
25 КБ |
| Итого | ≈ 1,1 МБ |
После распаковки — ориентировочно 3–4 МБ. Точные цифры на роутере:
apk info -s zerotier libstdcpp6 libminiupnpc libnatpmp1Это минимум для официального пакета: ZeroTier написан на C++, поэтому
libstdcpp6 обязателен, а libminiupnpc и libnatpmp1 — жёсткие зависимости
пакета (автоматический проброс портов). Убрать их без пересборки нельзя.
Если собираете свою прошивку, добавьте только сам пакет:
CONFIG_PACKAGE_zerotier=y
# CONFIG_ZEROTIER_ENABLE_SELFTEST is not set
CONFIG_TARGET_OPTIMIZATION="-Os"
CONFIG_USE_STRIP=y
CONFIG_STRIP_KERNEL_EXPORTS=y
luci-app-zerotier не нужен — скрипт настраивает всё через UCI. Официальный
пакет уже собирается с ZT_EMBEDDED=1 и gc-sections, поэтому заметно
уменьшить его без потери функциональности не получится.
Если важна именно минимальность, а не ZeroTier: встроенный WireGuard занимает десятки килобайт, но это другой тип VPN.
Сначала проверьте, что роутер видит интернет и DNS:
ping -c 1 1.1.1.1
ping -c 1 raw.githubusercontent.comЕсли второй ping пишет bad address — сначала исправьте DNS (раздел
«Диагностика»).
uclient-fetch -O /tmp/zerotier-setup.sh \
https://raw.githubusercontent.com/fackerghost/openwrt-zerotier-setup/main/zerotier-setup.shuclient-fetch есть в большинстве сборок OpenWrt и обычно работает там, где
wget падает с Failed to send request: Operation not permitted.
Если wget не умеет HTTPS, поставьте TLS-пакеты:
opkg update
opkg install ca-bundle libustream-mbedtlsДля сборок с OpenSSL вместо mbedTLS:
opkg install ca-bundle libustream-opensslЗатем:
wget -O /tmp/zerotier-setup.sh \
https://raw.githubusercontent.com/fackerghost/openwrt-zerotier-setup/main/zerotier-setup.shЕсли GitHub или raw.githubusercontent.com недоступен:
uclient-fetch -O /tmp/zerotier-setup.sh \
https://cdn.jsdelivr.net/gh/fackerghost/openwrt-zerotier-setup@main/zerotier-setup.shРезервное зеркало:
uclient-fetch -O /tmp/zerotier-setup.sh \
https://raw.githack.com/fackerghost/openwrt-zerotier-setup/main/zerotier-setup.shСкачайте файл и передайте на роутер:
scp zerotier-setup.sh root@192.168.1.1:/tmp/Подойдёт WinSCP или любой SFTP-клиент. Адрес роутера замените на свой.
head -n 1 /tmp/zerotier-setup.sh
wc -c /tmp/zerotier-setup.shПервая строка должна быть #!/bin/sh, размер — около 14 КБ. Если вместо
скрипта скачалась HTML-страница, зеркало вернуло ошибку — попробуйте другой
вариант.
sh /tmp/zerotier-setup.shС доступом в локальную сеть:
sh /tmp/zerotier-setup.sh --lanДругая сеть:
sh /tmp/zerotier-setup.sh --network 0123456789abcdef| Параметр | Описание |
|---|---|
-n, --network ID |
ID сети ZeroTier (по умолчанию 8d1c312afa6d0fe8) |
--lan |
Разрешить forwarding между ZeroTier и зоной lan |
--no-firewall |
Не изменять /etc/config/firewall |
--no-install |
Только настроить, пакет не устанавливать |
-h, --help |
Показать справку |
ID сети можно передать и через переменную ZEROTIER_NETWORK_ID.
Скрипт выведет ID узла. Без авторизации узел не получит IP, даже если join выполнен.
- Откройте https://my.zerotier.com/network/8d1c312afa6d0fe8.
- Найдите ID узла в разделе Members.
- Поставьте галочку Authorized.
Если сеть другая — замените ID в ссылке.
zerotier-cli info
zerotier-cli listnetworksОжидаемый результат:
zerotier-cli info—200 info <ID узла> <версия> ONLINE;zerotier-cli listnetworks— строка с вашей сетью и статусомOK;- у интерфейса
zt...появился адрес из сети ZeroTier.
Посмотреть адрес интерфейса:
ip addr show | grep -A2 'zt'Если статус REQUESTING_CONFIGURATION — узел ещё не авторизован или роутер
не может достучаться до контроллера. Если ACCESS_DENIED — не отмечен
Authorized в ZeroTier Central.
Да, служба работает постоянно:
zerotier-oneзапускается при загрузке и перезапускается procd при падении;- это не одно TCP-соединение, а виртуальный интерфейс
zt...и UDP-туннель к пирам; в простое идут keepalive-пакеты; - при смене WAN-IP или NAT-маппинга связь переустанавливается автоматически;
- после перезагрузки роутера узел сам переподключается: identity хранится в
/etc/config/zerotier, join прописан в UCI; - порт
9993/UDPнаружу открывать не нужно — используется NAT traversal, при неудаче трафик идёт через relay.
Проверка состояния:
zerotier-cli info
zerotier-cli listnetworks
zerotier-cli peersВ peers видно, идёт ли трафик напрямую (direct) или через relay.
На системах с fw4 скрипт создаёт зону:
config zone
option name 'zerotier'
option input 'ACCEPT'
option output 'ACCEPT'
option forward 'ACCEPT'
option masq '1'
option mtu_fix '1'
list device 'zt+'
По умолчанию клиенты ZeroTier могут обращаться к самому роутеру (SSH, LuCI,
DNS), но не в LAN за ним. Флаг --lan добавляет forwarding в обе стороны:
zerotier -> lan;lan -> zerotier.
Изменения firewall можно не делать вовсе: --no-firewall.
Скрипт идемпотентен: повторный запуск не создаёт дубликаты секций и правил. Чтобы обновить скрипт, скачайте его заново и запустите снова.
/etc/init.d/zerotier stop
/etc/init.d/zerotier disable
opkg remove zerotier # или: apk del zerotierЗону zerotier и правила forwarding удалите в LuCI
(Network → Firewall) или через UCI, если они больше не нужны.
Это не ошибка скрипта: wget не смог даже установить соединение. Чаще всего
виноват DNS, реже — отсутствие маршрута, неверное время или блокировка
GitHub.
Проверьте:
ping -c 1 1.1.1.1
ping -c 1 raw.githubusercontent.com
nslookup raw.githubusercontent.com 1.1.1.1
date -uping 1.1.1.1не проходит — нет интернета/WAN. Проверьтеip route,logread, настройки WAN.ping 1.1.1.1проходит, а по имени —bad address— сломан DNS.- Время сильно отличается от реального — TLS-сертификат будет считаться недействительным.
- Всё проходит, но GitHub недоступен — используйте зеркало jsDelivr.
Замените wan на имя вашего WAN-интерфейса, если оно другое:
uci set network.wan.peerdns='0'
uci -q delete network.wan.dns
uci add_list network.wan.dns='1.1.1.1'
uci add_list network.wan.dns='8.8.8.8'
uci commit network
/etc/init.d/network restartБыстрая проверка без перезапуска сети:
echo 'nameserver 1.1.1.1' > /etc/resolv.conf
ping -c 1 raw.githubusercontent.comПосле перезагрузки /etc/resolv.conf будет сгенерирован заново, поэтому
постоянно исправляйте DNS через UCI.
opkg update
opkg install ca-bundle libustream-mbedtlsили libustream-openssl, если сборка на OpenSSL.
На OpenWrt с apk (24.10+ / 25.x) загрузка может оборваться на одном из
пакетов, хотя остальные установятся:
(1/4) Installing libminiupnpc (...)
wget: Failed to send request: Operation not permitted
ERROR: libminiupnpc-...: unexpected end of file
...
(4/4) Installing zerotier (...)
1 error; ...
ERROR: failed to install zerotier
При этом сам zerotier уже стоит, но без libminiupnpc не запустится.
Симптом — ошибка при генерации identity:
Error loading shared library libminiupnpc.so.18: No such file or directory
(needed by /usr/bin/zerotier-idtool)
Скрипт проверяет библиотеки через ldd и сам пытается выполнить apk fix.
Вручную:
apk cache clean 2>/dev/null
apk update
apk add libminiupnpc
# или сразу починить все зависимости:
apk fixЕсли apk снова не может скачать пакет, скачайте его через uclient-fetch
и поставьте локально (путь для 25.12.4 / aarch64_cortex-a53):
uclient-fetch -O /tmp/libminiupnpc.apk \
https://downloads.openwrt.org/releases/25.12.4/packages/aarch64_cortex-a53/packages/libminiupnpc-2.2.8-r1.apk
apk add /tmp/libminiupnpc.apkПроверка:
ldd /usr/bin/zerotier-one 2>&1 | grep -E 'not found|Error loading'Пустой вывод — всё на месте, можно снова запускать скрипт:
sh /tmp/zerotier-setup.shЕсли apk снова обрывается на том же месте, повторите — это сетевой сбой
или нехватка места, а не ошибка пакета.
Скачайте скрипт на компьютер и передайте через scp/WinSCP (вариант 4 выше).
Для установки самого ZeroTier интернет на роутере всё равно понадобится:
пакет ставится из репозитория OpenWrt.
MIT — см. LICENSE. Текст лицензии — стандартная английская формулировка.