Files
dawnline/README_ru.md
T
Aemeath 58492be021
Build packages / CI (push) Blocked by required conditions
Build packages / Version (push) Waiting to run
CI / Web (format, types, tests, bundles) (push) Blocked by required conditions
CI / ShellCheck (push) Blocked by required conditions
CI / ucode static checks (push) Blocked by required conditions
CI / ucode compiles and tests pass (OpenWrt 24.10) (push) Blocked by required conditions
CI / ucode compiles and tests pass (OpenWrt 25.12) (push) Blocked by required conditions
Dawnline 0.13.0
- "Internet like a home device" starts off on new servers: sending the
  tunnel through the home network costs speed. Both server wizards (the
  first one and "Add server") have the switch, and on it says what it
  costs. Servers that have it on keep it
- With it off, Server → Access says what that means: DNS still goes
  through the router, its proxies and filters see the tunnel only once its
  interface is added to their source interfaces, and sites the router's
  DNS answers with proxy addresses won't open
- With it on, established connections skip the second pass through
  netfilter in Dawnline's network namespace (a software flowtable): about
  12% less router CPU per packet, and about a quarter more speed through a
  proxy on the router. Without kmod-nft-offload the old rules load and the
  service log says so
- Its address at home stays the same when it is turned off and on again;
  it moved down by one each time (.254, .253, .252)
- Less CPU for the same work: the background agent's once-a-second look at
  the tunnels, Status, Health and the portal no longer compile the same
  patterns again for each line, address and device. At idle the agent uses
  about a quarter of the CPU it did; a portal request 5-10 ms less
- On LuCI's Bootstrap themes the admin looks as it does on Outline: cards
  and menus a step above the page, icon tiles that keep their colour,
  Outline's status colours in dark mode. The choices in Settings → Logs &
  history and Updates are LuCI's own controls in every theme
- "Add from devices at home" keeps a device's name readable in a narrow
  window: its ports go under the name
- DESIGN.md describes the portal's look, components and motion, and the
  rules send portal work there first. lint-ucode no longer ends a function
  at a brace inside a template literal
2026-10-21 01:42:23 +03:00

27 KiB
Raw Blame History

Dawnline

Dawnline

Ваш роутер на OpenWrt как личный VPN для тех, кого вы выберете.

Последний релиз CI Загрузки Лицензия
OpenWrt 24.10 OpenWrt 25.12 AmneziaWG 2.0 и 3.1

Быстрый старт  ·  Демо  ·  Возможности  ·  Как это работает  ·  Скриншоты  ·  Вопросы  ·  Разработка

English  ·  Русский


Dawnline запускает сервер AmneziaWG на вашем роутере с OpenWrt и даёт каждому, кого вы пригласите, личную ссылку. По ней человек сам добавляет свои телефоны и компьютеры и подключается через AmneziaVPN, AmneziaWG или WireGuard. Вы решаете, что ему доступно (домашняя сеть, интернет или и то и другое), и на какой срок, сколько трафика и в какие часы.

Личный портал: устройства и доступ, добавление телефона в три шага
Личная страница человека: его устройства и доступ. Телефон добавляется в три шага, и страница видит, когда он подключился. Попробуйте в демо: ничего не устанавливается и никуда не подключается.

💡 Почему Dawnline?

Обычно, чтобы поделиться домашним VPN, приходится вручную делать файл конфигурации, отправлять его в мессенджере и надеяться, что дальше он никуда не уйдёт. Dawnline делает наоборот:

VPN вручную С Dawnline
Настройка устройства Вы делаете конфиг и отправляете его Человек добавляет устройство сам по своей ссылке
Кому что можно Всем одно и то же Дом, интернет или и то и другое, для каждого своё
Конец доступа Найти и удалить его пиры Дата, лимит трафика или один клик
Что происходит Читать wg show Кто в сети, трафик, места, журнал
Когда что-то ломается Узнаёте от людей Автовосстановление замечает и чинит

Это преемник Liminal: та же идея, перестроенная вокруг людей, а не пиров, с личным порталом, лимитами, трафиком в реальном времени и современной админкой в LuCI.

🚀 Быстрый старт

  1. Установите на роутер (установщик спрашивает, прежде чем что-то менять):

    sh -c "$(wget -qO- https://raw.githubusercontent.com/tickcount/luci-app-dawnline/main/install.sh)"
    
  2. Настройте в LuCI: Network › Dawnline, дальше по мастеру. Он предложит порт, публичный адрес и сети.

  3. Пригласите человека: Добавить человека, затем отправьте ему ссылку или карточку приглашения с QR-кодом. Остальное он сделает сам.

