一个专为管理儿童上网时间而设计的 OpenWrt LuCI 应用。通过基于设备 MAC 地址的时间控制，让家长能够轻松管理孩子的网络使用时间，如控制看电视、平板电脑等设备的网络访问时间段。
- 设备级时间控制：基于 MAC 地址精确控制特定设备的网络访问
- 灵活的时间安排：支持按星期、时间段设置不同的网络访问策略
- 快速规则配置：提供"工作日"、"周末"、"全选"等快捷选择
- 移动端优化界面：专为手机操作优化的响应式设计
- 高优先级处理：使用
raw_prerouting链确保规则优先执行 - 服务分离：与代理服务（如 PassWall）完全独立，避免冲突
- 实时生效：配置更改后立即生效，无需重启路由器
- 资源友好：基于 nftables，性能优异且资源占用低
- 直观的设备管理：一目了然的设备列表和规则展示
- 友好的时间选择：HTML5 时间选择器，支持各种设备
- 移动端适配：大按钮设计，2列网格布局，适合手机操作
- 多语言支持：中文界面，适合国内用户使用
- 儿童电视时间管理：控制智能电视、电视盒子的使用时间
- 学习设备管理：限制平板电脑、学习机的娱乐时间
- 游戏设备控制：管理游戏主机、掌机的网络访问时间
- 智能设备管理：控制智能音箱、投影仪等设备的使用时间
- 办公环境：限制员工设备在非工作时间的网络访问
- 学校宿舍：管理学生设备的上网时间
- 公共场所：控制公共设备的使用时段
- 临时限制：快速对特定设备实施临时网络限制
- ✅ OpenWrt 23.05 (推荐)
- ✅ OpenWrt 24.10 (已测试)
- ✅ OpenWrt 22.03 (兼容)
⚠️ OpenWrt 21.02 (需要手动安装 nftables)
本应用基于经典LuCI (Lua版本)开发。OpenWrt 23.05及以后版本默认使用新版LuCI (ucode版本)，需要安装luci-compat包才能正常运行。安装本应用时会自动安装luci-compat依赖。
- RAM: 最小 64MB (推荐 128MB+)
- Flash: 最小 8MB (推荐 16MB+)
- 架构: 支持所有 OpenWrt 支持的架构 (x86, ARM, MIPS 等)
nftables- 现代防火墙工具kmod-nft-core- nftables 内核模块luci-base- LuCI 基础框架luci-compat- LuCI兼容层 (OpenWrt 23.05+必需)
-
下载 IPK 包
# 替换为最新版本号和适合你架构的包 wget https://github.com/your-repo/luci-app-timecontrol/releases/download/v1.2.0/luci-app-timecontrol_1.2.0_all.ipk -
上传并安装
# 上传到路由器 scp luci-app-timecontrol_1.2.0_all.ipk root@192.168.1.1:/tmp/ # SSH 连接路由器并安装 ssh root@192.168.1.1 opkg install /tmp/luci-app-timecontrol_1.2.0_all.ipk
-
克隆仓库
git clone https://github.com/your-repo/luci-app-timecontrol.git cd luci-app-timecontrol -
构建 IPK 包
./build.sh
-
安装生成的包
scp build/luci-app-timecontrol_1.2.0_all.ipk root@192.168.1.1:/tmp/ ssh root@192.168.1.1 'opkg install /tmp/luci-app-timecontrol_1.2.0_all.ipk'
安装完成后，在 LuCI 界面中导航到：
网络 → Time Control
-
填写设备信息
- 设备名称：例如 "Sony电视"、"小明的平板"
- MAC 地址：设备的网络适配器 MAC 地址
-
选择规则类型
- 🚫 禁止上网：在指定时间段内阻止设备访问网络
- ✅ 允许上网：仅在指定时间段内允许设备访问网络
-
设置时间安排
- 快捷选择：全选、工作日、周末、全不选
- 时间段：使用时间选择器设置开始和结束时间
-
提交规则
- 点击"提交"按钮，规则立即生效
- 查看规则：在下方表格中查看所有活跃的控制规则
- 删除规则：点击"删除"按钮移除不需要的规则
- 修改规则：删除现有规则后重新添加
本项目提供了完整的自动化测试方案，确保功能的可靠性：
# 快速功能验证
./test-e2e.sh测试内容：
- IPK 包安装和文件部署
- 服务启动和管理功能
- 配置文件解析和 UCI 集成
- nftables 规则创建和管理
- LuCI 界面集成验证
- 压力测试（多设备规则）
# 默认连接 192.168.1.1
./test-real-router.sh
# 自定义路由器地址
ROUTER_IP=192.168.4.1 ./test-real-router.sh
# 清理测试环境
./test-real-router.sh cleanup测试内容：
- 真实设备的 MAC 地址过滤
- 实际网络封堵效果验证
- 防火墙规则动态切换
- 与现有网络环境兼容性
- LuCI 界面完整功能测试
测试完成后会生成详细报告：
test-report.txt- Docker 测试报告real-router-test-report.txt- 真实路由器测试报告
详细的测试指南请参考 TESTING.md
# 查看服务状态
/etc/init.d/timecontrol status
# 重新加载规则
/etc/init.d/timecontrol reload
# 停止时间控制
/etc/init.d/timecontrol stop
# 启动时间控制
/etc/init.d/timecontrol start
# 查看当前防火墙规则
nft list chain inet fw4 raw_prerouting- 服务脚本:
/etc/init.d/timecontrol - 配置文件:
/etc/config/timecontrol - LuCI 模板:
/usr/lib/lua/luci/view/timecontrol/main.htm - LuCI 控制器:
/usr/lib/lua/luci/controller/timecontrol.lua
# /etc/config/timecontrol
config device 'sony_tv'
option name 'Sony电视'
option mac '78:11:DC:92:9A:D8'
option enable '1'
config timeslot 'rule_sony_evening'
option device 'sony_tv'
option weekdays 'Mon Tue Wed Thu Fri'
option start_time '19:00'
option stop_time '21:00'
option rule_type 'allow'
config timeslot 'rule_sony_weekend'
option device 'sony_tv'
option weekdays 'Sat Sun'
option start_time '14:00'
option stop_time '18:00'
option rule_type 'allow'
luci-timecontrol/
├── Makefile # OpenWrt 包构建文件
├── build.sh # 独立构建脚本
├── README.md # 项目文档
└── root/ # 包文件内容
├── etc/
│ ├── config/
│ │ └── timecontrol # UCI 配置文件
│ └── init.d/
│ └── timecontrol # 系统服务脚本
└── usr/
├── lib/lua/luci/
│ ├── controller/
│ │ └── timecontrol.lua # LuCI 控制器
│ └── view/timecontrol/
│ └── main.htm # 主页面模板
└── share/luci/menu.d/
└── luci-app-timecontrol.json # LuCI 菜单配置
-
修改代码
# 编辑相关文件 vim root/usr/lib/lua/luci/view/timecontrol/main.htm vim root/etc/init.d/timecontrol -
测试构建
./build.sh
-
部署测试
# 快速部署到测试路由器 scp build/*.ipk root@test-router:/tmp/ ssh root@test-router 'opkg remove luci-app-timecontrol; opkg install /tmp/luci-app-timecontrol_*.ipk'
- Fork 本仓库
- 创建功能分支:
git checkout -b feature/new-feature - 提交更改:
git commit -am 'Add new feature' - 推送分支:
git push origin feature/new-feature - 创建 Pull Request
# 检查服务状态
/etc/init.d/timecontrol status
# 检查防火墙规则
nft list table inet fw4
# 重新加载规则
/etc/init.d/timecontrol reload本应用使用 raw_prerouting 链，优先级最高，应该不会与 PassWall、OpenClash 等代理软件冲突。如有冲突：
# 检查链的优先级
nft list chains
# 查看具体规则
nft list chain inet fw4 raw_prerouting- 确保使用现代浏览器
- 清除浏览器缓存
- 检查是否启用了 Argon 主题
# 在路由器上查看连接的设备
cat /proc/net/arp
cat /tmp/dhcp.leases# 启用调试日志
echo 1 > /sys/kernel/debug/nft_trace
# 查看 nftables 追踪
nft monitor trace
# 查看系统日志
logread | grep timecontrol本应用已在以下环境中测试验证：
- ✅ OpenWrt 24.10.1 (x86_64) - 主要测试环境
- ✅ OpenWrt 23.05.4 (ARM Cortex-A7) - 在树莓派上测试
- ✅ OpenWrt 23.05.2 (MediaTek MT7621) - 路由器测试
- 📺 智能电视 (Sony, LG, 小米)
- 📱 移动设备 (iPad, Android 平板)
- 🎮 游戏设备 (Nintendo Switch, PlayStation)
- 📻 流媒体设备 (Roku, Apple TV, 电视盒子)
- 🔄 与 PassWall 共存测试通过
- 🔄 与 OpenClash 共存测试通过
- 🔄 与 AdGuardHome 共存测试通过
- 🔄 多设备并发控制测试通过
欢迎大家：
- 🐛 报告 Bug
- 💡 提出功能建议
- 📝 完善文档
- 🔧 提交代码改进
- ⭐ 给项目点星支持
- 支持更细粒度的时间控制（精确到分钟）
- 添加流量统计功能
- 支持设备分组管理
- 增加访问白名单功能
- 开发移动端 App
本项目采用 MIT License 许可证。
🔒 隐私说明: 本应用仅在本地路由器上运行，不会收集或上传任何用户数据到外部服务器。所有配置和日志都保存在本地设备上。