在使用 ifu Agent 的过程中，下面 6 类问题出现频率最高。先自查再提问，能省下不少等待时间。
1. 为什么访问 /control 页面显示 404？
请检查 URL 是否正确。注意 URL 路径是小写的 /control。
另外，请确保服务已启动且版本是最新的（旧版本可能未包含此功能）。
2. 发送了关机命令，但电脑没有反应？
可能的原因有：
- 权限不足：前台模式下请确保当前用户具备关机权限（Windows 默认具备；Linux 需 root 或 polkit 授权）。
- MAC 地址不匹配：检查 JSON 请求中的
mac字段是否与本机 MAC 一致，或者尝试使用"mac": "all"进行测试。 - 防火墙拦截：检查防火墙是否放行了 42000/42001/42002 端口。
3. 音量/屏幕/键盘/鼠标/剪贴板命令返回"功能不可用"？
这些交互类功能需要交互式桌面会话：
- 服务模式不可用：系统服务运行于 Windows Session 0（或 Linux 无头会话），无法访问用户的交互桌面。请使用前台模式（默认安装方式）。
- Linux 依赖缺失：通过
GET /capabilities查看具体缺失原因——音量需要pactl、屏幕需要xset（仅 X11）、键盘/鼠标需要/dev/uinput权限、剪贴板需要xclip/xsel/wl-copy。
4. 浏览器提示 “Method not allowed”
这是因为您尝试直接在浏览器地址栏访问只允许 POST 请求的接口（如 / 根路径）。
- 如果要使用控制台，请访问
/control。 - 如果要进行健康检查，请访问
/health。 - 如果要查询功能能力，请访问
/capabilities。
5. 如何查看日志？
- Windows：默认在安装目录下的
logs文件夹中。 - Linux：如果使用 systemd，可以通过
journalctl -u ifuAgent查看实时日志，或查看/var/log/ifuAgent/下的文件。
日志文件按日期命名（ifuAgent_YYYY-MM-DD.log），超过 10MB 自动轮转（保留 3 份备份）。
6. 可以在公网使用吗？
极其不建议直接将服务暴露在公网。
本程序没有内置复杂的身份验证机制（仅 MAC 校验），暴露在公网极其危险。建议通过 VPN（如 WireGuard、Tailscale）接入局域网后使用。
相关阅读
- ifu Agent 是什么？—— 认识产品定位与核心功能。
- ifu Agent 安装部署与配置指南—— 排查时确认安装方式、运行模式与服务状态。
- ifu Agent 通信协议与 API 详解—— 确认请求报文格式是否正确。
