Repository navigation
Releases
v1.1.2
飞牛 fnOS v1.1.2
修复两个稳定性问题,其中 Core 崩溃隐患由 @zxs1216 报告并定位。
1. 事件回调缺 @callback,可能导致 Core 崩溃(感谢 @zxs1216)
sensor.fnos_all_entities 的三个 bus.async_listen 处理函数是普通同步函数,HA 会把它们放到 Executor 线程执行;回调里调用 async_call_later() 属于跨线程操作事件循环,日志出现 HassJobType.Executor 报错,严重时 RuntimeError: list changed size during iteration 导致整机重启。现已补 @callback,并复核全部注册点。
@zxs1216 实测:修复后 Executor 报错 0 次、崩溃 0 次,实体刷新正常。
2. 空闲回收定时器参数错位
async_track_time_interval 会把时间作为第一个参数传给回调,原写法收到的是 datetime 而非 hass,每 5 分钟刷一条 AttributeError。已改为闭包包装 + @callback。
其它(1.1.0 / 1.1.1 累积)
- 对 NAS 请求减少约 2/3(分层 TTL 缓存、无独显/无风扇跳过、下载中心负缓存)
- 写入更少:远程/控制台地址改事件驱动、聚合实体按变化重写、相册改按需拉取
- 单位固定(KB/s、MB/s、GB),不再出现「单位已改变」告警
- 单个接口失败沿用上一轮数据;集成可正常重载,不再要求重启
- 新增诊断下载与回调类型回归测试
升级:HACS 更新到 1.1.2 后重启一次 HA;确认日志中不再出现上述两类报错即可。
感谢 @zxs1216 的完整分析,本次崩溃修复基于他的 Issue。
V1.0.1
v1.0.0
一、功能
1. 系统监控(主机设备)
| 类别 | 实体 |
|---|---|
| 性能 | CPU 使用率、内存使用率、内存已用/总量、GPU 使用率、风扇转速(含 CPU 温度、风扇模式属性) |
| 网络 | 网络下载速率、网络上传速率、网卡数量(含网卡明细属性) |
| 磁盘 | 磁盘读取速率、磁盘写入速率、硬盘数量、异常硬盘数量、HDD/SSD/USB 数量、硬盘健康状态、存储池 |
| 存储 | 存储总容量、存储已用容量、存储可用容量 |
| 系统 | 系统版本、系统更新、运行时长、本次运行开始时间、未读通知、登录设备、证书数量 |
| 应用 | 应用状态、Docker 容器(汇总)、虚拟机(汇总)、运行中容器、运行中虚拟机、下载中心活动任务/上行/下行、外部访问域名、FN Connect |
| 硬件 | 硬件信息(CPU 型号、核心数、主板、序列号等,JSON 属性) |
| 操作 | 重启、关机(按钮);远程控制总开关、SSH/SMB/NFS/FTP/WebDAV/DLNA/防火墙(开关);有可用系统更新、硬盘健康异常(二进制传感器) |
2. Docker 容器(每个容器一个设备)
- 传感器:运行状态(含镜像、ID、端口、项目、命令、网络模式、创建时间属性)、CPU 使用率、内存用量、网络收发
- 开关:容器电源(启动 / 停止)
- 按钮:重启容器
- 设备「访问」:容器映射端口聚合的访问链接页
容器新增/删除会自动跟随(60 秒一次增量补齐,不会漏也不能重复建)。
3. 虚拟机(每台虚拟机一个设备)
- 传感器:电源状态(含 CPU/内存/OS/IP 属性)、IP 地址、vCPU 数量、内存容量、芯片组、固件、显卡、磁盘容量、MAC 地址、操作系统、控制台地址
- 开关:电源(开机 / 软关机,带乐观状态,按下立即反馈)
- 按钮:重启、强制关机
- 支持远程控制:直接在 HA 里打开虚拟机的实时画面(键盘鼠标可用),详见下节
4. 虚拟机远程控制
不用装客户端、不用开 fnOS 桌面,在 HA 里就能远程操作虚拟机(等同 fnOS 虚拟机 App 的「控制台」):
- 打开方式:虚拟机设备的「访问」按钮 → 虚拟机详情页(信息/硬件/磁盘/网络/快照/CPU 曲线)→ 点「打开控制台」;也可以直接使用该设备的「控制台地址」传感器属性里的
url - 实时画面:控制台是真实的 noVNC 会话,走 HA 同源反代(HTTP + WebSocket 双向透传),键盘、鼠标、剪贴板可用,画面随虚拟机实时刷新
- 前端悬浮窗内打开:可拖动、可缩放到全屏,多台虚拟机可各开一个窗口互不替换
- 总开关
switch.fnos_remote_control(远程控制):默认开启、状态持久化(HA 重启后保持上次选择),所有虚拟机共用;关闭后- 新建控制台页面 / VNC 数据连接一律拒绝(403)
- 立即切断已建立的所有控制台会话,不等浏览器超时
- 「控制台地址」传感器不再外泄链接,详情页「打开控制台」置灰
- 开关属性里可看到「活动控制台连接」数
- 友好提示:虚拟机关机时打开控制台会给出提示页并可一键开机(避免黑屏或连接失败)
- 链接有效期:签名链接 24 小时有效,集成每 12 小时自动重签,重启 HA 后也会自动重签,无需手动处理
5. 文件 / 相册 / 影视应用
- 文件:最近文件数、收藏文件数、回收站文件数、分享链接数
- 相册:最近添加(JSON 属性带 60 张原图地址)、相册服务可用性
- 影视:影视服务可用性
- 每个设备都有「访问」链接与独立悬浮窗页面(文件管理器可浏览/下载/上传;相册照片墙可看大图)
6. 远程访问地址(跟随浏览器地址栏)
- 每个设备的「访问」按钮指向 HA 侧签名页面
/fnos/web?entry=..&target=..,与「远程地址」传感器读同一个字段,两处永远一致 - 基地址优先级:集成选项里显式填写的地址 → 浏览器心跳上报的 origin(自动跟随端口转发/反代的访问地址)→ HA 外部地址 → 内部地址
- fnOS 整站经 HA 同源反代(HTTP + WebSocket),前端模块拦截「访问」点击并在页面内弹出可拖动、可缩放的悬浮窗,不同 target 可同时打开
7. 聚合实体 sensor.fnos_all_entities
一个实体装下整台 NAS 的目录,供前端卡片一屏渲染:
- state:fnOS 实体总数(不含自身与禁用实体)
- 属性
groups[]:一台设备一个节点,{key, name, kind, label, count, entities[]},其中entities[]每项为{entity_id, name, state, icon} - 容器/虚拟机/应用增减后自动出现在列表里(注册表变化 1 秒防抖、状态变化 5 秒合并、30 秒轮询兜底)
- 大属性默认不写入 recorder(绕开单实体属性 16384 字节上限)。若连状态也不要入库:
recorder:
exclude:
entities:
- sensor.fnos_all_entities8. 固定英文实体 ID
显示名是中文,但 entity_id 统一为短英文,方便写模板/前端:
sensor.fnos_cpu # 主机 CPU
sensor.fnos_storage_total # 存储总容量
switch.fnos_ssh # SSH 服务
switch.fnos_remote_control # 远程控制总开关
button.fnos_reboot # 重启
sensor.fnos_docker_nginx_state # Docker 容器 nginx 状态
sensor.fnos_vm_windows_10_state # 虚拟机(标题)状态
sensor.fnos_all_entities # 聚合实体
配置多个 fnOS 条目时会插入条目段(如 sensor.fnos_192_168_1_10_cpu)避免抢号;旧版本生成的拼音 ID 会自动迁移到新 ID(唯一 ID / 历史 / 统计保留)。