阿里云OSS FTP是阿里云面向個(gè)人推出的FTP服務(wù)器，僅適合OSS SDK的生產(chǎn)環(huán)境，當(dāng)它接收到了FTP請(qǐng)求后，你就可以直接對(duì)OSS操作文件夾和文件，支持上傳、下載和刪除，讓您可以更加方便的來(lái)管理OSS上的文件，而且它支持大部分的FTP指令，可以滿足您的各種FTP使用需求。

阿里云OSS FTP主要特性

1、跨平臺(tái): 無(wú)論是Windows、Linux還是Mac， 無(wú)論是32位還是64位操作系統(tǒng)，無(wú)論是圖形界面還是命令行都可以運(yùn)行。

2、免安裝: 解壓后可直接運(yùn)行。

3、免設(shè)置: 無(wú)需設(shè)置即可運(yùn)行。

4、透明化: FTP工具是python寫(xiě)的，您可以看到完整的源碼，官方還開(kāi)源到Github。

阿里云OSS FTP功能介紹

1、支持文件和文件夾的上傳、下載、刪除等操作。

2、通過(guò)Multipart方式，分片上傳大文件。

3、支持大部分FTP指令，可以滿足日常FTP的使用需求。

阿里云OSS FTP怎樣連接到FTP服務(wù)器

推薦使用FileZilla客戶端去連接FTP server。下載安裝后，按如下方式連接即可：

 FileZilla下載地址Win: 32位  64位

主機(jī): 127.0.0.1

登錄類型： 正常

用戶：access_key_id/bucket_name

密碼：access_key_secret

注意：用戶中，/是必須的，如用戶tSxyiUM3NKswPMEp/test-hz-jh-002。

阿里云OSS FTP高級(jí)使用教程

1、修改監(jiān)聽(tīng)地址

如果需要通過(guò)網(wǎng)絡(luò)來(lái)訪問(wèn)FTP server, 那么需要修改監(jiān)聽(tīng)地址，因?yàn)槟J(rèn)的監(jiān)聽(tīng)地址127.0.0.1只允許來(lái)自本地的訪問(wèn)?？梢孕薷某蓛?nèi)網(wǎng)ip或公網(wǎng)ip。

2、修改監(jiān)聽(tīng)端口

修改FTP server監(jiān)聽(tīng)的端口, 建議端口大于1024， 因?yàn)楸O(jiān)聽(tīng)1024以下的端口時(shí)需要管理員權(quán)限.

3、修改日志等級(jí)

設(shè)置FTP server的日志級(jí)別。FTP server的日志會(huì)輸出到data/ossftp/目錄下， 可以通過(guò)控制頁(yè)面的日志按鈕在線查看。默認(rèn)的日志界別為INFO, 打印的日志信息較少，如果需要更詳細(xì)的日志信息，可以修改為DEBUG模式。如果希望減少日志的輸出，可以設(shè)置級(jí)別為WARNING或ERROR等。

4、設(shè)置Bucket endpoints

FTP server默認(rèn)會(huì)探索bucket的所屬location信息，隨后將請(qǐng)求發(fā)到對(duì)應(yīng)的region（如oss-cn-hangzhou.aliyuncs.com或oss-cn-beijing.aliyuncs.com)，F(xiàn)TP server會(huì)優(yōu)先嘗試內(nèi)網(wǎng)訪問(wèn)oss。如果您設(shè)置了bucket endpoints, 如設(shè)置為test-bucket-a.oss-cn-hangzhou.aliyuncs.com， 那么當(dāng)訪問(wèn)test-bucket-a時(shí)，就會(huì)使用oss-cn-hangzhou.aliyuncs.com域名。

注意

1）所有修改都需要重啟才能生效。

2）上述的所有修改其實(shí)都是修改的ftp根目錄下的config.json， 所以您可以直接修改該文件。

5、直接啟動(dòng)FTP server(Linux/Mac)

可以直接啟動(dòng)ossftp目錄下的ftpserver.py, 免去web_server的開(kāi)銷。

$ python ossftp/ftpserver.py &

配置修改方式同上。

阿里云OSS FTP使用注意事項(xiàng)

1、考慮到安裝部署的簡(jiǎn)便，OSS FTP工具沒(méi)有支持TLS加密。由于FTP協(xié)議是明文傳輸?shù)?，為了防止您的密碼泄漏，建議將FTP server和client運(yùn)行在同一臺(tái)機(jī)器上，通過(guò)127.0.0.1:port的方式來(lái)訪問(wèn)。

2、不支持rename和move操作。

3、安裝包解壓后的路徑不要含有中文。

4、FTP server的管理控制頁(yè)面在低版本的IE中可能打不開(kāi)。

5、FTP server支持的Python版本: Python2.6, Python2.7。

 

下載安裝使用

首先解壓之前下載的文件，然后根據(jù)環(huán)境情況選擇不同的運(yùn)行方式。

Windows: 雙擊運(yùn)行start.vbs即可

Linux： 打開(kāi)終端，運(yùn)行

$ bash start.sh

Mac：雙擊start.command，或者在終端運(yùn)行

$ bash start.command

上述步驟會(huì)啟動(dòng)一個(gè)FTP server, 默認(rèn)監(jiān)聽(tīng)在127.0.0.1的2048端口。同時(shí)，為了方便您對(duì)FTP server的狀態(tài)進(jìn)行管控，還會(huì)啟動(dòng)一個(gè)web服務(wù)器，監(jiān)聽(tīng)在127.0.0.1的8192端口。如果您的系統(tǒng)有圖形界面，還會(huì)自動(dòng)打開(kāi)控制頁(yè)面。在控制頁(yè)面中允許修改監(jiān)聽(tīng)地址、監(jiān)聽(tīng)端口、日志類型、指定某個(gè)地域的存儲(chǔ)空間（格式為bucket.enpoint）、頁(yè)面語(yǔ)言。修改后需保存配置并重啟后生效。

