使用手册 · v0.3.1

从第一块桶,
到一块顺手的云端盘

这份手册写给第一次接触对象存储的人。你会先弄懂桶、Endpoint 和 AccessKey 是什么,再完成安装、扫描、接入云端、预览与编辑 Office / WPS 文档、挂载虚拟盘、手机访问(开发中),以及最关键的迁出与迁回;文末还包含一键分享、盘间迁移(mklink)与程序自身清理。

适用 Windows 10 / 11 x64 初次配置约 20–40 分钟 密钥只留在本机 全文 AI 辅助创作
AI 创作声明

本手册全部文字由 AI 辅助创作,可能包含错误、遗漏或与厂商最新界面不一致的内容。它不构成云厂商官方文档、法律意见或数据安全承诺。操作前请以软件实际界面、云厂商控制台提示与官方文档为准,并自行核验关键步骤。

AI 辅助创作

开始之前

存储熊不是云盘,也不卖存储容量。它是一层“使用工具”:把你已经购买的阿里云、腾讯云、华为云、火山引擎等对象存储接入电脑,建立文件索引,并把这些文件整理成一块可上传下载的云端盘,同时保留本机索引镜像。开始前请确认三件事。

  • 你已经拥有,或愿意开通至少一家对象存储,并创建一个桶(Bucket)。没有桶时,软件仍能安装,但无法完成迁出与云端取回。
  • 你使用的电脑是 64 位 Windows 10 或 Windows 11,并拥有管理员权限,用于安装客户端、启用 WebDAV 组件和映射网络盘。
  • 你愿意明确选择“哪些本地目录允许被同账号手机查看”。手机只能看到被授权的电脑目录,且只能读、不能写。
先备份,再操作迁移

迁出会在上传成功后删除本地文件,迁回默认会在下载成功后删除云端副本。请先用少量不重要的文件试跑一遍,确认上传、日志与恢复都符合预期,再处理重要资料。任何云服务都不能替代你自己的多份备份。

当前是 0.3.1 测试版本

安装包需要在 Windows 上构建,由本项目的部署者提供。当前演示服务器可能未开放安装包下载;请向部署者索取构建产物,或参照项目中的构建说明自行打包。功能与界面以实际版本为准。

01先弄懂四个词

对象存储和你熟悉的“网盘”不太一样。它没有真正的文件夹,只有“桶”和“对象键”。你可以把桶想成一个巨大的仓库,对象键就是仓库里那件物品的完整编号。理解下面四个词,后面的配置就不会陌生。

名词通俗解释在哪里看到
桶 Bucket存放对象的容器,名字在整个厂商范围内通常唯一。一个桶对应一个地域。对象存储控制台的“桶列表”
Endpoint访问这个桶的接口地址,包含地域信息。填错会连到别处或直接失败。桶概览、访问域名、S3 兼容端点
Region桶所在的地域,例如 cn-hangzhou。它要与 Endpoint、桶三者匹配。创建桶时选择的地域
AccessKey
SecretKey
调用接口用的“账号 + 密码”。它们是钥匙,不是登录云控制台的密码。访问控制 / API 密钥管理
对象键 Key对象在桶里的完整路径。文件迁移后,原路径会记录在日志里,不会因为键名改变而丢失。对象列表、迁出日志

存储熊做了什么:它在你的电脑上运行一个本地代理,扫描选定目录、建立文件名和路径索引,保存云密钥,并直接与对象存储通信。它还提供云端 WebDAV 盘和迁移日志;手机访问入口正在开发中。

它不做什么:不替你购买云存储,不代扣续费,不把你的文件正文上传到存储熊服务器,也不会让手机写入或删除电脑文件。服务器只保存账号、设备、授权目录和文件索引元数据。

费用提醒

对象存储通常按存储量、请求次数和外网下行流量计费。把文件迁回本地、手机打开云端文件都可能产生下行流量费用。各厂商的免费额度、取回策略和最低存储期限不同,请先在控制台查看计费说明。

