二．相關配置

1.伺服器配置

server元素

<serverxmlns="http://mina.apache.org/ftpserver/spring/v1"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://mina.apache.org/ftpserver/spring/v1 http://mina.apache.org/ftpserver/ftpserver-1.0.xsd"

id="server"

max-logins="500"

anon-enabled="false"

max-anon-logins="123"

max-login-failures="124"

login-failure-delay="125">

...

</server>

元素	描述	是否必需	預設值
id	XML配置檔案中的唯一識別符號	Y
max-logins	最大併發使用者數	N	21
max-anon-logins	最大匿名使用者數	N	10
anon-enabled	是否允許匿名使用者登陸	N	true
max-login-failures	連線關閉前登陸失敗後嘗試次數	N	3
login-failure-delay	登陸失敗後的時間延遲（ms），用於限制配置暴力破解密碼	N	500

listener元素

Listener是FtpServer中負責監聽網路socket介面，當客戶端連線後建立使用者session、執行命令等。一個FtpServer可以同時擁有多個listerner，以下是一些例子： 

1）一個在21埠的預設監聽； 

2）一個在21埠的超速通道監聽，一個隱式的在22埠上的SSL監聽

3）一個在內部IP超速通道監聽，一個外部IP的SSL監聽

Listener以name標識，預設Listener的名稱是“default”。

主要的網路配置表現在listener上，例如監聽埠、SSL配置。

在XML配置格式內，所有的監聽器以“listeners”元素進行配置

<listeners>

<nio-listenername="default"port="2222"implicit-ssl="true"idle-timeout="60"local-address="1.2.3.4">

<ssl>

<keystorefile="mykeystore.jks"password="secret"key-password="otherSecret"/>

<truststorefile="mytruststore.jks"password="secret"/>

</ssl>

<data-connectionidle-timeout="60">

<activeenabled="true"local-address="1.2.3.4"local-port="2323"ip-check="true">

<passiveports="123-12"" address="1.2.3.4"external-address="1.2.3.4"/>

</data-connection>

<blacklist>1.2.3.0/16, 1.2.4.0/16, 1.2.3.4</blacklist>

</nio-listener>

</listeners>

nio元素 

裝配FtpServer的監聽器叫做nio-listener，因為它是基於Java NIO的以提升效能和規模。

元素	描述	是否必需	預設值
name	監聽名稱，如果是“default”，它會覆蓋預設的監聽器	Y
port	監聽器接受連線的埠	N	21
local-address	監聽器繫結的伺服器地址	N	All available
implicit-ssl	如果使用隱式的SSL，其值為true	N	false
idle-timeout	非活躍客戶端斷開時間。如果值設為0,則閒置時間不可用（一個客戶端可以永遠閒置，如果沒有從伺服器斷開）如果一個較低的最大閒置時間配置給使用者（比如使用PropertiesUserManager閒置時間配置），它會覆蓋listener值.這樣listener值強加以更高的閾值，但是低層值可以提供給每個使用者。	N	300

ssl元素

對於需要FTPS 支援的Listener必須

元素	描述	是否必需	預設值
protocol	使用SSL協議，支援有 SSL 和TLS	N	TLS
client-authentication	是否客戶端認證？支援的值有：“NEED”，“WANT”和“NONE”	N	NONE
enabled-ciphersuites	對於本連線的一個可用的逗號分隔的密碼元件列表。可用的加密元件依賴於所採用的Java版本	N	所有加密元件均可用

keystore元素

如果提供了ssl元素，它將是必須的。它為金鑰儲存提供配置，用於查詢私鑰和伺服器證書。

元素	描述	是否必需	預設值
file	金鑰儲存路徑	Y
password	金鑰儲存密碼	Y
key-password	金鑰儲存中的金鑰密碼	N	金鑰儲存密碼
key-alias	金鑰儲存中key的別名	N	Uses first key found
type	金鑰儲存型別	N	JKS
algorithm	金鑰儲存演算法	N	SunX509

truststore 

該元素用於配置信任儲存，以定位信任的證書。 

元素	描述	是否必需	預設值
file	金鑰儲存路徑	Y
password	金鑰儲存密碼	N	無密碼可讀取證書
type	金鑰儲存型別	N	JRE key store default type, normally JKS
algorithm	金鑰儲存演算法	N	SunX509

data-connection元素

為資料連線提供配置 

元素	描述	是否必需	預設值
idle-timeout	資料連線要關閉最大閒置時間	N	300

active元素

為積極資料連線提供配置 

元素	描述	是否必需	預設值
enabled	如果積極資料連線不被允許，值為false	N	true
local-address	伺服器建立連線時使用的本地地址	N	Any available
local-port	伺服器建立連線時使用的本地埠	N	Any available
ip-check	伺服器是否監察資料連線IP與控制socket的IP相同？	N	false

passive

相關推薦