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)