02安装电脑端

  1. 获取并运行安装包

    从 Windows 最新版下载 获取安装包,放到本机后双击。安装程序需要管理员权限,可按向导选择安装位置。

  2. 允许安装器自动准备组件

    安装时会尝试启用 Windows 的 WebDAV 客户端(WebClient),并在缺少 Visual C++ 运行库时联网下载安装。若这一步被安全软件拦截,不需要手动敲命令:首次挂载失败时点客户端里的「一键修复并重试」,按提示允许一次管理员授权即可。

  3. 选择是否开机自动启动

    首次登录后,客户端会询问是否随 Windows 启动。开启后会在当前 Windows 用户的启动项中登记,可在「任务管理器 → 启动应用」看到「存储熊」或「StorageBear」;之后在托盘静默运行,不弹主窗口。可在「设置与帮助 → 这台电脑」中随时关闭。需要开机自动挂载网络盘时,再单独打开虚拟磁盘页的「开机后自动挂载」。

  4. 处理系统的安全提示

    当前版本可能未做代码签名,Windows SmartScreen 会提示“未知发布者”。请确认安装包来源可信后再选择“更多信息 → 仍要运行”。不要从陌生来源下载安装包。

  5. 注册或登录同一账号

    启动存储熊并在“注册”页填写邮箱,点击“获取验证码”。验证码会发送到该邮箱,10 分钟内有效,连续输错 5 次需重新获取;没收到时请检查垃圾邮件,并等待 60 秒后再重发。填入验证码、密码后创建账号。电脑端注册后会以“电脑”类型登记设备;手机端功能上线后可用同一账号登录。

  6. 认识六个页面

    左侧依次是:总览、文件库、云端与续费、迁出与迁回、虚拟磁盘、手机访问(开发中)。右上角有“一键扫描”,设置页可查看客户端版本、服务连接和手册入口。

无需单独安装 Python

本地代理已随客户端打包,普通用户不需要安装 Python、配置环境变量或手动启动服务。若安全软件拦截本地代理,请允许存储熊在本机回环地址上运行。

之后怎么更新

客户端会在联网时从存储熊服务器的 /updates/ 检查新版本,发现更新后询问是否下载;也可以到「设置与帮助 → 关于」点「检查更新」。安装过程会保留你的账号、索引与本地配置。若提示无法检查更新,通常是网络问题或服务器更新目录暂未就绪,可从宣传页的「Windows 最新版」获取安装包覆盖安装。

服务器连接与账号

客户端内置本项目部署的服务器 http://47.100.27.233,登录页不再需要填写服务器地址。当前未启用 HTTPS,登录密码与令牌在传输中不加密,请只在可信网络使用;域名备案完成并启用 HTTPS 后,会随新版本把内置地址切回 https:// 域名。账号密码用于登录存储熊;云厂商 AccessKey 是另一套密钥,只保存在本机。

03授权目录与首次扫描