Tip

Если портал за Cloudflare, дайте ему порт, который Cloudflare проксирует: 2053, 2083, 2087, 2096 или 8443.

✨ Возможности

🔗 Ссылка вместо аккаунта

Три слова, например vpn.example.com/kamiro-telosu-bavine. Ссылка и есть ключ: без регистрации и пароля, а новая ссылка сразу отключает старую.

📱 Свои устройства

Люди сами добавляют, переименовывают и удаляют устройства в пределах лимита. При добавлении портал ведёт по шагам: нужное приложение, затем QR-код, ссылка, ключ или файл.

👥 Люди, а не пиры

Карточка на каждого человека: устройства, кто в сети, трафик, дата окончания и лимит. Фильтры по тем, кто требует внимания или на паузе.

🧭 Кому что доступно

Домашняя сеть, интернет или и то и другое; только часть домашних сетей или устройств (NAS, Home Assistant). Семья видит семью, гости видят гостей.

⏳ Лимиты

Даты окончания, лимит трафика на месяц или за всё время, часы доступа, кнопка паузы. Изменения применяются сразу и не обрывают подключения остальных.

🕶️ Маскировка

Пресеты, которые мешают распознать и заблокировать VPN-трафик, и что каждый из них требует от приложений.

🏠 Интернет как у домашних устройств

Включите, и устройства людей выйдут в интернет так же, как домашние: ваши прокси, фильтры рекламы и DNS сработают и для них. По умолчанию выключено: это стоит скорости.

🗺️ Обзор и места

Кто в сети и с чего, скорость сейчас, последние 30 дней и карта, откуда подключаются, с точностью до города.

🩺 Чинит себя сам

Проверки состояния с исправлением в один клик и автовосстановление, которое каждую минуту проверяет туннели, правила доступа и портал и чинит их.

📦 Обновления и резервные копии

Dawnline и AmneziaWG, собранный под вашу прошивку, в одном месте; ночные резервные копии, экспорт и импорт для переезда на другой роутер.

🌐 Английский и русский

Портал подстраивается под язык посетителя и переключается в шапке. Админка и сообщения роутера на русском с пакетом luci-i18n-dawnline-ru.

🧩 Как это работает

flowchart LR
    you(["🛠️ Вы, в LuCI"]) -- "добавляете человека" --> link["🔗 Его ссылка"]
    link -- "он открывает её" --> portal["📱 Его портал"]
    portal -- "добавляет устройство" --> app["Приложение и подключение"]
    app == "туннель AmneziaWG" ==> router["🌅 Dawnline<br>на вашем роутере"]
    router -- "если разрешено" --> home["🏠 Домашняя сеть"]
    router -- "если разрешено" --> net["🌍 Интернет"]
  1. Вы добавляете человека в LuCI и выбираете, что ему доступно, лимит устройств, дату окончания или лимит трафика.
  2. Он открывает свою ссылку на любом устройстве. Портал только его: там его устройства и его доступ; доступ и лимиты меняете только вы.
  3. Он добавляет устройство. Портал подсказывает приложение для его системы и передаёт подключение; роутер выдаёт каждому устройству свои ключи.
  4. Устройство подключается через сервер AmneziaWG на роутере, а Dawnline пропускает только то, что доступно этому человеку, считает его трафик и следит за лимитами.

📸 Как это выглядит

Обзор: кто в сети, скорость, последние 30 дней и откуда подключаются
Обзор: кто в сети, скорость сейчас, последние 30 дней и карта, откуда подключаются.

Люди: все на сервере, с устройствами, трафиком и состоянием

Люди: в сети, доступ скоро закончится, сверх лимита, вне часов доступа, на паузе.

Человек: его устройства, трафик, места и лимиты

Человек: его устройства, трафик, места и лимиты.

📋 Требования

Что нужно Dawnline
OpenWrt 24.10 (opkg, .ipk) или 25.12 (apk, .apk)
AmneziaWG kmod-amneziawg, amneziawg-tools, luci-proto-amneziawg: если их нет, установщик поставит сборку для вашей прошивки
Свободная флеш-память около 2 МБ

📥 Установка

