FreeKiosk 安全体系全解:PIN锁、Lock Mode、阻塞覆盖层与看门狗自动恢复四层防护
FreeKiosk 安全体系全解:PIN锁、Lock Mode、阻塞覆盖层与看门狗自动恢复四层防护
FreeKiosk 是一款开源的 Android 安卓平板/电视 Kiosk 模式与设备锁定(Lockdown)应用,可作为 Fully Kiosk 的免费替代品,用于数字标牌、仪表盘、POS 与单用途设备。它的安全体系由四层组成:PBKDF2 加密存储的 PIN 锁、基于 Device Owner + Lock Task 的 Lock Mode 全屏锁定、可精确划定区域的阻塞覆盖层,以及进程被杀后自动恢复的看门狗服务。本文带你完整理解这四道防线是如何协作的。
1. 安全体系总览:四层防线各管什么
FreeKiosk 的 Kiosk 模式把任何网页或应用全屏接管后,需要解决四类问题:谁能改设置、用户怎么逃出去、误触怎么办、进程被杀谁来救。四层防线分别对应:
| 防线 | 核心机制 | 解决的问题 |
|---|---|---|
| 🔐 PIN 锁 | PBKDF2 哈希 + 暴力破解锁定 | 防止他人进入设置界面 |
| 🔒 Lock Mode | Device Owner + Lock Task 白名单 | 锁死系统导航、电源菜单等出口 |
| 🖐 阻塞覆盖层 | 悬浮窗拦截指定区域触摸 | 防止误触/触碰敏感按钮 |
| ⏰ 看门狗 | START_STICKY 前台服务 + 开机锁屏 | 进程崩溃或重启后自动恢复 |
💡 在 docs/features-and-modes.md 中,FreeKiosk 将锁定强度分为 Basic、Standard、Enterprise 三个等级,企业级(Device Owner full lockdown)才是面向生产环境公网设备的完整形态。
2. PIN 锁:不只是"记一个密码"
很多人以为 PIN 锁只是输入四个数字。FreeKiosk 的 PIN 实现(secureStorage.ts)在细节上相当讲究:
✅ 密码从不以明文保存
PIN 通过 PBKDF2(100,000 次迭代 + SHA-256 + 32 字节随机盐)哈希后,存入 Android Keystore(secureStorage.ts#L81-L125)。即使有人拿到设备存储,也反推不出原始 PIN。若设备的 Keystore 损坏(如部分 Rockchip 工控板,issue #200),会自动降级到 AsyncStorage 备用存储——但存的仍然是不可逆的哈希,绝不是明文。
✅ 防暴力破解锁定
- 默认最多尝试 5 次(可在设置中调整为 1–100)
- 超限后 锁定 15 分钟,期间输入正确 PIN 也无济于事
- 连续 1 小时无操作后,失败计数自动清零(secureStorage.ts#L22-L24)
✅ 堵住绕过入口
PIN 输入界面(PinScreen.tsx)拦截了 Android 硬件返回键——按返回不会"跳过"PIN,而是直接跳回 Kiosk 界面(issue #93)。退出 Lock Mode 的唯一合法路径是:5 次点击手势 + 正确 PIN,没有后门。
默认 PIN 是 1234,部署时请务必修改;PIN 也会同步一个哈希给 ADB 通道,保证命令行配置和界面配置一致。
3. Lock Mode:Device Owner 下的真正锁定
Lock Mode 是 FreeKiosk 安全体系的主体。开启后(设置 → SECURITY 标签页,见下图),FreeKiosk 通过 Android 的 Lock Task(屏幕钉住)机制把设备"钉"在白名单应用内:
白名单机制:只有白名单内的应用可以出现在前台。白名单在 MainActivity.kt#L609-L671 中动态构建,包含:
- FreeKiosk 自身
- 配置的外部锁定应用(external app 模式)
- 托管应用列表(managed apps)
- 按需加入:打印后台(启用
window.print()时)、系统拨号器(启用锁屏紧急呼叫时)、SystemUI(可选,用于放行 USB 调试授权弹窗,issue #268)
白名单之外的任何跳转——桌面、最近任务、设置、浏览器——全部被系统层面拒绝。
可精细控制的锁定开关(MainActivity.kt#L673-L759):
| 设置项 | 效果 | 默认 |
|---|---|---|
| Block Power Menu | 屏蔽长按电源键的重启/关机菜单 | 关 |
| Allow Notifications | 允许下拉通知栏(NFC 读卡场景需要) | 关 |
| Show System Info Bar | 显示不可交互的时间/电量状态栏 | 关 |
| System Screen-lock 兼容 | 熄屏后保留系统锁屏(PIN/图案) | 关 |
| Block Factory Reset | 阻止用户通过恢复模式重置设备 | 关 |
| Allow USB Debug Dialog | 锁定中放行"允许 USB 调试?"弹窗 | 关 |
⚠️ Device Owner 是完整锁定的前提:Lock Task 白名单 API 需要 Device Owner 权限。一次性命令即可设置(前提是设备上没有任何已登录用户账户):
adb shell dpm set-device-owner com.freekiosk/.DeviceAdminReceiver
没有 Device Owner 时,FreeKiosk 会降级为需要用户手动确认的屏幕钉住(screen pinning),锁定强度明显下降——这也是为什么部署文档反复强调"生产环境请设为 Device Owner"(详见 docs/adb-configuration.md)。另外,LockTaskCompat.kt 还处理了 Android 7 上 getLockTaskPackages API 缺失的兼容问题,保证 minSdk 24 的设备也能正常运行。
4. 开机零缝隙:BootLock 与 BOOT_COMPLETED
锁定还有一个容易被忽略的缝隙:开机到 Kiosk 界面加载完成之间的 1–2 分钟。在低配设备上,这段时间用户拥有完整的系统访问权(issue #98)。
FreeKiosk 的解法是一个纯原生(不依赖 React Native)的锁屏活动 BootLockActivity.kt:
- 开机广播触发后,1 秒内启动并立即进入 Lock Task,显示加载界面
- 每秒轮询一次,主界面(React Native)就绪后无缝交接(同一包名,锁定状态不中断)
- 独立看门狗线程(issue #222):主线程卡死时仍能恢复;超时 120 秒仍未就绪则释放锁定,避免设备"永远卡在加载页"(issue #243)
- 设备设有安全锁屏时,自动让位于系统锁屏,等用户解锁后再拉起 Kiosk(BootReceiver.kt#L99-L128)
5. 阻塞覆盖层:精确到区域的触摸拦截
Lock Mode 解决"逃不出去",阻塞覆盖层解决"点错了"。它的配置界面在设置 → Blocking Overlays(BlockingOverlaysScreen.tsx),核心实现在 BlockingOverlayManager.kt:
- 最多 10 个区域(
MAX_REGIONS = 10),坐标用屏幕百分比表示(0–100%),换不同分辨率的屏也不用重新调整 - 三种显示模式:完全透明(隐形拦截)、半透明灰(50%)、不透明深色——透明模式最适合"想挡住按钮但又不影响画面"的场景
- 按应用过滤:每个区域可指定
targetPackage,只有目标应用在前台时才生效(数据模型见 BlockingRegion.kt) - 实现原理是用
TYPE_APPLICATION_OVERLAY悬浮窗覆盖该区域并消费所有触摸事件,窗口外区域完全不受影响
典型用法:给数字标牌顶部的系统状态栏位置加一条透明拦截带,顾客再怎么"探索"也点不到隐藏功能。
6. 看门狗自动恢复:Kiosk 进程"死"了怎么办
公共场合运行的 Kiosk,最大的风险不是被攻破,而是进程消失——低内存设备上内核 OOM killer 随时可能杀掉浏览器进程(issue #96:2GB 内存的 Android TV 上真实发生过),用户会直接看到桌面。
KioskWatchdogService(KioskWatchdogService.kt)就是为此设计的看门狗,它是一个 START_STICKY 前台服务(自己被杀后 Android 也会重启它),核心行为:
- 每 10 秒检查一次 Kiosk 主界面是否还在前台
- 发现消失则自动重新拉起,且两次重拉之间至少间隔 15 秒(防止崩溃循环)
- 开机广播(BootReceiver)和主界面启动时都会确保它在运行
它还很"聪明",不会误伤合法场景:
- 熄屏待机时不做任何操作,亮屏(SCREEN_ON 广播)瞬间立即复查
- 外部应用模式 / 多应用模式下,白名单应用在前台不算"跑偏"(issue #282)
- 打印对话框、USB 调试弹窗(issue #268)在前台时跳过重拉,避免把系统弹窗顶掉
- 注册了云设备或 MQTT 时,还兼做 keep-alive:即使没有 Lock Mode,也能顶住 OEM 电池管理对后台进程的清理(issue #234),让远程心跳不断线
7. 部署建议:把四层防线都打开
✅ 一套推荐的公网 Kiosk 安全配置清单:
- 设为 Device Owner(一次性,解锁全部锁定能力)
- 修改默认 PIN 并确认 15 分钟锁定策略
- 开启 Lock Mode,并按需关闭电源菜单、禁用恢复模式
- 给易误触区域添加 透明阻塞覆盖层
- 确认看门狗通知存在(说明自动恢复已生效)
- 用配置备份功能(Backup/Restore)存档,方便批量部署时还原
四层防线各管一段:PIN 锁守住入口,Lock Mode 封死出口,阻塞覆盖层兜住误触,看门狗保证进程永远"活着"。配合 docs/features-and-modes.md 的模式选择指南和 docs/adb-configuration.md 的批量部署方案,一台普通 Android 平板就能变成真正"防君子也防小人"的数字标牌或单用途终端。