扫描只读取文件名、路径、大小、修改时间和类型,不读取文件正文,也不会上传文件。索引用于文件库、搜索、分享、迁移和手机浏览(开发中)。

  1. 选择扫描目录

    点击“一键扫描”,添加要建立索引的目录。不要直接选整个系统盘;Windows、Program Files、回收站等系统目录会被自动跳过。建议先选一个资料目录试跑。

  2. 确认文件类型

    默认索引 PDF、Office / WPS 文档、常见音视频,以及 zip、rar、7z、tar、gz 等压缩包;图片等其他类型可在扫描选项中追加扩展名。文档范围包括 docx、xlsx、pptx、旧版 doc、xls、ppt,以及 WPS 原生 wps、et、dps。只有 docx、xlsx、pptx 支持内置预览,其余会索引并交给本机 Office 或 WPS 打开。

  3. 开始扫描并等待完成

    文件数量多时扫描会持续一段时间。期间请保持电脑开机,避免休眠中断。完成后,文件会出现在“文件库”,可以用类型、状态和云存储三个下拉框组合筛选,也可搜索文件名或路径。迁出后的文件仍会留在文件库中并标记为“仅云端”。

  4. 设置免扫路径(推荐)

    在“设置与帮助 → 扫描目录与扩展名”中添加免扫路径,例如 C:\Users\你的用户名\.dsh。即使以后扫描它的上级目录甚至整个 C 盘,这个路径下的文件和子目录也会被完全跳过。点“从应用选择”可以读取 Windows 已安装应用,一次勾选多个应用并加入免扫。

  5. 预留手机可见范围(开发中)

    手机访问上线后,只有被加入授权范围的目录才会出现在手机端;目前该功能暂未开放,可先完成目录扫描。届时手机上看到的目录结构来自电脑,文件能否打开取决于电脑是否在线、原文件是否存在,以及云存储是否可用。

  6. 后续更新索引

    新增或移动文件后,可再次扫描对应目录刷新索引。索引是“快照”,不会实时监听每一次文件变化。

下载目录里的压缩包

文件库顶部的「下载目录压缩包」只读取系统下载目录的第一层,列出 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、访问样式选路径样式。

ALI 阿里云 OSS

需使用 S3 兼容 Endpoint;中国内地新桶可能要求绑定自定义域名。示例:s3.oss-cn-hangzhou.aliyuncs.com

COS 腾讯云 COS

使用 COS 的 S3 兼容访问方式。地域、桶名和 Endpoint 必须匹配。示例:cos.ap-guangzhou.myqcloud.com

OBS 华为云 OBS

以 OBS 控制台显示的 S3 兼容 Endpoint 为准,注意区分不同地域。示例:obs.cn-north-4.myhuaweicloud.com

TOS 火山引擎 TOS

TOS 的 S3 端点必须带 -s3-,且只支持虚拟主机样式。示例:tos-s3-cn-beijing.volces.com

OOS 天翼云 OOS

请先在 OOS 控制台获取 S3 兼容 Endpoint 后填入;不同资源池的地址不同。

S3 MinIO / 其他 S3 兼容

可接入自建 MinIO 或标准 S3 兼容端点。自建服务要确保电脑能访问该地址,并注意 HTTP 的安全性。

R2 Cloudflare R2

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,并在迁回时勾选保留云端副本。

保存并测试

  1. 选择厂商预设

    选择最接近的厂商后,Endpoint 与地域会自动填入示例值,仍需按你的实际桶修改。

  2. 填写桶和密钥

    桶名不含路径;AccessKey 与 SecretKey 填在电脑端,不会发送到存储熊服务器。

  3. 测试连接

    保存前点击“测试连接”。成功说明端点、地域、桶名和密钥基本匹配;失败时先看错误码,再核对第 12 节。

  4. 补充配额与续费信息

    到期日期与续费网址用于提醒和跳转,不会自动扣款。配额可留空,具体以厂商控制台为准。

密钥保护因平台而异

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 资源管理器提示是否覆盖;覆盖后云端对象会被替换。
  • 文件正文只在你的电脑与云存储之间传输,不经过存储熊服务器。

本机索引镜像(可选)

在虚拟磁盘页关闭“云端盘模式”后,盘内改为只读镜像:展示已扫描的目录结构与云端副本。写入、改名、删除不会同步到原文件或云端,适合查看索引。

  1. 启动服务

    进入“虚拟磁盘”,点击“启动服务”。状态应显示“服务就绪”。

  2. 挂载为网络盘

    Windows 点击“挂载为网络盘”,软件会映射一个空闲盘符,你也可以指定盘符,例如 Z。自动挂载会先用专用本地账号(Windows 会保存凭据,打开盘符时仍能认证),失败后再尝试仅对本机有效的随机安全会话。每次显示挂载成功后,客户端会实际打开一次盘符验证;打不开会自动换下一种方式。

  3. 设置自动挂载

    需要开机即用时,打开“开机后自动挂载”,并确保存储熊已随系统启动、登录的是同一个 Windows 账号。自动启动可在设置页或首次登录提示中开启。

  4. macOS / Linux

    点击挂载会显示连接方法。使用系统文件管理器的“连接服务器”功能,填入界面显示的本机 WebDAV 地址、用户名和密码。

  5. 不用时卸载

    点击“卸载网络盘”或“停止服务”。停止服务后,旧连接地址不可再用。

