先核对能不能用，再往下看。
网络端口
| 协议 | 端口 | 用途 | 方向 | 必需 | 备注 |
|---|---|---|---|---|---|
| TCP | 19500 | 本地配置服务：管理页 + REST API(/api/*) + 用户上传文件(/static/*) | 入站 | 是 | 端口被占用自动顺延重试；可在配置中修改 |
| TCP | 8080 | 用户内容服务器（可选）：对外提供指定目录静态文件 | 入站 | 否 | 仅 enableUserServer 开启后监听，端口可改 |
默认账号
管理后台
- 登录地址
- http://<本机IP>:19500
- 密码
- 已设置，请向 IFU 获取
- 默认状态
- 默认
- 备注
- 同一局域网浏览器直接访问；生产环境建议用防火墙限制来源网段，详见《4-高级配置》
退出保护
- 登录地址
- （应用内验证）
- 密码
- 已设置，请向 IFU 获取
- 默认状态
- 默认
- 备注
- 开启 preventExit 后退出应用需输入退出密码，可在管理页「安全设置」修改
FoxKiosk 是 Fox 系列里「管网页终端」的那一个。它装在自助终端、查询一体机或任何需要「只开一个网页」的设备上，开机即全屏加载指定的业务网址——政务查询、医院自助挂号、门店会员注册、展厅信息查询，都是它的典型现场。它不是一个浏览器：用户没有地址栏、没有多标签、没有退出按钮，能看到的只有业务页面本身。
它解决的是「网页当终端用，但终端不能失控」的问题。直接拿浏览器全屏开网页，用户按 F5 能刷新、右键能另存、Alt+F4 能跑出程序，运维得靠人盯。FoxKiosk 把这些口子全部收掉：右键菜单禁用、常见快捷键拦截、退出保护密码、窗口强制置顶，移动端还有屏幕固定与 Kiosk 锁定；业务页面出问题导致程序崩溃时，内置看门狗会在两秒内自动拉起，无人值守现场不需要人去重启。
所有管理能力都在一个内置的网页配置后台里。程序自带本地服务，现场在同一网络的任何手机或电脑打开浏览器，输入终端地址就能进入管理页：改主页网址、切屏幕方向、开关声音视频、设退出密码、传图片视频等业务资源、看系统日志、清缓存，全部页面化操作，不需要连线、不需要拆设备、不需要懂命令行。
业务页与管理端之间有双向通道。管理后台改完配置即时生效，不用重启终端；业务网页也可以通过内置的 JS 桥主动通知宿主程序——让终端重启、请求退出、上报业务日志，方便把「完成办理后自动返回首页」这类现场逻辑做进业务系统。
运行形态上是「轻壳重服务」：前台界面只有一层全屏 WebView，FoxKiosk 自身不出现在业务画面里，业务页面就是全部视觉；后台则内嵌完整的 HTTP 服务——配置接口、文件服务、日志查询都在本地闭环，离线现场功能完整，不依赖任何外部服务器。配置、上传的文件都落在设备本地，断网照常运行。
与同系列其它软件的边界很清楚：FoxDisplay 管大屏展示页面的编辑与发布，FoxPlayer 管视频节目单播放，FoxTimer 管会议计时，FoxAgent 管机器本身；FoxKiosk 只管「把网页安全地跑成终端」。需要大屏换欢迎页时用 Display，需要播视频时用 Player，需要「这台机器只能用我指定的网页」时，用 FoxKiosk。
它自己怎么跑，怎么接进来，怎么维护
FoxKiosk 装好后启动即全屏加载配置的主页网址——没有地址栏、没有标签页、没有系统边框，用户看到的只有业务页面本身。首次启动默认打开内置配置页，在「基础设置」里填入业务网址并保存，前台立即跳转，之后每次开机都直接进入业务页面。
运行时它在管三层事：一是跑网页——平台原生 WebView 全屏渲染，支持横竖屏切换、音视频开关与自定义 UA，缓存可开可清；二是守安全——右键禁用、常见快捷键拦截、窗口置顶、退出密码保护，移动端叠加屏幕固定 / Kiosk 锁定，程序自身崩溃由看门狗两秒内自动重启；三是供服务——本地 19500 端口常驻 HTTP 服务，管理页、配置接口、文件服务都在里面，局域网内浏览器直接可用。
管理入口在屏幕右上角 50×50 像素热区，长按即进入配置页；桌面端同时有系统托盘菜单（打开配置 / 重载应用 / 退出）。
要快速确认它在正常运行：看屏幕是否停在业务页面；或同一网络任意设备打开 http://<终端ip>:19500/api/network，返回 IP 与端口信息即在运行。管理页「系统日志」里每一步启动与接口调用都有记录。
单独用是这样：装上 → 配置页填业务网址 → 完事。安全管控与远程管理都是内置能力，不接任何外部系统也是完整可交付的自助终端。
配合业务系统是这样：业务网页就是全部界面，所以对接方式就是「把网页做好」。网页内可以通过内置 JS 桥向宿主发消息——restart 让终端重启、exit 请求退出（受退出密码约束）、log 上报业务日志；典型的「办理完成自动回首页」用网页自己的跳转逻辑即可。运维侧则可用 19500 的 REST API 做远程控制：/api/control/navigate 远程换页、/api/control/reload 远程刷新、/api/config 远程改配置，一台一地址，无需到现场。
需要本地素材是这样：业务页要用本机图片、视频或静态页时，从管理页「文件管理」上传，文件经 http://<终端ip>:19500/static/<文件路径> 直接可访问；批量资源打包成 zip 上传后可一键解压。有独立内容目录需求时，还可开启可选的「用户内容服务器」，把指定目录独立成站。
和兄弟软件的配合：机器级的开关机、音量、进程守护交给 FoxAgent；大屏欢迎与公告交给 FoxDisplay。FoxKiosk 只负责「这个屏只能用我指定的网页」，三者可在同一台设备各司其职。
接口在哪看：完整接口表、参数与示例见文档中心《FoxKiosk 集成与 API》与仓库 docs/PROTOCOL.md。本文只讲「怎么接」，不讲字段。
升级采用覆盖安装：Windows 重跑安装包或替换 Release 目录，Linux 重装 deb，macOS 替换 app，Android 覆盖安装 apk。配置存于系统应用数据（SharedPreferences），升级自动保留；上传的业务文件在用户文档目录 FoxKiosk/static/，升级不动它们。
日常看护围绕管理页做：局域网浏览器打开 http://<终端ip>:19500，「系统日志」页按级别、关键字过滤查最近 1000 条运行记录，可一键导出 JSON 给技术支持；「缓存管理」页看 WebView 缓存占用并一键清理；改配置即时生效，通常无需重启终端。
出问题时先看三处：一看前台是不是白屏（白屏先查网络与业务站本身，FoxKiosk 崩溃会自动重启而不是停在黑屏）；二看管理页「系统日志」里最后几条 ERROR（端口占用、URL 不可达都会写明）；三看端口——netstat 确认 19500 起来没有，被占用时程序会自动顺延端口，管理页「基础设置」能看到当前实际端口。
远程支持只需要终端在局域网内可达：支持人员浏览器进管理页即可改配置、传文件、看日志；需要彻底重置时，清空应用数据后重启即回到默认配置。全离线现场不受任何影响——所有管理能力都在终端本机闭环。
安装和使用中最常被问到的几件事
更细的排障步骤与参数说明在文档中心，注册登录后即可查看。