Gofile

Gofile

Gofile 是一个内容存储和分发平台。其目标是免费或以极低的价格提供尽可能多的服务。

Gofile 的初始设置包括登录网页界面,然后进入“我的资料”部分。复制“账户 API 令牌”,以便在配置文件中使用。

请注意,如果你希望将 rclone 连接到 Gofile,你需要一个高级账户。

配置

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

 rclone config

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

No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> remote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
XX / Gofile
   \ (gofile)
Storage> gofile

Option access_token.
API Access token
You can get this from the web control panel.
Enter a value. Press Enter to leave empty.
access_token> YOURACCESSTOKEN

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

Configuration complete.
Options:
- type: gofile
- access_token: YOURACCESSTOKEN
Keep this "remote" remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y

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

列出 Gofile 顶级目录和文件

rclone lsf remote:

将本地目录复制到 Gofile 中名为 backup 的目录

rclone copy /home/source remote:backup

修改时间和哈希值

Gofile 支持精度为 1 秒的修改时间。

Gofile 支持 MD5 哈希,因此你可以使用 --checksum 标志。

受限文件名字符

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

字符 编码值 替换字符
! 0x21
" 0x22
* 0x2A
: 0x3A
< 0x3C
> 0x3E
? 0x3F
\ 0x5C
| 0x7C

文件名也不能以以下字符开头或结尾。只有当这些字符是文件名的第一个或最后一个字符时才会被替换:

字符 编码值 替换字符
. 0x2E

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

公共链接

Gofile 支持使用 rclone link 为文件或目录创建公共链接。如果你指定的是一个目录,它将以 zip 文件的形式下载。你可以使用 --expire 标志指定链接的有效时间。注意,rclone link --unlink 会移除文件的所有公共链接。

根文件夹 ID

你可以为 rclone 设置 root_folder_id。这是 rclone 视为 Gofile 驱动器根目录的目录(由其 文件夹 ID 标识)。

通常你可以留空此项,rclone 会自行确定正确的根目录并将值填充到配置文件中。

但是,你可以设置此项来限制 rclone 仅访问特定的文件夹层级。

为此,你需要找到希望 rclone 显示的目录的 文件夹 ID

你可以使用 rclone 来完成此操作

$ rclone lsf -Fip --dirs-only remote:
d6341f53-ee65-4f29-9f59-d11e8070b2a0;Files/
f4f5c9b8-6ece-478b-b03e-4538edfe5a1c;Photos/
d50e356c-29ca-4b27-a3a7-494d91026e04;Videos/

要使用的 ID 是"; “前面的部分,因此可以设置为

root_folder_id = d6341f53-ee65-4f29-9f59-d11e8070b2a0

将 rclone 限制在 Files 目录。

标准选项

以下是 Gofile 特有的标准选项。

–gofile-access-token

API 访问令牌

你可以从 Web 控制面板获取此令牌。

属性:

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

高级选项

以下是 Gofile 特有的高级选项。

–gofile-root-folder-id

根文件夹的 ID

通常留空即可,rclone 会自动填充该值。

如果你希望 rclone 仅访问特定文件夹,可以填写此选项 - 更多信息请参阅文档。

属性:

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

–gofile-account-id

账户 ID

通常留空即可,rclone 会自动填充该值。

属性:

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

–gofile-list-chunk

每次调用列出的项目数量

属性:

  • 配置项:list_chunk
  • 环境变量:RCLONE_GOFILE_LIST_CHUNK
  • 类型:整数
  • 默认值:1000

–gofile-encoding

后端的编码方式。

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

属性:

  • 配置项:encoding
  • 环境变量:RCLONE_GOFILE_ENCODING
  • 类型:编码方式
  • 默认值:斜杠、尖括号、双引号、冒号、问号、星号、竖线、反斜杠、删除符、控制字符、左句号、右句号、无效 UTF - 8、点号、感叹号

–gofile-description

远程存储的描述。

属性:

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

限制

Gofile 仅支持长度不超过 255 个字符的文件名,这里的字符指 Unicode 字符。

目录缓存时间不应超过 24 小时,否则目录中的文件可能无法下载。实际上,这意味着在使用基于 VFS 的 rclone 命令(如 rclone mount)时,你应确保 --dir-cache-time 小于 24h

请注意,Gofile 目前总共限制为 100,000 个项目。如果你尝试上传超过此数量的项目,将会收到 error-limit-100000 错误。此限制未来可能会解除。

重复文件

Gofile 允许存在文件名重复的文件。例如,同一目录中可能有两个名为 hello.txt 的文件。

Rclone 无法将此类情况同步到普通文件系统,但可以使用 rclone dedupe 命令进行修复。

重复文件会导致同步出现问题,你会在日志中看到有关重复项的消息。

使用 rclone dedupe 命令修复重复文件。