- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 新华三人才研学中心
- 关于我们
03-FTP和TFTP命令
本章节下载： 03-FTP和TFTP命令 (278.60 KB)
【命令】
display ftp-server [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display ftp-server命令用来显示设备作为FTP服务器时的各项参数。
进行FTP参数设置后，可通过此命令查看设置结果。
相关配置可参考命令ftp server enable、ftp timeout和ftp update。
【举例】
# 显示FTP服务器参数设置结果。
FTP server is running
Max user number: 1
User count: 1
Timeout value(in minute): 30
Put Method: fast
表1-1 display ftp-server命令显示信息描述表
|
字段 |
描述 |
|
FTP server is running |
FTP服务器功能正在运行中 |
|
Max user number |
支持同时登录的最大用户数 |
|
User count |
当前登录的用户数 |
|
Timeout value (in minute) |
FTP用户的连接空闲时间，如果在该时间段内，FTP客户端和服务器之间没有报文交互，该FTP连接则会被断开 |
|
Put Method |
FTP服务器更新文件的方式，fast表示快速更新；normal表示普通方式 |
【命令】
display ftp-user [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display ftp-user命令用来显示当前FTP用户的详细情况。
【举例】
# 显示FTP用户详细情况。
<Sysname> display ftp-user
UserName HostIP Port Idle HomeDir
ftp 192.168.1.54 1190 0 flash:
# 当登录用户名长度超过10位时，将换行并靠左对齐显示。例如登录用户名为administrator，显示情况为：
<Sysname> display ftp-user
UserName HostIP Port Idle HomeDir
administra
tor 192.168.0.152 1031 0 flash:
表1-2 display ftp-user命令显示信息描述表
|
字段 |
描述 |
|
UserName |
当前登录的FTP用户名 |
|
HostIP |
当前登录的FTP用户的IP地址 |
|
Port |
当前登录的FTP用户使用的端口 |
|
Idle |
当前FTP连接的持续时间（单位为分钟） |
|
HomeDir |
当前登录的FTP用户的授权路径 |
【命令】
free ftp user username
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
username：用户名。可以使用display ftp-user命令来查看当前FTP连接所使用的登录用户名。
【描述】
free ftp user命令用来强制释放通过指定用户名建立的FTP连接。
执行该命令后，无论使用用户名username建立的连接是否正在传输文件，该连接都会被立即释放。
【举例】
# 强制释放通过用户名ftpuser建立的FTP连接。
<Sysname> free ftp user ftpuser
Are you sure to free FTP user ftpuser? [Y/N]:y
【命令】
ftp server acl acl-number
undo ftp server acl
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
acl-number：基本访问控制列表号，取值范围为2000～2999。
【描述】
ftp server acl命令用来使用ACL限制哪些FTP客户端可以访问FTP服务器。undo ftp server acl命令用来恢复缺省情况。
缺省情况下，没有使用ACL限制FTP客户端。
通过配置ACL规则，可以过滤掉来自某些客户端的FTP请求报文，只允许符合ACL过滤规则的客户端访问FTP服务器。该配置只过滤新建立的FTP连接，不会对已建立的FTP连接和操作造成影响。如果多次使用该命令配置FTP服务与ACL关联，FTP服务将只与最后一次配置的ACL关联。
【举例】
# 配置FTP服务与ACL关联，只允许客户端（1.1.1.1）通过FTP访问本FTP服务器。
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule 0 permit source 1.1.1.1 0
[Sysname-acl-basic-2001] rule 1 deny source any
[Sysname-acl-basic-2001] quit
[Sysname] ftp server acl 2001
【命令】
ftp server enable
undo ftp server
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
无
【描述】
ftp server enable命令用来开启设备的FTP服务器功能，允许FTP用户登录。undo ftp server命令用来关闭设备的FTP服务器功能。
缺省情况下，FTP服务器功能处于关闭状态。
【举例】
# 开启设备的FTP服务器功能。
<Sysname> system-view
[Sysname] ftp server enable
[Sysname]
【命令】
ftp server dscp dscp-value
undo ftp server dscp
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
dscp-value：报文的DSCP优先级，取值范围为0～63。
【描述】
ftp server dscp命令用来配置FTP服务器发送报文的DSCP优先级。undo ftp server dscp命令用来恢复缺省情况。
缺省情况下，FTP服务器发报文的DSCP优先级为0。
【举例】
# 配置FTP服务器发送的报文的DSCP优先级为30。
<Sysname> system-view
[Sysname] ftp server dscp 30
[Sysname]
【命令】
ftp timeout minute
undo ftp timeout
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
minute：连接空闲时间，取值范围为1～35791，单位为分钟。
【描述】
ftp timeout命令用来设置连接空闲时间。undo ftp timeout命令用来恢复缺省情况。
缺省情况下，FTP连接空闲时间为30分钟。
使用连接空闲时间，当FTP服务器与某用户的连接在一定时间内没有进行消息交互时，FTP服务器将认为该连接已失效并断开该连接，从而避免系统资源被持续占用、其他FTP用户的登录受影响。
【举例】
# 设置连接空闲时间为36分钟。
<Sysname> system-view
[Sysname] ftp timeout 36
【命令】
ftp update { fast | normal }
undo ftp update
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
fast：快速更新方式。在给FTP服务器上传文件时使用fast方式，FTP服务器会先将文件全部写入内存，再一次全部写入到存储设备。
normal：普通更新方式。在给FTP服务器上传文件时使用normal方式，FTP服务器会分多次将文件从内存写入存储设备，每次最多4096字节。
【描述】
ftp update命令用来设置在给FTP服务器上传文件的过程中，FTP服务器更新文件的方式。undo ftp update命令用来恢复缺省情况。
缺省情况下，FTP服务器采用normal方式更新文件。
【举例】
# 设置在接收上传文件时，FTP服务器采用普通方式。
<Sysname> system-view
[Sysname] ftp update normal
· 为避免重复，在本节中对需要在FTP Client视图下执行的命令进行举例时，将省略进入FTP Client视图的配置过程。进入FTP Client视图的命令请参考1.2.12 。
· 在执行本节介绍的FTP客户端配置命令前，请确认在FTP服务器上是否为用户配置了相应的权限，例如：查询工作目录下的文件列表、读取/下载指定文件、创建目录/上传文件、以及对服务器上的文件进行重命名/删除等。
· 本节举例中各命令的显示信息与FTP服务器的类型有关，请以实际情况为准。
【命令】
ascii
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
ascii命令用来设置文件传输的模式为ASCII模式。
缺省情况下，文件传输模式为ASCII模式。
不同的操作系统对换行符的表示方法不同，比如H3C设备系统和Windows系统使用“/r/n”作为换行符，在Linux系统中使用“/n”作为换行符。在换行符表示方法不同的两个系统（比如Linux系统和H3C设备系统）间传输完文件，必须根据传输文件类型选择FTP文件传输模式：
· 二进制模式（又称为binary模式），用于传输程序文件或者图片。
· ASCII码模式，用于传输文本文件。
相关配置可参考binary。
【举例】
# 设置数据传输的模式为ASCII模式。
<Sysname> ftp
[ftp] ascii
200 Type set to A.
【命令】
binary
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
binary命令用来设置文件传输的模式为二进制模式（也称为流模式）。
缺省情况下，文件传输模式为ASCII模式。
相关配置可参考ascii。
【举例】
# 设置文件传输类型支持binary模式。
<Sysname> ftp
[ftp] binary
200 Type set to I.
【命令】
bye
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
bye命令用来断开与远程FTP服务器的连接，并退回到用户视图。如果设备与远程FTP服务器没有建立连接，则直接退回到用户视图。
相关配置可参考命令close、disconnect和quit。
【举例】
# 终止与远程FTP服务器的连接，并退回到用户视图。
<Sysname> ftp
[ftp] bye
221 Server closing.
【命令】
cd { directory | .. | / }
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
directory：指定目标工作路径，如果指定的工作路径不存在，则执行cd directory后保持当前工作路径不变。格式为[drive:][/]path。drive和path参数的详细解释，请参见“基础配置指导”中的“文件系统管理”。如果没有给出drive信息，则表示当前工作路径下的文件夹或者子文件夹。
..：返回上一级目录，功能与cdup类似。如果当前的工作路径是根目录，则执行cd ..后保持当前的工作路径不变。该参数不支持命令行在线帮助。
/：返回FTP根目录。该参数不支持命令行在线帮助。
【描述】
cd命令用来切换远程FTP服务器上的工作路径，即访问FTP服务器上的另一目录。
需要注意的是，用户可以访问的目录只能是FTP服务器对用户已经授权的目录。
相关命令可参考pwd。
【举例】
# 切换工作路径到当前工作路径的logfile子目录下。
[ftp] cd logfile
250 CWD command successful.
# 切换工作路径到FTP根目录下的folder子目录下。
[ftp] cd /folder
250 CWD command successful.
【命令】
cdup
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
cdup命令用来退出远程FTP服务器的当前工作路径，返回FTP服务器的上一级目录。
如果当前工作路径已经是FTP根目录，则执行该命令后，保持当前工作路径不变。
相关命令可参考cd和pwd。
【举例】
# 将工作路径改为上一级目录。
[ftp] pwd
257 "/ftp/subdir" is current directory.
[ftp] cdup
200 CDUP command successful.
[ftp] pwd
257 "/ftp" is current directory.
【命令】
close
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
close命令用来在不退出FTP客户端视图的前提下，断开与FTP服务器的连接。
该命令的功能与disconnect命令相同。
【举例】
# 终止与FTP服务器的连接，并保持在FTP客户端视图。
[ftp] close
221 Server closing.
[ftp]
【命令】
debugging
undo debugging
【视图】
FTP客户端视图
【缺省级别】
1：监控级
【参数】
无
【描述】
debugging命令用来打开FTP客户端调试信息开关。undo debugging命令用来关闭FTP客户端调试信息开关。
缺省情况下，FTP客户端调试信息开关处于关闭状态。
【举例】
# 设备作为FTP客户端，成功登录后，打开设备的FTP客户端调试信息开关，使用主动模式下载FTP服务器当前工作路径下的sample.file文件。
<Sysname> terminal monitor
<Sysname> terminal debugging
<Sysname> ftp 192.168.1.46
Trying 192.168.1.46 ...
Press CTRL+K to abort
Connected to 192.168.1.46.
220 FTP service ready.
User(192.168.1.46:(none)):ftp
331 Password required for ftp.
Password:
230 User logged in.
[ftp]undo passive
FTP: passive is off
[ftp] debugging
FTP: debugging switch is on
[ftp] get sample.file
---> PORT 192,168,1,44,4,21
200 Port command okay.
The parsed reply is 200
---> RETR sample.file
150 Opening ASCII mode data connection for /sample.file.
The parsed reply is 150
FTPC: File transfer started with the signal light turned on.
FTPC: File transfer completed with the signal light turned off.
.226 Transfer complete.
FTP: 3304 byte(s) received in 4.889 second(s), 675.00 byte(s)/sec.
[ftp]
表1-3 debugging命令显示信息描述表
|
字段 |
描述 |
|
---> PORT 192,168,1,44,4,21 |
发出FTP指令，192,168,1,44分别为目的IP地址的四段，4,21用于计算数据端口号，计算方法为4*256+21 |
|
The parsed reply is |
收到的FTP应答码。FTP应答码由RFC 959规定 |
|
---> RETR |
下载文件 |
|
FTPC: File transfer started with the signal light turned on. |
开始文件传输，打开文件传输指示灯 |
|
FTPC: File transfer completed with the signal light turned off. |
文件传输结束，关闭文件传输指示灯 |
【命令】
delete remotefile
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
remotefile：文件名。
【描述】
delete命令用来彻底删除远程FTP服务器上的指定文件，删除的文件不能被恢复。
用户必须具有删除的权限，才能执行该操作。
【举例】
# 删除文件temp.c。
[ftp] delete temp.c
250 DELE command successful.
【命令】
dir [ remotefile [ localfile ] ]
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
remotefile：待查询的远程FTP服务器上的目录或文件名。
localfile：用于保存查询信息的本地文件的名称。
【描述】
dir命令用来查看远程FTP服务器当前工作路径下的所有子目录及文件的详细信息。
dir remotefile命令用来查看远程FTP服务器上指定目录或文件的详细信息。
dir remotefile localfile命令用来查看远程FTP服务器上指定目录或文件的详细信息，并把查看结果（找到的目录或文件的详细信息）保存在本地以localfile命名的文件中。
使用dir命令可以看到文件以及文件夹的相关信息，如大小、创建日期等。如用户仅需要列出当前工作路径下的所有文件以及文件夹的名称，可以使用ls命令。
【举例】
# 显示当前远程FTP服务器工作路径下的所有文件夹以及文件的信息。
[ftp] dir
227 Entering Passive Mode (192,168,1,46,5,68).
125 ASCII mode data connection already open, transfer starting for /*.
drwxrwxrwx 1 noone nogroup 0 Aug 08 2006 logfile
-rwxrwxrwx 1 noone nogroup 20471748 May 11 10:21 test.bin
-rwxrwxrwx 1 noone nogroup 4001 Dec 08 2007 config.cfg
-rwxrwxrwx 1 noone nogroup 3608 Jun 13 2007 startup.cfg
drwxrwxrwx 1 noone nogroup 0 Dec 03 2007 test
-rwxrwxrwx 1 noone nogroup 299 Oct 15 2007 key.pub
226 Transfer complete.
FTP: 394 byte(s) received in 0.189 second(s), 2.00K byte(s)/sec.
[ftp]
# 查看文件ar-router.cfg，并将查询结果保存在aa.txt文件中。
[ftp] dir ar-router.cfg aa.txt
227 Entering Passive Mode (192,168,1,50,17,158).
125 ASCII mode data connection already open, transfer starting for /ar-router.cfg.
....226 Transfer complete.
FTP: 67 byte(s) received in 4.600 second(s), 14.00 byte(s)/sec.
查看aa.txt文件的内容。
[ftp] quit
<Sysname> more aa.txt
-rwxrwxrwx 1 noone nogroup 3077 Jun 20 15:34 ar-router.cfg
【命令】
disconnect
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
disconnect命令用来在不退出FTP客户端视图的前提下，断开与FTP服务器的连接。
该命令的功能与close命令相同。
【举例】
# 终止与远程FTP服务器的连接，保持在FTP客户端视图。
[ftp] disconnect
221 Server closing.
[ftp]
display ftp client configuration [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display ftp client configuration命令用来显示FTP客户端的配置信息。
相关配置可参考命令ftp client source。
【举例】
# 显示FTP客户端的当前配置信息。
<Sysname> display ftp client configuration
The source IP address is 192.168.0.123.
目前该命令显示的是源地址配置信息，如果当前生效的源地址是源IP则显示配置的源IP，如果当前生效的源地址是源接口则显示配置的源接口。
【命令】
ftp [ server-address [ service-port ] [ source { interface interface-type interface-number | ip source-ip-address } ] ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
server-address：远程FTP服务器的主机名（长度为1～20的字符串）或IP地址。
service-port：远端设备提供FTP服务的TCP端口号，取值范围为0～65535，缺省值为21。
source { interface interface-type interface-number | ip source-ip-address } ]：指定建立FTP连接时使用的源地址。其中，
· interface interface-type interface-number：表示源接口的接口类型和接口编号。发送FTP协议报文时，设备将使用该接口下配置的主IP地址作为源地址。如果源接口下没有配置主地址，则不能建立连接。
· ip source-ip-address：表示源IP地址。发送FTP协议报文时，设备将使用该IP地址作为源地址。该地址必须是设备上已配置的IP地址，否则不能建立连接。
【描述】
ftp命令用来登录FTP服务器，并进入FTP客户端视图。
需要注意的是：
· 该命令仅适用于IPv4组网环境。
· 如果不指定任何参数，则只进入FTP客户端视图，不登录FTP服务器。
· 如果指定参数，系统会提示用户输入登录FTP服务器的用户名和密码。如果用户名和密码正确，则登录成功，并进入FTP客户端视图；否则，登录失败。
【举例】
# 使用FTP方式，从当前设备Sysname1登录到设备Sysname2（IP地址为192.168.0.211），并且FTP发送报文的源IP地址为192.168.0.212。
<Sysname1> ftp 192.168.0.211 source ip 192.168.0.212
Trying 192.168.0.211 ...
Press CTRL+K to abort
Connected to 192.168.0.211.
220 FTP Server ready.
User(192.168.0.211:(none)):abc
331 Password required for abc
Password:
230 User logged in.
[ftp]
【命令】
ftp client ipv6 dscp dscp-value
undo ftp client ipv6 dscp
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
dscp-value：报文的DSCP优先级，取值范围为0～63。
【描述】
ftp client ipv6 dscp命令用来配置IPv6 FTP客户端发送报文的DSCP优先级。undo ftp client ipv6 dscp命令用来恢复缺省情况。
缺省情况下，IPv6 FTP客户端发报文的DSCP优先级为0。
【举例】
# 配置IPv6 FTP客户端发送的报文的DSCP优先级为30。
<Sysname> system-view
[Sysname] ftp client ipv6 dscp 30
【命令】
ftp client dscp dscp-value
undo ftp client dscp
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
dscp-value：报文的DSCP优先级，取值范围为0～63。
【描述】
ftp client dscp命令用来配置FTP客户端发送报文的DSCP优先级。undo ftp client dscp命令用来恢复缺省情况。
缺省情况下，FTP客户端发报文的DSCP优先级为0。
【举例】
# 配置FTP客户端发送的报文的DSCP优先级为30。
<Sysname> system-view
[Sysname] ftp client dscp 30
【命令】
ftp client source { interface interface-type interface-number | ip source-ip-address }
undo ftp client source
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
interface interface-type interface-number：FTP连接使用的源接口，包括接口类型和接口编号。源接口下配置的主IP地址即为FTP发送报文的源地址。如果源接口下没有主地址，会导致连接失败。
ip source-ip-address：FTP连接使用的源IP地址。该地址必须是设备上已配置的IP地址。
【描述】
ftp client source命令用来配置FTP客户端发送的FTP报文的源地址。undo ftp client source命令用来恢复缺省情况。
缺省情况下，设备使用路由决定的源地址与FTP服务器通信。
需要注意的是：
· 源地址包括源接口和源IP，如果先后使用ftp client source命令指定了源接口和源IP，新指定的源IP将覆盖现有的源接口配置。反之亦然。
· 使用该命令指定了源地址后，又在ftp命令中指定了源地址，则采用ftp命令中指定的源地址进行通信。
· ftp client source命令指定的源地址对所有的ftp连接有效，ftp命令指定的源地址只对当前的ftp连接有效。
相关配置可参考命令display ftp client configuration。
【举例】
# 指定FTP客户端的源IP地址为2.2.2.2。
<Sysname> system-view
[Sysname] ftp client source ip 2.2.2.2
# 指定FTP客户端的源接口为Vlan-interface1。
<Sysname> system-view
[Sysname] ftp client source interface vlan-interface1
【命令】
ftp ipv6 [ server-address [ service-port ] [ source ipv6 source-ipv6-address ] [ -i interface-type interface-number ] ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
server-address：远端设备的IP地址或主机名。
service-port：远端设备提供FTP服务的TCP端口号，取值范围为0～65535，缺省值为21。
source ipv6 source-ipv6-address：当前FTP客户端连接所使用的源IPv6地址。该地址必须是设备上已配置的IPv6地址。
-i interface-type interface-number：表示出接口的接口类型和接口编号。此参数只用于FTP服务器的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址（链路本地地址的介绍和配置请参见“三层技术-IP业务配置指导”中的“IPv6基础”）。
【描述】
ftp ipv6命令用来登录FTP服务器，并进入FTP客户端视图。
需要注意的是：
· 该命令仅适用于IPv6组网环境。
· 如果不指定任何参数，则只进入FTP客户端视图，不登录FTP服务器。
· 如果指定参数，系统会提示用户输入登录FTP服务器的用户名和密码。如果用户名和密码正确，则登录成功，并进入FTP客户端视图；否则，登录失败。
【举例】
# 登录到IPv6地址为3000::200的远程FTP服务器。
<Sysname> ftp ipv6 3000::200
Trying 3000::200 ...
Press CTRL+K to abort
Connected to 3000::200.
220 Welcome!
User(3000::200:(none)): MY_NAME
331 Please specify the password.
Password:
230 Login successful.
[ftp]
【命令】
get remotefile [ localfile ]
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
remotefile：需要下载的文件名称。
localfile：将文件下载到本地保存时使用的文件名称。如不使用该参数，将使用源文件名称作为本地文件名称保存到用户执行ftp命令时的当前工作路径。
【描述】
get命令用来下载FTP服务器上的文件，并将下载的文件存储在本地。
【举例】
# 下载testcfg.cfg文件，并以aa.cfg文件名保存。
[ftp] get testcfg.cfg aa.cfg
227 Entering Passive Mode (192,168,1,50,17,163).
125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.
.....226 Transfer complete.
FTP: 5190 byte(s) received in 7.754 second(s), 669.00 byte(s)/sec.
【命令】
lcd
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
lcd命令用来获取FTP客户端本地的工作路径。
【举例】
# 显示本地的工作路径。
[ftp] lcd
FTP: Local directory now flash:/clienttemp.
以上信息表明FTP客户端在执行ftp命令前的工作路径是flash:/clienttemp。
【命令】
ls [ remotefile [ localfile ] ]
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
remotefile：待查询的远程FTP服务器上的目录或文件名。
localfile：用于保存查询信息的本地文件名称。
【描述】
ls命令用来查询远程FTP服务器上当前工作路径下的子目录及文件，系统将列出当前工作路径下的所有子目录及文件的名称。
ls remotefile命令用来查询远程FTP服务器上的指定目录或文件，系统将列出找到的目录或文件的名称。
ls remotefile localfile命令用来查询远程FTP服务器上指定的目录或文件，并把查询结果（找到的目录或文件的名称）保存到本地以localfile命名的文件中。
使用ls命令仅能列出FTP服务器上文件以及文件夹的名称，如用户需要查询其他与文件相关的信息，如大小、创建日期等，请使用dir命令。
【举例】
# 查询FTP服务器上当前工作路径下的所有子目录及文件。
[ftp] ls
227 Entering Passive Mode (192,168,1,50,17,165).
125 ASCII mode data connection already open, transfer starting for /*.
ar-router.cfg
logfile
mainar.bin
arbasic.bin
ftp
test
bb.cfg
testcfg.cfg
226 Transfer complete.
FTP: 87 byte(s) received in 0.132 second(s) 659.00 byte(s)/sec.
# 查询FTP服务器上的子目录logfile。
[ftp] ls logfile
227 Entering Passive Mode (192,168,1,50,10,49).
125 ASCII mode data connection already open, transfer starting for /logfile/*.
logfile.log
a.cfg
226 Transfer complete.
FTP: 20 byte(s) received in 0.075 second(s), 266.00 byte(s)/sec.
# 将查询FTP服务器上的子目录logfile的结果保存在aa.txt文件中。
[ftp] ls logfile aa.txt
227 Entering Passive Mode (192,168,1,50,4,3).
125 ASCII mode data connection already open, transfer starting for /logfile/*.
....226 Transfer complete.
FTP: 20 byte(s) received in 3.962 second(s), 5.00 byte(s)/sec.
# 查看aa.txt文件的内容。
[ftp] quit
<Sysname> more aa.txt
.
..
logfile.log
【命令】
mkdir directory
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
directory：待创建的目录名称。
【描述】
mkdir命令用来在远程FTP服务器上指定目录下创建子目录。
只有获得远程FTP服务器授权的客户端用户才能执行此项操作。
【举例】
# 在远程FTP服务器的当前工作路径下创建子目录mytest。
[ftp] mkdir mytest
257 "/mytest" new directory created.
【命令】
open server-address [ service-port ]
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
server-address：远端设备的IP地址或主机名。
service-port：远端设备提供FTP服务的TCP端口号，取值范围为0～65535，缺省值为21。
【描述】
open命令用来在FTP客户端视图下，登录IPv4 FTP服务器。
登录时，系统会提示用户输入登录用户名和密码。如果用户名和密码正确，则登录成功；否则，登录失败。
如果当前已经登录到FTP服务器，则不能直接使用open命令连接到其他服务器，需要中断与当前服务器的连接后再重新连接。
相关配置可参考命令close。
【举例】
# 在FTP Client视图下，登录远程FTP服务器（IP地址为192.168.1.50）。
<Sysname> ftp
[ftp] open 192.168.1.50
Trying 192.168.1.50 ...
Press CTRL+K to abort
Connected to 192.168.1.50.
220 FTP service ready.
User(192.168.1.50:(none)):aa
331 Password required for aa.
Password:
230 User logged in.
[ftp]
【命令】
open ipv6 server-address [ service-port ] [ -i interface-type interface-number ]
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
server-address：远端设备的IP地址或主机名。
service-port：远端设备提供FTP服务的TCP端口号，取值范围为0～65535，缺省值为21。
-i interface-type interface-number：出接口的接口类型和接口编号。此参数只用于FTP服务器的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址。（链路本地地址的介绍和配置请参见“三层技术-IP业务配置指导”中的“IPv6基础”。）
【描述】
open ipv6命令用来在FTP客户端视图下，登录IPv6 FTP服务器。
登录时，系统会提示用户输入登录用户名和密码。如果用户名和密码正确，则登录成功；否则，登录失败。
相关配置可参考命令close。
【举例】
# 在FTP Client视图下，登录FTP服务器（IPv6地址为3000::200）。
<Sysname> ftp
[ftp] open ipv6 3000::200
Trying 3000::200 ...
Press CTRL+K to abort
Connected to 3000::200.
220 Welcome!
User(3000::200:(none)): MY_NAME
331 Please specify the password.
Password:
230 Login successful.
【命令】
passive
undo passive
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
passive命令用来设置数据传输的方式为被动方式。undo passive命令用来设置数据传输的方式为主动方式。
缺省情况下，数据传输的方式为被动方式。
数据传输的方式分为：主动方式和被动方式。主动方式是指在建立数据连接时由服务器主动发起连接请求；被动方式是指在建立数据连接时由客户端主动发起连接请求。该命令主要与防火墙功能配合使用，以便限制私网和公网用户之间建立FTP会话。
【举例】
# 设置数据传输的方式为被动方式。
[ftp] passive
FTP: passive is on
【命令】
put localfile [ remotefile ]
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
localfile：待上传的本地文件名称。
remotefile：文件上传完成后，在服务器上保存时使用的文件名称。
【描述】
put命令用来将客户端本地的文件上传到远程FTP服务器。
如果用户没有指定远程服务器上的文件名，则系统缺省认为此文件名与本地文件名相同。文件上传后将保存在远程服务器用户被授权的路径，该路径可以在远程服务器上使用authorization-attribute命令来设置。
【举例】
# 将本地cc.txt文件上传到远程FTP服务器，并以dd.txt文件名保存。
[ftp] put cc.txt dd.txt
227 Entering Passive Mode (192,168,1,50,17,169).
125 ASCII mode data connection already open, transfer starting for /dd.txt.
226 Transfer complete.
FTP: 9 byte(s) sent in 0.112 second(s), 80.00 byte(s)/sec.
【命令】
pwd
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
pwd命令用来显示当前用户正在访问的远程FTP服务器上的路径。
【举例】
# 显示当前用户正在访问的远程FTP服务器上的路径。
[ftp] cd servertemp
[ftp] pwd
257 "/servertemp" is current directory.
以上显示信息表明当前用户正在访问FTP根目录下的servertemp文件夹。
【命令】
quit
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
quit命令用来断开与远程FTP服务器的连接，并退回到用户视图。
【举例】
# 终止与远程FTP服务器的连接，并退回到用户视图。
[ftp] quit
221 Server closing.
<Sysname>
【命令】
remotehelp [ protocol-command ]
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
protocol-command：FTP协议命令。
【描述】
remotehelp命令用来显示远程FTP服务器支持的FTP相关协议命令的帮助信息。
如果不指定协议命令参数，则显示远程FTP服务器支持的FTP相关协议命令。
【举例】
# 查看远程FTP服务器支持的FTP相关协议命令。
[ftp] remotehelp
214-Here is a list of available ftp commands
Those with '*' are not yet implemented.
USER PASS ACCT* CWD CDUP SMNT* QUIT REIN*
PORT PASV TYPE STRU* MODE* RETR STOR STOU*
APPE* ALLO* REST* RNFR* RNTO* ABOR* DELE RMD
MKD PWD LIST NLST SITE* SYST STAT* HELP
NOOP* XCUP XCWD XMKD XPWD XRMD
214 Direct comments to H3C company.
# 查看协议命令user的帮助信息。
[ftp] remotehelp user
214 Syntax: USER <sp> <username>.
[ftp]
表1-4 remotehelp命令显示信息描述表
|
字段 |
描述 |
|
214-Here is a list of available ftp commands |
以下是可用的FTP命令列表 |
|
Those with '*' are not yet implemented. |
带星号“*”的命令功能目前还没实现 |
|
USER |
用户名 |
|
PASS |
用户口令 |
|
CWD |
改变当前工作路径 |
|
CDUP |
改变目录到父级目录 |
|
SMNT* |
文件结构设置 |
|
QUIT |
退出 |
|
REIN* |
重新初始化 |
|
PORT |
数据端口号 |
|
PASV |
被动模式 |
|
TYPE |
请求类型 |
|
STRU* |
文件结构 |
|
MODE* |
传输模式 |
|
RETR |
下载文件 |
|
STOR |
上传文件 |
|
STOU* |
唯一性上传文件 |
|
APPE* |
追加上传 |
|
ALLO* |
分配空间 |
|
REST* |
重启动 |
|
RNFR* |
重命名源 |
|
RNTO* |
重命名目的 |
|
ABOR* |
中断传输 |
|
DELE |
删除文件 |
|
RMD |
删除文件夹 |
|
MKD |
创建文件夹 |
|
PWD |
打印工作路径 |
|
LIST |
列出文件 |
|
NLST |
列出文件简单描述 |
|
SITE* |
定位参数 |
|
SYST |
显示系统参数 |
|
STAT* |
状态 |
|
HELP |
帮助 |
|
NOOP* |
空操作 |
|
XCUP |
扩展命令，含义同CUP |
|
XCWD |
扩展命令，含义同CWD |
|
XMKD |
扩展命令，含义同MKD |
|
XPWD |
扩展命令，含义同PWD |
|
XRMD |
扩展命令，含义同RMD |
|
Syntax: USER <sp> <username>. |
USER命令的语法：user（关键字）+空格+用户名 |
【命令】
rmdir directory
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
directory：远程FTP服务器上的目录名。
【描述】
rmdir命令用来删除FTP服务器上指定的目录。
只有获得远程FTP服务器授权的客户端用户才能执行此项操作。
需要注意的是：
· 被删除的目录必须为空目录（即删除目录前，必须先删除该目录下的所有文件及子目录，文件的删除请参见delete命令）。
· 成功执行rmdir后，远程回收站中原来属于该文件夹的文件会自动被彻底删除。
【举例】
# 删除FTP根目录下的temp1目录。
[ftp] rmdir /temp1
200 RMD command successful.
【命令】
user username [ password ]
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
username：其他的登录用户名。
password：登录密码。该参数可以在输入username后，空格，再输入；也可以输入username后，回车，出现“Password:”提示符后再输入。
【描述】
user命令用来在成功登录FTP服务器后，使用其他用户身份重新登录当前访问的FTP服务器。
在使用该命令前，必须在FTP服务器上设置了相应的用户名和密码，否则，登录失败，FTP连接关闭。
【举例】
# 用户ftp1已经登录FTP服务器，现以ftp2的身份重新访问当前FTP服务器。（假设用户名ftp2及其登录密码123123123123已经在FTP服务器设置完毕）
· 方法一
[ftp] user ftp2
331 Password required for ftp2.
Password:
230 User logged in.
[ftp]
· 方法二
[ftp] user ftp2 123123123123
331 Password required for ftp.
230 User logged in.
[ftp]
【命令】
verbose
undo verbose
【视图】
FTP客户端视图
【缺省级别】
3：管理级
【参数】
无
【描述】
verbose命令用来打开FTP功能的协议信息开关，使能显示FTP服务器返回的详细信息。undo verbose命令用来关闭verbose开关，禁止显示FTP服务器返回的详细信息。
缺省情况下，FTP协议信息开关为开启状态。
【举例】
# 打开FTP协议信息开关。
[ftp] verbose
FTP: verbose is on
# 关闭FTP协议信息开关时，执行get操作。
[ftp] undo verbose
FTP: verbose is off
[ftp] get startup.cfg bb.cfg
FTP: 3608 byte(s) received in 0.052 second(s), 69.00K byte(s)/sec.
[ftp]
# 打开FTP协议信息开关时，执行get操作。
[ftp] verbose
FTP: verbose is on
[ftp] get startup.cfg aa.cfg
227 Entering Passive Mode (192,168,1,46,5,85).
125 ASCII mode data connection already open, transfer starting for /startup.cfg.
226 Transfer complete.
FTP: 3608 byte(s) received in 0.193 second(s), 18.00K byte(s)/sec.
【命令】
display tftp client configuration [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display tftp client configuration命令用来显示TFTP客户端的配置信息。
相关配置可参考命令tftp client source。
【举例】
# 显示TFTP客户端的当前配置信息。
<Sysname> display tftp client configuration
The source IP address is 192.168.0.123.
目前该命令显示的是源地址配置信息，如果当前生效的源地址是源IP则显示配置的源IP，如果当前生效的源地址是源接口则显示配置的源接口。
【命令】
tftp-server [ ipv6 ] acl acl-number
undo tftp-server [ ipv6 ] acl
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
ipv6：TFTP服务支持IPv6协议。不带该参数，表示使用IPv4协议。
acl-number：基本访问控制列表的编号，取值范围为2000～2999。
【描述】
tftp-server acl命令用来使用ACL限制设备可访问哪些TFTP服务器。undo tftp-server acl命令用来恢复缺省情况。
缺省情况下，没有使用ACL限制TFTP服务器。
用户利用ACL中配置的规则可以允许或禁止对网络中特定TFTP服务器的访问。
ACL的相关内容请参见“ACL和QoS配置指导”中的“ACL”。
【举例】
# 仅允许设备访问IP地址为1.1.1.1的TFTP server，不能访问其他TFTP server。（IPv4组网环境）
<Sysname> system-view
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 1.1.1.1 0
[Sysname-acl-basic-2000] quit
[Sysname] tftp-server acl 2000
# 仅允许设备访问IP地址为2001::1的TFTP server，不能访问其他TFTP server。（IPv6组网环境）
<Sysname> system-view
[Sysname] acl ipv6 number 2001
[Sysname-acl6-basic-2001] rule permit source 2001::1/128
[Sysname-acl6-basic-2001] quit
[Sysname] tftp-server ipv6 acl 2001
【命令】
tftp server-address { get | put | sget } source-filename [ destination-filename ] [ source { interface interface-type interface-number | ip source-ip-address } ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
server-address：TFTP服务器的IP地址或主机名。
get：表示普通下载文件操作。
put：表示上传文件操作。
sget：表示安全下载文件操作。
source-filename：源文件名。
destination-filename：目标文件名，如果不指定本参数，则使用源文件名作为目标文件名，文件路径为用户执行tftp命令时的当前工作路径。
source：配置源地址绑定参数。
· interface interface-type interface-number：当前TFTP客户端传输使用的源接口，包括接口类型和接口编号。此接口下配置的主IP地址即为发送报文的源地址。如果源接口下没有配置主地址，传输失败。
· ip source-ip-address：当前TFTP客户端发送报文所使用的源IP地址。此地址必须是设备上已配置的IP地址。
【描述】
tftp命令用来在IPv4组网环境下执行下列操作：
· 下载文件操作：将TFTP服务器上的指定源文件下载到本地。
· 上传文件操作：将本地的指定源文件上传到TFTP服务器。
【举例】
# 将TFTP根目录下的config.cfg文件下载到本地存储设备。TFTP服务器的IP地址为192.168.0.98，下载到本地之后以文件名config.bak保存，指定源IP地址为192.168.0.92。
<Sysname> tftp 192.168.0.98 get config.cfg config.bak source ip 192.168.0.92
...
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait....
TFTP: 372800 bytes received in 1 second(s)
File downloaded successfully.
# 将设备存储器的文本文件config.cfg上传到TFTP服务器缺省路径下。TFTP服务器的IP地址为192.168.0.98，config.cfg文件在TFTP服务器上以文件名config.bak保存，指定源接口为GigabitEthernet1/0/1。
<Sysname> tftp 192.168.0.98 put config.cfg config.bak source interface GigabitEthernet 1/0/1
File will be transferred in binary mode
Sending file to remote TFTP server. Please wait...
TFTP: 345600 bytes sent in 1 second(s).
File uploaded successfully.
【命令】
tftp client dscp dscp-value
undo tftp client dscp
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
dscp-value：报文的DSCP优先级，取值范围为0～63。
【描述】
tftp client dscp命令用来配置TFTP客户端发送报文的DSCP优先级。Undo tftp client dscp命令用来恢复缺省情况。
缺省情况下，TFTP客户端发报文的DSCP优先级为0。
【举例】
# 配置TFTP客户端发送的报文的DSCP优先级为30。
<Sysname> system-view
[Sysname] tftp client dscp 30
【命令】
tftp client ipv6 dscp dscp-value
undo tftp client ipv6 dscp
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
dscp-value：报文的DSCP优先级，取值范围为0～63。
【描述】
tftp client ipv6 dscp命令用来配置IPv6 TFTP客户端发送报文的DSCP优先级。undo tftp client ipv6 dscp命令用来恢复缺省情况。
缺省情况下，IPv6 TFTP客户端发报文的DSCP优先级为0。
【举例】
# 配置IPv6 TFTP客户端发送的报文的DSCP优先级为30。
<Sysname> system-view
[Sysname] tftp client ipv6 dscp 30
【命令】
tftp client source { interface interface-type interface-number | ip source-ip-address }
undo tftp client source
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
interface interface-type interface-number：设置TFTP传输使用的源接口，包括接口类型和接口编号。源接口下配置的主IP地址即为发送报文的源地址。如果源接口下没有配置地址，会导致传输失败。
ip source-ip-address：设置当前TFTP客户端发送报文所使用的源IP地址。该地址必须是设备上已配置的IP地址。
【描述】
tftp client source命令用来配置TFTP客户端发送的TFTP报文的源地址。undo telnet client source命令用来恢复缺省情况。
缺省情况下，设备使用路由决定的源地址与TFTP服务器通信。
需要注意的是：
· 源地址包括源接口和源IP，如果先后使用tftp client source命令指定了源接口和源IP，新指定的源IP将覆盖现有的源接口配置。反之亦然。
· 使用该命令指定了源地址后，又在tftp命令中指定了源地址，则采用tftp命令中指定的源地址进行通信。
· 本命令指定的源地址对所有的tftp传输有效，tftp命令指定的源地址只对当前的tftp传输有效。
相关配置可参考命令display tftp client configuration。
【举例】
# 指定TFTP客户端的源IP地址为2.2.2.2。
<Sysname> system-view
[Sysname] tftp client source ip 2.2.2.2
# 指定TFTP客户端的源接口为Vlan-interface 1。
<Sysname> system-view
[Sysname] tftp client source interface vlan-interface 1
【命令】
tftp ipv6 tftp-ipv6-server [ -i interface-type interface-number ] { get | put } source-filename [ destination-filename ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
tftp-ipv6-server：TFTP服务器的IPv6地址或主机名（主机名为1～46个字符的字符串）。
-i interface-type interface-number：表示源接口的接口类型和接口编号。此参数只用于TFTP服务器的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址（链路本地地址的介绍和配置请参见“三层技术-IP业务配置指导”中的“IPv6基础”）。
get：执行下载文件操作。
put：执行上传文件操作。
source-filename：源文件的名称。
destination-filename：目的文件的名称。如果不指定该参数，则目的文件的名称与源文件的名称相同。
【描述】
tftp ipv6命令用来在IPv6组网环境下执行下列操作：
· 下载文件操作：将TFTP服务器上的指定源文件下载到本地。
· 上传文件操作：将本地的指定源文件上传到TFTP服务器。
【举例】
# 从TFTP服务器下载文件filetoget.txt。
<Sysname> tftp ipv6 fe80::250:daff:fe91:e058 -i Vlan-interface 1 get filetoget.txt
...
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait....
TFTP: 411100 bytes received in 2 second(s)
File downloaded successfully.
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
售前咨询
售后咨询
人工在线咨询
