目  录

1 FTP配置命令

1.1 FTP服务器配置命令

1.1.1 display ftp-server

1.1.2 display ftp-user

1.1.3 free ftp user

1.1.4 ftp server acl

1.1.5 ftp server enable

1.1.6 ftp timeout

1.1.7 ftp update

1.2 FTP客户端配置命令

1.2.1 ascii

1.2.2 binary

1.2.3 bye

1.2.4 cd

1.2.5 cdup

1.2.6 close

1.2.7 debugging

1.2.8 delete

1.2.9 dir

1.2.10 disconnect

1.2.11 display ftp client configuration

1.2.12 ftp

1.2.13 ftp client source

1.2.14 ftp ipv6

1.2.15 get

1.2.16 lcd

1.2.17 ls

1.2.18 mkdir

1.2.19 open

1.2.20 open ipv6

1.2.21 passive

1.2.22 put

1.2.23 pwd

1.2.24 quit

1.2.25 remotehelp

1.2.26 rmdir

1.2.27 user

1.2.28 verbose

2 TFTP配置命令

2.1 TFTP客户端配置命令

2.1.1 display tftp client configuration

2.1.2 tftp-server acl

2.1.3 tftp

2.1.4 tftp client source

2.1.5 tftp ipv6

 

1 FTP配置命令

1.1  FTP服务器配置命令

1.1.1  display ftp-server

【命令】

display ftp-server

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

无

【描述】

display ftp-server命令用来显示设备作为FTP服务器时的各项参数。

进行FTP参数设置后，可通过此命令查看设置结果。

相关配置可参考命令ftp server enable、ftp timeout和ftp update。

【举例】

# 显示FTP服务器参数设置结果。

<Sysname> display ftp-server

   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表示普通方式

 

1.1.2  display ftp-user

【命令】

display ftp-user

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

无

【描述】

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用户的授权路径

 

1.1.3  free ftp user

【命令】

free ftp user username

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

username：待释放的FTP连接建立时使用的用户名。可以使用display ftp-user命令来查看当前FTP连接所使用的登录用户名。

【描述】

free ftp user命令用来强制释放通过指定用户名建立的FTP连接。

需要注意的是如果所释放的用户正在传输文件，则用户与FTP服务器之间的连接将在文件传输完成之后断开。

【举例】

# 强制释放通过用户名ftpuser建立的FTP连接。

<Sysname> free ftp user ftpuser

Are you sure to free FTP user ftpuser? [Y/N]:y

<Sysname>

1.1.4  ftp server acl

【命令】

ftp server acl acl-number

undo ftp server acl

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

acl-number：基本访问控制列表号，取值范围为2000～2999。

【描述】

ftp server acl命令用来使用ACL限制哪些FTP客户端可以访问设备。undo ftp server acl命令用来恢复缺省情况。

缺省情况下，没有使用ACL限制FTP客户端。

通过将FTP服务与ACL关联，可以过滤掉来自某些客户端的FTP请求报文，只允许符合ACL过滤规则的客户端访问设备。该配置只过滤新建立的FTP连接，不会对已建立的FTP连接和操作造成影响。如果多次使用该命令配置FTP服务与ACL关联，FTP服务将只与最后一次配置的ACL关联。

【举例】

# 配置FTP服务与ACL关联，只允许客户端（1.1.1.1）通过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

1.1.5  ftp server enable

【命令】

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

1.1.6  ftp timeout

【命令】

ftp timeout minute

undo ftp timeout

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

minute：连接空闲时间，取值范围为1～35791，单位为分钟。

【描述】

ftp timeout命令用来设置连接空闲时间。undo ftp timeout命令用来恢复缺省情况。

缺省情况下，FTP连接空闲时间为30分钟。

用户登录到FTP服务器后，如果连接异常中断，FTP服务器又无法及时获悉，此时，系统将继续保持该连接，从而导致系统资源被占用，其它FTP用户的登录受影响。使用连接空闲时间，可以防止这类情况的发生：当FTP服务器与某用户的连接在一定时间内没有进行消息交互，FTP服务器即可认为连接已经失效，而断开与该用户的连接。

