drouter

38 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
liuzhuohua	a8659dfb98	docs(readme): 用 78 张真实界面截图替换 SVG 占位图原文里 docs/screenshots/ 放的是 6 张同尺寸 SVG 占位图，只为让 README 在仓库刚建好时能完整渲染。现在换成 78 张真实运行截图（1272x900，取自一台 2 核 4G 的 Debian 13 虚拟机）。改动： - 新增 docs/screenshots/ 78 张 jpg，按 9 个功能分组编号命名（01-login / 02-overview… / 09-settings-4），覆盖全部 43 个功能页 - 删除 6 张 SVG 占位图与 devtools/make-placeholder-shots.py - README「截图」章节重写：首屏放 8 张精选大图，其余 70 张按功能分组放进 9 个 <details> 折叠块，每组内用两列表格 + 图注 - README 项目结构补充 docs/screenshots 与 devtools/shots-map.py - dist/RELEASE_NOTES.md 同步「截图已全部为真图」为什么文件名必须 ASCII： GitHub Releases 资产名已被实测证明会静默剥离非 ASCII 字符（DOCKER-使用说明.md → DOCKER-.md）；且原始文件名含 &（如 AC&AP管理中心.jpg、UPnp&NAT-PMP.jpg）在 shell / CI 里都要额外转义。 devtools/shots-map.py 负责「中文名 → ASCII 名」的映射与复制，并做完整性校验（漏拷/多余/重名都会中止）。新增两项预检，挂进 devtools/sync.sh： - devtools/check-md-links.py：所有 md 的本地引用逐条查存在性 - 截图清单双向校验：README 引用的 78 张与目录里的 78 个文件必须一一对应验证：check-md-links 扫 10 个 md / 98 个本地引用，0 死链； 78 张图与源目录 md5 集合完全一致； t-packaging / t-audit / t-deps / t-cachebust 全部通过。	2026-09-30 22:46:43 +08:00
liuzhuohua	64df3cf331	feat: Drouter 1.0.0 —— Debian 13 软路由管理系统一套跑在 Debian 13 (trixie) 上的软路由管理系统，提供 43 个功能页面的 Web 管理面板：WAN 接入、PPPoE 多拨、DHCP/DNS、IPv6、防火墙、QoS 限速、访问控制、DDNS、文件共享、Docker 管理等。核心设计原则：不重新实现任何协议 PPPoE 交给 ppp，DHCP 交给 dnsmasq，IPv6 RA 交给 radvd，NAT 交给 nftables。 Web 面板只做三件事：渲染原生配置文件 → 语法预检 → 原子写入并 reload。面板删掉后，系统仍是一台配置完好的 Debian 路由器。安全默认值 · 安装后不接管网络：不改默认路由、不开 IP 转发、不启动 DHCP 服务 · 所有改网络的动作都需要用户在面板上亲手点「应用」 · 避开 5900 端口，不触碰 VNC / X 会话 · 配置写入前先做语法预检，失败则回滚架构 · backend/ Python 3 标准库，零第三方依赖（9 个模块） · web/ 原生 JS/CSS，无构建步骤 · 常驻 helper 通过 Unix socket 提供 75 个动作，socket 不可用时回退 subprocess · 鉴权走 X-Token 请求头打包 · packaging/build-deb.sh → drouter_1.0.0_all.deb（含 6 个 systemd 单元） · scripts/make-offline-deps.sh → 236 个依赖 .deb + 本地仓库索引 · packaging/build-offline-bundle.sh → 自包含离线包，目标机零外网可装 · packaging/build-docker.sh → 容器镜像（体验用）测试 40 套单元测试 + 3 个前端检查脚本（菜单映射 / 离线渲染 / 手机适配），全部挂在 devtools/sync.sh 的预检链里。许可：MIT	2026-09-30 19:26:24 +08:00

Author

SHA1

Message

Date

liuzhuohua

a8659dfb98

