从安装到第一次跑起来
1. 环境要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10/11（64 位）；macOS 11+；Linux Debian/Ubuntu 系（需 WebKitGTK）；Android 5.0+；iOS 12+ |
| 硬件 | 2GB 内存以上；普通核显即可 |
| 网络 | 管理与文件服务全部本地闭环；业务页面按其自身需要访问网络 |
| 输入 | 触摸屏（推荐）或鼠标键盘（功能等价） |
2. 获取安装包
- 官网会员区：登录 ifu.me 会员区，在 FoxKiosk 软件页下载对应平台安装包。
- 联系获取：通过销售或技术支持获取。
- 文件形态：
FoxKiosk.exe（Windows 绿色版）/ MSIX、foxkiosk_<版本>_amd64.deb（Linux）、FoxKiosk.dmg（macOS）、app-release.apk（Android）、IPA（iOS，TestFlight / 企业分发）。
3. 安装步骤
3.1 Windows
- 解压发布包到任意目录（绿色版），或按向导安装 MSIX；
- 运行
FoxKiosk.exe，应用自动全屏启动。
3.2 macOS
- 打开
.dmg，将 FoxKiosk 拖入「应用程序」； - 首次启动如提示来源验证，右键 → 打开一次即可。
3.3 Linux（deb）
sudo dpkg -i foxkiosk_2.1.2_amd64.deb
安装后在应用菜单找到 FoxKiosk 启动。
3.4 Android
侧载安装 app-release.apk；如需 Kiosk 锁定，在系统设置中将其设为屏幕固定应用或设备所有者。
3.5 iOS
经 TestFlight 邀请或企业证书分发安装。
4. 首次启动
启动后进入全屏画面，默认加载内置配置页（主页地址默认指向本机配置服务）。屏幕右上角有一个隐形的 50×50 管理热区，长按可随时回到配置页——现场误入业务页后，这就是管理入口。
5. 跑通第一步（3 分钟）
- 进配置：启动后长按屏幕右上角 → 配置页；
- 填主页：「基础设置」→ 主页 URL 填入业务网址（如
https://www.example.com）→ 保存； - 看前台：前台 WebView 立即跳转到业务页面，全屏显示；
- 回管理：长按右上角热区回到配置页，随时可改；
- 试远程：同一 Wi-Fi 下用手机浏览器打开
http://<终端IP>:19500——同样进入配置页，这就是日常远程管理方式。
6. 常见安装失败
| 现象 | 原因 | 处理 |
|---|---|---|
| Windows 提示缺 WebView2 | 未装 WebView2 Runtime | 安装 WebView2 Runtime 后重试 |
| Linux 启动报 WebKitGTK 缺失 | 缺依赖 | sudo apt -f install，或确认已装 libwebkit2gtk |
| 启动后提示端口占用 | 19500 被其他程序占用 | 程序会自动顺延端口重试；确认实际端口见管理页「基础设置」 |
| 管理页打不开（远程） | 不在同一网段 / IP 不对 | 在终端上确认本机 IP（/api/network 也可查）；ping 连通后再访问 |
| 业务页白屏 | 业务站不可达或证书异常 | 先在普通浏览器验证该网址；HTTPS 证书无效会被 WebView 拦截 |
7. 下一步
- 管理页六个模块逐个讲 → 《使用手册》
- 配置字段、用户内容服务器、安全加固 → 《高级配置》
- REST API 与 JS 桥 → 《集成与 API》
扫码在手机上打开，再用微信右上角的「···」发送给朋友或分享到朋友圈。