先核对能不能用，再往下看。
网络端口
| 协议 | 端口 | 用途 | 方向 | 必需 | 备注 |
|---|---|---|---|---|---|
| TCP | 42301 | HTTP 管理后台 + REST API(/api/v1/*) + WebSocket(/ws) 实时推送 | 入站 | 是 | 可在系统设置中修改，保存后服务自动切换新端口 |
| TCP | 42302 | JSON Lines 命令通道：每行一条 JSON 命令，中控长连接 | 入站 | 否 | 仅中控对接时需要 |
| UDP | 42303 | 单包命令 + 局域网发现应答(广播 discover) | 双向 | 否 | 关闭后无法被广播发现，需手动填 IP |
默认账号
管理后台
- 登录地址
- http://<本机IP>:42301
- 密码
- 已设置，请向 IFU 获取
- 默认状态
- 默认
- 备注
- 浏览器打开即用；如已设置访问密码，登录页输入即可，可在系统设置中修改或清除
命令通道
- 登录地址
- （无需登录）
- 密码
- 已设置，请向 IFU 获取
- 默认状态
- 默认
- 备注
- TCP 42302 / UDP 42303 面向内网中控，不做账号验证
FoxDisplay 是 Fox 系列里「管展示页面」的那一个。它装在大屏主机上，开机即全屏展示——欢迎领导莅临、欢迎贵宾到访、节日祝福、会议指引、通知公告，这些都由内置的 20 个现成模板提供，开箱就能用。它不是一个播放器，也不是网页全屏壳：展示的每一个页面都是一个可编辑的「场景」，页面上的标题、副标题、图标加文字的组合、实时时钟、装饰线条，都是可以被单独选中、移动、缩放和改写的元素。
它解决的是「大屏内容改起来麻烦」的问题。传统做法要么让设计每次出图换素材，要么给大屏配一台带设计软件的电脑。FoxDisplay 把这两件事都省了：在触摸屏上点一下配置角标，直接进编辑——点选文字块就地改字，拖动摆位，双指捏合缩放，色板换色；不想动手时，局域网内任何一台手机或电脑打开浏览器进入管理后台，同样能完成这些操作，保存后大屏立即刷新。到了现场，来的是哪路宾客，主机前三十秒就能把欢迎词改好。
典型场景有三类：一是单位门厅与展厅大屏，平时轮播欢迎与公告内容，有来访时快速换成对应欢迎页；二是会议室门口与会场大屏，显示会议进行中、茶歇时间等指引；三是节日场景，节前从模板库选出对应祝福页一键上屏。后台的资产中心还支持上传自有背景图与字体，让展示页与单位视觉规范保持一致。
它有三种使用方式，覆盖不同的人：现场人员用触摸屏直接改；管理人员用浏览器进管理后台（场景管理、模板库、资产中心、系统设置、运行日志齐全）；中控系统通过 TCP 长连接或 UDP 单包接口远程切换场景、修改文字，协议是统一的 JSON 格式，对接成本低。所有配置改动实时生效并落盘，大屏主机断电重启后自动恢复到最近的显示内容，无需人工干预。
运行形态上是「全屏无边框的常驻程序」：启动即进入 Kiosk 全屏，无系统边框干扰展示；系统托盘提供显示/全屏切换、打开管理后台与退出的入口；支持开机自启与单实例运行。管理后台本身内置于程序中，不依赖任何外部服务器，局域网内即可访问，离线现场照常使用。
与同系列其它软件的边界很清楚：FoxPlayer 管内容播放，FoxKiosk 管 Web 应用的运行环境，FoxTimer 管会议节奏，FoxAgent 管机器本身；FoxDisplay 只管「大屏上展示什么、怎么改」。需要大屏播视频节目单时用 Player，需要把整台机器变成网页终端时用 Kiosk，需要「把欢迎页换掉、把标题改对」时，用 FoxDisplay。
它自己怎么跑，怎么接进来，怎么维护
FoxDisplay 装好后启动即全屏无边框，直接进入上一次显示的场景——没有窗口边框、没有菜单栏，观感就是大屏内容本身。首次启动会展示内置的「欢迎领导莅临指导」模板；内置模板共 20 个，覆盖欢迎、节日、会议、公告四类场景。
运行时它在管三件事：一是展示——按当前场景渲染大屏画面，实时时钟、日期等元素自动刷新；二是听命令——同时监听 HTTP 42301（管理后台与接口）、TCP 42302（中控命令通道）、UDP 42303（单包命令与局域网发现）三个端口，任何一路收到切换或改字命令都立即生效；三是被配置——触摸屏上轻点会浮现配置角标，点进去就是触控编辑模式；浏览器访问 http://<大屏ip>:42301 则进入管理后台。
触摸编辑里没有传统菜单栏：点选任意元素，元素下方浮出一排工具（改字、字号、字体、颜色、对齐、图标位置、层级、删除）；左下角加号展开可添加元素、切换内置背景图库或上传图片；右侧抽屉打开模板库，每个模板都有真实缩略图预览，点一下即载入。右上角的保存按钮按下后，改动立即上屏并落盘。
要快速确认它在正常运行：轻触屏幕看配置角标是否浮现，或浏览器打开 http://<大屏ip>:42301/api/v1/health，返回「服务正常」即在运行；管理后台总览页还能看到运行时长、场景数量与三个端口的实时状态。
单独用是这样：装上、上电、完事。20 个内置模板加触屏编辑加浏览器后台，不接任何外部系统也能完成全部日常工作。
配合用是这样：现场的中控或业务系统负责「在正确的时机说正确的话」。典型用法是贵宾到达时中控下发一条切换命令，把大屏从默认页换成对应欢迎页；也可以只改一行文字（比如把来访单位名填进标题），页面其余部分不动。命令走 TCP 长连接（适合频繁控制的常驻对接）或 UDP 单包（适合轻量触发与广播发现），格式统一为 JSON，一条命令一个动作。局域网内广播 discover 还能自动列出网内所有 FoxDisplay 终端，多块大屏时不必逐台登记 IP。
和兄弟软件的配合：与 FoxAgent 同机部署很常见——Agent 管机器开关机与音量，Display 管屏幕内容，两者端口族不同（421xx 与 423xx），互不冲突；中控可以把「开机」发给 Agent、「换欢迎页」发给 Display。
接口在哪看：完整的命令表、统一返回格式、错误码与可运行示例，见文档中心《FoxDisplay 集成与 API》一篇；设计层细节见设计文档《命令协议》。本文只讲「怎么接」，不讲字段。
升级采用覆盖安装：Linux 直接替换安装新 deb 或新 AppImage；Windows 重新运行安装包即可。场景与设置存放在数据目录（scenes/、settings.json），升级不动它们，升级后显示内容原样保留。升级后建议打开管理后台总览页核对一次版本号与端口状态。
日常看护几乎不需要人盯：开机自启 + 单实例 + 断电自恢复三者保证「上电即工作」。偶尔要看状态时，管理后台总览页一屏给出三个端口是否在监听、当前场景、运行时长；「接口文档」页的运行日志每 3 秒自动刷新，每一条命令的处理结果（来源、命令名、成功与否）都在里面。
远程支持只需要两个条件：大屏在局域网内可达、浏览器能打开 http://<大屏ip>:42301。支持人员在任意位置进管理后台即可改内容、传背景与字体、看日志，无需到现场、无需远程桌面。若设置了访问密码，向现场要一次密码即可；全离线现场不受任何影响——所有功能都在局域网内闭环。
出问题时先看三处：一看大屏是否还在全屏（黑屏先查视频线与电源，程序问题不会黑屏——崩溃后重启会自动恢复场景）；二看后台总览页端口状态；三看运行日志里最后几条命令记录。多数「改了没生效」是改完没点保存，或浏览器打开的不是大屏本机地址。
安装和使用中最常被问到的几件事
更细的排障步骤与参数说明在文档中心，注册登录后即可查看。