存储系统
Mailru

Mailru

Mail.ru Cloud 是由俄罗斯互联网公司 Mail.Ru Group 提供的云存储服务。官方桌面客户端是 Disk - O:，支持 Windows 和 Mac OS 系统。

功能亮点

  • 路径可以按需设置深度，例如 remote:directory/subdirectory
  • 文件具有 最后修改时间 属性，而目录没有
  • 删除的文件默认会移动到回收站
  • 文件和目录可以通过公共链接共享
  • 不支持部分上传或流式上传，上传前必须知道文件大小
  • 免费账户的单个文件最大大小限制为 2G，付费账户则无限制
  • 存储系统会为所有文件保存哈希值，并进行透明的去重处理，哈希算法是改进版的 SHA1
  • 如果存储中已经存在某个特定文件，可以快速提交文件哈希值，而不是进行长时间的文件上传（rclone 支持此优化功能）

配置

以下是一个配置 Mail.ru 云存储的示例。

首先，创建一个 Mail.ru Cloud 账户并选择一个套餐。

你需要登录并为 rclone 创建一个应用密码。rclone 不能使用 你的普通用户名和密码，否则会出现类似 oauth2: server response missing access_token 的错误。

  • 点击右上角的用户图标
  • 进入安全设置 / “Пароль и безопасность”（密码和安全）
  • 点击应用密码 / “Пароли для внешних приложений”（外部应用密码）
  • 添加密码 - 给它取个名字，例如 “rclone”
  • 复制该密码，后续使用此密码，普通登录密码将无法使用。

现在运行

rclone config

这将引导你完成一个交互式的设置过程：

No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Type of storage to configure.
Enter a string value. Press Enter for the default ("").
Choose a number from below, or type in your own value
[snip]
XX / Mail.ru Cloud
   \ "mailru"
[snip]
Storage> mailru
User name (usually email)
Enter a string value. Press Enter for the default ("").
user> [email protected]
Password

This must be an app password - rclone will not work with your normal
password. See the Configuration section in the docs for how to make an
app password.
y) Yes type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Skip full upload if there is another file with same data hash.
This feature is called "speedup" or "put by hash". It is especially efficient
in case of generally available files like popular books, video or audio clips
[snip]
Enter a boolean value (true or false). Press Enter for the default ("true").
Choose a number from below, or type in your own value
 1 / Enable
   \ "true"
 2 / Disable
   \ "false"
speedup_enable> 1
Edit advanced config? (y/n)
y) Yes
n) No
y/n> n
Remote config
Configuration complete.
Options:
- type: mailru
- user: [email protected]
- pass: *** ENCRYPTED ***
- speedup_enable: true
Keep this "remote" remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y

配置使用说明

此后端的配置不需要本地 Web 浏览器。你可以按如下方式使用已配置的后端：

查看顶级目录

rclone lsd remote:

创建一个新目录

rclone mkdir remote:directory

列出目录的内容

rclone ls remote:directory

将 /home/local/directory 同步到远程路径，并删除该路径中多余的文件。

rclone sync --interactive /home/local/directory remote:directory

修改时间和哈希值

文件支持修改时间属性，精度最高可达 1 秒。 目录没有修改时间，显示为 “1970 年 1 月 1 日”。

文件哈希功能受支持，采用基于 SHA1 的自定义 Mail.ru 算法。 如果文件大小小于或等于 SHA1 块大小（20 字节）， 其哈希值就是其数据右填充零字节后的结果。 对于较大文件，其哈希值是文件数据字节与数据长度的十进制表示形式拼接后的 SHA1 值。

清空回收站

删除文件或目录实际上是将其移动到回收站，rclone 无法看到回收站，但可以在 Web 浏览器中查看。被删除的文件仍然占用部分总配额。如果你想清空回收站并释放一些配额，可以使用 rclone cleanup remote: 命令，该命令将永久删除所有已删除的文件。 此命令不接受任何路径参数。

