19HomeAssistant 如何清除或者删除传感器的历史记录，减少硬盘空间，小白教程

admin

在最新版本中，Home Assistant 将原本的“服务 (Services)”更名为**“动作 (Actions)”**，请务必注意这一界面变化。

以下提供三种方法，由浅入深，小白建议优先使用 方法一。

---

方法一：手动清除（最安全、最推荐）

这个方法是通过 Home Assistant 自带的工具来清理旧数据，不会误删配置，适合觉得最近硬盘空间不够用，想立刻释放空间的情况。

• 进入开发者工具：
  在左侧菜单栏点击 “开发者工具 (Developer Tools)”。

• 切换到“动作”标签页：
  在顶部菜单中，点击 “动作 (Actions)”（旧版本叫“服务”）。

• 搜索清理动作：
  在搜索框中输入 recorder.purge，点击出现的 “Recorder: Purge”。

• 设置清理参数：

  • Keep days (保留天数)：输入你想保留最近几天的历史。例如输入 7，表示只保留最近 7 天的数据，7 天以前的全部删除。

  • Repack (重组数据库)：一定要勾选这个！

    • 解释：如果不勾选，数据虽然被标记为删除，但数据库文件大小往往不会变小（类似电脑的回收站）。勾选后才会真正压缩文件，释放硬盘空间。

      
      

  • Apply filter (应用过滤器)：一般不勾选。

    • 解释：如果你只想删除特定几个传感器的历史，可以勾选这个并在下方添加实体 ID，但为了释放空间，通常是全量清理，所以不勾选。

      
      
    
    

• 执行清理：
  点击绿色的 “执行动作 (Perform Action)” 按钮。

  • 注意：点击后界面不会有明显提示“完成”，但后台已经开始工作了。如果你的数据库很大（比如几个 GB），这个过程可能需要几分钟甚至更久，请耐心等待，不要重复点击。

    
    
  
  

---

方法二：自动维护（一劳永逸）

如果不想每次都手动删，可以通过修改配置文件，让 Home Assistant 每天自动清理过期的记录。

• 安装/打开 File Editor：
  确保你安装了 "File Editor" 或 "Studio Code Server" 插件来编辑配置文件。[2]

• 编辑 ：
  打开 /config/configuration.yaml 文件。

• 添加/修改 Recorder 配置：
  在文件中找到 recorder: 字段（如果没有就手动从新的一行添加）。复制以下内容：

  codeYaml
  
  recorder:  # 每天自动清理，只保留最近 10 天的数据（根据你的硬盘大小调整，SD卡建议 5-7 天）  purge_keep_days: 10  # 开启自动重组，确保存储空间被真正释放  auto_repack: true  # (可选) 如果你想彻底屏蔽某些传感器不记录历史，可以在这里排除  exclude:    domains:      - automation # 不记录自动化的触发历史[[2](https://www.google.com/url?sa=E& ... srKq4QLabC2gz5Hc%3D)][[3](https://www.google.com/url?sa=E& ... 8aA_Nc8tiqrRtKis%3D)]      - update     # 不记录更新实体的历史    entities:      - sensor.date # 不记录日期变化[[2](https://www.google.com/url?sa=E& ... srKq4QLabC2gz5Hc%3D)][[3](https://www.google.com/url?sa=E& ... 8aA_Nc8tiqrRtKis%3D)]      - sensor.time # 不记录每分钟的时间变化（这个非常占空间！）```[[2](https://www.google.com/url?sa=E& ... srKq4QLabC2gz5Hc%3D)][[3](https://www.google.com/url?sa=E& ... 8aA_Nc8tiqrRtKis%3D)]
  
  
  
  

• 重启系统：
  保存文件后，去 设置 -> 系统 ->在此右上角点击重启 Home Assistant 以使配置生效。

  
  

---

方法三：核弹级清理（彻底重置）

如果你的数据库文件 (home-assistant_v2.db) 已经损坏，或者大到几十 GB 且上述方法无效，可以直接删除它。后果是你会失去所有的历史记录图表（变成空白），但设备配置和自动化都不会丢失。

• 停止 Home Assistant：

  • 进入 开发者工具 -> YAML，点击 “检查配置” 确保没报错。

  • 你需要通过 SSH 或者宿主机终端操作。输入命令：ha core stop (如果是 HAOS)。

  • 小白替代方案：直接在网页端点 重启，在重启还没完成的一瞬间（网页失去连接时），去执行第 2 步，但不够安全。推荐安装 "Terminal & SSH" 插件来操作。

    
    

• 删除数据库文件：
  使用 File Editor 或 Samba 访问 /config 文件夹。
  找到名为 home-assistant_v2.db 的文件，直接删除。

• 重启电源/系统：
  拔掉电源重插，或者在终端输入 ha core start。
  系统启动后会自动创建一个全新的、只有几 KB 大小的空数据库文件。

  
  

---

如何验证空间是否减少？

• 清理前：去 设置 (Settings) -> 系统 (System) -> 存储 (Storage)，查看当前磁盘使用率。

• 执行“方法一”或“方法三”后：等待约 5-10 分钟（让系统完成压缩），再次回到存储页面，你会发现“使用量”明显下降。