【举例】

# 设置连接空闲时间为36分钟。

<Sysname> system-view

[Sysname] ftp timeout 36

1.1.7  ftp update

【命令】

ftp update { fast | normal }

undo ftp update

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

fast：快速更新方式。

normal：普通更新方式。

【描述】

ftp update命令用来设置在给FTP服务器上传文件的过程中，FTP服务器更新文件的方式。undo ftp update命令用来恢复缺省情况。

缺省情况下，FTP服务器采用normal方式更新文件。

【举例】

# 设置在接收上传文件时，FTP服务器采用普通方式。

<Sysname> system-view

[Sysname] ftp update normal

1.2  FTP客户端配置命令

 

1.2.1  ascii

【命令】

ascii

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

ascii命令用来设置文件传输的模式为ASCII模式。

缺省情况下，文件传输模式为ASCII模式。

不同的操作系统对换行符的表示方法不同，比如H3C设备系统和Windows系统使用“/r/n”标志换行，在Linux系统中使用“/n”表示换行，所以在换行符表示方法不同的两个系统（比如Linux系统和H3C设备系统）间传输完文件后，要正确解析这些文件的话，必须遵循FTP传输模式规则。FTP传输文件有两种模式：

l              二进制模式（又称为binary模式），用于传输程序文件或者图片。

l              ASCII码模式，用于传输文本文件。

相关配置可参考binary。

【举例】

# 设置数据传输的模式为ASCII模式。

[ftp] ascii

200 Type set to A.

1.2.2  binary

【命令】

binary

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

binary命令用来设置文件传输的模式为二进制模式（也称为流模式）。

缺省情况下，文件传输模式为ASCII模式。

相关配置可参考ascii。

【举例】

# 设置文件传输类型支持binary模式。

[ftp] binary

200 Type set to I.

1.2.3  bye

【命令】

bye

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

bye命令用来断开与远程FTP服务器的连接，并退回到用户视图。如果设备与远程FTP服务器没有建立连接，则直接退回到用户视图。

相关命令可参见close、disconnect和quit。

【举例】

# 终止与远程FTP服务器的连接，并退回到用户视图。

[ftp] bye

221 Server closing.

1.2.4  cd

【命令】

cd { directory | .. | / }

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

directory：指定目标工作路径。格式为[drive:/]path。drive和path参数的详细解释，请参见“系统分册”中的“文件系统管理配置”。如果没有给出drive信息，则表示当前路径下的文件夹或者子文件夹。

..：返回上一级目录，其功能相当于cdup。如果当前的工作路径是根目录，或不存在上一级目录，则执行cd ..后保持当前的工作路径不变。该参数不支持命令行在线帮助。

/：返回存储介质的根目录。该参数不支持命令行在线帮助。

【描述】

cd命令用来切换远程FTP服务器上的工作路径。

用户访问FTP服务器上的另一目录时，可使用本命令。需要注意的是，用户可以访问的目录只能是FTP服务器对用户已经授权的目录。

相关命令可参考pwd。

【举例】

# 切换工作路径到当前目录下的logfile子目录。

[ftp] cd logfile

250 CWD command successful.

# 切换工作路径到授权目录下的folder子目录。

[ftp] cd /folder

250 CWD command successful.

1.2.5  cdup

【命令】

cdup

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

cdup命令用来退出远程FTP服务器的当前目录，返回FTP服务器的上一级目录。

如果当前目录已经是授权目录（即work-directory），执行该命令，工作路径将不再更改。

相关命令可参考cd和pwd。

【举例】

# 将工作路径改为上一级目录。

[ftp] pwd

257 "/ftp/subdir" is current directory.

[ftp] cdup

200 CDUP command successful.

[ftp] pwd

257 "/ftp" is current directory.

1.2.6  close

【命令】

