dnsmasq-webconf 0.2.0__tar.gz

dnsmasq_webconf-0.2.0/.gitignore

@@ -0,0 +1,135 @@
+./conf
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+cables.json
+
+.DS_Store
+*.bkp

dnsmasq_webconf-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019-2026 Akiva Miura
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dnsmasq_webconf-0.2.0/PKG-INFO

@@ -0,0 +1,264 @@
+Metadata-Version: 2.5
+Name: dnsmasq-webconf
+Version: 0.2.0
+Summary: Lightweight web UI for editing dnsmasq static DHCP reservations, without rewriting your config
+Project-URL: Homepage, https://github.com/akivajp/dnsmasq-webconf
+Project-URL: Repository, https://github.com/akivajp/dnsmasq-webconf
+Project-URL: Issues, https://github.com/akivajp/dnsmasq-webconf/issues
+Author-email: Akiva Miura <akiva.miura@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dhcp,dns,dnsmasq,network,self-hosted,web-ui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.9
+Requires-Dist: bottle>=0.12
+Requires-Dist: jinja2>=3.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: webtest>=3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Dnsmasq WebConf
+
+[![CI](https://github.com/akivajp/dnsmasq-webconf/actions/workflows/ci.yml/badge.svg)](https://github.com/akivajp/dnsmasq-webconf/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/dnsmasq-webconf)](https://pypi.org/project/dnsmasq-webconf/)
+[![Python](https://img.shields.io/pypi/pyversions/dnsmasq-webconf)](https://pypi.org/project/dnsmasq-webconf/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+A small web UI for managing **static DHCP reservations** in dnsmasq — without taking
+ownership of your config file.
+
+[日本語版 README はこちら](README.ja.md)
+
+![Screenshot](https://user-images.githubusercontent.com/4126355/70373854-96a87080-192f-11ea-8c5e-673323248b6d.png)
+
+## Why this exists
+
+Most dnsmasq front-ends (Pi-hole, router firmwares, config generators) **own** the
+configuration: they generate `dnsmasq.conf` from their own database, and your
+hand-written directives either get moved somewhere else or are lost.
+
+`dnsmasq-webconf` does the opposite. It reads your existing config file, and when you
+save, it **rewrites only the `dhcp-host=` lines you actually changed**. Every other
+line — your `dhcp-range=`, your `dhcp-option=`, your comments, your ordering — is
+preserved byte-for-byte.
+
+That makes it useful in one specific situation: you already run dnsmasq, you want to
+keep managing it as a text file, but you'd rather not hand-edit MAC addresses every
+time a new device shows up.
+
+If you want an all-in-one DNS/DHCP/ad-blocking appliance, use
+[Pi-hole](https://pi-hole.net/) instead — it is far more capable, and this tool does
+not try to compete with it. See [Alternatives](#alternatives) below.
+
+## Features
+
+- **Static DHCP reservations** — add, edit, reorder, comment out, and delete
+  `dhcp-host=` entries.
+- **One-click reservation from a live lease** — see a device in the DHCP lease table,
+  press *Add Static*, and it becomes a fixed reservation.
+- **Blocklist management** — mark a MAC as `ignore` so dnsmasq refuses to serve it.
+- **Per-host notes** — comments are round-tripped as `#` comments in the config file,
+  so they stay readable when you edit by hand.
+- **Read-only views** of the DHCP lease table and the system `hosts` file.
+- **Optional reload hook** — run `systemctl reload dnsmasq` (or anything else) after a
+  successful save.
+- **No database, no build step, no JavaScript toolchain.** Two Python dependencies,
+  and all CSS/JS is bundled — it works on an isolated network with no internet access.
+
+## Installation
+
+### From PyPI (recommended)
+
+```shell
+pipx install dnsmasq-webconf
+# or: uv tool install dnsmasq-webconf
+# or, inside a virtualenv: pip install dnsmasq-webconf
+```
+
+> On modern Debian/Ubuntu/Raspberry Pi OS, `pip install --user` is blocked by
+> [PEP 668](https://peps.python.org/pep-0668/). Use `pipx` or `uv tool` instead.
+
+### With Docker
+
+```shell
+docker build -t dnsmasq-webconf .
+docker run --rm -p 8080:8080 \
+    --user "$(id -u):$(id -g)" \
+    -e DNSMASQ_WEBCONF_AUTH='admin:secret' \
+    -v /etc/dnsmasq.more.conf:/etc/dnsmasq.more.conf \
+    -v /var/lib/misc/dnsmasq.leases:/var/lib/misc/dnsmasq.leases:ro \
+    dnsmasq-webconf
+```
+
+### From source
+
+```shell
+git clone https://github.com/akivajp/dnsmasq-webconf.git
+cd dnsmasq-webconf
+pip install -e .
+```
+
+## Usage
+
+```shell
+dnsmasq-webconf --config /etc/dnsmasq.more.conf
+```
+
+Then open <http://127.0.0.1:8080>.
+
+By default the server listens on **loopback only**. To expose it on your LAN you must
+also set credentials:
+
+```shell
+dnsmasq-webconf --host 0.0.0.0 --auth admin:secret \
+    --config /etc/dnsmasq.more.conf \
+    --reload "systemctl reload dnsmasq"
+```
+
+To avoid putting the password in your shell history or in `ps` output, use the
+environment variable instead of `--auth`:
+
+```shell
+DNSMASQ_WEBCONF_AUTH='admin:secret' dnsmasq-webconf --host 0.0.0.0 ...
+```
+
+Run `dnsmasq-webconf --help` for the full option list.
+
+### Recommended dnsmasq setup
+
+Point the tool at a dedicated include file rather than your main `dnsmasq.conf`, so
+that a mistake can never take down DNS resolution:
+
+```conf
+# /etc/dnsmasq.conf
+conf-file=/etc/dnsmasq.more.conf
+```
+
+```shell
+sudo touch /etc/dnsmasq.more.conf
+dnsmasq-webconf --config /etc/dnsmasq.more.conf
+```
+
+### Running as a service
+
+```ini
+# /etc/systemd/system/dnsmasq-webconf.service
+[Unit]
+Description=Dnsmasq WebConf
+After=network.target
+
+[Service]
+# Needs write access to the config file; adjust to suit your setup.
+User=root
+Environment=DNSMASQ_WEBCONF_AUTH=admin:secret
+ExecStart=/usr/local/bin/dnsmasq-webconf 8080 \
+    --host 0.0.0.0 \
+    --config /etc/dnsmasq.more.conf \
+    --reload "systemctl reload dnsmasq"
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+## Security
+
+This tool edits the configuration of your network's DHCP server. Anyone who can write
+to it can hand out arbitrary IP addresses, gateways and DNS servers to every device on
+your LAN. Please treat access to it accordingly.
+
+- **Authentication is off by default, and so is network exposure.** The server binds to
+  `127.0.0.1` unless you pass `--host`. Binding to a non-loopback address without
+  `--auth` is refused outright (override with `--allow-no-auth` only if you know the
+  port is protected some other way).
+- **HTTP Basic auth is not encrypted.** On an untrusted network, put the tool behind a
+  reverse proxy with TLS, or reach it over a VPN / SSH tunnel:
+  `ssh -L 8080:127.0.0.1:8080 your-server`.
+- **Writes are CSRF-protected** by an `Origin` check, because browsers attach Basic
+  auth credentials automatically.
+- **`--reload-command` runs through a shell.** It is only ever the string you supply on
+  the command line, but do not build it from untrusted input.
+- Use `--read-only` if you only want the dashboard views.
+
+### Reporting a vulnerability
+
+Please open a [security advisory](https://github.com/akivajp/dnsmasq-webconf/security/advisories/new)
+rather than a public issue.
+
+> **Upgrading from v0.1.x?** The default listen address changed from `0.0.0.0` to
+> `127.0.0.1`, and v0.1.x had **no authentication at all** on its save endpoint. If you
+> ran it on a LAN, assume the config was writable by anyone who could reach the port.
+> See [CHANGELOG.md](CHANGELOG.md).
+
+## How saving works
+
+1. The browser sends back only the entries you touched, each tagged with the line
+   number it came from and the **original text of that line**.
+2. The server re-reads the config file and, for each changed entry, checks that the
+   line still matches what the browser saw.
+3. If it matches, that single line is replaced. If it doesn't — because you edited the
+   file by hand, or another session saved first — the write is **skipped and reported**
+   back to you rather than silently overwriting.
+4. The result is written to a temporary file in the same directory and moved into place
+   with `os.replace()`, so an interrupted write cannot corrupt your config. The previous
+   contents are kept as `<config>.bak` (disable with `--no-backup`).
+
+Deleted entries are written as `##dhcp-host=...` rather than being removed, so you can
+always recover them by hand.
+
+## Scope and limitations
+
+This tool deliberately covers a small surface. It **only** parses and edits
+`dhcp-host=` directives.
+
+Not supported: `dhcp-range`, `dhcp-option`, DNS records (`address=`, `cname=`), IPv6
+reservations, query logs, statistics, and multi-user access control. Lines it does not
+understand are preserved untouched, so you can manage them by hand alongside it.
+
+## Alternatives
+
+| Project | Best for |
+|---|---|
+| [Pi-hole](https://pi-hole.net/) | An all-in-one DNS/DHCP appliance with ad-blocking. Note that since v6 it generates `dnsmasq.conf` itself and does not read hand-written ones. |
+| [OpenWrt LuCI](https://openwrt.org/docs/guide-user/luci/luci.essentials) / pfSense / OPNsense | You're already running a router OS — it's built in. |
+| [dnsmasq-manager](https://github.com/gringolito/dnsmasq-manager) | A REST API (no UI) for scripting static leases, with JWT auth and distro packages. |
+| [dnsmasq-leases-ui](https://github.com/fschlag/dnsmasq-leases-ui) | Just viewing the lease table, in a container. |
+| [nexus-dnsmasq-mgr](https://github.com/brainchillz/nexus-dnsmasq-mgr) | A much broader feature set (DNS overrides, PXE boot, `dnsmasq --test` validation). |
+
+## Development
+
+```shell
+git clone https://github.com/akivajp/dnsmasq-webconf.git
+cd dnsmasq-webconf
+uv venv && uv pip install -e '.[dev]'
+uv run pytest
+```
+
+To refresh the bundled jQuery/Bootstrap files and their checksum manifest:
+
+```shell
+scripts/update-vendor.sh
+```
+
+Contributions are welcome — please keep the "don't rewrite lines the user didn't
+change" guarantee intact, and add a test for it.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Bundled third-party assets (jQuery, Bootstrap) are MIT licensed; see
+[`dnsmasq_webconf/static/vendor/MANIFEST.txt`](dnsmasq_webconf/static/vendor/MANIFEST.txt)
+for their versions, origins and checksums.

dnsmasq_webconf-0.2.0/README.ja.md

@@ -0,0 +1,233 @@
+# Dnsmasq WebConf
+
+[![CI](https://github.com/akivajp/dnsmasq-webconf/actions/workflows/ci.yml/badge.svg)](https://github.com/akivajp/dnsmasq-webconf/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/dnsmasq-webconf)](https://pypi.org/project/dnsmasq-webconf/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+dnsmasq の**静的 DHCP 予約**を管理する軽量 Web UI です。
+設定ファイルの所有権を奪わないことを最大の特徴としています。
+
+[English README](README.md)
+
+![スクリーンショット](https://user-images.githubusercontent.com/4126355/70373854-96a87080-192f-11ea-8c5e-673323248b6d.png)
+
+## このツールの位置づけ
+
+dnsmasq のフロントエンドの多く (Pi-hole、ルーター用ファームウェア、各種設定ジェネレーター) は、
+設定ファイルを**自ら生成・所有**します。`dnsmasq.conf` は独自データベースから出力されるため、
+手書きしたディレクティブは別の場所へ移動させられるか、失われます。
+
+`dnsmasq-webconf` は逆のアプローチを取ります。既存の設定ファイルをそのまま読み込み、
+保存時には**実際に変更した `dhcp-host=` 行だけを書き換えます**。
+それ以外の行 — `dhcp-range=`、`dhcp-option=`、コメント、行の並び順 — は
+1 バイトも変更されません。
+
+そのため、次のような状況に向いています。
+
+> すでに dnsmasq を運用していて、今後もテキストファイルとして管理したい。
+> ただし、新しい端末が増えるたびに MAC アドレスを手で書き足すのは避けたい。
+
+DNS・DHCP・広告ブロックを一体で提供するアプライアンスが欲しい場合は、
+[Pi-hole](https://pi-hole.net/) を使ってください。機能面では比較にならないほど高機能であり、
+本ツールはそこと competing する意図を持ちません。[代替ツール](#代替ツール)も参照してください。
+
+## 機能
+
+- **静的 DHCP 予約の管理** — `dhcp-host=` エントリの追加・編集・並べ替え・
+  コメントアウト・削除
+- **リースからワンクリックで予約化** — DHCP リース一覧に現れた端末の *Add Static* を押すだけで
+  固定予約に変換
+- **ブロックリスト管理** — MAC を `ignore` 指定し、dnsmasq に応答させないようにする
+- **ホストごとのメモ** — コメントは設定ファイル中の `#` コメントとして往復するため、
+  手で開いたときにも読める
+- **閲覧専用ビュー** — DHCP リース一覧とシステムの `hosts` ファイル
+- **保存後のリロード** — `systemctl reload dnsmasq` などを任意に実行可能
+- **データベース・ビルド手順・JS ツールチェーン不要** — Python の依存は 2 つだけ。
+  CSS/JS はすべて同梱しているため、インターネットに接続できない閉域ネットワークでも動作します
+
+## インストール
+
+### PyPI から (推奨)
+
+```shell
+pipx install dnsmasq-webconf
+# または: uv tool install dnsmasq-webconf
+# 仮想環境内なら: pip install dnsmasq-webconf
+```
+
+> 近年の Debian / Ubuntu / Raspberry Pi OS では
+> [PEP 668](https://peps.python.org/pep-0668/) により `pip install --user` が拒否されます。
+> `pipx` または `uv tool` を利用してください。
+
+### Docker を使う場合
+
+```shell
+docker build -t dnsmasq-webconf .
+docker run --rm -p 8080:8080 \
+    --user "$(id -u):$(id -g)" \
+    -e DNSMASQ_WEBCONF_AUTH='admin:secret' \
+    -v /etc/dnsmasq.more.conf:/etc/dnsmasq.more.conf \
+    -v /var/lib/misc/dnsmasq.leases:/var/lib/misc/dnsmasq.leases:ro \
+    dnsmasq-webconf
+```
+
+### ソースから
+
+```shell
+git clone https://github.com/akivajp/dnsmasq-webconf.git
+cd dnsmasq-webconf
+pip install -e .
+```
+
+## 使い方
+
+```shell
+dnsmasq-webconf --config /etc/dnsmasq.more.conf
+```
+
+ブラウザで <http://127.0.0.1:8080> を開きます。
+
+既定では**ループバックのみ**を待ち受けます。LAN へ公開する場合は認証の設定が必須です。
+
+```shell
+dnsmasq-webconf --host 0.0.0.0 --auth admin:secret \
+    --config /etc/dnsmasq.more.conf \
+    --reload "systemctl reload dnsmasq"
+```
+
+シェル履歴や `ps` の出力にパスワードを残さないため、`--auth` の代わりに
+環境変数を使うことを推奨します。
+
+```shell
+DNSMASQ_WEBCONF_AUTH='admin:secret' dnsmasq-webconf --host 0.0.0.0 ...
+```
+
+全オプションは `dnsmasq-webconf --help` で確認できます。
+
+### 推奨する dnsmasq 側の構成
+
+メインの `dnsmasq.conf` ではなく、専用の include ファイルを対象にすることを推奨します。
+万一設定を壊しても名前解決そのものを止めずに済みます。
+
+```conf
+# /etc/dnsmasq.conf
+conf-file=/etc/dnsmasq.more.conf
+```
+
+```shell
+sudo touch /etc/dnsmasq.more.conf
+dnsmasq-webconf --config /etc/dnsmasq.more.conf
+```
+
+### サービスとして常駐させる
+
+```ini
+# /etc/systemd/system/dnsmasq-webconf.service
+[Unit]
+Description=Dnsmasq WebConf
+After=network.target
+
+[Service]
+# 設定ファイルへの書き込み権限が必要。環境に合わせて調整すること。
+User=root
+Environment=DNSMASQ_WEBCONF_AUTH=admin:secret
+ExecStart=/usr/local/bin/dnsmasq-webconf 8080 \
+    --host 0.0.0.0 \
+    --config /etc/dnsmasq.more.conf \
+    --reload "systemctl reload dnsmasq"
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+## セキュリティ
+
+本ツールはネットワークの DHCP サーバーの設定を書き換えます。
+書き込み権限を得た者は、LAN 上のあらゆる端末に任意の IP アドレス・ゲートウェイ・
+DNS サーバーを配布できます。アクセス権はそれに見合った扱いをしてください。
+
+- **認証もネットワーク公開も既定では無効です。** `--host` を指定しない限り
+  `127.0.0.1` を待ち受けます。`--auth` なしで非ループバックアドレスへ公開しようとすると
+  起動を拒否します (他の手段でポートを保護している場合のみ `--allow-no-auth` で解除可能)。
+- **BASIC 認証は暗号化されません。** 信頼できないネットワークでは TLS 終端する
+  リバースプロキシの背後に置くか、VPN / SSH トンネル経由で利用してください。
+  例: `ssh -L 8080:127.0.0.1:8080 your-server`
+- **書き込みは CSRF 対策済みです。** ブラウザが BASIC 認証の資格情報を自動送信するため、
+  `Origin` ヘッダによる同一オリジン検証を併用しています。
+- **`--reload-command` はシェル経由で実行されます。** 実行されるのは管理者が
+  コマンドラインで指定した文字列のみですが、信頼できない入力から組み立てないでください。
+- ダッシュボードとしてのみ使う場合は `--read-only` を利用してください。
+
+### 脆弱性の報告
+
+公開 Issue ではなく
+[セキュリティアドバイザリ](https://github.com/akivajp/dnsmasq-webconf/security/advisories/new)
+からご連絡ください。
+
+> **v0.1.x からの移行についての注意**
+> 既定の待ち受けアドレスが `0.0.0.0` から `127.0.0.1` に変更されました。
+> また v0.1.x の保存 API には**認証が一切ありませんでした**。
+> LAN 上で運用していた場合、そのポートに到達できる者は誰でも設定を書き換えられた状態でした。
+> 詳細は [CHANGELOG.md](CHANGELOG.md) を参照してください。
+
+## 保存処理の仕組み
+
+1. ブラウザは変更したエントリのみを、**取得元の行番号**と**その行の原文**を添えて送信します。
+2. サーバーは設定ファイルを読み直し、変更対象の各エントリについて、
+   該当行がブラウザの見ていた内容と一致するかを検証します。
+3. 一致すればその 1 行だけを置き換えます。一致しない場合 (手動で編集した、
+   別のセッションが先に保存した等) は、**黙って上書きせず、スキップして結果を通知**します。
+4. 書き込みは同一ディレクトリの一時ファイルへ行い、`os.replace()` で差し替えます。
+   そのため書き込みが中断されても設定ファイルは破損しません。
+   直前の内容は `<config>.bak` として保存されます (`--no-backup` で無効化可)。
+
+削除したエントリは行を消すのではなく `##dhcp-host=...` として残すため、
+後から手作業で復元できます。
+
+## 対応範囲と制限
+
+本ツールは意図的に対象を絞っており、`dhcp-host=` ディレクティブ**のみ**を解析・編集します。
+
+非対応: `dhcp-range`、`dhcp-option`、DNS レコード (`address=`、`cname=`)、
+IPv6 予約、クエリログ、統計、複数ユーザーのアクセス制御。
+
+解釈できない行はそのまま保持されるため、それらは手作業で併用管理できます。
+
+## 代替ツール
+
+| プロジェクト | 向いている用途 |
+|---|---|
+| [Pi-hole](https://pi-hole.net/) | 広告ブロック込みの DNS/DHCP 統合アプライアンス。ただし v6 以降は `dnsmasq.conf` を自ら生成するため、手書きの設定ファイルは読みません |
+| [OpenWrt LuCI](https://openwrt.org/docs/guide-user/luci/luci.essentials) / pfSense / OPNsense | すでにルーター OS を運用している場合。標準機能として内蔵されています |
+| [dnsmasq-manager](https://github.com/gringolito/dnsmasq-manager) | UI ではなく REST API で静的リースを自動化したい場合。JWT 認証とディストリビューション向けパッケージあり |
+| [dnsmasq-leases-ui](https://github.com/fschlag/dnsmasq-leases-ui) | リース一覧の閲覧のみをコンテナで行いたい場合 |
+| [nexus-dnsmasq-mgr](https://github.com/brainchillz/nexus-dnsmasq-mgr) | DNS オーバーライド、PXE ブート、`dnsmasq --test` による検証など、より広範な機能が必要な場合 |
+
+## 開発
+
+```shell
+git clone https://github.com/akivajp/dnsmasq-webconf.git
+cd dnsmasq-webconf
+uv venv && uv pip install -e '.[dev]'
+uv run pytest
+```
+
+同梱している jQuery / Bootstrap とチェックサムのマニフェストを更新する場合:
+
+```shell
+scripts/update-vendor.sh
+```
+
+コントリビューションを歓迎します。
+「ユーザーが変更していない行は書き換えない」という保証を壊さないようにし、
+その点を検証するテストを添えてください。
+
+## ライセンス
+
+MIT — [LICENSE](LICENSE) を参照してください。
+
+同梱しているサードパーティアセット (jQuery、Bootstrap) は MIT ライセンスです。
+バージョン・取得元・チェックサムは
+[`dnsmasq_webconf/static/vendor/MANIFEST.txt`](dnsmasq_webconf/static/vendor/MANIFEST.txt)
+に記録しています。