配额信息

要查看当前配额，可以使用 rclone about remote: 命令，该命令将显示你的使用限制（配额）和当前使用情况。

受限文件名的字符

除了 默认受限字符集 之外，以下字符也会被替换：

字符 编码值 替换字符
" 0x22 ＂
* 0x2A ＊
: 0x3A ：
< 0x3C ＜
> 0x3E ＞
? 0x3F ？
\ 0x5C ＼
| 0x7C ｜

无效的 UTF-8 字节也会被 替换，因为它们不能用于 JSON 字符串。

标准选项

以下是 Mail.ru（Mail.ru 云存储）特定的标准选项。

–mailru-client-id

OAuth 客户端 ID。

通常留空。

属性：

  • 配置项：client_id
  • 环境变量：RCLONE_MAILRU_CLIENT_ID
  • 类型：字符串
  • 是否必需：否

–mailru-client-secret

OAuth 客户端密钥。

通常留空。

属性：

  • 配置项：client_secret
  • 环境变量：RCLONE_MAILRU_CLIENT_SECRET
  • 类型：字符串
  • 是否必需：否

–mailru-user

用户名（通常是电子邮件）。

属性：

  • 配置项：user
  • 环境变量：RCLONE_MAILRU_USER
  • 类型：字符串
  • 是否必需：是

–mailru-pass

密码。

这必须是应用密码 - rclone 不能使用你的普通密码。有关如何创建应用密码，请参阅文档中的配置部分。

注意：输入此密码时必须进行加密处理 - 请参阅 rclone obscure。

属性：

  • 配置项：pass
  • 环境变量：RCLONE_MAILRU_PASS
  • 类型：字符串
  • 是否必需：是

–mailru-speedup-enable

如果存在具有相同数据哈希的另一个文件，则跳过完整上传。

此功能称为 “加速” 或 “按哈希上传”。对于常见的可用文件（如流行书籍、视频或音频片段），此功能特别有效，因为会在所有 Mail.ru 用户的所有账户中按哈希搜索文件。 如果源文件是唯一的或加密的，则此功能没有意义且无效。 请注意，rclone 可能需要本地内存和磁盘空间来预先计算内容哈希，并决定是否需要完整上传。 此外，如果 rclone 事先不知道文件大小（例如，在流式传输或部分上传的情况下），它甚至不会尝试此优化。

属性：

  • 配置项：speedup_enable
  • 环境变量：RCLONE_MAILRU_SPEEDUP_ENABLE
  • 类型：布尔值
  • 默认值：true
  • 示例：
    • “true”
      • 启用
    • “false”
      • 禁用

高级选项

以下是 Mail.ru（Mail.ru 云存储）特定的高级选项。

–mailru-token

OAuth 访问令牌，以 JSON 格式存储。

属性：

  • 配置项：token
  • 环境变量：RCLONE_MAILRU_TOKEN
  • 类型：字符串
  • 是否必需：否

–mailru-auth-url

认证服务器 URL。

留空则使用提供商的默认值。

属性：

  • 配置项：auth_url
  • 环境变量：RCLONE_MAILRU_AUTH_URL
  • 类型：字符串
  • 是否必需：否

–mailru-token-url

令牌服务器 URL。

留空则使用提供商的默认值。

属性：

  • 配置项：token_url
  • 环境变量：RCLONE_MAILRU_TOKEN_URL
  • 类型：字符串
  • 是否必需：否

–mailru-client-credentials

使用客户端凭证 OAuth 流程。

这将使用 RFC 6749 中描述的 OAUTH2 客户端凭证流程。

属性：

  • 配置项：client_credentials
  • 环境变量：RCLONE_MAILRU_CLIENT_CREDENTIALS
  • 类型：布尔值
  • 默认值：false

–mailru-speedup-file-patterns

符合加速（按哈希上传）条件的文件名模式列表，以逗号分隔。

模式不区分大小写，并且可以包含 ‘*’ 或 ‘?’ 通配符。

