Skip to content

xops scp ​

以下列出命令用法和可用选项。已安装版本支持的参数以 --help 为准。

text
在本地与远程主机之间上传、下载或跨机中转文件。

单机传输(支持节点名、别名或 [user@]host,指定端口用 -P):
  xops scp local_path web-01:remote_path
  xops scp web-01:remote_path local_path
  xops scp web-01:path1 web-02:path2
  xops scp --sudo local_path web-01:/root/remote_path # 提权传输
  xops scp -i ~/.ssh/id_rsa -P 122 local_path user@host:remote_path

指定主机或批量上传(本地 -> 一台或多台主机):
  xops scp --host web-01 local_path remote_path
  xops scp --host web-01,web-02 local_path remote_path
  xops scp --tag web local_path remote_path
  xops scp -I hosts.txt local_path remote_path

具名路径兼容写法(--src 与 --dest 须成对使用,不可与位置参数混用):
  xops scp --src local_path --dest web-01:remote_path

路径与目标说明:
  必须提供源路径和目标路径(第一个为源,第二个为目标)。
  地址冒号后的内容全部作为文件路径,例如 user@host:22:file 表示文件 22:file;SSH 端口请用 -P/--port 指定。
  未指定 -P 时使用匹配节点的配置端口;若同一主机匹配到多个端口会提示歧义,请用 -P 或唯一别名区分。
  --host、-I/--ifile、--tag 互斥,可用 --exclude 排除部分主机;使用这些选项时固定从本地上传,两个路径中的 :、@ 按普通文件名字符处理。
  --sudo 启用提权传输(建立 root 权限的 SFTPv3 流),在上传、下载和跨主机中转中均生效。

进度与诊断:
  终端默认显示进度条(重定向或管道时自动隐藏)。
  -q/--quiet 隐藏进度条及 SSH 告警与诊断(保留失败报错和安全确认)。
  -v/--verbose 输出 SSH/SFTP 连接与传输诊断(与 --debug 项目日志独立):
    -v   连接、认证与传输状态
    -vv  附加 SFTP 扩展与文件操作
    -vvv 附加 SFTP 数据包信息
  组合顺序同 OpenSSH:-qv 隐藏进度但保留 SSH/SFTP 诊断;-vq 仅保留 SCP 传输诊断。

Usage:
  xops scp [flags] [[user@]host:]source [[user@]host:]dest

Flags:
      --alias string       连接别名
      --dest string        目标路径(兼容写法,须与 --src 成对使用,不可与位置路径混用)
      --exclude strings    排除指定的主机(支持节点ID/别名/IP/User@Host,逗号分隔或多次指定)
  -f, --force              强制覆盖现有文件
  -h, --help               help for scp
      --host string        目标主机,多个主机用逗号分隔
  -i, --identity string    SSH 身份(私钥)文件路径
  -I, --ifile string       主机列表文件路径
  -J, --jump string        跳板机地址,支持 Node/Alias、FQDN、IP 或 [user@]host[:port]
  -l, --login string       SSH 登录用户名
  -n, --no-clobber         不覆盖已存在的文件 (no-clobber)
      --otp string         当前连接会话的一次性动态口令 (OTP/2FA)
      --otp-stdin          从标准输入安全读取一次性动态口令 (OTP)
      --passphrase-stdin   从标准输入 (stdin) 安全读取私钥密码,避免在进程参数中暴露明文
      --password-stdin     从标准输入 (stdin) 安全读取密码,避免在进程参数中暴露明文
  -P, --port uint16        SSH端口
  -q, --quiet              隐藏进度条及 SSH 告警与诊断(保留失败报错和安全确认)
  -r, --recursive          递归复制目录
      --remember string    凭据保存策略: ask、always、never;未指定时继承 credential.remember_prompted,再默认 ask;批处理不保存
      --src string         源路径(兼容写法,须与 --dest 成对使用,不可与位置路径混用)
      --sudo               是否请求sudo权限
      --tag string         按分组(标签)传输
      --task int           并行传输的主机数 (default 3)
      --thread int         单个文件的并行分块数 (default 4)
  -v, --verbose            输出 SSH/SFTP 诊断信息(-vv 含文件操作,-vvv 含 SFTP 数据包;独立于 --debug)

Global Flags:
      --color string       ANSI 颜色输出 (auto=自动检测管道/重定向, never=禁用, always=强制启用)
      --debug              开启调试模式 (等同于 --log-level=debug)
      --lang string        界面语言 (zh/en)
      --log-level string   设置内部诊断日志级别 (debug, info, warn, error)

MIT License