写入边界

云端盘只在自动生成的桶文件夹内开放上传和新建文件夹;根目录始终只读。当前不支持删除、移动和改名,因为这些操作在对象存储里往往不可逆或需要先复制再删除。同名上传按覆盖处理,资源管理器会先询问是否替换。

挂载失败时

直接点客户端里的「一键修复并重试」,Windows 弹出管理员授权时选「是」。它会自动启动 MRxDAV 网络重定向器和 WebClient、修正 HTTP 基本认证、把 WebClient 改为自动启动并重启服务,然后自动重试挂载;不需要输入 NET USE 或手动改注册表。若提示需要重启,请重启电脑后再挂载。修复失败时,界面会显示 MRxDAV、WebClient 的现场状态、每种挂载方式的结果和最近日志,可点「复制诊断」发给部署者。公司组策略或安全软件禁止 WebDAV 时,仍需管理员放行。这个地址只在本机有效,不能拿到手机上使用。

08手机单向访问(开发中)

该功能正在开发

当前版本暂不开放手机登录。下列说明是计划中的使用方式,正式上线后才会启用。

手机端将是一个网页入口,用与电脑端相同的账号登录(当前暂未开放)。它只列出你名下的电脑,不显示手机设备,也不允许电脑反向访问手机目录。权限是单向的。

  1. 登录并选择电脑

    登录后能看到电脑列表、在线状态和最近同步时间。离线电脑仍可浏览已有索引,但取回文件需要电脑重新上线。

  2. 浏览授权目录

    首页展示可访问的磁盘与目录。进入目录后可以返回上级,或直接在顶部切换到根目录。

  3. 搜索文件

    可输入文件名或路径片段,并按 PDF、音频、视频等类型筛选。搜索范围限于你有权限的电脑索引。

  4. 请求打开文件

    点击文件后,服务器会通知对应电脑准备链接。若电脑在线,通常几秒内即可拿到云端限时链接;若文件尚未上传,电脑会先生成云端副本。离线时会提示你先让电脑上线。

  5. 复制或打开链接

    拿到链接后可直接在手机浏览器打开,或复制到其他应用。链接来自云厂商,有有效期,也可能产生流量费用。

  6. 安全退出

    在“我的”页退出登录。共用手机或公共浏览器上务必退出,避免他人继续使用你的会话。

  • 手机不能上传、修改、删除或重命名电脑文件。
  • 手机不能浏览电脑未授权的目录。
  • 手机相册、通讯录等本机数据不会被索引,也不会被电脑查看。
  • 当前演示部署若仍使用 HTTP,登录令牌与密码在传输中不受加密保护,请勿在不可信网络使用,等待部署者启用 HTTPS。

09迁出、迁回与日志

这是存储熊最重要的数据操作,请先读完再执行。迁出把本地文件上传到云端;迁回把云端副本恢复到原路径。两者都会写入日志,用来回答“哪些文件去了哪里、有没有删本地、云端副本还在不在”。

迁出

  1. 选择文件或目录

    在文件库中勾选目标,或直接对某个目录迁出。目录会递归收集其中尚未迁出的文件。

  2. 选择云端目标

    可以选择单个云存储,也可以选择拼接组合。未指定时按规则选择可用目标。

  3. 确认是否删除本地文件

    默认迁出成功后删除本地副本,释放磁盘空间。只想保留云端副本、不删本地时,请关闭“移动/删除本地”选项。

  4. 等待任务完成并检查结果

    失败的文件会保留在本地并在结果中列出。不要只看进度条,务必查看错误摘要。

