开始之前
存储熊不是云盘,也不卖存储容量。它是一层“使用工具”:把你已经购买的阿里云、腾讯云、华为云、火山引擎等对象存储接入电脑,建立文件索引,并把这些文件整理成一块可上传下载的云端盘,同时保留本机索引镜像。开始前请确认三件事。
- 你已经拥有,或愿意开通至少一家对象存储,并创建一个桶(Bucket)。没有桶时,软件仍能安装,但无法完成迁出与云端取回。
- 你使用的电脑是 64 位 Windows 10 或 Windows 11,并拥有管理员权限,用于安装客户端、启用 WebDAV 组件和映射网络盘。
- 你愿意明确选择“哪些本地目录允许被同账号手机查看”。手机只能看到被授权的电脑目录,且只能读、不能写。
迁出会在上传成功后删除本地文件,迁回默认会在下载成功后删除云端副本。请先用少量不重要的文件试跑一遍,确认上传、日志与恢复都符合预期,再处理重要资料。任何云服务都不能替代你自己的多份备份。
安装包需要在 Windows 上构建,由本项目的部署者提供。当前演示服务器可能未开放安装包下载;请向部署者索取构建产物,或参照项目中的构建说明自行打包。功能与界面以实际版本为准。
01先弄懂四个词
对象存储和你熟悉的“网盘”不太一样。它没有真正的文件夹,只有“桶”和“对象键”。你可以把桶想成一个巨大的仓库,对象键就是仓库里那件物品的完整编号。理解下面四个词,后面的配置就不会陌生。
| 名词 | 通俗解释 | 在哪里看到 |
|---|---|---|
| 桶 Bucket | 存放对象的容器,名字在整个厂商范围内通常唯一。一个桶对应一个地域。 | 对象存储控制台的“桶列表” |
| Endpoint | 访问这个桶的接口地址,包含地域信息。填错会连到别处或直接失败。 | 桶概览、访问域名、S3 兼容端点 |
| Region | 桶所在的地域,例如 cn-hangzhou。它要与 Endpoint、桶三者匹配。 | 创建桶时选择的地域 |
| AccessKey SecretKey | 调用接口用的“账号 + 密码”。它们是钥匙,不是登录云控制台的密码。 | 访问控制 / API 密钥管理 |
| 对象键 Key | 对象在桶里的完整路径。文件迁移后,原路径会记录在日志里,不会因为键名改变而丢失。 | 对象列表、迁出日志 |
存储熊做了什么:它在你的电脑上运行一个本地代理,扫描选定目录、建立文件名和路径索引,保存云密钥,并直接与对象存储通信。它还提供云端 WebDAV 盘和迁移日志;手机访问入口正在开发中。
它不做什么:不替你购买云存储,不代扣续费,不把你的文件正文上传到存储熊服务器,也不会让手机写入或删除电脑文件。服务器只保存账号、设备、授权目录和文件索引元数据。
对象存储通常按存储量、请求次数和外网下行流量计费。把文件迁回本地、手机打开云端文件都可能产生下行流量费用。各厂商的免费额度、取回策略和最低存储期限不同,请先在控制台查看计费说明。
02安装电脑端
-
获取并运行安装包
从 Windows 最新版下载 获取安装包,放到本机后双击。安装程序需要管理员权限,可按向导选择安装位置。
-
允许安装器自动准备组件
安装时会尝试启用 Windows 的 WebDAV 客户端(WebClient),并在缺少 Visual C++ 运行库时联网下载安装。若这一步被安全软件拦截,不需要手动敲命令:首次挂载失败时点客户端里的「一键修复并重试」,按提示允许一次管理员授权即可。
-
选择是否开机自动启动
首次登录后,客户端会询问是否随 Windows 启动。开启后会在当前 Windows 用户的启动项中登记,可在「任务管理器 → 启动应用」看到「存储熊」或「StorageBear」;之后在托盘静默运行,不弹主窗口。可在「设置与帮助 → 这台电脑」中随时关闭。需要开机自动挂载网络盘时,再单独打开虚拟磁盘页的「开机后自动挂载」。
-
处理系统的安全提示
当前版本可能未做代码签名,Windows SmartScreen 会提示“未知发布者”。请确认安装包来源可信后再选择“更多信息 → 仍要运行”。不要从陌生来源下载安装包。
-
注册或登录同一账号
启动存储熊并在“注册”页填写邮箱,点击“获取验证码”。验证码会发送到该邮箱,10 分钟内有效,连续输错 5 次需重新获取;没收到时请检查垃圾邮件,并等待 60 秒后再重发。填入验证码、密码后创建账号。电脑端注册后会以“电脑”类型登记设备;手机端功能上线后可用同一账号登录。
-
认识六个页面
左侧依次是:总览、文件库、云端与续费、迁出与迁回、虚拟磁盘、手机访问(开发中)。右上角有“一键扫描”,设置页可查看客户端版本、服务连接和手册入口。
本地代理已随客户端打包,普通用户不需要安装 Python、配置环境变量或手动启动服务。若安全软件拦截本地代理,请允许存储熊在本机回环地址上运行。
客户端会在联网时从存储熊服务器的 /updates/ 检查新版本,发现更新后询问是否下载;也可以到「设置与帮助 → 关于」点「检查更新」。安装过程会保留你的账号、索引与本地配置。若提示无法检查更新,通常是网络问题或服务器更新目录暂未就绪,可从宣传页的「Windows 最新版」获取安装包覆盖安装。
客户端内置本项目部署的服务器 http://47.100.27.233,登录页不再需要填写服务器地址。当前未启用 HTTPS,登录密码与令牌在传输中不加密,请只在可信网络使用;域名备案完成并启用 HTTPS 后,会随新版本把内置地址切回 https:// 域名。账号密码用于登录存储熊;云厂商 AccessKey 是另一套密钥,只保存在本机。
03授权目录与首次扫描
扫描只读取文件名、路径、大小、修改时间和类型,不读取文件正文,也不会上传文件。索引用于文件库、搜索、分享、迁移和手机浏览(开发中)。
-
选择扫描目录
点击“一键扫描”,添加要建立索引的目录。不要直接选整个系统盘;Windows、Program Files、回收站等系统目录会被自动跳过。建议先选一个资料目录试跑。
-
确认文件类型
默认索引 PDF、Office / WPS 文档、常见音视频,以及 zip、rar、7z、tar、gz 等压缩包;图片等其他类型可在扫描选项中追加扩展名。文档范围包括 docx、xlsx、pptx、旧版 doc、xls、ppt,以及 WPS 原生 wps、et、dps。只有 docx、xlsx、pptx 支持内置预览,其余会索引并交给本机 Office 或 WPS 打开。
-
开始扫描并等待完成
文件数量多时扫描会持续一段时间。期间请保持电脑开机,避免休眠中断。完成后,文件会出现在“文件库”,可以用类型、状态和云存储三个下拉框组合筛选,也可搜索文件名或路径。迁出后的文件仍会留在文件库中并标记为“仅云端”。
-
设置免扫路径(推荐)
在“设置与帮助 → 扫描目录与扩展名”中添加免扫路径,例如
C:\Users\你的用户名\.dsh。即使以后扫描它的上级目录甚至整个 C 盘,这个路径下的文件和子目录也会被完全跳过。点“从应用选择”可以读取 Windows 已安装应用,一次勾选多个应用并加入免扫。 -
预留手机可见范围(开发中)
手机访问上线后,只有被加入授权范围的目录才会出现在手机端;目前该功能暂未开放,可先完成目录扫描。届时手机上看到的目录结构来自电脑,文件能否打开取决于电脑是否在线、原文件是否存在,以及云存储是否可用。
-
后续更新索引
新增或移动文件后,可再次扫描对应目录刷新索引。索引是“快照”,不会实时监听每一次文件变化。
下载目录里的压缩包
文件库顶部的「下载目录压缩包」只读取系统下载目录的第一层,列出 zip、rar、7z、tar、gz 等常见压缩包,勾选后可直接上传到指定云存储,适合浏览器刚下载完就归档的场景。
- 压缩包按原文件上传,当前不提供在线解压,也不改动压缩包内容。
- 默认在上传成功后删除下载目录中的原文件;如果还想保留本地副本,请取消勾选“上传成功后删除”。
- 已经迁出且在云端有映射的条目会标记为“已在云端”,默认不可重复选择。
- 不会递归读取子目录;需要处理其他位置时,用「迁出文件」手动选择。
索引元数据会同步到存储熊服务器,用于跨设备检索(当前手机访问仍在开发中)。文件名和路径本身可能暴露信息,因此请勿把包含敏感命名的目录授权给手机。手机访问上线后,可在电脑端随时收紧授权目录。
04接入云存储
先到云厂商控制台创建一个桶,再回到存储熊填写四类信息:厂商、Endpoint、地域、桶名,以及本机保存的 AccessKey/SecretKey。建议为存储熊单独创建一组最小权限密钥,不要使用主账号的长期全权限密钥。
火山引擎 TOS 的完整流程——创建 IAM 用户 → 只授予必要权限 → 保存 AccessKey / SecretKey → 建私有桶 → 记下 S3 Endpoint 与 Region → 在存储熊里填连接信息——见 火山引擎 TOS 接入教程,共 13 步带脱敏截图,附录还给了存储类型选购建议。
用 Cloudflare R2 的话,看同一页的 Cloudflare R2 接入步骤:在 R2 控制台创建 API 令牌、复制带账户 ID 的 Endpoint、Region 填 auto、访问样式选路径样式。
需使用 S3 兼容 Endpoint;中国内地新桶可能要求绑定自定义域名。示例:s3.oss-cn-hangzhou.aliyuncs.com
使用 COS 的 S3 兼容访问方式。地域、桶名和 Endpoint 必须匹配。示例:cos.ap-guangzhou.myqcloud.com
以 OBS 控制台显示的 S3 兼容 Endpoint 为准,注意区分不同地域。示例:obs.cn-north-4.myhuaweicloud.com
TOS 的 S3 端点必须带 -s3-,且只支持虚拟主机样式。示例:tos-s3-cn-beijing.volces.com
请先在 OOS 控制台获取 S3 兼容 Endpoint 后填入;不同资源池的地址不同。
可接入自建 MinIO 或标准 S3 兼容端点。自建服务要确保电脑能访问该地址,并注意 HTTP 的安全性。
Endpoint 必须带上账户 ID:https://<账户ID>.r2.cloudflarestorage.com;Region 固定填 auto,访问样式选路径样式(Path)。密钥要在 R2 控制台创建「API 令牌」时生成,Bucket 名称必须与 R2 完全一致。详见Cloudflare R2 接入步骤。
推荐的密钥权限
如果厂商支持自定义策略,只授予目标桶的以下操作,不要授予整个账号的读写权限:
s3:ListBucket
s3:GetObject
s3:PutObject
s3:DeleteObject
s3:AbortMultipartUpload
s3:ListMultipartUploadParts
s3:GetBucketLocation
删除权限仅在迁回后清理云端副本时需要。如果你希望始终保留云端副本,可以去掉 s3:DeleteObject,并在迁回时勾选保留云端副本。
保存并测试
- 选择厂商预设
选择最接近的厂商后,Endpoint 与地域会自动填入示例值,仍需按你的实际桶修改。
- 填写桶和密钥
桶名不含路径;AccessKey 与 SecretKey 填在电脑端,不会发送到存储熊服务器。
- 测试连接
保存前点击“测试连接”。成功说明端点、地域、桶名和密钥基本匹配;失败时先看错误码,再核对第 12 节。
- 补充配额与续费信息
到期日期与续费网址用于提醒和跳转,不会自动扣款。配额可留空,具体以厂商控制台为准。
Windows 上,密钥通过系统 DPAPI 加密后保存在本机;macOS 与 Linux 上当前版本使用可逆编码保存,并不等同于系统级加密。请确保电脑磁盘加密、账号不共享。不要在公共电脑或多人共用账号上保存云密钥。
05多云拼接
拼接把至少两家云存储组合成一个迁出目标,适合容量分散在不同厂商的用户。它不是把多个桶合并成一个真实文件系统,而是一条选择规则:迁出时优先选择当前副本占用较少的一家。
- 先接入至少两家可用云存储,并分别通过连接测试。
- 新建拼接,命名并勾选参与组合的云存储,至少选择两家。
- 迁出文件或目录时,在目标位置选择这个拼接组合。
- 迁回时仍按实际所在的单一云存储或迁出日志处理,不会把各家数据混在一起。
删除拼接只移除这条选择规则。要清理文件,必须逐家迁回或到云厂商控制台操作。拼接也不会共享或合并各家的密钥权限。
06原位打开、Office / WPS 预览与分享链接
原位打开
在文件库中双击或选择“打开”,存储熊会优先使用原路径的本地文件。如果本地文件已经迁出、暂不存在,它会按数据库中的原路径与云端对象键找到云端副本,先取回到本机临时目录,再用系统默认应用打开。原路径不会被自动改写;需要长期保留在本机时,请使用“迁回”。
所有预览都在本机
PDF、HTML、文本、图片、音视频以及 Office 文档都不再从云端直链预览。本机已有文件时直接读取;只有云端副本时,先下载到本机临时目录,再交给系统默认应用或内置预览窗口。文件不经过存储熊服务器中转,也不会在服务器上留下副本。
- PDF、HTML、文本、图片和音视频使用系统默认应用打开,实际用哪个软件由文件关联决定。
- 云端文件使用本机临时副本,不会覆盖原路径;临时目录中超过 2 天未使用的副本会在之后打开文件时自动清理。
- 预览不再设置 40 MB 之类的固定大小上限,但仍受本机可用内存、磁盘空间、网络速度和文档复杂程度影响。特别大的文件首次打开需要先等待下载完成。
Office / WPS 预览与修改
双击 docx、xlsx、pptx 会在存储熊的独立预览窗口中本地渲染,不会自动下载回原路径。预览不依赖本机是否安装 Office 或 WPS,也不区分文件由 Microsoft Office 还是 WPS 保存;复杂版式可能与原软件略有差异。
- 预览窗口的“用本机 Office / WPS 编辑”会调用 Windows 的默认文件关联。电脑装的是 Microsoft Office 还是 WPS 都可以,实际用哪一个由系统默认应用决定。
- 该操作会为云端文件准备临时副本,不改变原路径,也不会把文件标记为本地副本。修改后在 Office 或 WPS 中保存,回到预览窗口点“完成并上传”。
- 客户端会先上传为新版本对象,成功后才删除旧对象;失败时旧对象保留,可重试。每次回传都会生成新的对象键并写入“编辑回传”日志,记录旧键与新键。
- 只有本地副本的文件,在 Office 或 WPS 中保存后直接生效,不上传、不生成新对象;如果本地与云端都有副本,回传会把云端更新为新版本。
- 旧版
.doc、.xls、.ppt和 WPS 原生.wps、.et、.dps暂不支持内置预览。提示中仍可交给本机默认应用打开;云端文件会先下载到临时目录,这里的修改不会自动回传,需要改原件时请先迁回或另存为 docx / xlsx / pptx。 - 编辑回传同样没有固定大小上限;文件越大,下载、打开和上传耗时越长,请保持网络稳定与足够的上行带宽。
- 上传、删除对象会各产生一次请求,可能计费。
电脑端本地渲染可以避免把文档正文上传到存储熊服务器,也不需要为在线预览套件长期占用服务器容器与内存。预览和修改都使用你电脑上的临时副本,文档内容只在你、本机和云存储之间流转。
创建分享链接
选择文件后点击“创建链接”,本地代理会为云端对象生成预签名 GET 链接,默认有效期为 6 天。拿到链接的人在该有效期结束前可以直接下载,不需要登录你的云账号。请把链接当作临时凭证,不要发到公开群组或长期公开页面。
- 链接到期后返回 403 是正常现象,重新创建即可。
- 文件尚未在云端时,软件会先按迁出流程上传,再生成链接;请留意本机磁盘与云端状态。
- 删除云端对象后,旧链接立即失效,即使还没到期。
- 预签名链接不等于公开读权限,不会改变桶的访问策略。
资源管理器右键:一键分享
Windows 安装版会在文件与文件夹的右键菜单加入「存储熊:一键分享」,并开启多选。选中内容后点击,存储熊会判断该怎么传:
- 只选了一个文件:直接上传(已有云端副本则复用),生成 6 天有效的链接并写入剪贴板。
- 选了多个文件,或选了文件夹:先在本机打包成
.tar.zst压缩包,再上传压缩包并生成链接。zstd 是无损压缩,体积通常只有 zip 的七成左右,打包过程不改动原文件。 - 压缩包暂存在本机临时目录,上传完成后立即删除;超过一天仍未清理的残留会在下次打包前自动清掉。
- 压缩优先用 zstd:装了 zstd 组件时一路写一路报进度;没装时用 Windows 10/11 自带的
tar.exe --zstd(同样是 zstd 格式,零依赖);两者都不可用时才回退 zip——功能不受影响,只是体积略大。
完成后默认发一条系统通知,写明条目数、原始体积、压缩后体积和使用的云存储。链接写入剪贴板始终开启,通知可以在「设置与帮助 → 资源管理器右键」中关闭。
- 自动选择云存储时,优先比较到期时间:到期越晚越优先,未填写到期时间视为无限;到期时间相同时,再比较剩余容量(额度 - 已用),余量大的优先。
- 可以在同一设置卡片中指定始终使用某个云存储;指定的桶不可用时回退为自动选择。单文件且已有云端副本时会继续使用原桶,避免重复上传。
- 右键菜单写入当前 Windows 用户注册表,不需要管理员权限;卸载或关闭开关会移除。Windows 11 可能把入口收在「显示更多选项」里。
- 内容较大时打包与上传都需要时间,完成后才会出现通知并写入剪贴板;失败时通知会给出原因,请确认已登录且至少有一个可用云存储。
- 打包只收录你选中的这些文件与文件夹本身,不会扫描或上传其它目录;被其它程序占用的文件可能导致打包失败,关闭占用后重试即可。
资源管理器右键:迁移到其它盘
同一个右键菜单里还有「存储熊:迁移到其它盘并创建链接」,用于把 C 盘里的大文件、大文件夹搬到 D / E 盘,同时保持原路径可用。它先把内容完整复制到目标盘,校验通过后再删除原位置,并在原位置创建链接;任何一步失败都会尽量把内容复制回原位,并说明原因。
- 目录使用 junction(目录联接),不需要管理员权限。单文件优先用硬链接(同一块磁盘内可用,也不需要管理员权限);跨盘时改用符号链接,这一步需要管理员权限或开启 Windows 开发者模式。
- 目标盘永远不选 C 盘,也不会与源盘相同;默认挑选剩余空间最大的非系统盘。
- 磁盘根目录、Windows / Program Files / ProgramData 等系统目录,以及存储熊自身的数据目录都不允许迁移。
- 迁移不改变文件内容与路径,索引、快捷方式和其它程序照旧能打开,因此不需要重新扫描。
- 正在被程序占用的文件无法删除,迁移会失败并保留原样;建议先关掉相关程序。
07挂载云端虚拟盘
虚拟盘通过本机 WebDAV 服务提供,服务只监听 127.0.0.1,不会暴露到局域网或公网。新版默认是“云端盘”,根目录只显示自动生成的云存储文件夹;也可以在虚拟磁盘页关闭“云端盘模式”,切换回本机索引只读镜像。
云端盘(默认)
- 根目录只显示
{厂商}-{桶名}文件夹;多个来源挂同一个桶时会自动加-2、-3等后缀,保证唯一。 - 根目录不能新建文件夹、不能拖入文件,也不能上传根级文件。这是强制限制,避免出现无归属的根对象。
- 进入桶文件夹后可直接拖入文件上传,也可新建子文件夹;双击文件时从云端按需读取,不会强制把所有对象同步到本机。
- 只显示存储熊上传过的对象(包括迁出、快速链接和云端盘上传的文件),桶里其他工具上传的对象不会出现。
- 当前不开放删除和改名。同名上传会由 Windows 资源管理器提示是否覆盖;覆盖后云端对象会被替换。
- 文件正文只在你的电脑与云存储之间传输,不经过存储熊服务器。
本机索引镜像(可选)
在虚拟磁盘页关闭“云端盘模式”后,盘内改为只读镜像:展示已扫描的目录结构与云端副本。写入、改名、删除不会同步到原文件或云端,适合查看索引。
- 启动服务
进入“虚拟磁盘”,点击“启动服务”。状态应显示“服务就绪”。
- 挂载为网络盘
Windows 点击“挂载为网络盘”,软件会映射一个空闲盘符,你也可以指定盘符,例如
Z。自动挂载会先用专用本地账号(Windows 会保存凭据,打开盘符时仍能认证),失败后再尝试仅对本机有效的随机安全会话。每次显示挂载成功后,客户端会实际打开一次盘符验证;打不开会自动换下一种方式。 - 设置自动挂载
需要开机即用时,打开“开机后自动挂载”,并确保存储熊已随系统启动、登录的是同一个 Windows 账号。自动启动可在设置页或首次登录提示中开启。
- macOS / Linux
点击挂载会显示连接方法。使用系统文件管理器的“连接服务器”功能,填入界面显示的本机 WebDAV 地址、用户名和密码。
- 不用时卸载
点击“卸载网络盘”或“停止服务”。停止服务后,旧连接地址不可再用。
云端盘只在自动生成的桶文件夹内开放上传和新建文件夹;根目录始终只读。当前不支持删除、移动和改名,因为这些操作在对象存储里往往不可逆或需要先复制再删除。同名上传按覆盖处理,资源管理器会先询问是否替换。
直接点客户端里的「一键修复并重试」,Windows 弹出管理员授权时选「是」。它会自动启动 MRxDAV 网络重定向器和 WebClient、修正 HTTP 基本认证、把 WebClient 改为自动启动并重启服务,然后自动重试挂载;不需要输入 NET USE 或手动改注册表。若提示需要重启,请重启电脑后再挂载。修复失败时,界面会显示 MRxDAV、WebClient 的现场状态、每种挂载方式的结果和最近日志,可点「复制诊断」发给部署者。公司组策略或安全软件禁止 WebDAV 时,仍需管理员放行。这个地址只在本机有效,不能拿到手机上使用。
08手机单向访问(开发中)
当前版本暂不开放手机登录。下列说明是计划中的使用方式,正式上线后才会启用。
手机端将是一个网页入口,用与电脑端相同的账号登录(当前暂未开放)。它只列出你名下的电脑,不显示手机设备,也不允许电脑反向访问手机目录。权限是单向的。
- 登录并选择电脑
登录后能看到电脑列表、在线状态和最近同步时间。离线电脑仍可浏览已有索引,但取回文件需要电脑重新上线。
- 浏览授权目录
首页展示可访问的磁盘与目录。进入目录后可以返回上级,或直接在顶部切换到根目录。
- 搜索文件
可输入文件名或路径片段,并按 PDF、音频、视频等类型筛选。搜索范围限于你有权限的电脑索引。
- 请求打开文件
点击文件后,服务器会通知对应电脑准备链接。若电脑在线,通常几秒内即可拿到云端限时链接;若文件尚未上传,电脑会先生成云端副本。离线时会提示你先让电脑上线。
- 复制或打开链接
拿到链接后可直接在手机浏览器打开,或复制到其他应用。链接来自云厂商,有有效期,也可能产生流量费用。
- 安全退出
在“我的”页退出登录。共用手机或公共浏览器上务必退出,避免他人继续使用你的会话。
- 手机不能上传、修改、删除或重命名电脑文件。
- 手机不能浏览电脑未授权的目录。
- 手机相册、通讯录等本机数据不会被索引,也不会被电脑查看。
- 当前演示部署若仍使用 HTTP,登录令牌与密码在传输中不受加密保护,请勿在不可信网络使用,等待部署者启用 HTTPS。
09迁出、迁回与日志
这是存储熊最重要的数据操作,请先读完再执行。迁出把本地文件上传到云端;迁回把云端副本恢复到原路径。两者都会写入日志,用来回答“哪些文件去了哪里、有没有删本地、云端副本还在不在”。
迁出
- 选择文件或目录
在文件库中勾选目标,或直接对某个目录迁出。目录会递归收集其中尚未迁出的文件。
- 选择云端目标
可以选择单个云存储,也可以选择拼接组合。未指定时按规则选择可用目标。
- 确认是否删除本地文件
默认迁出成功后删除本地副本,释放磁盘空间。只想保留云端副本、不删本地时,请关闭“移动/删除本地”选项。
- 等待任务完成并检查结果
失败的文件会保留在本地并在结果中列出。不要只看进度条,务必查看错误摘要。
日志与清单在哪里
每次迁出会生成一个日志编号,清单以 JSONL 格式上传到对应桶的以下位置:
_storagebear/logs/<logid>.jsonl
清单逐行记录原路径、对象键、云存储、文件大小和修改时间。迁出日志同时保存在本机数据库并同步到存储熊服务器(不含文件正文)。迁回时优先按日志恢复;若日志文件被删除,可尝试按云存储或原路径恢复,但可能缺少精确对应关系。
日志默认只在目标桶与本机数据库中。如果桶被删除、密钥丢失或本机重装,日志可能一起消失。重要迁移完成后,建议在目标桶中复制一份 _storagebear/logs/ 到其他位置,并记录日志编号。
编辑回传与版本对象
在预览窗口编辑云端 Office / WPS 文件并选择“完成并上传”时,存储熊会执行一条可回滚的替换流程:先以新对象键上传修改后的文件,确认上传成功并更新索引后,才删除旧对象;上传失败不会提前删除旧版本。可回传的格式是 docx、xlsx、pptx;原生 doc、xls、ppt、wps、et、dps 暂不支持内置编辑回传。
- 新对象键在原键后追加
-v时间戳-随机串;重复编辑会更新这个版本后缀,不会无限叠加。 - 日志类型显示为“编辑回传”,记录原路径、新旧对象键、云存储、大小和时间;旧对象删除失败会单独标注。
- 上传的是完整文件而不是增量,会产生上行流量和一次删除请求,可能计入云厂商账单。
- 回传只替换当前对象,不额外保留历史版本;若云厂商开启了版本控制,旧版本是否保留由厂商策略决定。
迁回
续费不足、准备停用某家云、或需要在本机重新打开文件时,都可以迁回。你可以按迁出日志、按某家云存储、按具体文件路径或全部云端文件恢复。
- 默认按原路径恢复,并恢复原修改时间。
- 如果本地已经存在且大小相同的文件,默认跳过,避免覆盖你后来修改的版本;需要覆盖时请显式开启“覆盖已有文件”。
- 下载成功后,默认删除对应云端副本并清除“仅云端”映射;如需保留,请开启“保留云端副本”,此时文件会标记为“本地 + 云”。
- 如果云端删除失败,文件已经恢复到本地,错误会记录在日志中,可稍后手动清理。
- 迁回同样会生成一条恢复日志,记录文件数量、来源云存储和是否保留云端副本。
只有成功下载的文件才会进入删除云端副本的步骤,但磁盘写满、权限错误或网络中断都可能造成部分失败。迁回完成后检查错误摘要与本地文件数量,再决定是否停用云存储或让它到期。
盘间迁移(mklink)
“迁出”是把文件放进云端,“盘间迁移”则是把文件搬到本机的另一块磁盘:C 盘太满时,把大文件或整个文件夹挪到 D / E 盘,同时在原位置留下一个链接。这样一来,路径不变、索引不变,程序、快捷方式、Office 的最近文件都照旧能用,但实际数据已经不在系统盘上了。
- 选择目标盘
设置页会列出每块磁盘的剩余空间,并推荐空间最大的非系统盘。也可以从资源管理器右键「存储熊:迁移到其它盘并创建链接」直接开始。
- 选择文件或文件夹
两者都支持,也可以多选。不建议把 D / E 盘的内容迁移回 C 盘,那会让系统盘更紧张。
- 先复制、再校验、后删除
确认后,存储熊把内容完整复制到
<目标盘>\StorageBearLinks\<原盘符>\原路径,校验通过才删除原位置,再创建链接。目录用 junction,单文件用硬链接,跨盘时用符号链接。 - 失败会尽量回滚
复制失败不会删除原文件;删除失败会提示哪个程序在占用;链接创建失败会把内容复制回原位并说明原因。
- 目录链接(junction)不需要管理员权限;单文件优先建硬链接(同一块磁盘内直接成功),跨盘才会用到符号链接,而符号链接需要管理员权限或开启 Windows 开发者模式,失败时请右键以管理员身份运行存储熊后重试。
- 磁盘根目录、
Windows、Program Files、ProgramData等系统目录,以及存储熊自身的数据目录都会被拒绝迁移。 - 迁移不会改变文件的修改时间和内容,因此不需要重新扫描索引。
- 迁移后的位置在资源管理器中看起来仍是原路径;如果移动了目标盘里的真实数据,原路径会失效。
- 删除原链接不会删除目标盘里的数据;要真正删除,请到
StorageBearLinks里操作。
正在被 Word、播放器、虚拟机或同步盘占用的文件无法删除,迁移会失败并保留原样。关掉相关程序后重试即可;已经复制到目标盘的部分不会影响原文件。
10续费与到期提醒
存储熊只管理提醒,不代扣续费,也不售卖容量。你可以在每家云存储的编辑页填写到期日期和续费网址。距到期 15 天以内时,总览页与云端页面会出现提醒,并给出“一键迁回”入口。
- 记录真实到期日
以云厂商控制台的到期时间为准。预付资源包、存储包和桶本身可能有不同的到期规则,存储熊无法自动读取这些信息。
- 填写续费网址
填入厂商控制台相应页面的链接。点击“续费”时只会打开该链接,不传输密钥,也不会自动付款。
- 提前评估容量
在“云端与续费”查看各家的云端副本占用、配额记录和剩余天数。临近到期的云存储,优先迁回重要文件。
- 到期前处理
若不打算续费,务必在到期前完成迁回与验证,并另外保留日志。云服务过期后可能限制访问,甚至按厂商政策清理数据。
提醒依赖你填写的日期和客户端运行状态。客户端长期不开机、日期填错或系统通知被屏蔽时,提醒不会生效。请把它当作辅助,而不是唯一的续费保障。
+存储熊自身清理
用了几个月以后,程序自己的临时文件、预览副本、日志和下载过的更新包会占掉一些空间。这些都不是你的文件,可以随时清理:打开「设置与帮助」,在「存储熊自身清理」卡片点「统计占用」看明细,再点「一键清理」。
| 清理项 | 位置 | 说明 |
|---|---|---|
| 临时文件 | tmp/ | 云端文件预览与打开时下载的副本,默认 2 天后自动过期 |
| 缓存 | cache/ | 界面与预览窗口的本地缓存,删除后会自动重建 |
| 旧日志 | logs/ | 按设置页选择的保留天数删除,正在写的日志不会被删 |
| 分享临时包 | tmp/share/ | 一键分享打包出来的压缩包,上传成功后本就会立即删除 |
| 更新缓存 | 用户数据目录 | 已经下载过的安装包,删除后不影响当前版本,需要时会重新下载 |
- 清理不会删除索引数据库、迁出 / 迁回日志、云存储配置或任何用户文件。
- 清理期间不要强制退出存储熊;如果某个文件正被占用,会跳过并提示。
- 想更彻底地缩小本机数据库,可以在清理完成后重启一次存储熊,数据库会做一次整理。
「诊断日志清理」卡片按类型与天数精细裁剪日志;「存储熊自身清理」是把临时文件、缓存、旧日志和更新包一次性打包处理。两者都不触及迁移日志。
11安全边界
存储熊采用“控制面与数据面分离”的设计:服务器只协调设备和元数据,文件内容在你电脑与对象存储之间直接传输。理解下面这张表,有助于判断哪些风险由谁承担。
| 数据 | 保存在哪里 | 谁会接触到 |
|---|---|---|
| 账号、设备、授权目录 | 存储熊服务器数据库 | 服务器管理员、登录账号 |
| 文件名、路径、大小、类型、云端状态 | 服务器与本地索引 | 服务器管理员、同账号手机 |
| 云 AccessKey / SecretKey | 仅本机 | 本机客户端;Windows 上由 DPAPI 加密 |
| 文件正文 | 你的电脑与你的对象存储 | 不经存储熊服务器转发 |
| 分享链接 | 由云厂商签发 | 任何拿到链接且在有效期内的人 |
| WebDAV 凭据 | 仅本机运行时 | 本机回环地址上的客户端 |
- 为存储熊单独创建最小权限密钥,不要复用主账号全权限密钥。
- Windows 上启用 BitLocker 等磁盘加密;不要把系统账号借给他人。
- macOS / Linux 上的密钥当前仅为编码保存,请在可信设备上使用,等待后续版本改进。
- 当前演示环境使用 HTTP,客户端内置的服务器地址是
http://47.100.27.233。密码和会话令牌在传输中不加密,请只在可信网络登录;域名备案完成并启用 HTTPS 后,会随新版本把内置地址改为https://域名。 - 手机访问功能上线后将保持只读,且只能看到已授权目录;不要在授权目录中放置身份证、合同等敏感文件。
- 分享链接默认 6 天有效,任何人持有即可下载,转发前确认接收者与场合。
- 定期检查云厂商的访问日志与账单,及时发现异常请求。
本软件处于早期版本,可能存在未被发现的安全缺陷。不要把它作为唯一备份手段,也不要在未评估风险的情况下处理高度敏感数据。发现漏洞请联系部署者,不要在公开渠道泄露密钥或用户数据。
12故障排查
安装时提示未知发布者 / 被 SmartScreen 拦截
当前构建可能未签名。先确认安装包来源与校验值,再从“更多信息”选择“仍要运行”。若来源不明,请停止安装。企业环境可能需要管理员批准或代码签名证书。
如何清理诊断日志?迁移日志会被删除吗?
在「设置与帮助 → 诊断日志清理」选择保留天数和日志类型,可清理本机代理、后端输出、桌面端、WebDAV 请求与修复日志。迁移日志(迁出/迁回记录和云端 JSONL 清单)不在此功能范围,也没有删除入口,会持续保留。正在被占用的日志文件会自动跳过。
客户端一直显示连接失败
先确认本机网络能打开部署地址,再检查防火墙是否拦截客户端。服务端若未启动、域名变更或仍是旧配置,也会连接失败。尝试退出客户端后重新启动;仍失败时把界面上的错误提示反馈给部署者。
扫描完成但文件库是空的
检查所选目录是否真的包含支持的文件类型,扩展名是否被加入扫描列表。系统目录会被跳过。若路径含权限限制,尝试以有权限的目录重新扫描。
搜索不到 docx / xlsx 等文档
新版客户端在旧索引里没有任何 Office / WPS 文档时,会在启动时自动补扫一次已保存目录。也可以手动重新扫描:扫描弹窗默认勾选文档类型。若仍搜不到,确认文档所在目录没有被设为免扫路径,并在文件库中清空类型、状态和云存储筛选后再搜索。
浏览器打开 WebDAV 地址显示目录列表
这是正常的目录页,说明本机 WebDAV 服务已启动、路径可访问。Windows 资源管理器挂载失败与浏览器能否打开是两件事:前者还依赖 MRxDAV、WebClient 和系统认证设置。挂载失败时仍按「一键修复 WebDAV」处理,并复制诊断。
测试连接失败:403 / AccessDenied
多为密钥权限不足或密钥填错。确认密钥属于当前账号、已启用,并拥有目标桶的 ListBucket / GetObject / PutObject 等权限。部分厂商需要额外授权 S3 兼容接口。
测试连接失败:SignatureDoesNotMatch
通常是 SecretKey 错误、Endpoint 与地域不匹配,或系统时间偏差过大。校正系统时间,核对桶名、Endpoint、地域三者是否属于同一资源池。
火山引擎 TOS 连接不上
确认 Endpoint 使用带 -s3- 的形式,并且采用虚拟主机样式。不要填写控制台登录地址或普通 TOS 域名。
阿里云 OSS 提示域名或访问限制
中国内地部分新桶要求绑定自定义域名后才能通过默认域名访问。请在 OSS 控制台确认访问域名与合规要求,或改用允许的 Endpoint。
手机显示电脑离线
只有电脑端在线时才能生成新的云端链接;已有索引仍可浏览。让电脑开机、登录存储熊并保持网络连接。若长时间未同步,在电脑端检查服务连接与设备状态。
手机打开文件一直停在“准备中”
可能正在上传大文件、云端连接较慢,或电脑刚刚离线。等待片刻后重试;若任务失败,界面会显示错误。确认对应云存储密钥仍可用、桶未到期。
Office / WPS 文件无法预览
内置预览支持 docx、xlsx、pptx,不要求本机安装 Office 或 WPS,也不区分文档由哪一家保存。预览没有固定的文件大小上限,但特别大或版式特别复杂的文档仍可能受本机内存和渲染能力限制;遇到渲染失败时,可直接用“用本机 Office / WPS 编辑”打开。旧版 doc、xls、ppt 与 WPS 原生 wps、et、dps 请用本机默认的 Office 或 WPS 打开;需要内置编辑回传时,请先另存为 docx、xlsx 或 pptx。云端文件打开时会先下载临时副本,建议在网络稳定时操作。
编辑后点“完成并上传”失败
先确认已经在本机 Office 或 WPS 中保存文件,而不是只关闭窗口。上传失败时旧云端对象不会被删除,检查网络、云存储密钥权限、桶容量与账单状态后重试。若提示未检测到修改,说明文件内容与打开时一致,无需上传。日志中会保留失败前后的对象键,便于核对。
下载目录里看不到压缩包
该入口只读取系统下载目录的第一层,不递归子目录,也只识别常见压缩包扩展名。若文件位于其他位置,请用「迁出文件」手动选择。已在云端的条目会显示“已在云端”并默认跳过;扫描未收录的类型不会被上传。
分享链接 403 / 无法打开
链接默认 6 天过期;云端对象被删除、桶权限改变或系统时间大幅偏差也会导致失败。重新创建链接;若仍失败,检查该文件是否还在云端,或先迁回本地再上传。
网络盘映射失败或反复要求登录
在虚拟磁盘页点「一键修复 WebDAV」,允许一次管理员授权。它会处理 MRxDAV、WebClient、HTTP 基本认证和旧映射冲突,并保留 Windows 命令的原始错误。修复后仍失败时,客户端还会依次尝试账号方式和不依赖 HTTP 基本认证的本机安全会话,并实际打开盘符验证;仍不行时重启电脑再试,若公司电脑受组策略限制,需要联系管理员放行 WebDAV 客户端。
迁回后本地文件打不开
查看迁回错误摘要,确认下载是否完整、磁盘是否写满、原目录权限是否允许写入。若云端副本已被删除而本地文件损坏,需要从其他备份恢复。执行迁回时保留云端副本可降低此类风险。
云端删除失败,但文件已回到本地
这是可恢复的状态:本地已有文件,只是远端清理失败。稍后重试,或在云厂商控制台手动删除对应对象。删除前核对日志中的对象键,避免误删其他版本。
忘记登录密码怎么办
当前版本未提供自助找回。请联系部署者,由服务器管理员处理账号;不要通过公开渠道发送密码或密钥。重装客户端不会删除服务器上的账号。
卸载后数据还在吗
默认卸载会保留用户账号、索引与云端日志,便于重装后继续使用。如需彻底清理,请按部署者说明删除本机数据目录;云端文件与日志需到对象存储控制台另行处理。
13名词表
| 名词 | 说明 |
|---|---|
| 控制面 | 账号、设备、索引、任务与提醒等服务端协调功能,不转发文件正文。 |
| 数据面 | 电脑直接与对象存储之间的上传、下载和预签名链接访问。 |
| 迁出 | 把本地文件上传到对象存储,默认在上传成功后删除本地副本。 |
| 迁回 | 把云端副本下载到原路径,默认在下载成功后删除云端副本。 |
| 清单 / 日志 | 记录原路径、对象键、云存储、大小和时间的 JSONL 文件,上传到目标桶的 _storagebear/logs/。 |
| 编辑回传 | 把本机 Office 或 WPS 修改后的 docx、xlsx、pptx 上传为新版本对象,成功后再删除旧对象的流程,会写入“编辑回传”日志。 |
| 版本对象键 | 编辑回传生成的新对象键,在原键后追加 -v时间戳-随机串,用于区分新旧版本。 |
| 预签名链接 | 云厂商签发的限时下载地址。持有者在有效期内可下载,无需登录。 |
| WebDAV | 一种网络文件协议。存储熊在本机提供 WebDAV 服务用于映射虚拟盘;云端盘默认桶内可写,根目录只读。 |
| DPAPI | Windows 的数据保护接口,用当前用户或系统凭据加密本机数据。 |
| S3 兼容 | 兼容亚马逊 S3 接口的访问方式。多数国内对象存储厂商都提供此类端点。 |
AI 创作声明与免责
本页全部说明文字(包括操作步骤、权限建议、故障判断和安全表述)由 AI 辅助生成,部署者可能进行了少量编辑。AI 可能产生不准确、不完整或已经过时的信息;云厂商的界面、计费规则、接口权限与政策也可能随时变化。
本手册不构成:云厂商的官方文档或服务承诺、法律或合规意见、对数据不会丢失的保证,也不替代你自己的备份与安全评估。涉及密钥、计费、数据删除和合规的操作,请以云厂商官方文档、控制台提示及你的实际情况为准。
如果你发现步骤与软件界面不一致,或某个链接、端点已经变化,请停止操作并联系部署者核验。不要依据未经核验的 AI 文本做出不可逆的删除决定。
- 先在少量测试文件上验证迁出、日志和迁回。
- 重要数据至少保留一份独立备份。
- 密钥使用最小权限,并定期轮换。
- 迁移前确认容量、流量费用和到期时间。