【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[:port]后会自动应用。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将被取消。没有参数，将罗列当前的所有别名。比如

12 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] 

退出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命令。举例：

get README
get README -o debian.README
get README README.mirrors
get README -o debian.README README.mirrors -o debian.mirrors
get README -o ftp://some.host.org/debian.README
get README -o ftp://some.host.org/debian-dir/ (end slash is important)
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 以特定格式输出，可以被重新加入队列
0102030405060708091011 > 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。

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

12 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将使命令返回零值时退出循环。比如：

12 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返回的命令。

12 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 用于保存站点的用户名和密码。