文档

FreeKiosk 文档

部署和配置自助终端所需的一切

概述

FreeKiosk 是一款免费的开源应用,可将 Android 平板电脑变成安全的自助终端,全屏显示单个网站或 Web 应用。非常适合信息显示屏、POS 系统、数字标牌和公共服务终端。

主要功能

  • 全屏 WebView 或外部应用
  • REST API(40 多个端点)
  • URL 轮换与计划
  • 完全锁定设备

要求

  • Android 8.0+(Oreo)
  • 网络连接
  • ADB(用于 Device Owner)

安装

基础安装

  1. 1

    下载 APK

    从我们的下载页面或 Google Play 商店获取

  2. 2

    传输到设备

    通过 USB、电子邮件或直接下载

  3. 3

    安装应用

    如有需要,请在“设置 > 安全”中启用“未知来源”

  4. 4

    打开 FreeKiosk

    配置您的 URL 和设置

下载 FreeKiosk

Device Owner 模式

为什么需要 Device Owner?

Device Owner 模式可实现完全锁定:没有状态栏、没有通知、没有导航按钮,崩溃后自动重启,用户也无法退出自助终端。

要求

  • 设备已恢复出厂设置(未添加 Google 账号)
  • 电脑上已安装 ADB
  • 设备已启用 USB 调试
  • 已安装 FreeKiosk

分步设置

第 1 步:恢复出厂设置

前往设置 → 系统 → 重置选项 → 清除所有数据

初始设置期间请勿添加 Google 账号。跳过所有账号创建步骤。

第 2 步:启用开发者选项
  1. 前往设置 → 关于平板电脑
  2. 连续点按版本号 7 次
  3. 返回设置 → 开发者选项
  4. 启用USB 调试
第 3 步:安装 FreeKiosk

通过 USB 传输、网页下载或 SD 卡安装 APK。请确保在运行 ADB 命令之前已安装该应用。

第 4 步:设置 Device Owner

通过 USB 连接平板电脑并运行:

adb shell dpm set-device-owner com.freekiosk/.DeviceAdminReceiver

您应该会看到: Success: Device owner set

移除 Device Owner 模式

要移除 Device Owner 状态,请前往FreeKiosk 设置 → 移除 Device Owner,或运行:

adb shell dpm remove-active-admin com.freekiosk/.DeviceAdminReceiver

基础配置(快速入门)

1您的 URL

平板电脑将始终显示的 URL。

https://freekiosk.app

2PIN 码

用于进入设置的 4-6 位 PIN 码。

3推荐模式

用途模式屏幕固定
🌐 网页WebView✅ 启用
📺 外部应用外部应用✅ 启用
🧪 测试 / 演示WebView❌ 禁用

4基本设置

选项推荐值
全屏✅ 启用
开机自动启动✅ 启用
隐藏状态栏✅ 启用
屏幕超时从不(或通过屏幕保护程序)
亮度50-70%

5REST API(可选)

通过 Home Assistant 控制您的平板电脑。

更多详情请参阅API 文档。

功能

完全锁定

没有 PIN 码无法退出

REST API

40 多个端点,适用于 Home Assistant

URL 轮换与计划

按时间/日期循环或安排 URL

外部应用模式

锁定任意 Android 应用

媒体播放器

视频和图片轮播的数字标牌

MQTT 与 Home Assistant

原生 MQTT 自动发现

云端管理

注册并控制整个设备群组

现代化界面

按选项卡分类的设置

FreeKiosk Cloud(远程管理)

运行不止一台自助终端?FreeKiosk Cloud 是我们可选的 SaaS 控制台,用于远程监控、控制和更新整个设备群组。没有它,应用也能完美运行;但注册设备后,即可使用实时监控、远程命令、分组、警报和远程截图。

首台设备永久免费

创建账号并免费注册您的首台设备,无需绑定银行卡。请参阅价格。

注册设备

1

创建您的组织

在 cloud.freekiosk.app 上注册账号并选择设备数量。

2

生成注册令牌

在控制台中打开“添加设备”,获取一次性注册令牌。

3

在平板电脑上输入

在 FreeKiosk 设置中打开“高级”选项卡,然后进入“云端管理”,粘贴服务器 URL 和令牌。

4

设备出现在您的设备群组中

设备几秒钟内即可完成注册,并每 30 秒发送一次包含其状态的心跳。

您可以通过 Cloud 做什么

实时状态:电量、网络、存储、屏幕
远程命令(重新加载、重启、截图……)
支持批量操作的设备分组
配置文件(URL、亮度、音量)
通过电子邮件、Webhook 和推送发送警报
远程截图与活动日志(CSV)
了解 FreeKiosk Cloud

故障排除

Device Owner 命令执行失败

请确保设备已恢复出厂设置且未添加 Google 账号。在“设置 → 账号”中移除所有账号。

ADB 找不到设备

启用 USB 调试,换一根 USB 数据线试试,并在电脑上安装设备驱动程序。

自助终端显示白屏

检查 URL 是否正确且可以访问。可先在 Chrome 中尝试加载该 URL。

无法退出自助终端模式

在屏幕任意位置快速点按 5 次(默认手势),即可调出 PIN 码界面。

需要更多帮助?

查看我们的常见问题,或在 GitHub 上提交 issue