# Cloudreve

Cloudreve「外置机械硬盘」策略的 101 个已登记文件已从 SMB 源目录硬链接迁入策略 Blob 目录，未复制约 133.4GiB，再以单事务更新数据库 source，保持文件名、ID、逻辑结构和容量统计不变。工具默认预演，仅适用本次任务。最终设备号、inode、大小、mtime 一致，文件属主 cloudreve、600 权限，服务恢复 HTTP 200。硬链接不是备份，Blob 文件不可手工整理，原 SMB 共享已无这批文件。

RK3588 盒子通过 NPU 运行 bge-small-zh-v1.5，为 Cloudreve 提供本地语义搜索，并与 Meilisearch 混合检索。全程不调用云端 API，文本只在私网桥与宿主机服务间传输，无模型费用，也不外发正文。正式部署为宿主机 systemd 服务而非 Docker：RKNN SDK 依赖设备树，容器会遮挡平台识别。服务仅监听私网地址，并设专用用户、密钥和资源限制。CPU 负责分词与归一化，NPU 跑编码器，长文本滑窗聚合。实测 NPU 端到端中位 19.16/78.92 ms，约 CPU 的 8 倍，向量余弦最低 0.999782；但样本小，仍需混合检索。部署后 554 个分块全部向量化；未验证整机重启、功耗和网页端语义搜索效果。

将 Windows DSH graph-memory 插件和自建笔记应用接入已有的本机 NPU 嵌入服务。方案是不新起进程，复用同一 cloudreve-embedding 模型与推理锁，通过独立端口、密钥和单 IP 白名单隔离。DSH 零源码修改，仅改配置，采用带策略版本的对称编码，512 维、阈值 0.58，223 条摘要迁为 512 维且未重抽摘要，需重启 DSH 生效。笔记容器不能用 127.0.0.1，改为固定 172.24.0.2 并加入白名单，实测 512 维、约 215 毫秒。服务无 /v1/models 与 TLS，仅限可信内网，共享单 NPU 会影响排队。

Cloudreve 社区版 4.19.1 ARM64 可把 SMB 共享中约 133.4GiB 的老文件原地登记，不复制、不移动。实现关键是给专用用户 cloudreve 加只读命名 ACL：父目录仅 --x，源树目录 r-x、文件 r--，不递归 chown，不改属主，也不改 systemd 可写范围。修复权限后新建任务 6 导入，完成后登记 101 个文件、41 个子目录，路径大小与源一致，源文件未改且可实际读取。需注意 SMB 新增文件不会自动导入，源文件改移删可能使记录失效，新上传路径也不是源目录；回滚仅恢复 ACL，不回滚数据库，归档不含数据库与业务数据。

在 RK3588 的 Ubuntu 24.04 ARM 盒子上，用 Cloudreve 社区版 4.19.1 官方 ARM64 静态二进制搭建内网私有网盘。复用已有 MySQL 容器，以 systemd 而非 Docker 运行，仅监听 192.168.10.62:5212，不做公网映射或穿透。关键配置包括 CPU 0–3 亲和性与 GOMAXPROCS=4、文件句柄上限 65535；上传目录符号链接到外接 ext4 盘，并以最小 ACL 允许服务用户穿越。启动检查会核对磁盘 UUID、文件系统、写权限和符号链接，缺盘或 UUID 变化时拒绝启动；应用成功初始化 17 张表。验证显示首页 HTTP 200、仅内网监听，线程绑定与句柄上限符合预期。数据库端口应只绑 127.0.0.1，账号按最小权限收敛；正式备份需一致性导出、加密并预演恢复，升级前先备份。未实测上传下载、分享、WebDAV、拔盘、整机重启与数据库中断。

本文记录在RK3588 ARM64上，为宿主机Cloudreve 4.19.1部署Tika和Meilisearch全文搜索，服务仅监听本机回环端口。本轮只完成依赖部署和局部验证，未开启后台开关、未重建业务索引或扫描历史文件，语义搜索暂未部署。后台需填回环端点，密钥从.env读取，最大20MB、分块1KB。已有文件不会自动入索引，需手动重建；普通Tika无OCR，扫描件和图片不能文字检索。撤销时关闭全文搜索并停止容器，down勿加-v。

Cloudreve 4.19.1 离线下载报错，根因是主节点只配 provider=aria2，缺少 aria2 子配置且未装下载器，导致空指针 panic。修复不升级、不重启本体，在 RK3588/Ubuntu 24.04 新建独立 aria2 1.37.0 容器，仅回环发布 6800，随机 RPC 令牌，非 root、只读 rootfs、资源受限，并配合 usb-storage-guard 与外盘挂载；再用 manage.py 经官方 API 补全节点配置。验证 API 返回 1.37.0，认证 RPC 正常，未认证和局域网访问被拒，真实下载 LICENSE 35146 字节且 SHA256 一致，原有失败任务未重试。回退须先关闭主节点离线下载再停容器，不能清空子配置却保留 provider。未实测 BT、大文件、断电与缺盘重启。