drouter

38 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
liuzhuohua	7b321bfdce	fix: 第二轮深度审计 —— 堵提权/注入、收口资源生命周期、低配置性能水位，版本号 1.0.5 安全： - chpasswd 换行注入可改 root 密码：用户名/密码拒绝换行与控制字符 - 删用户保护从写死两个名字改为 UID<1000 系统账号 - WOL 接口名白名单 + 目标地址 IPv4 校验，去 sh -c 管道 - ACL hosts 改 ipaddress 严格校验；存储挂载点限定 /mnt\|/media\|/srv - 文件管理器拒绝清单扩到目录级 + 按文件名拦截（authorized_keys/shadow 等） - 前端 201 处 value="${...}" 补 esc()；href 只放行 http/https；主题导出注释同时剥 /* 与 */ 丢数据/假功能： - ACL/文件共享/DDNS 三页切走再回来草稿被静默覆盖：新增 PAGE_DIRTY 脏页登记 - LAN 页网关/域名写进 system 死键，改绑 dnsmasq 同源 - UPnP 映射表按钮不再顺手起服务，走只读接口 read:upnpmap 资源： - PTY 缓冲 8MB 封顶 + 会话信号量 + 后台空闲回收 + 离开页面主动断开 - Web 工作线程 48 封顶、请求体 16MB 封顶、会话 500 封顶改单调时钟、审计 2 万行裁剪、helpd 并发 6 封顶 - helper 日志 32MB 轮转；快照前查磁盘余量；fs 下载 512MB→20MB （通道单条响应 32MB，超限只会静默失败） - 11 处配置写入改原子写；rescue/snapshot 单元补 MemoryMax（三处同步）性能： - /api/config 16 次开库 → 1 次 IN 查询 - cleanup 状态扫描 30s 缓存；gzip 缓存加 24MB 字节闸 - 后台标签页心跳暂停、终端轮询降频杂项：DHCPv6 停用只留注释；租约回收用 dhcp_release（DEPS 可选登记）； VLAN 只删自建接口；公网探测清残留结果文件；快照根白名单；心跳定时器防重复；keep_days/keep_rows 不吞 0	2026-10-02 10:25:40 +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

7b321bfdce

fix: 第二轮深度审计 —— 堵提权/注入、收口资源生命周期、低配置性能水位，版本号 1.0.5

安全：
- chpasswd 换行注入可改 root 密码：用户名/密码拒绝换行与控制字符
- 删用户保护从写死两个名字改为 UID<1000 系统账号
- WOL 接口名白名单 + 目标地址 IPv4 校验，去 sh -c 管道
- ACL hosts 改 ipaddress 严格校验；存储挂载点限定 /mnt|/media|/srv
- 文件管理器拒绝清单扩到目录级 + 按文件名拦截（authorized_keys/shadow 等）
- 前端 201 处 value="${...}" 补 esc()；href 只放行 http/https；
  主题导出注释同时剥 /* 与 */

丢数据/假功能：
- ACL/文件共享/DDNS 三页切走再回来草稿被静默覆盖：新增 PAGE_DIRTY 脏页登记
- LAN 页网关/域名写进 system 死键，改绑 dnsmasq 同源
- UPnP 映射表按钮不再顺手起服务，走只读接口 read:upnpmap

资源：
- PTY 缓冲 8MB 封顶 + 会话信号量 + 后台空闲回收 + 离开页面主动断开
- Web 工作线程 48 封顶、请求体 16MB 封顶、会话 500 封顶改单调时钟、
  审计 2 万行裁剪、helpd 并发 6 封顶
- helper 日志 32MB 轮转；快照前查磁盘余量；fs 下载 512MB→20MB
  （通道单条响应 32MB，超限只会静默失败）
- 11 处配置写入改原子写；rescue/snapshot 单元补 MemoryMax（三处同步）

性能：
- /api/config 16 次开库 → 1 次 IN 查询
- cleanup 状态扫描 30s 缓存；gzip 缓存加 24MB 字节闸
- 后台标签页心跳暂停、终端轮询降频

杂项：DHCPv6 停用只留注释；租约回收用 dhcp_release（DEPS 可选登记）；
VLAN 只删自建接口；公网探测清残留结果文件；快照根白名单；
心跳定时器防重复；keep_days/keep_rows 不吞 0

2026-10-02 10:25:40 +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