close

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

close命令用来在不退出FTP客户端视图的前提下，断开与FTP服务器的连接。

该命令的功能与disconnect命令相同。

【举例】

# 终止与FTP服务器的连接，并保持在FTP客户端视图。

[ftp] close

221 Server closing.

[ftp]

1.2.7  debugging

【命令】

debugging

undo debugging

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

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	发出FTP指令，数据端口号为
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.	文件传输结束，关闭文件传输指示灯

 

1.2.8  delete

【命令】

delete remotefile

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

remotefile：文件名。

【描述】

delete命令用来彻底删除远程FTP服务器上的指定文件，删除的文件不能被恢复。

用户必须具有删除的权限，才能执行该操作。

【举例】

# 删除文件temp.c。

[ftp] delete temp.c

250 DELE command successful.

1.2.9  dir

【命令】

dir [ remotefile [ localfile ] ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

remotefile：待查询的远程FTP服务器上的目录或文件名。

localfile：用于保存查询信息的本地文件的名称。

【描述】

dir命令用来查看远程FTP服务器当前目录下的所有子目录及文件的详细信息。

dir remotefile命令用来查看远程FTP服务器上指定目录或文件的详细信息。

dir remotefile localfile命令用来查看远程FTP服务器上指定目录或文件的详细信息，并把查看结果（找到的目录或文件的详细信息）保存在本地以localfile命名的文件中。

 

【举例】

# 显示当前远程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.app

-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

1.2.10  disconnect

【命令】

disconnect

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

disconnect命令用来在不退出FTP客户端视图的前提下，断开与FTP服务器的连接。

该命令的功能与close命令相同。

【举例】

# 终止与远程FTP服务器的连接，保持在FTP客户端视图。

[ftp] disconnect

221 Server closing.

1.2.11  display ftp client configuration

【命令】

display ftp client configuration

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display ftp client configuration命令用来显示FTP客户端的配置信息。

相关配置可参考命令ftp client source。

【举例】

# 显示FTP客户端的当前配置信息。

<Sysname> display ftp client configuration

The source IP address is 192.168.0.123

 

1.2.12  ftp

【命令】

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。

interface interface-type interface-number：当前FTP客户端连接使用的源接口，包括接口类型和接口编号。此接口下配置的主IP地址即为发送报文的源地址。如果源接口下没有配置主地址，连接失败。

ip source-ip-address：当前FTP客户端连接使用的源IP地址。该地址必须是设备上已配置的IP地址。

【描述】

ftp命令用来登录FTP服务器，并进入FTP客户端视图。

需要注意的是：

l              该命令适用于IPv4组网环境。

l              如果不指定任何参数，则只进入FTP客户端视图，不登录FTP服务器。

l              如果指定参数，系统会提示用户输入登录FTP服务器的用户名和密码。如果用户名和密码正确，则登录成功，并进入FTP客户端视图；否则，登录失败。

l              本命令指定的源地址的优先级高于ftp client source命令配置的源地址的优先级。如果执行ftp client source命令指定了源地址后，又在ftp命令中指定了源地址，则采用ftp命令中指定的源地址进行通信。

相关配置可参考命令ftp client source。

【举例】

# 使用FTP方式，从当前设备Sysname1登录到设备Sysname2（IP地址为192.168.0.211），并且FTP发送报文的源IP地址为192.168.0.212。

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

1.2.13  ftp client source

【命令】

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服务器通信。

需要注意的是：

l              源地址包括源接口和源IP，如果先后使用ftp client source命令指定了源接口和源IP，新指定的源IP将覆盖现有的源接口配置。反之亦然。

l              使用该命令指定了源地址后，又在ftp命令中指定了源地址，则采用ftp命令中指定的源地址进行通信。

l              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

1.2.14  ftp ipv6

【命令】

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客户端视图。

需要注意的是：

l              该命令适用于IPv6组网环境。

l              如果不指定任何参数，则只进入FTP客户端视图，不登录FTP服务器。

l              如果指定参数，系统会提示用户输入登录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]

