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 / Backend (Go: vet, tests, a real ubusd and uhttpd) (push) Blocked by required conditions
CI / Package files (push) Blocked by required conditions
- **Backend rewritten in Go.** One daemon, `dawnlined`, replaces the whole ucode backend: the rpcd plugin, the agent, the CLI and the updater. The package no longer depends on ucode. - **Per-architecture builds.** The release carries the backend for arm64, ARMv7, mips, mipsle and amd64; the router fetches its own after the package is installed and checks its sha256. Dawnline does not run on other architectures (older ARM, 32-bit x86, RISC-V). - **Faster on the router.** A firewall sync takes 0.06 s instead of 0.9 s; a full apply takes about 300 ms. The portal is served by the daemon itself, without a CGI process per request. - **Live pages.** The admin and the portal follow a live stream from the router instead of re-fetching the whole state every 30 seconds. - **Admin redesigned in the portal's style.** Three sections (Overview · Log · Settings); a server is a page of its own with People, Places and Settings; a device opens as a dialog over its person. - **Changes wait for «Apply».** Every setting, and a person's access, is staged in one dock before it reaches the router. - **Configuration rollout.** After a change that makes devices fetch their configuration again, the admin shows how many have fetched it and who has not. Every setting shows beforehand (⟳N) how many devices it will touch. - **Waiting for a decision.** Overview and People put first the people who need one (access ended, limit reached, a device that does not connect), each with its one action a tap away. - **Bulk actions on people.** «Select» (or a long press on a card) picks several people to extend by a month, pause or resume at once. - **Undo.** An action done from a card or a request is undone from its toast. - **Update dialogs redesigned.** An update is one view from its question to its result; Dawnline's own update runs in it like every other, and the page reloads itself once the new version answers. Other versions are a list, each with its notes and Install on a page of its own. - **Site to site: networks behind a router.** A router connected as a device can have networks behind it (up to eight, /16 to /30): the server routes them and applies the router's access to them. A network that shares addresses with a tunnel, the router's own networks or another site is refused by name. - **Routers from the portal.** People can add a router and name its networks on their own page; the admin accepts or declines with a reason, or lets them through without asking. - **Check access and Health know the networks behind routers.** - **Usage limits reworked.** A monthly limit no longer follows the calendar. A person's month starts with their first traffic and ends a month later; the next one starts only when they connect again, so time away uses up none of it. Before, everyone's limit reset on the 1st. - Extra data lasts until that person's month ends; «Reset usage» starts the month anew. - A limit is for a month or for the whole term; the admin and the portal show when it resets. - Charts that said «this month» show the last 30 days. - After the update nobody loses what was counted: the month that was running becomes the person's first and ends on the 1st. - **Access by time of day removed.** The Hours limit is gone from the admin, the portal and the backend; saved hours are dropped. - **Expiry simplified.** An end date always stops access, with a heads-up three days before; the per-person choice is gone. - **No false disconnects from sleeping phones.** A phone or a tablet stays online through ten minutes of silence. - **Mobile Safari fixes.** Pressing a control no longer sends the page to its top; tab tracks that do not fit scroll; switches animate after a press.
476 lines
32 KiB
Markdown
476 lines
32 KiB
Markdown
<div align="center">
|
||
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
|
||
<img alt="Dawnline" src="docs/assets/logo-light.svg" width="88" height="88">
|
||
</picture>
|
||
|
||
<h1>Dawnline</h1>
|
||
|
||
**Ваш роутер на OpenWrt как личный VPN для тех, кого вы выберете.**
|
||
|
||
<a href="https://github.com/tickcount/luci-app-dawnline/releases/latest"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/release/tickcount/luci-app-dawnline.svg?variant=secondary&font=geist&mode=dark"><img alt="Последний релиз" src="https://shieldcn.dev/github/release/tickcount/luci-app-dawnline.svg?variant=secondary&font=geist&mode=light"></picture></a>
|
||
<a href="https://github.com/tickcount/luci-app-dawnline/actions/workflows/ci.yml"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/ci/tickcount/luci-app-dawnline.svg?variant=secondary&font=geist&mode=dark"><img alt="CI" src="https://shieldcn.dev/github/ci/tickcount/luci-app-dawnline.svg?variant=secondary&font=geist&mode=light"></picture></a>
|
||
<a href="https://github.com/tickcount/luci-app-dawnline/releases"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/downloads/tickcount/luci-app-dawnline.svg?variant=secondary&font=geist&mode=dark"><img alt="Загрузки" src="https://shieldcn.dev/github/downloads/tickcount/luci-app-dawnline.svg?variant=secondary&font=geist&mode=light"></picture></a>
|
||
<a href="LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/license/tickcount/luci-app-dawnline.svg?variant=secondary&font=geist&mode=dark"><img alt="Лицензия" src="https://shieldcn.dev/github/license/tickcount/luci-app-dawnline.svg?variant=secondary&font=geist&mode=light"></picture></a>
|
||
<br>
|
||
<a href="https://openwrt.org/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/badge/OpenWrt-24.10%20%C2%B7%20opkg.svg?variant=secondary&font=geist&logo=openwrt&mode=dark"><img alt="OpenWrt 24.10" src="https://shieldcn.dev/badge/OpenWrt-24.10%20%C2%B7%20opkg.svg?variant=secondary&font=geist&logo=openwrt&mode=light"></picture></a>
|
||
<a href="https://openwrt.org/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/badge/OpenWrt-25.12%20%C2%B7%20apk.svg?variant=secondary&font=geist&logo=openwrt&mode=dark"><img alt="OpenWrt 25.12" src="https://shieldcn.dev/badge/OpenWrt-25.12%20%C2%B7%20apk.svg?variant=secondary&font=geist&logo=openwrt&mode=light"></picture></a>
|
||
<a href="https://docs.amnezia.org/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/badge/AmneziaWG-2.0%20%C2%B7%203.1.svg?variant=secondary&font=geist&logo=wireguard&mode=dark"><img alt="AmneziaWG 2.0 и 3.1" src="https://shieldcn.dev/badge/AmneziaWG-2.0%20%C2%B7%203.1.svg?variant=secondary&font=geist&logo=wireguard&mode=light"></picture></a>
|
||
|
||
[**Быстрый старт**](#-быстрый-старт) · [**Демо**](https://dawnline-demo.vercel.app) · [Возможности](#-возможности) · [Как это работает](#-как-это-работает) · [Скриншоты](#-как-это-выглядит) · [Вопросы](#-вопросы-и-ответы) · [Разработка](#-разработка)
|
||
|
||
[English](README.md) · **Русский**
|
||
|
||
</div>
|
||
|
||
<br>
|
||
|
||
Dawnline запускает сервер [AmneziaWG] на вашем роутере с OpenWrt и даёт каждому,
|
||
кого вы пригласите, **личную ссылку**. По ней человек **сам добавляет свои
|
||
телефоны и компьютеры** и подключается через AmneziaVPN, AmneziaWG или WireGuard.
|
||
Вы решаете, **что ему доступно** (домашняя сеть, интернет или и то и другое), и
|
||
**на какой срок и сколько трафика**.
|
||
|
||
<p align="center">
|
||
<a href="https://dawnline-demo.vercel.app"><img src="docs/screenshots/portal-ru.png" alt="Личный портал: устройства и доступ, добавление телефона в три шага" width="860"></a>
|
||
<br>
|
||
<sub>Личная страница человека: его устройства и доступ. Телефон добавляется в три шага, и страница видит, когда он подключился.
|
||
<a href="https://dawnline-demo.vercel.app"><b>Попробуйте в демо</b></a>: ничего не устанавливается и никуда не подключается.</sub>
|
||
</p>
|
||
|
||
## 💡 Почему Dawnline?
|
||
|
||
Обычно, чтобы поделиться домашним VPN, приходится вручную делать файл
|
||
конфигурации, отправлять его в мессенджере и надеяться, что дальше он никуда не
|
||
уйдёт. Dawnline делает наоборот:
|
||
|
||
| | VPN вручную | С Dawnline |
|
||
|---|---|---|
|
||
| **Настройка устройства** | Вы делаете конфиг и отправляете его | Человек добавляет устройство сам по своей ссылке |
|
||
| **Кому что можно** | Всем одно и то же | Дом, интернет или и то и другое, для каждого своё |
|
||
| **Конец доступа** | Найти и удалить его пиры | Дата, лимит трафика или один клик |
|
||
| **Что происходит** | Читать `wg show` | Кто в сети, трафик, места, журнал |
|
||
| **Когда что-то ломается** | Узнаёте от людей | Автовосстановление замечает и чинит |
|
||
|
||
Это преемник [Liminal]: та же идея, перестроенная вокруг людей, а не пиров, с
|
||
личным порталом, лимитами, трафиком в реальном времени и современной админкой
|
||
в LuCI.
|
||
|
||
## 🚀 Быстрый старт
|
||
|
||
1. **Установите** на роутер (установщик спрашивает, прежде чем что-то менять):
|
||
|
||
```sh
|
||
sh -c "$(wget -qO- https://raw.githubusercontent.com/tickcount/luci-app-dawnline/main/install.sh)"
|
||
```
|
||
|
||
2. **Настройте** в LuCI: <kbd>Services</kbd> › <kbd>Dawnline</kbd>, дальше по
|
||
мастеру. Он предложит порт, публичный адрес и сети.
|
||
3. **Пригласите** человека: <kbd>Добавить человека</kbd>, затем отправьте ему
|
||
ссылку или карточку приглашения с QR-кодом. Остальное он сделает сам.
|
||
|
||
> [!TIP]
|
||
> Если портал за Cloudflare, дайте ему порт, который Cloudflare проксирует:
|
||
> 2053, 2083, 2087, 2096 или 8443.
|
||
|
||
## ✨ Возможности
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
<h3>🔗 Ссылка вместо аккаунта</h3>
|
||
<p>Три слова, например <code>vpn.example.com/kamiro-telosu-bavine</code>. Ссылка и есть ключ: без регистрации и пароля, а новая ссылка сразу отключает старую.</p>
|
||
</td>
|
||
<td width="50%" valign="top">
|
||
<h3>📱 Свои устройства</h3>
|
||
<p>Люди сами добавляют, переименовывают и удаляют устройства в пределах лимита. При добавлении портал ведёт по шагам: нужное приложение, затем QR-код, ссылка, ключ или файл.</p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td valign="top">
|
||
<h3>👥 Люди, а не пиры</h3>
|
||
<p>Карточка на человека, где сказано только то, что важно в его состоянии: кто ждёт решения и одна кнопка, которая его решает, кто в сети, с какого времени и с какой скоростью, сколько скачано за неделю и за месяц. Фильтры, порядок, поиск по имени, устройству или IP; человек и устройство открываются отдельной страницей, а «Назад» возвращает на то же место, и те же люди стоят на карте мест, откуда они подключаются.</p>
|
||
</td>
|
||
<td valign="top">
|
||
<h3>🧭 Кому что доступно</h3>
|
||
<p>Домашняя сеть, интернет или и то и другое; только часть домашних сетей или устройств (NAS, Home Assistant). Семья видит семью, гости видят гостей.</p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td valign="top">
|
||
<h3>⏳ Лимиты</h3>
|
||
<p>Даты окончания, лимит трафика на месяц или за всё время, кнопка паузы. Изменения применяются сразу и не обрывают подключения остальных.</p>
|
||
</td>
|
||
<td valign="top">
|
||
<h3>🕶️ Маскировка</h3>
|
||
<p>Пресеты, которые мешают распознать и заблокировать VPN-трафик, и что каждый из них требует от приложений.</p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td valign="top">
|
||
<h3>🏠 Интернет как у домашних устройств</h3>
|
||
<p>Включите, и устройства людей выйдут в интернет так же, как домашние: ваши прокси, фильтры рекламы и DNS сработают и для них. По умолчанию выключено: это стоит скорости.</p>
|
||
</td>
|
||
<td valign="top">
|
||
<h3>🗺️ Обзор и места</h3>
|
||
<p>Одна страница, на которой видно, всё ли работает: проверки состояния, кто ждёт решения, кто в сети, скорость сейчас и кто нагружает больше всех, сегодня по часам, последние 30 дней рядом с предыдущими и серверы с теми, кто ещё не забрал новую настройку. Откуда подключаются (с точностью до города), показывает карта в «Людях».</p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td valign="top">
|
||
<h3>🩺 Чинит себя сам</h3>
|
||
<p>Проверки состояния с исправлением в один клик и автовосстановление, которое каждую минуту проверяет туннели, правила доступа и портал и чинит их.</p>
|
||
</td>
|
||
<td valign="top">
|
||
<h3>📦 Обновления и резервные копии</h3>
|
||
<p>Dawnline и AmneziaWG, собранный под вашу прошивку, в одном месте; ночные резервные копии, экспорт и импорт для переезда на другой роутер.</p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td valign="top">
|
||
<h3>🌐 Английский и русский</h3>
|
||
<p>Портал подстраивается под язык посетителя и переключается в шапке. Админка и сообщения роутера на русском с пакетом <code>luci-i18n-dawnline-ru</code>.</p>
|
||
</td>
|
||
<td valign="top"></td>
|
||
</tr>
|
||
</table>
|
||
|
||
## 🧩 Как это работает
|
||
|
||
```mermaid
|
||
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
|
||
пропускает только то, что доступно этому человеку, считает его трафик и
|
||
следит за лимитами.
|
||
|
||
## 📸 Как это выглядит
|
||
|
||
<p align="center">
|
||
<img src="docs/screenshots/people-ru.png" alt="Люди: кому нужно решение, кто в сети, остальные, кто на паузе" width="720">
|
||
<br>
|
||
<sub><b>Люди</b>: кому нужно решение, кто в сети, остальные, кто на паузе.</sub>
|
||
</p>
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
<img alt="Человек: его трафик, устройства, места, срок, использование и куда он доходит" src="docs/screenshots/person-ru.png">
|
||
<p align="center"><sub><b>Человек</b>: его трафик, устройства и места; срок, использование и куда он доходит.</sub></p>
|
||
</td>
|
||
<td width="50%" valign="top">
|
||
<img alt="Места: откуда подключаются устройства, на карте и списком" src="docs/screenshots/places-ru.png">
|
||
<p align="center"><sub><b>Места</b>: откуда подключаются устройства, сейчас и за последние 30 дней.</sub></p>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
<img alt="Устройство: когда было в сети, его трафик, места и настройка" src="docs/screenshots/device-ru.png">
|
||
<p align="center"><sub><b>Устройство</b>: когда было в сети, его трафик, места и настройка.</sub></p>
|
||
</td>
|
||
<td width="50%" valign="top">
|
||
<img alt="Ядро сервера: маскировка, MTU и keep-alive туннеля AmneziaWG" src="docs/screenshots/core-ru.png">
|
||
<p align="center"><sub><b>Ядро сервера</b>: маскировка, MTU и keep-alive туннеля AmneziaWG.</sub></p>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
## 📋 Требования
|
||
|
||
| | Что нужно Dawnline |
|
||
|---|---|
|
||
| **OpenWrt** | 24.10 (opkg, `.ipk`) или 25.12 (apk, `.apk`) |
|
||
| **AmneziaWG** | `kmod-amneziawg`, `amneziawg-tools`, `luci-proto-amneziawg`: если их нет, установщик поставит сборку для вашей прошивки |
|
||
| **Свободная флеш-память** | около 2 МБ |
|
||
|
||
## 📥 Установка
|
||
|
||
```sh
|
||
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`.
|
||
|
||
<details>
|
||
<summary><b>Параметры установщика</b></summary>
|
||
|
||
<br>
|
||
|
||
С параметрами его нужно сначала скачать:
|
||
|
||
```sh
|
||
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. То же самое делает `DAWNLINE_LANG` |
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Если GitHub медленный или заблокирован</b></summary>
|
||
|
||
<br>
|
||
|
||
Установщик сам повторяет загрузки через `ghfast.top` и `gh-proxy.com`. Чтобы
|
||
скачать сам установщик через зеркало:
|
||
|
||
```sh
|
||
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)"
|
||
```
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Установка вручную</b></summary>
|
||
|
||
<br>
|
||
|
||
Из [релиза](https://github.com/tickcount/luci-app-dawnline/releases):
|
||
|
||
```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`).
|
||
|
||
</details>
|
||
|
||
**Обновление**: в <kbd>Dawnline</kbd> › <kbd>Настройки</kbd> › <kbd>Обновления</kbd> или повторным
|
||
запуском установщика. Настройки, ключи и история сохраняются, перед обновлением
|
||
делается резервная копия.
|
||
|
||
### Удаление
|
||
|
||
```sh
|
||
sh -c "$(wget -qO- https://raw.githubusercontent.com/tickcount/luci-app-dawnline/main/uninstall.sh)"
|
||
```
|
||
|
||
Деинсталлятор сохраняет конфигурацию в `/etc/dawnline/backups`, запускает
|
||
удаление средствами самого Dawnline (как <kbd>Настройки</kbd> › <kbd>Удалить
|
||
Dawnline</kbd>), удаляет пакет и подчищает остатки. После
|
||
повторной установки Dawnline восстановите копию в <kbd>Настройки</kbd> ›
|
||
<kbd>Резервные копии</kbd>.
|
||
|
||
> [!IMPORTANT]
|
||
> AmneziaWG остаётся установленным: его могут использовать другие туннели.
|
||
> Чтобы удалить и его, добавьте `--remove-awg`.
|
||
|
||
<details>
|
||
<summary><b>Параметры деинсталлятора</b></summary>
|
||
|
||
<br>
|
||
|
||
С параметрами его нужно сначала скачать:
|
||
|
||
```sh
|
||
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` | Показать, что будет удалено; ничего не менять |
|
||
|
||
Вручную: <kbd>Настройки</kbd> › <kbd>Удалить Dawnline</kbd>
|
||
(резервная копия сохраняется), затем `opkg remove luci-app-dawnline` или
|
||
`apk del luci-app-dawnline`.
|
||
|
||
</details>
|
||
|
||
## ❓ Вопросы и ответы
|
||
|
||
<details>
|
||
<summary><b>Какими приложениями пользуются люди?</b></summary>
|
||
|
||
<br>
|
||
|
||
AmneziaVPN или AmneziaWG на телефонах и компьютерах, V2RayTun на Android (по
|
||
ссылке `awg://`; кроме максимальной маскировки, её он пока не
|
||
умеет), а
|
||
обычный WireGuard, если маскировка выключена. Портал показывает каждому приложение для его системы и
|
||
как добавить в нём подключение.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Что делать, если человек потерял ссылку?</b></summary>
|
||
|
||
<br>
|
||
|
||
Создайте новую на его странице. Старая ссылка сразу перестанет работать; его
|
||
устройства продолжат работать, если не отметить те, что нужно удалить вместе с
|
||
ней.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Можно ли подключить целую сеть другого места (site-to-site)?</b></summary>
|
||
|
||
<br>
|
||
|
||
Да. Добавьте роутер того места человеку как устройство типа «Роутер» и укажите
|
||
сети за ним (настройки сервера → Сеть → «Сети за роутерами людей»). Туннель
|
||
понесёт их в обе стороны: домашние устройства и люди с доступом к дому попадают
|
||
в узлы там, а узлам там доступно то же, что владельцу роутера. Человек может и
|
||
сам попросить роутер и его сети на своей странице; вы принимаете или отклоняете
|
||
каждый запрос (или разрешаете добавлять сразу, для каждого сервера отдельно).
|
||
Двум концам нужны разные адреса: сеть, которая пересекается с вашей домашней
|
||
сетью, туннелем или сетью другого роутера, не принимается. Дальний роутер
|
||
должен маршрутизировать свою сеть в туннель без NAT, иначе из дома до узлов за
|
||
ним не добраться. Домашние узлы попадают туда только там, где этот роутер у них
|
||
шлюз (или у них есть маршрут в ту сеть через него).
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Затрагивает ли он остальной роутер?</b></summary>
|
||
|
||
<br>
|
||
|
||
Только то, что создал сам, и `dawnline teardown` убирает всё это. Полный список:
|
||
[Что Dawnline меняет на роутере](#-что-dawnline-меняет-на-роутере).
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Как переехать на другой роутер?</b></summary>
|
||
|
||
<br>
|
||
|
||
<kbd>Экспорт JSON</kbd> в <kbd>Настройки</kbd> › <kbd>Резервные копии</kbd> на
|
||
старом роутере, установите Dawnline на новый и импортируйте там этот файл.
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Откуда берутся места на карте?</b></summary>
|
||
|
||
<br>
|
||
|
||
Из адреса, с которого подключается устройство: город определяется по нему и
|
||
кешируется на роутере. Это можно выключить в <kbd>Настройки</kbd> › <kbd>История и хранение</kbd>.
|
||
|
||
</details>
|
||
|
||
## 🧾 Что Dawnline меняет на роутере
|
||
|
||
Только то, что создал сам: сетевые интерфейсы с меткой `_dawnline`, секции
|
||
межсетевого экрана `dawnline_*`, таблицу nft `inet dawnline`, `/tmp/hosts/dawnline`,
|
||
сетевое пространство имён `dawnline` с двумя veth-связями (`dlx0` и `dll0`,
|
||
вторая подключена к мосту LAN и требует `kmod-veth`), правила маршрутизации для
|
||
интерфейсов туннелей с одной таблицей маршрутизации, маршруты к сетям за
|
||
роутерами людей (протокол маршрутизации 205 в основной таблице), второй экземпляр dnsmasq на
|
||
порту 5354 (`/var/etc/dawnline-dns.conf`), строку cron для проверки пульса
|
||
агента и, пока портал включён, экземпляр uhttpd для него. `dawnline teardown`
|
||
убирает всё это.
|
||
|
||
Данные хранятся в `/etc/config/dawnline` (права 0600, там приватные ключи) и в
|
||
`/etc/dawnline/` (трафик, события, выданные конфигурации, резервные копии).
|
||
Текущие счётчики живут в `/var/run/dawnline` и записываются во флеш-память не
|
||
чаще раза в час. Изменения доступа доходят до туннеля через `awg syncconf`, без
|
||
перезапуска интерфейса; `dawnline log` на роутере показывает журнал служб.
|
||
|
||
Всё, что касается служб, попадает и в системный журнал роутера, строкой на
|
||
событие с приоритетом syslog: `logread -e dawnline` покажет
|
||
`[info] [service] starting`, `[info] [apply] configuration applied in 310 ms · …`,
|
||
падения и восстановление туннелей и портала, сбои с тем, что о них знал syslog,
|
||
каждое изменение настроек (`admin changed settings · domain: lan → home`) и
|
||
изменения людей и устройств. Уровень выбирается в «Настройки → История и
|
||
хранение → Системный журнал»: ошибки, предупреждения, обычный или подробный
|
||
(каждый шаг запуска и применения настроек).
|
||
|
||
## 🧰 Разработка
|
||
|
||
```
|
||
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 (страницы),
|
||
style.js (их стили), map.js (карта, загружается по запросу)
|
||
po/ каталог строк админки (dawnline.pot, ru/dawnline.po)
|
||
web/ исходники админки и портала на TypeScript
|
||
web/i18n/ инструменты каталогов: сбор строк, слияние .po, сборка .lmo
|
||
build/Dockerfile сборка пакетов в OpenWrt SDK
|
||
scripts/ скрипты сборки, деплоя и проверок
|
||
```
|
||
|
||
```sh
|
||
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 # скриншоты админки для README из её демо (без роутера; рядом нужна сборка темы Outline)
|
||
scripts/capture-portal.mjs # скриншоты портала из его демо; и те и другие на английском и русском
|
||
scripts/frame-screenshots.py # оформить их для README
|
||
```
|
||
|
||
Бандлы не лежат в репозитории, они собираются (`npm run build` перед
|
||
`scripts/build-packages.sh`); каталоги лежат, и CI падает, если они устарели или
|
||
строка не переведена (`rules/i18n.md`). Тег `vX.Y.Z` (совпадающий с `PKG_VERSION`)
|
||
собирает пакеты и переводы в OpenWrt SDK и публикует релиз с `sha256sums.txt`.
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
<sub>Сделано для OpenWrt · <a href="LICENSE">лицензия MIT</a> · <a href="#readme">Наверх ↑</a></sub>
|
||
</div>
|
||
|
||
[AmneziaWG]: https://docs.amnezia.org/
|
||
[Liminal]: https://github.com/tickcount/openwrt-liminal
|
||
[Slava-Shchipunov]: https://github.com/Slava-Shchipunov/awg-openwrt
|
||
[2Grey]: https://github.com/2Grey/awg-openwrt
|