Uloz.to

Uloz.to

路径指定为 remote:path

路径可以按需设置深度,例如 remote:directory/subdirectory

Uloz.to 的初始设置需要填写用户凭证。rclone config 会引导你完成这一过程。

配置

以下是一个创建名为 remote 的远程存储的示例。首先运行:

 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.
Choose a number from below, or type in your own value
[snip]
XX / Uloz.to
   \ "ulozto"
[snip]
Storage> ulozto

Option app_token.
The application token identifying the app. An app API key can be either found in the API doc 
https://uloz.to/upload-resumable-api-beta or obtained from customer service.
Enter a value. Press Enter to leave empty.
app_token> token_value

Option username.
The username of the principal to operate as.
Enter a value. Press Enter to leave empty.
username> user

Option password.
The password for the user.
Choose an alternative below. Press Enter for the default (n).
y) Yes, type in my own password
g) Generate random password
n) No, leave this optional password blank (default)
y/g/n> y
Enter the password:
password:
Confirm the password:
password:

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Keep this "remote" remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y

配置完成后,你可以像这样使用 rclone

列出根目录下的文件夹:

rclone lsd remote:

列出根目录下的所有文件:

rclone ls remote:

将本地文件夹复制到 Uloz.to 上名为 backup 的文件夹:

rclone copy /home/source remote:backup

用户凭证

唯一可靠的用户认证方法是使用用户名和密码。Uloz.to 也提供了 API 密钥,但它仅用于 Uloz.to 内部应用程序,在其他情况下使用并不可靠。

修改时间和哈希值

Uloz.to 不允许用户设置自定义的修改时间,也不允许在上传后获取哈希值。因此,集成方案使用 API 提供的一个自由格式字段来编码客户端提供的时间戳和哈希值。时间戳以微秒精度存储。

上传时会验证服务器计算的文件 MD5 哈希值。之后,后端仅提供客户端计算的哈希值。在创建文件下载链接时也可以获取哈希值,但在类似 list 的操作中并不实用。

受限文件名的字符

除了默认的受限字符集之外,以下字符也会被替换:

字符 编码值 替换字符
\ 0x5C

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

传输

目前,所有文件都通过单个 HTTP 请求上传,因此上传大文件时需要稳定的网络连接。Rclone 会同时上传最多 --transfers 个块(所有上传任务共享)。

删除文件

默认情况下,文件会被移动到回收站,而文件夹会被立即删除。回收站中的文件在 30 天后会被永久删除。

目前,rclone 尚未实现清空回收站的功能。

根文件夹 ID

你可以为 rclone 设置 root_folder_slug。这是 rclone 视为 Uloz.to 驱动器根目录的文件夹(由其 文件夹别名 标识)。

通常,你可以留空此选项,rclone 会自行确定正确的根目录。但是,你可以设置此选项来限制 rclone 只能访问特定的文件夹层次结构。

要做到这一点,你需要找到你想用作根目录的文件夹的 文件夹别名。这将是你在 Uloz.to 网页界面中打开相关文件夹时 URL 的最后一段。

例如,要浏览 URL 为 https://uloz.to/fm/my-files/foobar 的文件夹,应将 foobar 用作根别名。

root_folder_slug 可以与远程路径中的特定路径一起使用。例如,如果你的远程配置的 root_folder_slug 对应于 /foo/bar,那么 remote:baz/qux 将指向 Uloz.to 绝对根目录/foo/bar/baz/qux

标准选项

以下是 Uloz.to 特有的标准选项。

–ulozto-app-token

用于标识应用程序的应用令牌。应用程序 API 密钥可以在 API 文档 https://uloz.to/upload-resumable-api-beta 中找到,也可以从客服处获取。

属性:

  • 配置项:app_token
  • 环境变量:RCLONE_ULOZTO_APP_TOKEN
  • 类型:字符串
  • 是否必需:否

–ulozto-username

要操作的主体的用户名。

属性:

  • 配置项:username
  • 环境变量:RCLONE_ULOZTO_USERNAME
  • 类型:字符串
  • 是否必需:否

–ulozto-password

用户的密码。

注意:输入此选项的值必须进行加密处理 - 请参阅 rclone obscure

属性:

  • 配置项:password
  • 环境变量:RCLONE_ULOZTO_PASSWORD
  • 类型:字符串
  • 是否必需:否

高级选项

以下是 Uloz.to 特有的高级选项。

–ulozto-root-folder-slug

如果设置了该选项,rclone 将使用此文件夹作为所有操作的根文件夹。例如,如果别名标识的是 foo/bar/,那么在未设置任何根别名的情况下,ulozto:baz 等同于 ulozto:foo/bar/baz

属性:

  • 配置项:root_folder_slug
  • 环境变量:RCLONE_ULOZTO_ROOT_FOLDER_SLUG
  • 类型:字符串
  • 是否必需:否

–ulozto-list-page-size

列表命令的单页大小。范围为 1 - 500。

属性:

  • 配置项:list_page_size
  • 环境变量:RCLONE_ULOZTO_LIST_PAGE_SIZE
  • 类型:整数
  • 默认值:500

–ulozto-encoding

后端的编码方式。

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

属性:

  • 配置项:encoding
  • 环境变量:RCLONE_ULOZTO_ENCODING
  • 类型:编码方式
  • 默认值:斜杠、反斜杠、删除符、控制字符、无效 UTF-8、点号

–ulozto-description

远程存储的描述。

属性:

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

限制

Uloz.to 的文件名中不能包含 \ 字符。rclone 会将其映射为外观相同的 Unicode 字符 (U+FF3C 全角反斜杠)。

Uloz.to 仅支持长度不超过 255 个字符的文件名。

Uloz.to 对 API 访问进行了速率限制,但具体细节并未公开。实际测试表明,在正常使用过程中触发速率限制的情况非常罕见,不过在同时上传大量文件时仍有可能发生。

Uloz.to 后端不支持 rclone about 命令。虽然有一个端点可用于为用户界面检索相关信息,但该端点并未在 API 中公开。不具备此功能的后端无法确定 rclone 挂载的可用空间,也不能在 rclone 联合远程存储中使用 mfs(最大可用空间)策略。

请参阅不支持 rclone about 的后端列表rclone about