1.2.15  get

【命令】

get remotefile [ localfile ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

remotefile：需要下载的文件名称。

localfile：将文件下载到本地保存时使用的文件名称。如不使用该参数，将使用源文件名称作为本地文件名称保存到用户执行ftp命令时的当前工作路径。

【描述】

get命令用来下载FTP服务器上的文件，并将下载的文件存储在本地。

【举例】

# 下载testcfg.cfg文件到主用主控板存储介质的根目录下，并以newest.cfg文件名保存。

[ftp] get testcfg.cfg newest.cfg

 

227 Entering Passive Mode (192,168,1,46,4,47).

125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.

..226 Transfer complete.

FTP: 3608 byte(s) received in 2.050 second(s), 1.00K byte(s)/sec.

# 下载testcfg.cfg文件到备用主控板（所在槽位号为1）存储介质的根目录下，并以newest.cfg文件名保存。

[ftp] get testcfg.cfg slot1#flash:/newest.cfg

 

227 Entering Passive Mode (192,168,1,46,4,48).

125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.

226 Transfer complete.

FTP: 3608 byte(s) received in 2.322 second(s), 1.00K byte(s)/sec.

1.2.16  lcd

【命令】

lcd

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

lcd命令用来获取FTP客户端本地的工作路径。

【举例】

# 显示本地的工作路径。

[ftp] lcd

FTP: Local directory now flash:/clienttemp.

以上信息表明FTP客户端在执行ftp命令前的工作路径是flash:/clienttemp。

1.2.17  ls

【命令】

ls [ remotefile [ localfile ] ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

remotefile：待查询的远程FTP服务器上的目录或文件名。

localfile：用于保存查询信息的本地文件名称。

【描述】

ls命令用来查询远程FTP服务器上当前目录下的子目录及文件，系统将列出当前目录下的所有子目录及文件的名称。

ls remotefile命令用来查询远程FTP服务器上的指定目录或文件，系统将列出找到的目录或文件的名称。

ls remotefile localfile命令用来查询远程FTP服务器上指定的目录或文件，并把查询结果（找到的目录或文件的名称）保存到本地以localfile命名的文件中。

 

【举例】

# 查询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.app

arbasicbtm.app

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，并将查询结果保存在aa.txt文件中。

[ftp] ls logfile aa.txt

227 Entering Passive Mode (192,168,1,46,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

1.2.18  mkdir

【命令】

mkdir directory

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

directory：待创建的目录名称。

【描述】

mkdir命令用来在远程FTP服务器上指定目录下创建子目录。

只有获得远程FTP服务器授权的客户端用户才能执行此项操作。

【举例】

# 在远程FTP服务器的当前目录下创建子目录mytest。

[ftp] mkdir mytest

257 "/mytest" new directory created. 

1.2.19  open

【命令】

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]

1.2.20  open ipv6

【命令】

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.

1.2.21  passive

【命令】

passive

undo passive

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

passive命令用来设置数据传输的方式为被动方式。undo passive命令用来设置数据传输的方式为主动方式。

缺省情况下，数据传输的方式为被动方式。

数据传输的方式分为：主动方式和被动方式。主动方式是指在建立数据连接时由服务器主动发起连接请求；被动方式是指在建立数据连接时由客户端主动发起连接请求。该命令主要与防火墙功能配合使用，以便限制私网和公网用户之间建立FTP会话。

【举例】

# 设置数据传输的方式为被动方式。

[ftp] passive

FTP: passive is on

1.2.22  put

【命令】

put localfile [ remotefile ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

localfile：待上传的本地文件名称。

remotefile：文件上传完成后，在服务器上保存时使用的文件名称。

【描述】

put命令用来将客户端本地的文件上传到远程FTP服务器。

如果用户没有指定远程服务器上的文件名，则系统缺省认为此文件名与本地文件名相同。文件上传后将保存在用户的授权路径，该路径可以使用authorization-attribute命令来设置。

【举例】

# 将主用主控板上的vrpcfg.cfg文件上传到远程FTP服务器做备份，并以ftpclient.cfg文件名保存。

[ftp] put vrpcfg.cfg ftpclient.cfg

227 Entering Passive Mode (192,168,1,46,4,50).

125 ASCII mode data connection already open, transfer starting for /ftpclient.cfg.

226 Transfer complete.

FTP: 1366 byte(s) sent in 0.064 second(s), 21.00Kbyte(s)/sec.

# 将备用主控板（所在槽位号为1）上的a.cfg文件上传到远程FTP服务器做备份，并以ftpclienta.cfg文件名保存。

[ftp] put slot1#flash:/a.cfg ftpclienta.cfg

227 Entering Passive Mode (192,168,1,46,4,52).

125 ASCII mode data connection already open, transfer starting for /ftpclienta.cfg.

226 Transfer complete.

FTP: 1226 byte(s) sent in 0.065 second(s), 18.00Kbyte(s)/sec.

1.2.23  pwd

【命令】

pwd

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

pwd命令用来显示当前用户正在访问的远程FTP服务器上的路径。

【举例】

# 显示当前用户正在访问的远程FTP服务器上的路径。

[ftp] cd servertemp

[ftp] pwd

257 "/servertemp" is current directory.

以上显示信息表明当前用户正在访问FTP服务器根目录下的servertemp文件夹。

1.2.24  quit

【命令】

quit

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

无

【描述】

quit命令用来终止与远程FTP服务器的连接，并退回到用户视图。

【举例】

# 终止与远程FTP服务器的连接，并退回到用户视图。

[ftp] quit

221 Server closing. 

 

<Sysname>

1.2.25  remotehelp

【命令】

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（关键字）+空格+用户名

 

1.2.26  rmdir

【命令】

rmdir directory

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

directory：远程FTP服务器上的目录名。

【描述】

rmdir命令用来删除FTP服务器上指定的目录。

只有获得远程FTP服务器授权的客户端用户才能执行此项操作。

需要注意的是：

l              被删除的目录必须为空目录（即删除目录前，必须先删除该目录下的所有文件及子目录，文件的删除请参见delete命令）。

l              成功执行rmdir后，远程回收站中原来属于该文件夹的文件会自动被彻底删除。

【举例】

# 删除FTP服务器上的授权目录下的temp1目录。

[ftp] rmdir /temp1

200 RMD command successful.

1.2.27  user

【命令】

user username [ password ]

【视图】

FTP客户端视图

【缺省级别】

3：管理级

【参数】

username：其他的登录用户名。

password：登录密码。该参数可以在输入username后，空格，再输入；也可以输入username后，回车，出现“Password:”提示符后再输入。

【描述】

user命令用来在成功登录FTP服务器后，使用其他用户身份重新登录当前访问的FTP服务器。

在使用该命令前，必须在FTP服务器上设置了相应的用户名和密码，否则，登录失败，FTP连接关闭。

【举例】

# 用户ftp1已经登录FTP服务器，现以ftp2的身份重新访问当前FTP服务器。（假设用户名ftp2及其登录密码123123123123已经在FTP服务器设置完毕）

l              方法一

[ftp] user ftp2

331 Password required for ftp2.

Password:

230 User logged in.

 

[ftp]

l              方法二

[ftp] user ftp2 123123123123

331 Password required for ftp.

230 User logged in.

 

[ftp]

1.2.28  verbose

【命令】

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.

 

2 TFTP配置命令

2.1  TFTP客户端配置命令

2.1.1  display tftp client configuration

【命令】

display tftp client configuration

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display tftp client configuration命令用来显示TFTP客户端的配置信息。

相关配置可参考命令tftp client source。

【举例】

# 显示TFTP客户端的当前配置信息。

<Sysname> display tftp client configuration

The source IP address is 192.168.0.123

 

2.1.2  tftp-server acl

【命令】

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 ipv6 acl命令用来恢复缺省情况。

缺省情况下，没有使用ACL限制TFTP服务器。

用户利用ACL中配置的规则可以允许或禁止对网络中特定TFTP服务器的访问。

ACL的相关内容请参见“ACL分册”中的“ACL配置”和“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

2.1.3  tftp

【命令】

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：目标文件名。

source：配置源地址绑定参数。

l              interface interface-type interface-number：当前TFTP客户端传输使用的源接口，包括接口类型和接口编号。此接口下配置的主IP地址即为发送报文的源地址。如果源接口下没有配置主地址，传输失败。

l              ip source-ip-address：当前TFTP客户端发送报文所使用的源IP地址。此地址必须是设备上已配置的IP地址。

【描述】

tftp命令用来实现从本地设备上传文件到TFTP服务器或从TFTP服务器下载文件至本地设备。

l              如果没有指定本地文件名，则使用与远程FTP服务器上相同的文件名保存到用户的当前工作路径（即执行tftp命令时的工作路径）。

l              本命令指定的源地址的优先级高于tftp client source命令配置的源地址的优先级。如果执行tftp client source命令指定了源地址后，又在tftp命令中指定了源地址，则采用tftp命令中指定的源地址进行通信。

该命令适用于IPv4组网环境。

相关配置可参考命令tftp client source。

【举例】

# 为了升级设备，将TFTP服务器根目录下的newest.app文件下载到主用主控板Flash的根目录以及备用主控板Flash的根目录。TFTP服务器的IP地址为192.168.1.26。

<Sysname> tftp 192.168.1.26 get newest.app startup.app

  .

  File will be transferred in binary mode

  Downloading file from remote TFTP server, please wait..................

  TFTP:  2737556 bytes received in 13 second(s)

  File downloaded successfully.

// 将TFTP服务器上的APP文件下载到主用主控板的根目录下。

<Sysname> tftp 192.168.1.26 get newest.app slot1#flash:/startup.app

 

  File will be transferred in binary mode

  Downloading file from remote TFTP server, please wait...|

  TFTP:  2737556 bytes received in 14 second(s)

  File downloaded successfully.

// 将TFTP服务器上的APP文件下载到备用主控板的根目录下。

2.1.4  tftp client source

【命令】

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服务器通信。

需要注意的是：

l              源地址包括源接口和源IP，如果先后使用tftp client source命令指定了源接口和源IP，新指定的源IP将覆盖现有的源接口配置。反之亦然。

l              使用该命令指定了源地址后，又在tftp命令中指定了源地址，则采用tftp命令中指定的源地址进行通信。

l              本命令指定的源地址对所有的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-interface1。

<Sysname> system-view

[Sysname] tftp client source interface vlan-interface1

2.1.5  tftp ipv6

【命令】

tftp ipv6 tftp-ipv6-server [ -i interface-type interface-number ] { get | put } source-file [ destination-file ]

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

tftp-ipv6-server：TFTP服务器的IPv6地址或主机名（主机名为1～46个字符的字符串）。

-i interface-type interface-number：出接口的接口类型和接口编号。此参数只用于TFTP服务器的地址是链路本地地址的情况，而且指定的出接口必需具有链路本地地址（链路本地地址的介绍和配置请参见“IP业务分册”中的“IPv6基础配置”）。

get：执行下载文件操作。

put：执行上传文件操作。

source-filename：源文件的名称。

destination-filename：目的文件的名称。如果不指定该参数，则目的文件的名称与源文件的名称相同。

【描述】

tftp ipv6命令用来执行下列操作：

l              下载文件操作：将TFTP服务器上的指定源文件下载到本地。

l              上传文件操作：将本地的指定源文件上传到TFTP服务器。

该命令适用于IPv6组网环境。

【举例】

# 从TFTP服务器下载文件filetoget.txt。

<Sysname> tftp ipv6 fe80::250:daff:fe91:e058 -i vlan-interface1 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.