sh -c "$(wget -qO- https://raw.githubusercontent.com/tickcount/luci-app-dawnline/main/install.sh)"

Установщик проверяет прошивку, часы, свободное место и DNS, даёт выбрать релиз (по умолчанию последний), показывает план и спрашивает, прежде чем что-то менять. Он скачивает пакет для вашего менеджера пакетов, сверяет его с sha256sums.txt, ставит AmneziaWG для вашей прошивки, если его нет, затем ставит Dawnline (с русским переводом, если LuCI на русском) и проверяет, что LuCI его видит.

Note

Прежде чем что-то менять, он сохраняет /etc/config/{dawnline,network,firewall,dhcp,uhttpd} и состояние служб в /etc/dawnline/installer-backups/ (хранятся три последние копии) и возвращает их, если какой-то шаг не удался. Пакеты не откатываются: чтобы вернуться к старому релизу, запустите установщик с --tag. Всё, что он делает, записывается в /tmp/dawnline-install.log.

Параметры установщика

С параметрами его нужно сначала скачать:

wget -O /tmp/dawnline-install.sh https://raw.githubusercontent.com/tickcount/luci-app-dawnline/main/install.sh
sh /tmp/dawnline-install.sh --dry-run             # всё проверить, ничего не менять
sh /tmp/dawnline-install.sh -y --tag 0.3.1        # конкретный релиз, без вопросов
sh /tmp/dawnline-install.sh --awg grey            # AmneziaWG от 2Grey
sh /tmp/dawnline-install.sh --lang ru             # с русским переводом админки
Параметр
-y, --yes Без вопросов: последний релиз (или --tag) и рекомендуемые варианты
-n, --dry-run Проверить систему, найти, скачать и проверить релиз; ничего не менять
-v, --verbose / -q, --quiet Подробнее / только предупреждения и ошибки
--tag X.Y.Z Конкретный релиз (sh install.sh 0.3.1 тоже работает)
--awg auto|slava|grey|skip Откуда брать AmneziaWG, если его нет: Slava-Shchipunov, затем 2Grey (auto, по умолчанию), только один из них или вообще не ставить (потом можно в Dawnline → Компоненты). То же самое делает DAWNLINE_AWG
--no-awg То же, что --awg skip
--lang auto|ru|none Перевод админки, luci-i18n-dawnline-<язык>: auto (по умолчанию) ставит его, если LuCI настроен на этот язык или в нём стоит перевод LuCI на него; none не ставит. Уже установленный перевод всегда обновляется вместе с Dawnline. Позже: Dawnline → Компоненты → Перевод. То же самое делает DAWNLINE_LANG
Если GitHub медленный или заблокирован

Установщик сам повторяет загрузки через ghfast.top и gh-proxy.com. Чтобы скачать сам установщик через зеркало:

sh -c "$(wget -qO- https://cdn.jsdelivr.net/gh/tickcount/luci-app-dawnline@main/install.sh)"
sh -c "$(wget -qO- https://ghfast.top/https://raw.githubusercontent.com/tickcount/luci-app-dawnline/main/install.sh)"
Установка вручную

Из релиза:

opkg update && opkg install ./luci-app-dawnline-0.1.0.ipk                 # OpenWrt 24.10
apk update && apk add --allow-untrusted ./luci-app-dawnline-0.1.0.apk     # OpenWrt 25.12

Русский перевод: luci-i18n-dawnline-ru-<версия> из того же релиза, ставится так же, после приложения (затем /etc/init.d/uhttpd restart).

Обновление: в Dawnline › Компоненты или повторным запуском установщика. Настройки, ключи и история сохраняются, перед обновлением делается резервная копия.

Удаление

sh -c "$(wget -qO- https://raw.githubusercontent.com/tickcount/luci-app-dawnline/main/uninstall.sh)"

Деинсталлятор сохраняет конфигурацию в /etc/dawnline/backups, запускает удаление средствами самого Dawnline (как Настройки › Удалить Dawnline с этого роутера), удаляет пакет и подчищает остатки. После повторной установки Dawnline восстановите копию в Настройки › Резервные копии.

Important

AmneziaWG остаётся установленным: его могут использовать другие туннели. Чтобы удалить и его, добавьте --remove-awg.

Параметры деинсталлятора

С параметрами его нужно сначала скачать:

