告别"文件在哪来着"：Spacedrive 跨设备文件管理上手指南
【免费下载链接】spacedriveSpacedrive is an open source cross-platform file explorer, powered by a virtual distributed filesystem written in Rust.项目地址: https://gitcode.com/gh_mirrors/sp/spacedrive
你换过电脑、接过移动硬盘、搬过 NAS，文件却越攒越难找：每台设备各存一份，搜索只能一台一台翻。Spacedrive 是一个开源跨平台文件管理器，你的文件留在原地，它只在本地建立索引，让同一批资料在多台设备间被统一搜索、浏览和同步。照着这篇做，你能把现有文件夹接入 Spacedrive，配好索引策略，并让两台设备开始协作。
先搞懂这几个概念
| 概念 | 一句话说明 | 生活化类比 |
|---|---|---|
| Library（库） | 记录你的设备、来源和策略的总控 | 一个储物间的钥匙扣 |
| Source（来源） | 对一个文件夹或整块硬盘的持续索引 | 给一个房间做的目录卡片柜 |
| Pin（置顶） | 侧边栏快捷入口，不产生新索引 | 目录卡上贴的便利贴 |
| 内容身份 | 证明多处副本的内容是否相同 | 给文件按指纹 |
一次性准备
- 在每台要用的设备上安装 Spacedrive：下载发行版直接装，无需注册账号
- 想从源码构建：先备好 bun 和 Rust 工具链，然后克隆仓库初始化
git clone https://gitcode.com/gh_mirrors/sp/spacedrive cd spacedrive just setup just dev-desktop- 打开应用，确认本地 daemon 已自动启动（关窗口不会停后台任务）
- 创建第一个Library，起名如 Personal
- 确认要接入的文件夹对当前账号可读
把现有文件接进来
添加第一个来源
打开侧边栏Sources，点Track source，选中一个文件夹或挂载好的移动硬盘。Spacedrive 会遍历该目录、记录结构与元数据，并靠文件系统事件保持更新——不移动、不改写你的任何文件。同一操作也可以用 CLI 完成：
sd-cli start sd-cli library create Personal sd-cli sources track ~/Documents sd-cli sources list sd-cli job list等首次索引跑完
来源会立刻出现在列表里，索引任务在后台分批写入。用sd-cli job list或界面里的任务面板观察进度即可，关窗口不影响 daemon 继续跑。
收紧或放开捕获策略
普通文件夹直接用默认策略，它会自动跳过系统噪音和构建产物。归档存储需要记录每一个可读对象时，改用无过滤捕获：sd-cli sources track /Volumes/Archive --unfiltered。策略放宽后，会为之前跳过的路径补一轮遍历。
给常用目录加 Pin
在路径栏对某个文件夹选Pin this folder，它会出现在侧边栏Pinned下。Pin 只是快捷方式，索引和监视由所属来源负责，不会重复扫描。来源与 Pin 的分工细节见 docs/overview/add-sources-and-pins.mdx。
按你的场景调配置 ⚙️
照片库
source: ~/Pictures policy: default # 跳过系统噪音 exif: on # 拍摄时间、相机、GPS 入库 watcher: on图片被识别后，元数据会抽读取样，重复内容再逐字节校验；拍摄时间、相机、GPS 直接存进索引，不用打开文件就能查。
文档档案
source: /Volumes/Archive policy: unfiltered # 归档场景全量记录 verify: on # 重复内容逐字节确认 freeze: after-walk # 首轮跑完冻结一份快照通用文件夹
source: ~/Downloads policy: default watcher: on cache: on-demand # 远端大文件按需取回，可随时回收多台设备怎么协作
两台设备先建立信任：在一台设备上跑sd-cli network pair generate生成 12 词配对码（5 分钟有效），另一台跑sd-cli network pair join "<PAIRING_CODE>"完成配对；跨网络时用带节点 ID 的 QR 方式。注意配对只记录网络信任，把新设备加进 Library 是独立的下一步。
信任建好后，按数据该往哪去选同步模式。浏览远端文件夹只是读取，不会悄悄占用本地存储：
| 模式 | 适用情况 | 注意点 |
|---|---|---|
| Copy 复制 | 一次性迁移、导出 | 不动目标已有内容 |
| Mirror 镜像 | 单向备份到 NAS | 删除传播需单独打开 |
| Two-way 双向 | 笔记本与 NAS 同时编辑 | 冲突保留双方版本，不会只按时间戳吞掉一侧 |
| Archive 归档 | 成品转入长期存储 | 删源文件是独立、可审计的步骤 |
| Cache 按需缓存 | 大文件就近访问 | 缓存可回收，权威副本仍在源头 |
技术细节见 docs/core/file-sync.mdx。
迁移完成自检 ✅
sd-cli sources list里的来源数量与你的计划一致- 搜索能命中一个你记得的旧文件名
- 第二台设备登录后能看到同一个 Library 与设备列表
- 新建、修改一个文件，监视器自动更新了索引记录
- 拔掉移动硬盘后，来源标记为离线，但目录仍可在索引中检索
用大小视图扫一眼，能确认哪个文件夹占了大头，迁移是否完整。
遇到问题先看这里
现象：索引进度长时间不动排查：用任务列表定位卡住的文件，把问题路径排除掉，再检查磁盘权限与文件系统健康。
现象：部分文件没出现在索引里排查：确认是否被默认捕获策略过滤，必要时改为 unfiltered 捕获；再核对文件权限。
现象：配对失败或超时排查：配对码 5 分钟过期，重新生成；两台设备跨网段时用 QR，或给 join 加上--node-id参数。
接下来可以试试 💡
- 给关键来源跑
sd-cli sources verify <SOURCE_ID>与sd-cli sources freeze <SOURCE_ID>，先校验内容、再留一份带日期的索引快照 - 定期用
sd-cli library backup导出整个 Library 的状态，换机时能整体恢复 - 跑
just dev-docs把文档站本地化，细读 indexing 与 pairing 的设计说明
现在就挑一个你最乱的文件夹接进来，剩下的交给索引。更多入口见 docs/overview/get-started.mdx。
【免费下载链接】spacedriveSpacedrive is an open source cross-platform file explorer, powered by a virtual distributed filesystem written in Rust.项目地址: https://gitcode.com/gh_mirrors/sp/spacedrive
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
入门：从状态同步痛点到最小实现)
