【Linux】lftp用法手册

    蛋疼地翻译了一遍man lftp......

    ====================

    lftp是个功能强大的文件传输工具,操作上很像shell,支持命令补全、历史记录、多任务后台执行,还有书签、排队、镜像、断点续传、多进程下载等功能。 

    lftp支持ftp, ftps, http, https, hftp, fish, sftp, file等多种文件访问方式(https和ftps方式只有lftp编译集成了OpenSSL库时才可用)。可以在open url命令中指定访问方式,比如open http://www.us.kernel.org/pub/linux/.  hftp是ftp-over-http-proxy协议的缩写,即通过http代理的ftp访问,设置ftp:proxy为http://proxy----escape_sem_autolink_uri:7be6e0311b7a3cfe0d547fd75105d6dc----后会自动应用。fish是通过ssh连接到unix账户的协议。sftp是内置了ssh2的访问协议。 

    lftp中的每项操作都是可靠的,非致命错误都会被忽略同时操作会被重新执行。比如下载中断,它会重新从中断点开始继续下载;即便ftp服务器不支持断点续传,lftp会从头开始重新下载文件知道文件传输完成。 



    lftp拥有类似shell的语法,支持并行在后台(&)运行命令,支持用()分组命令并将它们在后台执行。所有后台任务在同一个进程中执行。使用^Z(Ctrl+Z)将前台任务切换到后台执行,wait或fg(wait的别名)命令将后台任务切换到前台,使用jobs命令罗列正在执行的任务。一些命令(如cat, ls等)允许将输出重定向至文件或通过管道传送给别的命令。命令能根据前一命令的结束状态有选择性地执行(&&, ||)。 

    如果你在仍有任务未完成的情况下退出lftp, lftp将会把自己切换到nohup模式在后台继续运行,直至任务完成。 

    lftp内置了镜像功能(mirror命令)允许下载整个目录,反向镜像功能(mirror -R命令)允许上传整个目录到服务器上。镜像功能同样可用于同步两个远程服务器上的文件夹。 

    at命令在当前环境下指定在特定的时刻执行某些任务;queue命令将指定的命令在当前服务器上按顺序执行;还有其他很多命令。 

    启动时,lftp先后执行配置文件/etc/lftp.conf, ~/.lftprc, ~/.lftp/rc 。你可以在这些配置文件中增加alias或set命令。希望看到完整协议调试内容的朋友可以通过debug命令来启动调试模式,如使用debug 3将看到所有的问候消息和错误消息。 

    lftp拥有大量的配置项,可以通过set -a命令来查看所有的配置项和值,set -d命令查看配置项的默认值。配置项可以使用缩写并且省略前导符,只要名称唯一。 

    如果编译包括了OpenSSL (configure --with-openssl),那么lftp将内置有OpenSSL项目开发的软件功能。 

    lftp命令 

    ! shell command 

    运行shell或shell命令;如!ls将列出本地的当前文件夹下的内容。 

    alias  [name [value]] 

    定义或取消name别名。设置value,别名name将被定义;忽略value,别名name将被取消。没有参数,将罗列当前的所有别名。比如 

    alias dir ls -lF
    alias less zmore

    anon 

    设置用户为匿名用户,默认情况。 

    at time [ -- command ] 

    等到指定时间执行指定的命令。参见linux下的at命令。 

    bookmark  [subcommand] 

    操作书签,子命令如下: 

    • add <name> [<loc>] 将当前位置或指定位置以指定名称添加到书签
    • del <name> 删除指定名称的书签
    • edit 启动编辑器来编辑书签文件
    • import <type> 导入外部书签
    • list 罗列所有书签(默认)

    cache  [subcommand] 

    操作本地内存缓存,子命令如下: 

    • stat 打印缓存状态(默认)
    • on|off 开启或关闭缓存
    • flush 清空缓存
    • size lim 设置缓存大小限制,-1表示不限制
    • expire Nx 设置缓存过期时间为N秒(x=s), 分钟(x=m), 小时(x=h), 天(x=d)

    cat files 

    罗列远程目录下的内容到标准输出。 

    cd rdir 

    切换当前的远程目录。前一远程目录被存为-, 可以使用cd -切换到前一目录。每个站点前一目录会被保存到磁盘,所以即使重启lftp后同样可以执行open site; cd -命令。 

    chmod mode files 

    改变远程文件的权限控制码,mode必须为八进制数字。 

    close [-a] 

    关闭空闲链接。默认只关闭当前服务器连接,使用-a关闭所有空闲链接。 

    cls [OPTS] files... 

    获取指定的文件或目录信息,以OPTS参数指定的格式显示结果。与ls的差别是,ls请求由服务器来格式化信息,cls由自身来格式化信息。通过help cls查看OPTS参数的使用。 

    command cmd args... 

    执行执行的命令,忽略别名。 

    debug [-o file] level|off 

    切换调试默认是level级别或关闭调试。使用-o重定向调试信息输出到文件。 

    echo [-n] string 

    输出string字符串,使用-n不输出换行符。 

    eval [-f format ] args... 

    不指定-f,将把args作为命令执行;使用-f,args将被转换为新的命令。format可以包括普通字符和占位符$0 ... $9, $@(与参数args对应) 

    exit [bg] [top] [kill] [code

    退出lftp或将lftp切换到后台执行如果仍有活动任务。如果当前没有活动任务,code会被作为lftp的结束状态传给操作系统。如果code被忽略,最后一条命令的退出代码将被作为code。 

    exit bg强制lftp切换到后台执行如果cmd:move-background是false。exit  top终止最上层shell(lftp的内部命令)的执行。exit kill在退出前结束所有任务。选项可以别结合使用,比如at 08:00 -- exit top kill & 将在8:00结束所有任务并退出lftp。 

    fg 

    wait的别名。 

    find  [directory] 

    罗列指定目录(默认为当前目录)及所有子目录下的所有文件。作为服务器没有ls -R功能的补充。输出可进行重定向。 

    ftpcopy 

    过时的命令,使用一下命令取代: 

    • get ftp://... -o ftp://...
    • get -O ftp://... file1 file2...
    • put ftp://...
    • mput ftp://.../*
    • mget -O ftp://... ftp://.../*

    get [-E] [-a] [-c] [-O base] rfile [-o lfile] ... 

    获取远程文件rfile并保存为本地文件lfile。如果没有-o参数,文件将被保存为与rfile同名的本地文件。可以通过指定多个rfile和-o lfile来获取多个文件。如需使用通配符,请用mget代替get命令。举例: 

    get1 [OPTS] rfile 

    传输单个文件,选项: 

    • -o <lfile> 目标文件名(默认为同rfile中的文件名)
    • -c 继续,重新获取
    • -E 在传输完成后删除源文件
    • -a 使用ascii模式(默认为二进制模式)
    • --source-region=<from-to> 传输源文件的指定区块
    • --target-position=<pos> 指定目标文件的数据写入位置

    glob [-d] [-a] [-f] command patterns 

    取出当前目录下符合patterns的文件或文件夹名,结果串接后传给command命令。比如glob echo *。选项: 

    • -f  文件(默认)
    • -d 文件夹
    • -a 所有类型

    help [cmd] 

    打印cmd命令的帮助信息;未指定cmd时将打印所有可用命令。 

    jobs [-v] 

    罗列正在运行的任务。-v显示详细信息,可指定多个-v。 

    kill all|job_no 

    删除job_no指定的任务或所有任务。job_no可通过jobs命令查看。 

    lcd ldir 

    切换当前的本地目录为ldir。前一本地目录被存为-, 可以使用lcd -切换到前一目录。 

    lpwd 

    打印当前本地的工作目录。 

    ls params 

    罗列远程文件。可以将此命令的输出重定向至文件或通过管道传送给其他命令。默认,ls的输出会被缓存,使用rels或cache flush来查看新的罗列结果。 

    mget [-c] [-d] [-a] [-E] [-O base] files 

    获取满足通配符条件的文件,选项: 

    • -c 继续,重新获取
    • -d 创建与文件路径中目录名相同的目录,并保存文件到对应目录中
    • -E 在传输完成后删除源文件
    • -a 使用ascii模式(默认为二进制模式)
    • -O <base> 指定文件被保存的目录或URL

    mirror [OPTS] [source [target]]

    将源文件夹镜像到目标文件夹。如果目标文件夹以/结尾,原文件夹名称会被附加到目标文件夹名称之后。源和目标都可以是指向文件夹的URL。 

    • -c, --continue 续传上次的任务
    • -e, --delete 删除远程目录上不存在的文件
    •    --delete-first 在传输新文件之前删除旧的文件
    •    --depth-first 进入下一层目录优先于文件传输
    • -s, --allow-suid 根据远程站点设置suid/sgid比特位
    •    --allow-chown 尝试将自己设置为文件所有者和所有组
    •    --ascii 使用ascii方式传输(隐含了--ignore-size)
    •    --ignore-time 决定是否下载时忽略时间因素
    •    --ignore-size 决定是否下载时忽略文件大小因素
    •    --only-missing 只下载缺少的文件
    •    --only-existing 只下载已经存在于目标文件夹中的文件
    • -n, --only-newer 只下载新文件(-c参数无法工作)
    •    --no-empty-dirs 不创建空文件夹(隐含了--depth-first)
    • -r, --no-recursion 不进入子文件夹
    •    --no-symlinks 不创建符号链接
    • -p, --no-perms 不设置文件权限
    •    --no-umask 不使用文件预设权限
    • -R, --reverse 反向镜像(上传文件)
    • -L, --dereference 将符号链接作为文件下载
    • -N, --newer-than=SPEC 只下载比指定时间晚的文件
    •    --on-change=CMD 只要有文件或文件夹存在差异就执行命令CMD
    •    --older-than=SPEC 只下载比指定时间早的文件
    •    --size-range=RANGE 只下载大小在指定区间上的文件
    • -P, --parallel[=N] 并行下载N个文件
    •    --use-pget[-n=N] 使用pget传输每个文件
    •    --loop 循环知道找不到差异
    • -i RX, --include RX 包括相匹配的文件
    • -x RX, --exclude RX 不包括相匹配的文件
    • -I GP, --include-glob GP 包括相匹配的文件
    • -X GP, --exclude-glob GP 不包括相匹配的文件
    • -v, --verbose[=level] 冗长操作
    •    --log=FILE 将执行的lftp命令写入文件FILE
    •    --script=FILE 将lftp命令写入文件FILE,但不执行
    •    --just-print, --dry-run 与--script=-相同
    •    --use-cache 使用缓存目录列表
    • --Remove-source-files 传输完成后删除源文件
    • -a 与--allow-chown --allow-suid --no-umask相同

    使用-R时,第一个目录为本地目录,第二个目录为远程目录。如果第二个目录被忽略,将采用第一个目录的目录名。如果两个目录都被忽略,将采用当前的本地和远程目录。如果目标目录以/结尾,那么源目录名将被加到目标目录上。

    RX是扩展的正则表达式,具体语法可参考egrep命令。

    GP是通配符规则,比如*.zip。

    包含和不包含选项可以被多次使用。符合以下规则之一的文件将被镜像传输:(1)符合包含规则而不符合之后的不包含规则;(2)不符合任何规则,但第一条为不包含规则。目录匹配时包括结尾的/。

    注意:符号链接(软链接)不会被传输到远程服务器上,因为无法被FTP协议传输。要上传链接指向的文件,请使用mirror -RL命令(将符号链接视为普通文件)。

    对于--newer-than选项,你可以使用文件或时间作为参数。时间参数的格式同at命令,如now-7days、week age等。如果指定为文件,将采用文件的修改时间。

    冗长输出级别可以通过--verbose=level选项或者使用多个-v选项进行设定,比如-vvv。冗长输出级别为:

    • 0 - 无输出(默认)
    • 1 - 打印动作
    • 2 - +打印不删除的文件名(当没有采用-e选项时)
    • 3 - +打印

    --only-newer关闭文件大小比较,只上传/下载新的文件,即使文件大小存在差异,默认情况下旧的文件会被新的文件代替。

    当用URL代替目录时,可以对两台服务器上的目录进行镜像操作。只要可以,会自动使用FXP在FTP服务器之间进行文件传输。

    一些ftp服务器默认隐藏了.开头的文件(如.htaccess),只会在LIST命令使用-a选项时显示。在这种情况下,使用设置set ftp:list-options -a。

    mkdir [-p] dir(s)

    创建远程目录。如果使用-p参数,将创建路径的所有相关目录。

    module module [ args ]

    使用dlopen函数加载已知模块。如果模块名中不包含/,将在module:path指定的位置搜索模块。参数会被传给module_init函数,具体技术细节可查看README.modules。

    more files

    与cat files | more命令相同。

    mput [-c] [-d] [-a] [-E] [-O base] files

    上传符合通配符规则的文件。默认使用本地文件名作为远程的文件名,可以使用-d选项修改。

    • -c 继续上传
    • -d 创建与文件路径中目录名相同的目录,并将文件放到对应目录,而不是当前目录
    • -E 传输成功后删除源文件
    • -a 使用ascii模式(默认为二进制模式)
    • -O <base> 指定目标目录或URL

    mrm file(s)

    与glob rm命令相同,删除符合通配符规则的文件。

    mv file1 file2

    将文件file1重命名为file2。

    nlist [args]

    列出远程文件名。

    open [-e cmd] [-u user[,pass]] [-p port] host|url

    打开一台ftp服务器。

    pget [OPTS] rfile [-o lfile]

    使用多个连接下载同一文件,可提高下载速度,但会加重网络和服务器的负载,影响其他用户。尽量只在紧急时使用。选项:

    • -c 继续传输;需要文件lfile.lftp-pget-status
    • -n maxconn 设置最大连接数(默认使用pget:default-n设置)

    put [-E] [-a] [-c] [-O base] lfile [-o rfile]

    将文件lfile上传到远程并存为rfile。如果忽略-o参数,lfile中的文件名将被作为远程的文件名。如需扩展通配符,请使用mput。

    • -o <rfile> 指定远程文件名(默认为lfile中的文件名)
    • -c 继续上传,需要远程文件的覆盖权限
    • -E 传输完成后删除源文件
    • -a 使用ascii模式(默认为二进制模式)
    • -O <base> 指定目标目录或URL

    pwd [-p]

    打印当前的远程URL。使用-p参数在URL中显示密码。

    queue [-n num ] cmd

    将指定命令放入队列来依次执行。每个站点维护一个命令队列。-n参数将指定命令放入队列中指定位置。不要将cd或lcd命令加入队列,这可能使lftp执行出现混乱。应在queue命令之前使用cd/lcd切换目录。允许通过queue wait <jobno>命令将正在执行的任务加入队列,任务将继续执行即使它不是队列中的第一个。

    queue stop将停止队列,它将不再执行任何新的命令,但正在执行的命令会继续执行。你可以使用queue stop命令来创建一个空的暂停队列。queue start命令可以重新启动命令执行。当你退出lftp时,它将自动启动所有暂停的队列。

    没有指定参数的queue命令将创建一个暂停队列或者打印队列状态。

    queue --delete|-d [index or wildcard expression]

    删除队列中的一个或多个条目。如果没有指定参数,会删除队列中的最后一个条目。

    queue --move|-m <index or wildcard expression> [index]

    将指定条目移动到队列的指定位置;如没有指定位置,将会移动到末尾。

    • -q 不输出任何提示
    • -v 输出详细的提示
    • -Q 以特定格式输出,可以被重新加入队列
    > get file &
    [1] get file
    > queue wait 1
    > queue get another_file
    > cd a_directory
    > queue get yet_another_file
    
    queue -d 3          删除队列中的第3个条目
    queue -m 6 4        移动队列中的第6个条目到第4个条目之前
    queue -m "get*zip" 1     移动所有符合get*zip的命令道队列最开始(条目顺序不变)
    queue -d "get*zip"  删除所有所有符合get*zip的命令

    quote cmd

    FTP协议下,将直接向服务器发送命令。使用时需要注意:它将导致远程处于未知状态,导致重新连接,即使重新连接状态仍然无法被重置。

    HTTP协议下,语法为quote <command> [<args>],command可以为set-cookie或post。

    open http://www.site.net
    quote set-cookie "variable=value; othervar=othervalue"
    set http:post-content-type application/x-www-form-urlencoded
    quote post /cgi-bin/script.cgi "var=value&othervar=othervalue" > local_file

    FISH协议下,将直接向服务器发送命令。使用此方法可以在服务器上执行任何命令。但执行的命令不能需要输入和在新行的开头打印###,否则将导致协议失去同步。

    open fish://server
    quote find -name \*.zip

    reget rfile [-o lfile]

    与get -c命令相同。

    rels [args]

    与ls命令相同,但忽略缓存。

    renlist [args]

    与nlist命令相同,但忽略缓存。

    repeat [ -c <count>] [[-d] delay] [command]

    重复执行命令。在命令执行之间会加入延时,默认为1秒。-c选项用来限制重复次数。--while-ok将使命令返回非零值时退出循环;--until-ok将使命令返回零值时退出循环。比如:

    repeat at tomorrow -- mirror
    repeat 1d mirror

    reput lfile [-o rfile]

    与put -c命令相同。

    rm [-r] [-f] files

    删除远程文件。如需要使用通配符规则,请使用mrm代替。-r指定递归删除目录,-f 取消错误消息提示。

    rmdir dir(s)

    删除远程目录。

    scache [session]

    罗列缓存的会话,或切换到指定会话。

    set [var [val]]

    将变量设定为指定值。如果值被忽略了,则取消这个变量。如未指定变量名,将显示被改变的设置变量。可以使用以下选项修改显示:

    • -a 罗列所有的设置,包括默认值
    • -d 只罗列默认值

    site site_cmd

    执行站点命令site_cmd,可以重定向输出。

    sleep interval

    休眠指定时间间隔然后退出。时间间隔默认以秒为单位,但可以后缀m, h, d来对应表示分钟、小时、天。

    slot [name]

    选择特定的slot,或者罗列所有已分配的slot。slot是与服务器的一个连接,有点像虚拟控制台。你可以创建连接到不同服务器的多个slot,并可在不同的slot之间进行切换。你同样可以使用slot:name作为伪URL表示那个slot位置。

    默认情况下,可以使用Meta-0 至 Meta-9(往往使用Alt键代替Meta键)快捷键来快速切换0-9的slot。

    source file

    source -e command

    执行file文件中的命令或是有特定command返回的命令。

    source ~/.lftp/rc
    source -e echo help

    suspend

    暂停lftp进程。注意:传输任务同样或被暂停直到你使用shell的fg或bg命令继续执行这个进行。

    user user [pass]

    user URL [pass]

    使用特定的信息登陆远程ftp。如果你对URL指定了用户名,输入的密码将被缓存起来供以后使用。

    version

    打印lftp版本信息。

    wait [jobno]

    wait all

    等待特定任务终止。如果忽略jobno,将等待最后一个后台任务终止。wait all等待所有任务终止。

    zcat files

    与cat相同,但通过zcat过来每个文件。

    zmore files

    与more相同,但通过zcat过来每个文件。

    lftp设置

    lftp启动时执行~/.lftprc 和~/.lftp/rc。你可以在这两个文件中加入alias或set命令。如果你想看到完全的协议调试过程,可以使用debug来打开调试。

    系统级的启动文件为/etc/lftp.conf。

    lftp拥有众多设置项,可以通过set -a命令查看所有设置项及它们的值。

    lftp命令选项

    -d 切换到调试模式

    -e commands 执行指定的命令,并且不退出

    -p port 使用执行端口进行连接

    -u user[,pass] 使用执行的用户名和密码进行连接

    -f script_file 执行文件中的命令并且退出

    -c commands 执行指定的命令并且退出

    环境变量

    以下环境变量将被lftp使用:

    HOME 作为~的扩展

    SHELL 在!命令时决定使用哪个shell来运行

    PAGER 作为页面名称,在more和zmore命令中使用

    http_proxy, https_proxy 作为初始时http:proxy, hftp:proxy, https:proxy的值

    ftp_proxy 作为初始时ftp:proxy或hftp:proxy的值(由环境变量中的URL协议指定)

    no_proxy 作为初始时的net:no-proxy值

    LFTP_MODULE_PATH 作为初始时的module:path值

    LFTP_HOME 用于定位用户配置文件的目录,如未设置将使用~/.lftp

    相关文件

    /etc/lftp.conf 系统级启动文件。实际位置由--sysconfdir配置项决定。

    ~/.lftp/rc, ~/.lftprc 这些文件在/etc/lftp.conf之后被执行。

    ~/.lftp/log 用于记录lftp运行于后台nohup模式时的日志。

    ~/.lftp/bookmarks 用户保存lftp中的书签。

    ~/.lftp/cwd_history 用于保存每个站点的当前工作目录。

    ~/.netrc 用于保存站点的用户名和密码。

    [完毕]

    p.s. 以上如有翻译不到位的地方欢迎指出。



    本博客所有文章如无特别注明均为原创。
    复制或转载请以超链接形式注明转自枫芸志,原文地址《【Linux】lftp用法手册
    标签:
    分享:

已经有4 条评论抢在你前面了~

无觅相关文章插件,快速提升流量