同一時(shí)間內(nèi)只能存在一個(gè)服務(wù)器和一個(gè)連接。如果在一個(gè)服務(wù)器已連接的情況下新建連接，則之前連接會(huì)直接斷開(kāi)。

連接到FTP server

請(qǐng)使用FileZilla客戶端去連接FTP server。下載安裝后，按如下方式連接即可:

主機(jī): 127.0.0.1

登錄類型： 正常

用戶：access_key_id/bucket_name

密碼：access_key_secret

用戶中，/是必須的，如用戶tSxyiUM3NKswPMEp/test-hz-jh-002。

access_key_id和access_key_secret的獲取，請(qǐng)參見(jiàn)OSS訪問(wèn)控制。

高級(jí)使用

通過(guò)控制頁(yè)面管理FTP server

所有修改都需要重啟才能生效。

上述的所有修改其實(shí)都是修改的ftp根目錄下的config.json， 所以您可以直接修改該文件。

修改監(jiān)聽(tīng)地址

如果需要通過(guò)網(wǎng)絡(luò)來(lái)訪問(wèn)FTP server, 那么需要修改監(jiān)聽(tīng)地址，因?yàn)槟J(rèn)的監(jiān)聽(tīng)地址127.0.0.1只允許來(lái)自本地的訪問(wèn)?？梢孕薷某蓛?nèi)網(wǎng)ip或公網(wǎng)ip。

修改監(jiān)聽(tīng)端口

修改FTP server監(jiān)聽(tīng)的端口, 建議端口大于1024， 因?yàn)楸O(jiān)聽(tīng)1024以下的端口時(shí)需要管理員權(quán)限。

修改日志等級(jí)

設(shè)置FTP server的日志級(jí)別。FTP server的日志會(huì)輸出到data/ossftp/目錄下， 可以通過(guò)控制頁(yè)面的日志按鈕在線查看。默認(rèn)的日志界別為INFO, 打印的日志信息較少，如果需要更詳細(xì)的日志信息，可以修改為DEBUG模式。如果希望減少日志的輸出，可以設(shè)置級(jí)別為WARNING或ERROR等。

設(shè)置Bucket endpoints

FTP server默認(rèn)會(huì)探索bucket的所屬location信息，隨后將請(qǐng)求發(fā)到對(duì)應(yīng)的region（如oss-cn-hangzhou.aliyuncs.com或oss-cn-beijing.aliyuncs.com)，F(xiàn)TP server會(huì)優(yōu)先嘗試內(nèi)網(wǎng)訪問(wèn)oss。如果您設(shè)置了bucket endpoints, 如設(shè)置為test-bucket-a.oss-cn-hangzhou.aliyuncs.com， 那么當(dāng)訪問(wèn)test-bucket-a時(shí)，就會(huì)使用oss-cn-hangzhou.aliyuncs.com域名。

設(shè)置顯示語(yǔ)言

通過(guò)設(shè)置cn/en，可修改FTP控制頁(yè)面的顯示語(yǔ)言為中文/英文。

直接啟動(dòng)FTP server(Linux/Mac)

可以直接啟動(dòng)ossftp目錄下的ftpserver.py, 免去web_server的開(kāi)銷。

$ python ossftp/ftpserver.py &

配置修改方式同上。

可能遇到的問(wèn)題

如果連接FTP server時(shí)，遇到以下錯(cuò)誤：

有兩種可能：

只讀訪問(wèn)

OSS FTP工具需要的權(quán)限列表為 ListObjects、GetObject、HeadObject。關(guān)于如何創(chuàng)建一個(gè)具有只讀訪問(wèn)的ram子賬戶，請(qǐng)參考圖文教程如何結(jié)合ram實(shí)現(xiàn)文件共享。

上傳文件

如果允許ram子賬戶上傳文件，還需要PutObject。

刪除文件

如果允許ram子賬戶刪除文件，還需要DeleteObject。

輸入的 access_key_id 和 access_key_secret有誤。

解決：請(qǐng)輸入正確的信息后再重試。

所用的access_key信息為ram 子賬戶的access_key，而子賬戶不具有List buckets權(quán)限。

解決：當(dāng)使用子賬戶訪問(wèn)時(shí)，請(qǐng)?jiān)诳刂祈?yè)面中指定bucket endpoints， 即告訴FTP server某個(gè)bucket應(yīng)該用什么endpoint來(lái)訪問(wèn)。同時(shí)，子賬戶也需要一些必須的權(quán)限，關(guān)于使用ram訪問(wèn)oss時(shí)的訪問(wèn)控制，請(qǐng)參考文檔訪問(wèn)控制。具體如下。

如果您在Linux下運(yùn)行FTP server，然后用FileZilla連接時(shí)遇到如下錯(cuò)誤：

501 can't decode path (server filesystem encoding is ANSI_X3.4-1968)

一般是因?yàn)楸镜氐闹形木幋a有問(wèn)題。在將要運(yùn)行start.sh的終端中輸入下面的命令，然后再重新啟動(dòng)即可。

$ export LC_ALL=en_US.UTF-8; export LANG="en_US.UTF-8"; locale

主要功能

支持文件和文件夾的上傳、下載、刪除等操作。

通過(guò)Multipart方式，分片上傳大文件。

支持大部分FTP指令，可以滿足日常FTP的使用需求。