- A device is renamed where its name stands on its card: a click on the
name, Return or Space on it, or Rename in the ⋯ menu turns it into a
field with the name selected. Return saves, and the words shimmer until
the router answers. Esc or a click elsewhere puts the old name back. The
rename window is gone, and the page no longer redraws under a name being
edited
- Device names take up to 20 characters: letters of any language, digits,
spaces and - _ . The router refuses anything else when a device is added
or renamed, so a name can't carry symbols into configurations, file
names or the AmneziaVPN key. The portal and the admin turn a character
like that away as it is typed: the field shakes, its outline goes red
and a short line says why. Suggested names (a phone's model, "Phone 2")
are stripped of such characters and cut to fit. Names set before this
stay as they are
- LAN Bypass: Add a device, in the portal and in the admin, has a switch
that keeps the device's own local network (printer, TV, NAS) reachable
while it is connected. It is off by default and stays as chosen; the
admin's device drawer shows it. With home and internet access the switch
says which addresses still lead to the home network
- Health warns when a server's home network is on one of the subnets home
routers come with (192.168.0.x, 192.168.1.x and others). People with
home access who connect from a network on the same addresses reach your
home instead of their own, LAN Bypass or not
- The router tells when a device can't connect properly. After the problem
lasts three minutes, the portal card and the admin drawer name it:
can't finish connecting (the network may block it), connected but no
data (an outdated configuration, and the card offers Reconnect), on two
devices at once, or a connection that keeps dropping. Activity lists
these under Problems, one line per device per hour, and says when the
device connects normally again
- The set-up sheet's connection line follows what the device does:
waiting, can't finish, connected, or connected but no data. The sheet
closes by itself only once data comes through. On the device itself and
for a router, the steps regroup to what fixes the problem: "Set it up
again" when the handshake never finishes, "Add the connection again"
("Import the configuration again" for a router) when no data comes
- Set-up in the portal: a QR code too long for a camera to read gives its
place to a code that opens the set-up link (a LAN Bypass configuration
or a long AmneziaVPN key can be that long). A TV, box or NAS added from
a phone gets the steps for setting up from another device. Back from
"Open on the device" keeps the kind, LAN Bypass and the name typed. The
packet-size note under the kinds is gone
- The portal on phones keeps its place: nothing jumps when an access row
opens or folds, a notice comes or goes, or Safari redraws the cards. A
reload, or coming back from the VPN app, opens where the page was. Cards
glide to their new height, and an animation interrupted half-way goes on
from where it is instead of snapping. A double click no longer closes
the sheet it just opened
- In the admin, a device's drawer has its own MTU and keep-alive (empty
means the server's), each with a Change dialog. A change touches only
that device's configuration and restarts nothing on the router. Opening
the drawer no longer counts as handing out the configuration: "Update
config" stays until the new configuration is shown as a QR code,
downloaded or copied ("Show the new configuration"). New keys set the
device up again, as the portal's Reconnect does
- "Speed now" on a server's Overview is live: one point a second over the
last two minutes, all there as soon as the Overview opens. The agent
keeps those two minutes in memory and writes them out only while someone
is looking
- Disguise values that AmneziaWG refuses or crashes on are stopped before
they reach the kernel. That covers overlapping H1-H4, Jmin above Jmax,
broken I1-I5 tags, padding under 12 with header protection, and more.
Import and restore refuse them. After a hand edit in uci, the server's
tunnel stays down and Health and the service log say why and what to do.
Errors are full sentences in the reader's language
- The header protection key no longer shows in the status that read-only
users can see: the Server page says only that the key is set, and each
device's configuration still has it. The server no longer turns off
WireGuard's protection against handshake floods (devices keep
DisableCookies). A device can't be added with a server's own key
- An AmneziaWG update whose kernel module can't be swapped (another
AmneziaWG interface holds the old one) no longer fails. It is installed,
the tunnels come back on the old module, and Health and Components say
the update starts after a reboot. On apk firmware, an install that apk
left at the old version counts as failed. A module installed by hand is
recorded, so after a firmware upgrade Health can tell that it is gone
- Dawnline reads only its own tunnels, each one separately. Another
AmneziaWG interface on the router no longer slows the agent's
once-a-second check, has its keys read or breaks Dawnline's reads. A
portal request reads only that person's server: one process however many
servers there are
- Fewer false disconnects: a tunnel that netifd sets up again no longer
logs everyone as leaving and coming back, and a device with a long
keep-alive stays online between handshakes. One configuration on two
devices isn't logged as roaming every few seconds, and new keys end the
old session at once. A tunnel that is missing devices is synced within a
minute, and traffic across a tunnel restart is no longer undercounted
- Renaming a server no longer restarts its tunnel. If a tunnel's interface
is edited outside Dawnline (LuCI, uci), the watchdog sets it up again
with Dawnline's settings and names only the changed options. The routing
rules for "Internet like a home device" change one at a time, new ones
first, so traffic never falls between them. Health and the Server page
warn when the address's AAAA record isn't this router's, or the router
has no public IPv6: devices that prefer IPv6 fail to connect
- The README screenshots come in English and Russian; the portal's are
taken from its demo. The demo has a switch beside × in the set-up sheet
to show each state of the connection line. In Russian, long labels in
the admin's wide option buttons wrap under their icon. DESIGN.md
describes the switch, renaming on the card, the shimmer, the shake and
how the portal scrolls. New tests cover link states, the meter, access,
Health, firewall rules, network settings and packages
28 KiB
Dawnline
Ваш роутер на OpenWrt как личный VPN для тех, кого вы выберете.
Быстрый старт · Демо · Возможности · Как это работает · Скриншоты · Вопросы · Разработка
English · Русский
Dawnline запускает сервер AmneziaWG на вашем роутере с OpenWrt и даёт каждому, кого вы пригласите, личную ссылку. По ней человек сам добавляет свои телефоны и компьютеры и подключается через AmneziaVPN, AmneziaWG или WireGuard. Вы решаете, что ему доступно (домашняя сеть, интернет или и то и другое), и на какой срок, сколько трафика и в какие часы.
Личная страница человека: его устройства и доступ. Телефон добавляется в три шага, и страница видит, когда он подключился.
Попробуйте в демо: ничего не устанавливается и никуда не подключается.
💡 Почему Dawnline?
Обычно, чтобы поделиться домашним VPN, приходится вручную делать файл конфигурации, отправлять его в мессенджере и надеяться, что дальше он никуда не уйдёт. Dawnline делает наоборот:
| VPN вручную | С Dawnline | |
|---|---|---|
| Настройка устройства | Вы делаете конфиг и отправляете его | Человек добавляет устройство сам по своей ссылке |
| Кому что можно | Всем одно и то же | Дом, интернет или и то и другое, для каждого своё |
| Конец доступа | Найти и удалить его пиры | Дата, лимит трафика или один клик |
| Что происходит | Читать wg show |
Кто в сети, трафик, места, журнал |
| Когда что-то ломается | Узнаёте от людей | Автовосстановление замечает и чинит |
Это преемник Liminal: та же идея, перестроенная вокруг людей, а не пиров, с личным порталом, лимитами, трафиком в реальном времени и современной админкой в LuCI.
🚀 Быстрый старт
-
Установите на роутер (установщик спрашивает, прежде чем что-то менять):
sh -c "$(wget -qO- https://raw.githubusercontent.com/tickcount/luci-app-dawnline/main/install.sh)" -
Настройте в LuCI: Network › Dawnline, дальше по мастеру. Он предложит порт, публичный адрес и сети.
-
Пригласите человека: Добавить человека, затем отправьте ему ссылку или карточку приглашения с QR-кодом. Остальное он сделает сам.
Tip
Если портал за Cloudflare, дайте ему порт, который Cloudflare проксирует: 2053, 2083, 2087, 2096 или 8443.
✨ Возможности
🔗 Ссылка вместо аккаунтаТри слова, например |
📱 Свои устройстваЛюди сами добавляют, переименовывают и удаляют устройства в пределах лимита. При добавлении портал ведёт по шагам: нужное приложение, затем QR-код, ссылка, ключ или файл. |
👥 Люди, а не пирыКарточка на каждого человека: устройства, кто в сети, трафик, дата окончания и лимит. Фильтры по тем, кто требует внимания или на паузе. |
🧭 Кому что доступноДомашняя сеть, интернет или и то и другое; только часть домашних сетей или устройств (NAS, Home Assistant). Семья видит семью, гости видят гостей. |
⏳ ЛимитыДаты окончания, лимит трафика на месяц или за всё время, часы доступа, кнопка паузы. Изменения применяются сразу и не обрывают подключения остальных. |
🕶️ МаскировкаПресеты, которые мешают распознать и заблокировать VPN-трафик, и что каждый из них требует от приложений. |
🏠 Интернет как у домашних устройствВключите, и устройства людей выйдут в интернет так же, как домашние: ваши прокси, фильтры рекламы и DNS сработают и для них. По умолчанию выключено: это стоит скорости. |
🗺️ Обзор и местаКто в сети и с чего, скорость сейчас, последние 30 дней и карта, откуда подключаются, с точностью до города. |
🩺 Чинит себя самПроверки состояния с исправлением в один клик и автовосстановление, которое каждую минуту проверяет туннели, правила доступа и портал и чинит их. |
📦 Обновления и резервные копииDawnline и AmneziaWG, собранный под вашу прошивку, в одном месте; ночные резервные копии, экспорт и импорт для переезда на другой роутер. |
🌐 Английский и русскийПортал подстраивается под язык посетителя и переключается в шапке. Админка и сообщения роутера на русском с пакетом |
🧩 Как это работает
flowchart LR
you(["🛠️ Вы, в LuCI"]) -- "добавляете человека" --> link["🔗 Его ссылка"]
link -- "он открывает её" --> portal["📱 Его портал"]
portal -- "добавляет устройство" --> app["Приложение и подключение"]
app == "туннель AmneziaWG" ==> router["🌅 Dawnline<br>на вашем роутере"]
router -- "если разрешено" --> home["🏠 Домашняя сеть"]
router -- "если разрешено" --> net["🌍 Интернет"]
- Вы добавляете человека в LuCI и выбираете, что ему доступно, лимит устройств, дату окончания или лимит трафика.
- Он открывает свою ссылку на любом устройстве. Портал только его: там его устройства и его доступ; доступ и лимиты меняете только вы.
- Он добавляет устройство. Портал подсказывает приложение для его системы и передаёт подключение; роутер выдаёт каждому устройству свои ключи.
- Устройство подключается через сервер AmneziaWG на роутере, а Dawnline пропускает только то, что доступно этому человеку, считает его трафик и следит за лимитами.
📸 Как это выглядит
Обзор: кто в сети, скорость сейчас, последние 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/capture-portal.mjs # скриншоты портала для README из его демо, на английском и русском
scripts/frame-screenshots.py # оформить их для README
Бандлы и каталоги лежат в репозитории: CI падает, если они устарели или строка
не переведена (rules/i18n.md). Тег vX.Y.Z (совпадающий с PKG_VERSION)
собирает пакеты и переводы в OpenWrt SDK и публикует релиз с sha256sums.txt.