日志与清单在哪里

每次迁出会生成一个日志编号,清单以 JSONL 格式上传到对应桶的以下位置:

_storagebear/logs/<logid>.jsonl

清单逐行记录原路径、对象键、云存储、文件大小和修改时间。迁出日志同时保存在本机数据库并同步到存储熊服务器(不含文件正文)。迁回时优先按日志恢复;若日志文件被删除,可尝试按云存储或原路径恢复,但可能缺少精确对应关系。

请额外保留日志副本

日志默认只在目标桶与本机数据库中。如果桶被删除、密钥丢失或本机重装,日志可能一起消失。重要迁移完成后,建议在目标桶中复制一份 _storagebear/logs/ 到其他位置,并记录日志编号。

编辑回传与版本对象

在预览窗口编辑云端 Office / WPS 文件并选择“完成并上传”时,存储熊会执行一条可回滚的替换流程:先以新对象键上传修改后的文件,确认上传成功并更新索引后,才删除旧对象;上传失败不会提前删除旧版本。可回传的格式是 docx、xlsx、pptx;原生 doc、xls、ppt、wps、et、dps 暂不支持内置编辑回传。

  • 新对象键在原键后追加 -v时间戳-随机串;重复编辑会更新这个版本后缀,不会无限叠加。
  • 日志类型显示为“编辑回传”,记录原路径、新旧对象键、云存储、大小和时间;旧对象删除失败会单独标注。
  • 上传的是完整文件而不是增量,会产生上行流量和一次删除请求,可能计入云厂商账单。
  • 回传只替换当前对象,不额外保留历史版本;若云厂商开启了版本控制,旧版本是否保留由厂商策略决定。

迁回

续费不足、准备停用某家云、或需要在本机重新打开文件时,都可以迁回。你可以按迁出日志、按某家云存储、按具体文件路径或全部云端文件恢复。

  • 默认按原路径恢复,并恢复原修改时间。
  • 如果本地已经存在且大小相同的文件,默认跳过,避免覆盖你后来修改的版本;需要覆盖时请显式开启“覆盖已有文件”。
  • 下载成功后,默认删除对应云端副本并清除“仅云端”映射;如需保留,请开启“保留云端副本”,此时文件会标记为“本地 + 云”。
  • 如果云端删除失败,文件已经恢复到本地,错误会记录在日志中,可稍后手动清理。
  • 迁回同样会生成一条恢复日志,记录文件数量、来源云存储和是否保留云端副本。
删除云端前确认本地副本

只有成功下载的文件才会进入删除云端副本的步骤,但磁盘写满、权限错误或网络中断都可能造成部分失败。迁回完成后检查错误摘要与本地文件数量,再决定是否停用云存储或让它到期。

盘间迁移(mklink)

“迁出”是把文件放进云端,“盘间迁移”则是把文件搬到本机的另一块磁盘:C 盘太满时,把大文件或整个文件夹挪到 D / E 盘,同时在原位置留下一个链接。这样一来,路径不变、索引不变,程序、快捷方式、Office 的最近文件都照旧能用,但实际数据已经不在系统盘上了。

  1. 选择目标盘

    设置页会列出每块磁盘的剩余空间,并推荐空间最大的非系统盘。也可以从资源管理器右键「存储熊:迁移到其它盘并创建链接」直接开始。

  2. 选择文件或文件夹

    两者都支持,也可以多选。不建议把 D / E 盘的内容迁移回 C 盘,那会让系统盘更紧张。

  3. 先复制、再校验、后删除

    确认后,存储熊把内容完整复制到 <目标盘>\StorageBearLinks\<原盘符>\原路径,校验通过才删除原位置,再创建链接。目录用 junction,单文件用硬链接,跨盘时用符号链接。

  4. 失败会尽量回滚

    复制失败不会删除原文件;删除失败会提示哪个程序在占用;链接创建失败会把内容复制回原位并说明原因。

  • 目录链接(junction)不需要管理员权限;单文件优先建硬链接(同一块磁盘内直接成功),跨盘才会用到符号链接,而符号链接需要管理员权限或开启 Windows 开发者模式,失败时请右键以管理员身份运行存储熊后重试。
  • 磁盘根目录、Windows、Program Files、ProgramData 等系统目录,以及存储熊自身的数据目录都会被拒绝迁移。
  • 迁移不会改变文件的修改时间和内容,因此不需要重新扫描索引。
  • 迁移后的位置在资源管理器中看起来仍是原路径;如果移动了目标盘里的真实数据,原路径会失效。
  • 删除原链接不会删除目标盘里的数据;要真正删除,请到 StorageBearLinks 里操作。
