SPR：安全可编程路由器

项目简介

SPR（Secure Programmable Router）是一个基于 Linux 与 Docker 运行的安全可编程路由器系统，面向家庭、homelab 与小型网络环境。它通过「每台 WiFi 设备一个密码」建立不可伪造的设备身份，再为每台设备分配独立的 /30 子网，并结合防火墙与路由规则实现设备隔离和策略化访问控制。项目采用 BSD-3-Clause 许可证。

可在线体验 UI：https://demo.supernetworks.org/

主要功能

• 安全与隔离：Multi-PSK（含 WPA3）；默认隔离；双向设备组与单向服务规则；安全容器网络。
• WiFi：支持 WPA3/WPA2，兼容 WPA1；在支持的硬件上支持 WiFi 6/7、MLO 与 320MHz 信道。
• 防火墙与路由：基于策略的路由；WireGuard VPN；多 WAN 负载均衡；无线上行；组播流量支持。
• DNS 能力：DNS over HTTPS 远程查询；DNS 广告拦截列表；按设备 DNS 规则与覆盖；DNS 重绑定保护。
• 可观测性：按国家/ASN 的流量洞察；互联网与上行链路健康监控；告警；DNS 日志；事件系统与数据库。
• 家长控制：家庭 DNS 规则；设备使用时间限制。
• 扩展性：Docker 插件系统，可使用社区插件或自行编写；提供 API 文档。
• 界面与客户端：React 管理界面；提供 iOS App。

安装与使用

SPR 可在支持 Docker 的多种 Linux 系统上运行。使用预构建容器时：

docker-compose pull
./setup.sh # 可选
docker-compose up -d

从源码构建：

./build_docker_compose.sh --load
docker-compose up -d

构建默认使用内存文件系统，内存有限的设备可能构建失败，可通过 --set 参数将 *.args.USE_TMPFS 设为 false。详细安装指南见官方文档中的 Raspberry Pi 4/5、通用与虚拟环境设置页面。

注意事项

• 部分功能（如 Mesh with Wired Backhaul、Policy Based Site Forwarding）属于 SPR PLUS 付费订阅。
• 项目需要自行准备 Linux 主机或设备并部署 Docker 服务，不是直接打开的在线网站。
• 插件目录：https://www.supernetworks.org/plugins.html
• 常见问题：https://www.supernetworks.org/pages/docs/faq

本作品整理自 GitHub 开源项目 spr-networks/super，原作者 @spr-networks，许可证 BSD-3-Clause。中文介绍由 AI 根据项目 README 整理，以原仓库为准。