wget -O /tmp/dawnline-uninstall.sh https://raw.githubusercontent.com/tickcount/luci-app-dawnline/main/uninstall.sh
sh /tmp/dawnline-uninstall.sh --dry-run
Параметр
-y, --yes Не спрашивать подтверждения
-p, --purge Удалить также конфигурацию, ключи, историю и все резервные копии (/etc/config/dawnline, /etc/dawnline); копия не делается
--remove-awg Удалить также AmneziaWG, если его не использует другой интерфейс (--keep-awg, по умолчанию, оставляет его)
-n, --dry-run Показать, что будет удалено; ничего не менять

Вручную: Настройки › Удалить Dawnline с этого роутера (резервная копия сохраняется), затем opkg remove luci-app-dawnline или apk del luci-app-dawnline.

❓ Вопросы и ответы

Какими приложениями пользуются люди?

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

Что делать, если человек потерял ссылку?

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

Затрагивает ли он остальной роутер?

Только то, что создал сам, и dawnline teardown убирает всё это. Полный список: Что Dawnline меняет на роутере.

Как переехать на другой роутер?

Экспорт JSON в Настройки › Резервные копии на старом роутере, установите Dawnline на новый и импортируйте там этот файл.

Откуда берутся места на карте?

Из адреса, с которого подключается устройство: город определяется по нему и кешируется на роутере. Это можно выключить в Настройках.

🧾 Что Dawnline меняет на роутере

Только то, что создал сам: сетевые интерфейсы с меткой _dawnline, секции межсетевого экрана dawnline_*, таблицу nft inet dawnline, /tmp/hosts/dawnline, сетевое пространство имён dawnline с двумя veth-связями (dlx0 и dll0, вторая подключена к мосту LAN и требует kmod-veth), правила маршрутизации для интерфейсов туннелей с одной таблицей маршрутизации, второй экземпляр dnsmasq на порту 5354 (/var/etc/dawnline-dns.conf), строку cron для проверки пульса агента и, пока портал включён, экземпляр uhttpd для него. dawnline teardown убирает всё это.

Данные хранятся в /etc/config/dawnline (права 0600, там приватные ключи) и в /etc/dawnline/ (трафик, события, выданные конфигурации, резервные копии). Текущие счётчики живут в /var/run/dawnline и записываются во флеш-память не чаще раза в час. Изменения доступа доходят до туннеля через awg syncconf, без перезапуска интерфейса; dawnline log на роутере показывает журнал служб.

🧰 Разработка

package/luci-app-dawnline/
  root/usr/share/ucode/dawnline/   библиотека на ucode: модель (core), AmneziaWG (awg), apply, live,
                                   ops, view, loop, portal
  root/usr/share/rpcd/ucode/       объект RPC luci.dawnline
  root/usr/libexec/dawnline/       агент (трафик, лимиты, присутствие) и апдейтер
  root/usr/share/dawnline/portal/  CGI-обёртка портала и его (минифицированные) файлы
  root/usr/bin/dawnline            командная строка (`dawnline help`)
  htdocs/                          представления LuCI и сгенерированный модуль dawnline/app.js
  po/                              каталог строк админки (dawnline.pot, ru/dawnline.po)
web/                               исходники админки и портала на TypeScript
web/i18n/                          инструменты каталогов: сбор строк, слияние .po, сборка .lmo
build/Dockerfile                   сборка пакетов в OpenWrt SDK
scripts/                           скрипты сборки, деплоя и проверок
cd web
npm ci
npm run format        # Prettier
npm run ci            # форматирование, типы, каталоги, тесты, минифицированные бандлы
npm run i18n          # собрать новые строки в каталоги (затем перевести их в ru.po)

scripts/lint-ucode.py                    # статические проверки ucode
scripts/check-ucode.sh root@router       # скомпилировать все файлы ucode на роутере
scripts/deploy.sh root@router            # поставить рабочую копию (сначала сохраняет конфиги)
scripts/build-packages.sh all            # .ipk и .apk в OpenWrt SDK в Docker
scripts/capture-screenshots.mjs --demo   # скриншоты для README с роутера, с демо-людьми вместо настоящих
scripts/frame-screenshots.py             # оформить их для README

Бандлы и каталоги лежат в репозитории: CI падает, если они устарели или строка не переведена (rules/i18n.md). Тег vX.Y.Z (совпадающий с PKG_VERSION) собирает пакеты и переводы в OpenWrt SDK и публикует релиз с sha256sums.txt.


Сделано для OpenWrt · лицензия MIT · Наверх ↑