OSS-FTP是一款基于阿里云OSS的FTP server工具, 通过将FTP请求转换为OSS请求，使得用户可以用FTP的方式来使用OSS.

###主要特性

• 跨平台: 无论是windows、Linux还是Mac， 无论是32位还是64位操作系统，无论是图形界面还是命令行都可以运行
• 免安装: 解压后可直接运行
• 免设置: 无需设置即可运行
• 透明化: FTP工具是python写的，您可以看到完整的源码，我们稍后也会开源到Github

###主要功能

• 支持文件／文件夹的上传／下载／删除等操作
• 通过Multipart方式，分片上传大文件
• 支持大部分FTP指令，可以满足日常FTP的使用需求

###注意

1. 目前在1.0版本中，考虑到安装部署的简便, OSS FTP工具没有支持TLS加密。由于FTP协议是明文传输的，为了防止您的密码泄漏，建议将FTP server和client运行在同一台机器上，通过127.0.0.1:port的方式来访问

2. 不支持rename, move操作
3. 安装包解压后的路径不要含有中文
4. FTP server的管理控制页面在低版本的IE中可能打不开
5. FTP server支持的Python版本: python2.6, python2.7

有两种方法:

a. 启动FTP server的同时，启动一个简单的web server，方便进行FTP服务器的配置和状态监控

在FTP工具的根目录，直接运行对应的start脚本

• Windows: 双击运行start.vbs即可

• Linux:

$ bash start.sh

• Mac:

$ bash start.command

这种方法会读取FTP工具根目录下的config.json文件, 然后默认在本地的127.0.0.1:2048端口监听FTP请求，同时会在127.0.0.1:8192端口开启一个web服务器，方便对FTP server进行管理。

b. 轻量级的启动方式，即只启动一个FTP server 进入到ossftp目录

$ python ftpserver.py

这会在127.0.0.1:2048端口启动一个FTP 服务器

启动时也可以通过参数指定监听地址和端口等信息

python ftpserver.py --listen_address=<ip address> --port=<your local port> --internal=<True/False> --loglevel=<DEBUG/INFO>

如果 internal为"True", FTP server将通过内网域名访问OSS. 如果 internal为"False", FTP server通过公网域名访问OSS. 当不指定internal字段时，FTP server就会自动探测网络状态, 优先选择从内网域名访问OSS

关于OSS的访问域名的更多信息，请参考https://help.aliyun.com/document_detail/oss/user_guide/endpoint_region.html

loglevel决定了ftpserver的日志级别, DEBUG级别输出的日志信息会更详细

##连接到FTP server 推荐使用FileZilla客户端去连接FTP server。下载安装后，按如下方式连接即可:

• 主机: 127.0.0.1
• 登录类型： 正常
• 用户：access_key_id/bucket_name (注意： 这里的/是必须的，不是‘或’的意思，如用户名'tSxyiUM3NKswPMEp/test-hz-jh-002')
• 密码：access_key_secret

##可能遇到的问题

• 如果连接FTP server时，遇到以下错误：

$ 530 Can't list buckets, check your access_key. 

有两种可能:

1. 输入的 access_key_id 和 access_key_secret有误. 解决：请输入正确的信息后再重试

2. 所用的access_key信息为ram 子账户的access_key，而子账户不具有List buckets权限。 解决: 给ram子账户赋予足够的权限才能使用FTP工具. 关于用使用ram访问oss时的访问控制，请参考文档访问控制

• 只读访问 OSS FTP工具需要的权限列表为 ['ListBuckets', 'GetBucketAcl', 'ListObjects', 'GetObject', 'HeadObject']. 关于如何创建一个具有只读访问的ram子账户，请参考图文教程如何结合ram实现文件共享

• 如果允许ram子账户上传文件，还需要['PutObject']

• 如果允许ram子账户删除文件，还需要['DeleteObject']

• 如果你在Linux下运行FTP server，然后用FileZilla连接时遇到如下错误:

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

一般是因为本地的中文编码有问题。 在将要运行start.sh的终端中输入下面的命令，然后再重新启动即可

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

oss ftp官网主页