跳到主要内容

文件导入

将外部文件批量导入到悦库网盘。支持三种来源：服务器本地目录、FTP 服务器、SMB/CIFS 共享。

前提：只能在悦库服务器本机运行。目标目录须已存在，且当前账号拥有编辑、上传文件、上传文件夹权限。

常用命令（复制使用）​

从本地目录导入：

opscli import create --from /data/project --to /我的空间/自动化测试/testImport

从 FTP 导入：

opscli import create --from ftp://192.168.0.8/share/project --to /我的空间/自动化测试/testImport --username demo --password 123456

从 SMB/CIFS 共享导入：

opscli import create --from smb://192.168.0.8/ShareName --to /我的空间/自动化测试/testImport --username demo --password 123456

凭据也可内嵌到 URL：

opscli import create --from smb://demo:123456@192.168.0.8/ShareName --to /我的空间/自动化测试/testImport

如共享允许匿名访问，可省略用户名和密码：

opscli import create --from smb://192.168.0.8/ShareName --to /我的空间/自动化测试/testImport

SMB 默认端口 445。非标准端口在主机名后加 :端口号，例如 smb://192.168.0.8:445/ShareName。

一次导入多个目录（分号分隔，串行执行）：

opscli import create --from "/data/a;/data/b;/data/c" --to /我的空间/自动化测试/testImport

批量导入（JSON 文件）​

推荐用于重复执行或需要审计的场景。

1. 准备批量任务文件 import-batch.json：

[
  { "from": "/data/images", "to": "/我的空间/自动化测试/images" },
  { "from": "ftp://192.168.0.8/share/docs", "to": "/我的空间/自动化测试/docs",
    "username": "demo", "password": "123456" },
  { "from": "smb://192.168.0.8/ShareName", "to": "/我的空间/自动化测试/smb",
    "username": "demo", "password": "123456" }
]

2. 执行：

opscli import batch --file /data/tasks/import-batch.json

遇错继续（不中断整批任务）：

opscli import batch --file /data/tasks/import-batch.json --on-error continue

冲突处理​

目标已存在同名文件时，通过 --on-conflict 控制行为：

值说明
skip（默认）跳过已存在的文件
overwrite覆盖已存在的文件
resume续传：已存在且大小相同则跳过，否则重新导入

示例：

opscli import create --from /data/project --to /我的空间/testImport --on-conflict overwrite

查看与管理任务​

查看单个任务状态：

opscli import status --taskId 10002

查看最近任务列表：

opscli import list
opscli import list --count 50

续传中断的任务：

opscli import run --taskId 10002

取消任务：

opscli import terminate --taskId 10002

删除任务记录：

# 删除单个任务
opscli import delete --taskId 10002

# 删除 30 天前创建的任务
opscli import delete --before-days 30

# 预览将被删除的内容（不实际执行）
opscli import delete --all --dry-run

# 删除所有任务
opscli import delete --all

正在运行的任务会被自动跳过并打印提示，不会强制删除。建议先用 --dry-run 确认范围。

退出登录：

opscli logout

常见问题与排障​

  • 提示"尚未登录"：先执行 opscli login。
  • 权限不足：检查目标目录是否有"编辑 / 上传文件 / 上传文件夹"权限。
  • 路径不存在：本地导入确认 --from 目录真实存在；FTP/SMB 导入确认地址、共享名称和凭证正确；目标目录路径写错也会导致任务无法继续。
  • 仓库空间不足：清理目标仓库空间，或更换目标位置，或拆分为多次导入。
  • fast 模式下文件内容未就绪：正常现象，fast 模式优先导入目录和文件信息，内容在后台继续完成。

运维建议​

  • 首次导入使用小目录验证流程，确认无误后再做全量导入。
  • 大批量导入尽量避开业务高峰期。
  • 批量任务优先使用 JSON 文件，便于保存、复用和审计。
  • 导入完成后抽查若干文件和目录，确认数量与内容一致。