属性：

  • 配置项：speedup_file_patterns
  • 环境变量：RCLONE_MAILRU_SPEEDUP_FILE_PATTERNS
  • 类型：字符串
  • 默认值：".mkv,.avi,.mp4,.mp3,.zip,.gz,.rar,.pdf"
  • 示例：
    • ""
      • 空列表将完全禁用加速（按哈希上传）。
    • “*”
      • 所有文件都将尝试进行加速。
    • “.mkv,.avi,.mp4,.mp3”
      • 仅常见的音频/视频文件将尝试按哈希上传。
    • “.zip,.gz,.rar,.pdf”
      • 仅常见的存档文件或 PDF 书籍将尝试进行加速。

–mailru-speedup-max-disk

此选项允许你针对大文件禁用加速（按哈希上传）。

原因是预先哈希可能会耗尽你的 RAM 或磁盘空间。

属性：

  • 配置项：speedup_max_disk
  • 环境变量：RCLONE_MAILRU_SPEEDUP_MAX_DISK
  • 类型：SizeSuffix
  • 默认值：3Gi
  • 示例：
    • “0”
      • 完全禁用加速（按哈希上传）。
    • “1G”
      • 大于 1Gb 的文件将直接上传。
    • “3G”
      • 如果你的本地磁盘可用空间少于 3Gb，请选择此选项。

–mailru-speedup-max-memory

大于以下指定大小的文件将始终在磁盘上进行哈希计算。

属性：

  • 配置项：speedup_max_memory
  • 环境变量：RCLONE_MAILRU_SPEEDUP_MAX_MEMORY
  • 类型：SizeSuffix
  • 默认值：32Mi
  • 示例：
    • “0”
      • 预先哈希将始终在临时磁盘位置进行。
    • “32M”
      • 不要为预先哈希分配超过 32Mb 的 RAM。
    • “256M”
      • 你最多有 256Mb 的 RAM 可用于哈希计算。

–mailru-check-hash

如果文件校验和不匹配或无效，复制操作应如何处理。

属性：

  • 配置项：check_hash
  • 环境变量：RCLONE_MAILRU_CHECK_HASH
  • 类型：布尔值
  • 默认值：true
  • 示例：
    • “true”
      • 报错失败。
    • “false”
      • 忽略并继续。

–mailru-user-agent

客户端内部使用的 HTTP 用户代理。

默认为 “rclone/VERSION” 或命令行中提供的 “–user-agent”。

属性：

  • 配置项：user_agent
  • 环境变量：RCLONE_MAILRU_USER_AGENT
  • 类型：字符串
  • 是否必需：否

–mailru-quirks

内部维护标志列表，以逗号分隔。

普通用户不应使用此选项。它仅用于方便远程排查后端问题。标志的严格含义未记录，并且不保证在不同版本之间保持一致。当后端稳定后，这些标志将被移除。 支持的标志：atomicmkdir binlist unknowndirs

属性：

  • 配置项：quirks
  • 环境变量：RCLONE_MAILRU_QUIRKS
  • 类型：字符串
  • 是否必需：否

–mailru-encoding

后端的编码方式。

有关更多信息，请参阅 概述中的编码部分。

属性：

  • 配置项：encoding
  • 环境变量：RCLONE_MAILRU_ENCODING
  • 类型：Encoding
  • 默认值：Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,InvalidUtf8,Dot

–mailru-description

远程存储的描述。

属性：

  • 配置项：description
  • 环境变量：RCLONE_MAILRU_DESCRIPTION
  • 类型：字符串
  • 是否必需：否

限制

文件大小限制取决于你的账户类型。免费账户的单个文件大小限制为 2G，付费账户则无限制。有关总上传大小限制，请参考 Mail.ru 网站。

请注意，Mail.ru 不区分大小写，因此你不能同时拥有名为 “Hello.doc” 和 “hello.doc” 的文件。

Local FilesystemMega