从安装到第一次跑起来
1. 环境要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10/11（64 位，NSIS 安装包）；Linux 桌面发行版（deb 包适用于 Debian/Ubuntu 系，含 UOS / Deepin；AppImage 通用） |
| 硬件 | 4GB 内存以上；普通核显即可（渲染为矢量与位图合成，无视频解码压力） |
| 显示器 | 大屏或触摸一体机，推荐 1920×1080；其他分辨率按比例自适应（内容自动撑满屏幕） |
| 网络 | 不需要公网；局域网内如需浏览器后台或中控对接，大屏与使用设备需同网段互通 |
| 输入 | 触摸屏（推荐，支持现场直接编辑）或鼠标键盘（功能等价） |
2. 获取安装包
- 官网会员区：登录 ifu.me 会员区，在 FoxDisplay 软件页下载（未登录仅显示注册引导）。
- 联系获取：通过销售或技术支持获取对应平台的安装包。
- 文件形态：
foxdisplay_<版本>_amd64.deb（Linux 安装包）、FoxDisplay-<版本>.AppImage（Linux 绿色版）、FoxDisplay-Setup-V<版本>.exe（Windows，计划中）。
3. 安装步骤
3.1 Linux（deb，推荐用于 UOS/Deepin 等国产桌面）
- 将 deb 包拷贝到大屏主机；
- 双击安装，或在终端执行
sudo dpkg -i foxdisplay_1.2.1_amd64.deb； - 安装完成后在应用列表找到 FoxDisplay 启动，或直接执行
foxdisplay。
3.2 Linux（AppImage，绿色免安装）
- 下载
FoxDisplay-1.2.1.AppImage； chmod +x FoxDisplay-1.2.1.AppImage后直接运行，无需安装、不写系统目录。
3.3 Windows（NSIS 安装包）
- 双击
FoxDisplay-Setup-V1.2.1.exe； - 可选择安装目录，其余默认；完成后从桌面快捷方式启动。
三种形态行为完全一致：启动即全屏展示。首次运行会显示内置「欢迎领导莅临指导」模板。
4. 首次启动
启动后进入全屏无边框的大屏画面——这就是展示态。屏幕上默认没有按钮；轻触屏幕（或移动鼠标）右下角会浮现「配置」角标，几秒无操作自动淡出。右上角（Linux）或托盘里有退出与全屏/窗口化切换入口。
5. 跑通第一步（5 分钟）
- 进编辑：轻触屏幕 → 点右下角「配置」角标 → 进入编辑模式；
- 改标题：双击大标题文字 → 文字上出现编辑框 → 输入新的欢迎词 → 点下方「✓ 完成」；
- 换背景：点左下角绿色「＋」→「内置图库」→ 点任意一张缩略图，背景立即切换；
- 保存：点右上角「保存」（绿色按钮）→ 提示「已保存并应用到大屏」；
- 看结果：点左上「‹ 返回」回到展示态——大屏已是新内容。重启程序，内容依旧（已落盘）。
6. 常见安装失败
| 现象 | 原因 | 处理 |
|---|---|---|
| Linux 双击 deb 无反应 | 缺依赖 | 终端执行 sudo apt -f install 后重试 |
| AppImage 双击无反应 | 缺 FUSE | sudo apt install libfuse2，或改用 deb 包 |
| 启动后白屏或立即退出 | 显卡驱动过旧，不支持 GPU 合成 | 更新显卡驱动；或在驱动较旧的机器上使用软件渲染启动 |
| 42301 端口被占用，提示服务启动失败 | 其他程序占了端口 | 在系统设置中更换端口（或改配置文件后重启）；占用程序处理后可改回 |
| 浏览器打不开管理后台 | 不在同一网段 / IP 不对 | 在大屏上确认本机 IP；ping 连通后再访问 http://<大屏IP>:42301 |
7. 下一步
- 了解全部编辑功能 → 《使用手册》
- 局域网浏览器后台、字体上传、访问密码 → 《高级配置》
- 中控对接、命令清单 → 《集成与 API》
扫码在手机上打开，再用微信右上角的「···」发送给朋友或分享到朋友圈。