tech 2026年04月05日 · 阅读

放弃 WebDAV 进行高频或大体量的服务器间传输是一个明智的选择。如前所述，Seafile 的 WebDAV 是基于 Python 运行的附加组件，性能上限较低。

简单的方案还是用rclone挂载seafile吧。会造成带宽浪费并耽误些时间。

但使用原生客户端seaf-cli的优点：完美利用 Seafile 查重

seaf-cli 会在本地先计算文件块的哈希值，并在上传前询问服务器：“这个数据块你有了吗？”。如果服务器说有了，seaf-cli 就直接跳过传输，只发送一条元数据。这样既利用了查重，又节省了网络带宽（尽管目录里依然会显示两个文件）。

如果要从其他 VPS 向 Seafile 写入文件，除了 WebDAV，您还有以下几种更高效、更原生的方法：

1. 使用 Seafile 官方命令行客户端 (seaf-cli) —— ⭐ 强烈推荐

这是在 Linux 服务器（VPS）之间同步或备份数据到 Seafile 的最佳实践。seaf-cli 使用 Seafile 的原生 C 语言底层同步协议，完全避开了 WebDAV 的性能瓶颈。

  • 工作原理：它像桌面版同步客户端一样工作，但在终端后台运行。它会在本地切块、去重，然后以极高的并发原生传输到服务端。

  • 优点：

    • 速度极快，完全发挥带宽上限。
    • 支持断点续传。
    • 自带增量同步和文件秒传（基于数据块）。
    • 不会遇到 WebDAV 的那些超时和锁问题。

  • 用法简述：

    1. 下载，改名
    wget https://sos-ch-dk-2.exo.io/seafile-downloads/Seafile-cli-x86_64-9.0.16.AppImage
chmod +x Seafile-cli-x86_64-9.0.16.AppImage
mv Seafile-cli-x86_64-9.0.16.AppImage seaf-cli
sudo cp seaf-cli /usr/local/bin

    参考
    https://help.seafile.com/syncing_client/linux-cli/

    1. 初始化并启动：seaf-cli init -d ~/.seafile-client -> seaf-cli start
    2. 同步远端资料库到本地目录：seaf-cli sync -l <远端资料库ID> -s https://您的域名 -d /本地/要同步的/目录 -u 用户名 -p 密码
  • 适用场景：需要持续、大量、稳定地将 VPS 上的目录单向备份或双向同步到 Seafile。

2. 使用 Seafile Web API (REST API)

Seafile 提供了非常完整的 REST API。您可以直接写简单的 Bash/Python 脚本，或者使用 curl 命令将文件直接 POST 到 Seafile 服务器。

  • 优点：无须安装任何客户端，轻量级，非常适合结合 cron 定时任务或自动化脚本。
  • 缺点：对于大于百兆的超大文件，自己写脚本处理分块上传（Chunked Upload）会比较繁琐；不如客户端稳定。

  • 用法示例（获取 Token 并上传文件）：

    # 1. 获取 Token
curl -d "username=您的邮箱&password=您的密码" https://您的域名/api2/auth-token/

# 2. 获取上传链接
curl -H "Authorization: Token 您的Token" https://您的域名/api2/repos/资料库ID/upload-link/

# 3. 执行上传
curl -H "Authorization: Token 您的Token" -F file=@/本地路径/文件.txt -F filename=文件.txt -F parent_dir=/ https://获取到的上传链接
  • 适用场景：偶尔上传单个文件、脚本自动化备份（如定期打包数据库并丢给 Seafile）。

3. 本地直接导入 (seaf-import.sh) + 传统传输工具

由于您是使用 Docker 部署的 Seafile，如果您有一批极其庞大的历史数据（比如几百 GB）需要一次性迁移，通过网络协议走 HTTP/WebDAV 都太慢了。您可以采用“曲线救国”的物理导入法。

  • 工作原理：先用传统且极其稳定的工具（如 rsync 或 scp）把文件传到宿主机，然后让 Seafile 在本地直接将文件“吃”进数据库。

  • 操作步骤：

    1. 使用 rsync 将 VPS 上的文件高速传到您 Seafile 宿主机的某个临时目录（例如 /tmp/vps_data）。
    2. 将该目录映射给 Seafile 容器（或者直接用 docker cp 复制进容器）。

    3. 进入 Seafile 容器执行官方的导入脚本：

      docker exec -it seafile /bin/bash
cd /opt/seafile/seafile-server-latest
./seaf-import.sh -p /tmp/vps_data -n "新资料库名称" -u 您的邮箱
  • 优点：速度是所有方法中最快的（达到硬盘读写极限），因为不走任何 Web 服务，直接在底层进行数据块切分和数据库写入。
  • 缺点：只能用于一次性、大批量的存量数据导入，不能作为日常实时写入的方案。

总结建议：

如果您想用类似 rclone 那种在后台挂着同步的体验，且彻底解决两台 VPS 并发写入导致卡死的问题，直接安装 seaf-cli 是最完美的解决方案。放弃 WebDAV 挂载，改用原生同步客户端，您的传输速度会发生质的飞跃。

⚠️ -a参数 用于2FA/TOTP验证开启的情况

在开启了双重验证（2FA/TOTP）的 Seafile 账号下使用 seaf-cli，官方已经在命令行工具中内置了对动态验证码的支持。您不需要关闭 2FA，只需要在执行命令时附加一个专用参数即可。

1. 使用 -a 参数传递验证码

在执行需要与服务器进行身份验证的指令（如 sync、download 或 list-remote）时，直接在命令末尾加上 -a 参数，并在其后填入您身份验证器（如 Google Authenticator）中当前显示的 6 位数字代码。

同步已有目录的命令示例：

seaf-cli sync -l <远端资料库ID> -s https://您的域名 -d /本地/要同步的/目录 -u 您的邮箱 -p 您的密码 -a 123456

下载远端资料库的命令示例：

seaf-cli download -l <远端资料库ID> -s https://您的域名 -d /本地/存放的/父目录 -u 您的邮箱 -p 您的密码 -a 123456

2. 核心机制：只需验证一次

请放心，您不需要每次同步文件都去输入这个验证码。

当您首次运行带有 -a 参数的同步或下载命令时，seaf-cli 会通过验证码向 Seafile 服务器申请一个长效的认证 Token。这个 Token 会保存在客户端的本地数据库中。
此后，由 seaf-daemon 负责的后台持续同步工作将使用该 Token 进行通信，后续所有的静默同步、断点续传都不再需要 2FA 验证码。

3. 全自动化脚本部署方案（进阶）

如果您是在编写 Bash 脚本以实现无人值守的自动化部署（例如一次性在多台 VPS 上初始化同步），人工查看并输入验证码显然不现实。此时可以借助 Linux 的 oathtool 工具在脚本中动态生成 TOTP。

  1. 安装工具： 在 VPS 上安装 oathtool（例如 Debian/Ubuntu 下运行 apt install oathtool）。
  2. 获取 Secret： 找到您在 Seafile 网页端绑定 2FA 时，系统提供的初始文本密钥（Secret Key）。

  3. 脚本集成：

    # 动态生成当前的 6 位验证码
MY_TOTP=$(oathtool --totp -b 您的_2FA_SECRET_KEY)

# 将生成的验证码变量传入 seaf-cli
seaf-cli sync -l <远端资料库ID> -s https://您的域名 -d /本地/目录 -u 您的邮箱 -p 您的密码 -a $MY_TOTP
selfhosting seafile