r2：Cloudflare R2 桌面客户端

项目简介

r2 是一款免费开源的桌面 GUI 客户端，用来管理 Cloudflare R2、AWS S3、MinIO 和 RustFS 对象存储。它基于 Tauri、Next.js 与 React 构建，可在 macOS、Windows 和 Linux 上运行，支持多账号、多 Token，并能把任意 bucket 挂载成本地磁盘，像操作 Finder / 资源管理器里的文件夹一样读写远端文件。

主要功能

• 多服务商与多账号：支持 R2、AWS S3、MinIO、RustFS（强制 path-style）；同一个账号（R2）下可以保存多个 API Token，分别对应不同的 bucket 权限。
• 文件管理：浏览 bucket 目录，上传文件与文件夹，支持断点续传的分片上传。
• 文件预览：
  • 图片：jpg、jpeg、png、gif、webp、svg、bmp、ico
  • 视频：mp4、webm、ogg、mov、m4v
  • PDF：带翻页的完整阅读器
  • 文本/代码：基于 Monaco Editor 的语法高亮查看器，覆盖 js/ts/jsx/tsx/css/html/vue/svelte、json/yaml/toml/xml/env、md/txt/log、sh/ps1/bat、csv/sql 等
• 批量操作：批量下载（进度追踪、可暂停恢复）、批量移动（文件夹树选择）、批量删除、文件夹内批量重命名。
• 跨账号传输：在 R2 / S3 / MinIO / RustFS 之间移动或复制文件；同服务商优先走服务端复制，跨服务商流式传输无需临时文件；大文件并行分片上传（4 并发分片），最多 5 个并发传输，支持暂停/恢复/取消，关闭弹窗后队列仍在后台继续。
• 挂载为本地磁盘：把 bucket 挂载到本地文件夹，默认可读写，也可以切换为只读；由应用自身提供 NFSv3 服务，无需 macFUSE、WinFsp 或内核扩展；可在「设置 → Mounts」统一管理，退出应用时自动卸载。
• 视频缩略图生成（依赖 ffmpeg）、复制签名链接或公开链接、深色模式、自动更新，以及一键「报告问题」（自动附带版本、系统信息和最近 5 分钟错误日志，密钥会脱敏，提交前由你确认）。

安装与使用

macOS 可用 Homebrew 安装：

brew install dickwu/tap/r2

也可以从 Releases 页面 下载对应安装包：macOS 为 .dmg（Apple Silicon 与 Intel），Windows 为 .msi 或 .exe，Linux 为 .deb、.rpm 或 .AppImage。

首次启动会自动弹出「Add Account」对话框：选择服务商，填写对应凭据（R2 需要 Account ID、Access Key ID / Secret Access Key；S3 需要密钥与 Region；MinIO / RustFS 需要密钥与 Endpoint），点击 Load 拉取 bucket 列表，也可以手动添加 bucket 名称。

把 bucket 挂载为本地磁盘：在侧边栏点击 bucket 的 ⋯ 菜单 → Mount as local drive，选择本地文件夹（默认 ~/CloudMounts/<bucket>）即可。

账号配置保存在本地 SQLite 数据库：macOS 为 ~/Library/Application Support/r2/uploads-turso.db，Windows 为 %APPDATA%\r2\uploads-turso.db，Linux 为 ~/.local/share/r2/uploads-turso.db。

如果要从源码构建，需要 Node.js（v18+）、Bun 和 Rust，然后执行：

bun install
bun run tauri dev

注意事项

• macOS 首次打开需要在「系统设置 → 隐私与安全性」中点击「仍要打开」；若应用未出现在该列表中，可执行 sudo xattr -d com.apple.quarantine /Applications/r2.app/。
• Linux 挂载需要安装 nfs-utils（或 nfs-common），某些发行版需要按应用给出的 sudo mount 命令手动执行一次。
• Windows 暂不支持挂载功能，官方表示后续版本会加入。
• 可写挂载的上传在后台完成，需保持应用运行；挂载期间本机其他应用也能读取（可写挂载还能修改）这些文件，但服务不会暴露到网络。macOS 还会向 bucket 写入 .DS_Store 等辅助文件。
• 在两个已挂载 bucket 之间移动文件会经过本机中转（NFSv3 的限制），大批量跨 bucket 传输建议使用应用内的 Batch Move，可走服务端复制、速度更快。

本作品整理自 GitHub 开源项目 dickwu/r2，原作者 @dickwu。中文介绍由 AI 根据项目 README 整理，以原仓库为准。