ossftp工具win版是一個(gè)特殊FTP server, 它接收普通FTP請(qǐng)求后，將對(duì)文件、文件夾的操作映射為對(duì)OSS的操作，從而使得您可以基于FTP協(xié)議來(lái)管理存儲(chǔ)在OSS上的文件。由于Windows不會(huì)默認(rèn)安裝Python2.7，所以安裝包中包含了Python2.7，免去您python安裝配置的麻煩，解壓即可使用。

主要特性

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

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

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

透明化:FTP工具是python寫(xiě)的，您可以看到完整的源碼，我們稍后也會(huì)開(kāi)源到Github。

下載安裝使用

首先解壓之前下載的文件，然后根據(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)端口、日志類(lèi)型、指定某個(gè)地域的存儲(chǔ)空間（格式為bucket.enpoint）、頁(yè)面語(yǔ)言。修改后需保存配置并重啟后生效。

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

連接到FTP server

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

主機(jī): 127.0.0.1

登錄類(lèi)型： 正常

用戶(hù)：access_key_id/bucket_name

密碼：access_key_secret

用戶(hù)中，/是必須的，如用戶(hù)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)槟�認(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)銷(xiāo)。

$ 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子賬戶(hù)，請(qǐng)參考圖文教程如何結(jié)合ram實(shí)現(xiàn)文件共享。

上傳文件

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

刪除文件

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

輸入的 access_key_id 和 access_key_secret有誤。

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

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

解決：當(dāng)使用子賬戶(hù)訪問(wèn)時(shí)，請(qǐng)?jiān)诳刂祈?yè)面中指定bucket endpoints， 即告訴FTP server某個(gè)bucket應(yīng)該用什么endpoint來(lái)訪問(wèn)。同時(shí)，子賬戶(hù)也需要一些必須的權(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的使用需求。

注意說(shuō)明

目前在1.0版本中，考慮到安裝部署的簡(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)。

不支持rename和move操作。

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

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

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

注意生產(chǎn)環(huán)境請(qǐng)使用oss sdk, OSS FTP工具主要面向個(gè)人用戶(hù)使用。