screenpipe 本地数据（~/.screenpipe）如何备份到外置盘或 NAS？
screenpipe 本地数据~/.screenpipe如何备份到外置盘或 NAS【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipescreenpipe 默认是 local-first 的屏幕、音频、转录和检索数据都写在本机的~/.screenpipe/目录下长期积累后文档给出的参考基线是 1 FPS 下约 30 GB/月你可能会想把这份数据存到外置盘或 NAS 上做长期保存。官方文档给出的做法是退出 screenpipe 后把~/.screenpipe/整个复制到外部存储备份保持加密并先测试一次恢复再依赖它同时明确警告不要把慢速或不稳定的网络盘当作实时数据库路径使用——NAS 适合作备份目的地不适合作正在写入的数据库位置。先确认备份对象~/.screenpipe/ 里有什么根据 privacy data flow 文档 和 FAQ默认数据位置及内容为内容位置screenpipe 数据根目录~/.screenpipe/录制的屏幕与音频媒体~/.screenpipe/data/元数据库SQLitemetadata、accessibility 文本、OCR 回退文本、转录~/.screenpipe/db.sqlite已安装的 pipes~/.screenpipe/pipes/文档还提到 connections 优先存在 secure store 中遗留的~/.screenpipe/connections.json作为 fallback。也就是说只要整目录复制就能覆盖屏幕、音频和转录这三类主要内容。备份步骤主路径完全退出 screenpipe。这是文档明确的前置条件quit screenpipe before copying~/.screenpipe/。如果应用还在运行数据库处于活跃写入状态复制出来的副本可能不一致。把整个~/.screenpipe/目录复制到外置盘或 NAS 上的目标位置。可以用系统自带的文件复制方式完成以文档中出现的外置盘路径/Volumes/MyDrive/为例macOS/Linux 下可以这样复制cp -a ~/.screenpipe /Volumes/MyDrive/这是示例命令目标位置换成你实际挂载的外置盘或 NAS 路径即可。-a用于保留目录结构和权限如果你用文件管理器或 NAS 客户端复制整个目录效果等同。保持备份加密。文档原话是 keep the backup encrypted。备份中包含你的屏幕内容、音频和转录文本属于敏感数据加密工具文档没有指定由你按所在环境的既有加密方案选择。测试一次恢复见下节文档要求 test a restore before relying on it。验证备份可用做一次恢复演练文档对恢复的要求是test that it can be restored而没有给出独立的恢复脚本。结合 privacy data flow 文档 中changing your storage location一节说明的机制可以按下面的路径验证副本完好把备份副本从外置盘/NAS 拷回本机某个测试位置例如/Volumes/MyDrive/.screenpipe/拷回本地。启动 screenpipe 前设置环境变量让它读取副本而不是默认目录export SCREENPIPE_DATA_DIR/路径/恢复出来的/.screenpipe将上面的路径替换为你实际存放副本的目录。文档中给出的用法示例是SCREENPIPE_DATA_DIR/Volumes/MyDrive/.screenpipe。启动 screenpipe 后用文档中的本地 API 检查数据是否可读curl http://localhost:3030/health curl http://localhost:3030/search?limit5content_typeallhealth返回正常、search能返回历史记录说明这个副本可以被 screenpipe 正常读取。验证完成后取消该环境变量并重启让应用回到默认目录。两点来自文档的注意事项如果换了SCREENPIPE_DATA_DIR后 pipes 仍读写默认位置检查 screenpipe 主程序是否完全重启过、CLI 或计划任务是否使用了同一个SCREENPIPE_DATA_DIR值、桌面端设置是否已保存并重启。验证完一定要切回默认目录否则日常数据会继续写入副本位置。可选把数据目录整体迁到外置存储如果你希望长期数据直接落在外置盘上privacy data flow 文档 给出了迁移步骤退出 screenpipe → 复制~/.screenpipe/到新位置 → 启动前设置SCREENPIPE_DATA_DIR→ 重启。但要明确文档给出的边界do not use a slow or unreliable network drive as the live database pathtroubleshooting 与 privacy 两篇文档都重申了这一点。外置 USB 盘如果连接稳定可以承载运行数据NAS 这类网络盘在文档中的定位是备份目的地慢速或不稳定的网络存储can make the app feel broken or risk corruption。所以稳妥的分工是运行库留在可靠的本地磁盘外置盘/NAS 只存加密副本。与删除/清理操作的配合文档中有几处提醒备份要走在删除前面值得纳入同一套习惯删除时间范围不可恢复。api-recipes 中/data/delete-range的说明是 data deletion is permanent; make a reviewed backup before deleting a range or deviceretention 清理同样写着 back up anything you need before cleanup because deleted ranges are not recoverable。缩短保留期之前先备份。FAQ 建议在 shorten local retention 之前完成 any backup you need。删除后可以用compact database把未用空间归还给操作系统FAQ 与 troubleshooting 均有此步骤。参考文档备份到外置盘/NAS 的直接依据troubleshooting.mdxcan I store data on a NAS or external drive? 一节数据位置、SCREENPIPE_DATA_DIR迁移与备份注意事项privacy-data-flow.mdx目录内容与存储 FAQfaq.mdx数据库与媒体文件的具体位置architecture.mdx【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考