Rivet 是一个跨平台(Windows / macOS / Linux)的远程服务器桌面文件浏览器,支持 SFTP、SMB、WebDAV 与 S3(兼容 AWS S3、Cloudflare R2、Backblaze B2 等服务)。它把远端目录当作本地文件管理器来用:连接、浏览、上传下载、改名、删除、复制移动、冲突处理和传输管理都在同一个窗口完成。
- SFTP:密码、私钥 + 口令、SSH agent;首次连接的主机密钥确认与 known-hosts 记忆。
- SMB:SMB 2.0.2 / 2.1 共享,NTLMv2 密码认证;填主机、端口和服务器导出的共享名。适合 Windows 共享与 NAS。当前不支持 SMB3、签名、加密与 Kerberos。
- WebDAV:Basic / Digest 认证、自定义基础路径、自签证书开关。
- S3:任意 S3 兼容端点,可配 region、桶、path-style 与桶内前缀;桶名可从账号的桶列表里直接选,不用记。上传走 multipart,支持超过 5 GiB 的文件。
- 粘贴地址连接:从剪贴板识别
sftp://、smb://、webdav(s)://地址,自动填好新建连接表单。 - 连接过程有状态反馈,可随时取消;超过 30 秒无响应按超时失败,不会在后台留下已建立却无人使用的连接。
- 多连接管理;连接配置持久化,密码只在主进程经
safeStorage加密存储,私钥只保存路径。
- 列表 / 宫格视图,虚拟滚动、排序、框选、右键菜单与常用快捷键。
- 条目拖到其它目录即移动;名称列是拖动源,其余列与空白处仍是框选。
- 前进 / 后退、地址栏、当前目录过滤;复制路径与收藏文件夹。
- 每台服务器记住最后停留的目录,重连或下次启动直接回到原处。
- 新建文件夹、重命名、删除、复制、移动、刷新。
- 大目录分页加载,一次没列完可继续加载。
- 文件夹属性统计:文件数、文件夹数、总大小;状态栏显示选中文件的总大小与文件夹数量。
- 上传 / 下载冲突处理:覆盖、跳过、保留两者,可应用到全部。
- 文件与文件夹的上传、下载,支持拖拽上传。
- 上传、下载各自独立的并发上限(1–10);可分别限速(KB/s,0 表示不限速),同一方向的并发任务共享这份配额。
- 任务进度与速度、子文件进度、失败详情、取消与重试。
- 下载可暂停 / 继续:继续时从已下载的字节接着传,已落盘的文件不再重下;文件夹按「文件在且没有半成品」判定已完成。上传暂不支持断点续传。
- 底部传输队列可收起、拖高或最大化;跨连接时按会话分组。
- SFTP 连接可以在底部抽屉里打开交互式 shell,
Ctrl+`切换;打开时自动cd到当前浏览目录。 - 与文件会话同生共死:断开连接或心跳掉线会一并关闭终端。
- 只做最基础的命令交互:没有多标签、tmux、端口转发、会话恢复,也没有本地 shell。
- 服务器拒绝 shell 时提示「该服务器不允许交互式 shell」;只放行 sftp 子系统的(例如
ForceCommand internal-sftp)会打印服务端原文后标为「已退出」。判定只能匹配 ssh2 的错误文案。 - SMB、WebDAV、S3 不提供终端入口。
- 浅色 / 深色 / 跟随系统主题;Windows 11 22H2+ 的 Mica、macOS 13+ 的 vibrancy。
- 中文 / English 界面。
- 单窗口、可调整侧栏、原生窗口控制;关窗默认最小化到托盘继续传输(可改为退出),后台完成或失败有系统通知。
当前 SMB 基于 v9u-smb2,上游三处缺陷都在应用层绕开,不修改依赖源码:readdir 把文件列表当句柄传给 CLOSE,目录句柄因此泄漏、删除可能只进 delete-pending(改为复用其消息层自行遍历,src/main/providers/smb/readdir.ts);写流在 _final/_destroy 重复 CLOSE(包装后只关一次);CREATE 的 DesiredAccess 带上目录专用的 FILE_DELETE_CHILD,Samba 对既有文件回 ACCESS_DENIED(在消息生成阶段剔除)。
会话按空闲池复用(上限 4),失败的操作一律换新会话;并发读写各占一条会话,并行传输仍有各自的 TCP 连接。删除后按一次 stat 定性:条目还在就报失败,只有 delete-pending 才重试。
已知限制:改名/移动固定 ReplaceIfExists=true,Windows 上目标已存在或被占用时返回 ACCESS_DENIED,界面按权限不足提示。
对象存储没有目录、没有 rename,也没有原子覆盖:目录是前缀,空目录靠零字节的 <prefix>/ 标记维持,改名是 copy + delete(目录改名会逐个对象搬运,中断会留下部分副本),上传的数据在 multipart 完成前对读端不可见。文件名(key)大小写敏感,#、%、+、空格由 SDK 负责编码。
上传时按扩展名写入 Content-Type(图片、PDF、文本在浏览器里能直接打开),右键可为单个对象生成预签名链接,默认一天有效。
已知限制:不支持版本控制与 ACL/桶策略;STS 临时凭证(sessionToken)未实现;「路径」以桶内前缀为根,不能跨桶浏览。
| 层 | 选型 |
|---|---|
| 桌面 | Electron、electron-forge |
| 界面 | React、TypeScript、Vite、Tailwind CSS、radix-ui、Zustand、TanStack Query / Virtual、i18next |
| 协议 | ssh2、undici、fast-xml-parser、v9u-smb2、@aws-sdk/client-s3 与 s3-request-presigner |
| 日志 | electron-log(按天 + 按大小滚动) |
环境要求:Node 24 LTS、pnpm 12。
pnpm install
pnpm run dev
pnpm run verifypnpm run verify依次执行 typecheck、lint、单元测试、类型测试、i18n 检查、生产依赖审计与打包。pnpm run build产出可运行的免安装目录(pnpm run verify用的是它);要安装包用pnpm run package。- 国内网络卡在 Electron 二进制下载时,先设临时镜像再装依赖:
$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"(PowerShell)。 - 真实服务集成测试(provider 层,默认不进 verify):先起
scripts/sftp/serve.py与scripts/dav/serve.py(或 Docker),再RIVET_INTEGRATION=1 pnpm run test:integration;S3 用例默认连127.0.0.1:9000,可用RIVET_S3_ENDPOINT、RIVET_S3_BUCKET、RIVET_S3_ACCESS_KEY、RIVET_S3_SECRET_KEY指向任意 S3 兼容端点。SMB 用例默认连127.0.0.1:1445,用RIVET_SMB_*覆盖。 - E2E 需要 Docker:
pnpm run e2e:servers→pnpm run build→pnpm run test:e2e→pnpm run e2e:servers:down。E2E 包含 SFTP、SSH 终端、SMB(Samba,SMB2-only)、WebDAV 与 S3(s3mock)。 - 手动验证 SFTP 页面:
python scripts/sftp/serve.py(Paramiko,依赖见scripts/sftp/requirements.txt;--auth publickey、--emit-client-key、--readonly、--rotate-host-key切换分支)。 - 手动验证 SMB 页面:连接真实 SMB2 服务器;不知道共享名时用
python scripts/smb/list-shares.py <host> --user <user>枚举。 - 手动验证 WebDAV 页面:
python scripts/dav/serve.py(WsgiDAV,依赖见scripts/dav/requirements.txt;--auth digest、--https、--base-path、--readonly切换分支)。 - 手动验证 S3 页面:
python scripts/s3/serve.py(moto,依赖见scripts/s3/requirements.txt;本机没装 Docker 时用)。 - 更多命令与工程约定见 AGENTS.md。
主进程持有窗口、连接、文件系统、传输与秘密;渲染层只通过类型化 IPC 契约访问能力;协议差异收敛在 FileProvider。详见 docs/architecture.md。