迁移前请关闭占用程序

正在被 Word、播放器、虚拟机或同步盘占用的文件无法删除,迁移会失败并保留原样。关掉相关程序后重试即可;已经复制到目标盘的部分不会影响原文件。

10续费与到期提醒

存储熊只管理提醒,不代扣续费,也不售卖容量。你可以在每家云存储的编辑页填写到期日期和续费网址。距到期 15 天以内时,总览页与云端页面会出现提醒,并给出“一键迁回”入口。

  1. 记录真实到期日

    以云厂商控制台的到期时间为准。预付资源包、存储包和桶本身可能有不同的到期规则,存储熊无法自动读取这些信息。

  2. 填写续费网址

    填入厂商控制台相应页面的链接。点击“续费”时只会打开该链接,不传输密钥,也不会自动付款。

  3. 提前评估容量

    在“云端与续费”查看各家的云端副本占用、配额记录和剩余天数。临近到期的云存储,优先迁回重要文件。

  4. 到期前处理

    若不打算续费,务必在到期前完成迁回与验证,并另外保留日志。云服务过期后可能限制访问,甚至按厂商政策清理数据。

提醒不是保证

提醒依赖你填写的日期和客户端运行状态。客户端长期不开机、日期填错或系统通知被屏蔽时,提醒不会生效。请把它当作辅助,而不是唯一的续费保障。

+存储熊自身清理

用了几个月以后,程序自己的临时文件、预览副本、日志和下载过的更新包会占掉一些空间。这些都不是你的文件,可以随时清理:打开「设置与帮助」,在「存储熊自身清理」卡片点「统计占用」看明细,再点「一键清理」。

清理项位置说明
临时文件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 服务用于映射虚拟盘;云端盘默认桶内可写,根目录只读。
DPAPIWindows 的数据保护接口,用当前用户或系统凭据加密本机数据。
S3 兼容兼容亚马逊 S3 接口的访问方式。多数国内对象存储厂商都提供此类端点。

AI 创作声明与免责

本手册由 AI 辅助创作

本页全部说明文字(包括操作步骤、权限建议、故障判断和安全表述)由 AI 辅助生成,部署者可能进行了少量编辑。AI 可能产生不准确、不完整或已经过时的信息;云厂商的界面、计费规则、接口权限与政策也可能随时变化。

本手册不构成:云厂商的官方文档或服务承诺、法律或合规意见、对数据不会丢失的保证,也不替代你自己的备份与安全评估。涉及密钥、计费、数据删除和合规的操作,请以云厂商官方文档、控制台提示及你的实际情况为准。

如果你发现步骤与软件界面不一致,或某个链接、端点已经变化,请停止操作并联系部署者核验。不要依据未经核验的 AI 文本做出不可逆的删除决定。

  • 先在少量测试文件上验证迁出、日志和迁回。
  • 重要数据至少保留一份独立备份。
  • 密钥使用最小权限,并定期轮换。
  • 迁移前确认容量、流量费用和到期时间。

存储熊 v0.3.1 · 本手册为 AI 辅助创作 · 厂商名称与商标归各自权利人所有。最后更新:2026 年 10 月。