docs(readme): 用 78 张真实界面截图替换 SVG 占位图

原文里 docs/screenshots/ 放的是 6 张同尺寸 SVG 占位图，只为让 README
在仓库刚建好时能完整渲染。现在换成 78 张真实运行截图（1272x900，
取自一台 2 核 4G 的 Debian 13 虚拟机）。

改动：
- 新增 docs/screenshots/ 78 张 jpg，按 9 个功能分组编号命名
  （01-login / 02-overview… / 09-settings-4），覆盖全部 43 个功能页
- 删除 6 张 SVG 占位图与 devtools/make-placeholder-shots.py
- README「截图」章节重写：首屏放 8 张精选大图，其余 70 张按功能分
  组放进 9 个 <details> 折叠块，每组内用两列表格 + 图注
- README 项目结构补充 docs/screenshots 与 devtools/shots-map.py
- dist/RELEASE_NOTES.md 同步「截图已全部为真图」

为什么文件名必须 ASCII：
  GitHub Releases 资产名已被实测证明会静默剥离非 ASCII 字符
  （DOCKER-使用说明.md → DOCKER-.md）；且原始文件名含 &（如
  AC&AP管理中心.jpg、UPnp&NAT-PMP.jpg）在 shell / CI 里都要额外转义。
  devtools/shots-map.py 负责「中文名 → ASCII 名」的映射与复制，
  并做完整性校验（漏拷/多余/重名都会中止）。

新增两项预检，挂进 devtools/sync.sh：
- devtools/check-md-links.py：所有 md 的本地引用逐条查存在性
- 截图清单双向校验：README 引用的 78 张与目录里的 78 个文件必须一一对应

验证：check-md-links 扫 10 个 md / 98 个本地引用，0 死链；
      78 张图与源目录 md5 集合完全一致；
      t-packaging / t-audit / t-deps / t-cachebust 全部通过。

2026-09-30 22:46:43 +08:00

liuzhuohua

64df3cf331

feat: Drouter 1.0.0 —— Debian 13 软路由管理系统

一套跑在 Debian 13 (trixie) 上的软路由管理系统，提供 43 个功能页面的
Web 管理面板：WAN 接入、PPPoE 多拨、DHCP/DNS、IPv6、防火墙、QoS 限速、
访问控制、DDNS、文件共享、Docker 管理等。

核心设计原则：不重新实现任何协议
  PPPoE 交给 ppp，DHCP 交给 dnsmasq，IPv6 RA 交给 radvd，NAT 交给 nftables。
  Web 面板只做三件事：渲染原生配置文件 → 语法预检 → 原子写入并 reload。
  面板删掉后，系统仍是一台配置完好的 Debian 路由器。

安全默认值
  · 安装后不接管网络：不改默认路由、不开 IP 转发、不启动 DHCP 服务
  · 所有改网络的动作都需要用户在面板上亲手点「应用」
  · 避开 5900 端口，不触碰 VNC / X 会话
  · 配置写入前先做语法预检，失败则回滚

架构
  · backend/  Python 3 标准库，零第三方依赖（9 个模块）
  · web/      原生 JS/CSS，无构建步骤
  · 常驻 helper 通过 Unix socket 提供 75 个动作，socket 不可用时回退 subprocess
  · 鉴权走 X-Token 请求头

打包
  · packaging/build-deb.sh            → drouter_1.0.0_all.deb（含 6 个 systemd 单元）
  · scripts/make-offline-deps.sh      → 236 个依赖 .deb + 本地仓库索引
  · packaging/build-offline-bundle.sh → 自包含离线包，目标机零外网可装
  · packaging/build-docker.sh         → 容器镜像（体验用）

测试
  40 套单元测试 + 3 个前端检查脚本（菜单映射 / 离线渲染 / 手机适配），
  全部挂在 devtools/sync.sh 的预检链里。

许可：MIT

2026-09-30 19:26:24 +08:00