欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  科技

如何快速安装OSSFTP工具?阿里云OSS FTP安装图文详细教程

程序员文章站 2022-11-29 10:52:54
如何快速安装OSSFTP工具?阿里云OSS FTP安装图文详细教程...

ossftp工具是一个特殊ftpserver,它接收普通ftp请求后,将对文件、文件夹的操作映射为对oss的操作,从而使得您可以基于ftp协议来管理存储在oss上的文件。

注意生产环境请使用osssdk,ossftp工具主要面向个人用户使用。

主要特性

跨平台:

无论是windows、linux还是mac,无论是32位还是64位操作系统,无论是图形界面还是命令行都可以运行。

免安装:

解压后可直接运行。

免设置:

无需设置即可运行。

透明化:

ftp工具是python写的,您可以看到完整的源码,我们稍后也会开源到github。

主要功能

支持文件和文件夹的上传、下载、删除等操作。

通过multipart方式,分片上传大文件。

支持大部分ftp指令,可以满足日常ftp的使用需求。

注意

1.目前在1.0版本中,考虑到安装部署的简便,ossftp工具没有支持tls加密。由于ftp协议是明文传输的,

为了防止您的密码泄漏,建议将ftpserver和client运行在同一台机器上,通过127.0.0.1:port的方式来访问。

2.不支持rename和move操作。

3.安装包解压后的路径不要含有中文。

4.ftpserver的管理控制页面在低版本的ie中可能打不开。

5.ftpserver支持的python版本:python2.6,python2.7。

下载

由于windows不会默认安装python2.7,所以安装包中包含了python2.7,免去您python安装配置的麻烦,解压即可使用。

由于linux/mac系统默认会安装python2.7或python2.6,所以安装包中不再包含可执行的python,只包含了相关依赖库。

运行

首先解压之前下载的文件,然后根据环境情况选择不同的运行方式。

windows:双击运行start.vbs即可

linux:打开终端,运行 i.$bashstart.sh

mac:双击start.command,或者在终端运行 i.$bashstart.command

上述步骤会启动一个ftpserver,默认监听在127.0.0.1的2048端口。同时,为了方便您对ftpserver的状态进行管控,还会启动一个web服务器,监听在127.0.0.1的8192端口。如果您的系统有图形界面,还会自动打开控制页面,

如下所示:

如何快速安装OSSFTP工具?阿里云OSS FTP安装图文详细教程

大部分情况不要任何配置,就可以运行一个ftpserver了,如果想对ftpserver进行配置,请注意需要重启才能生效。

连接到ftpserver推荐使用filezilla客户端去连接ftpserver。

下载安装后,按如下方式连接即可:

主机:127.0.0.1

登录类型:正常

用户:access_key_id/bucket_name

密码:access_key_secret

注意:

用户中,/是必须的,如用户

tsxyium3nkswpmep/test-hz-jh-002。

-access_key_id和access_key_secret的获取

如何快速安装OSSFTP工具?阿里云OSS FTP安装图文详细教程

高级使用

通过控制页面管理ftpserver

修改监听地址

如果需要通过网络来访问ftpserver,那么需要修改监听地址,因为默认的监听地址127.0.0.1只允许来自本地的访问。可以修改成内网ip或公网ip。

修改监听端口

修改ftpserver监听的端口,建议端口大于1024,因为监听1024以下的端口时需要管理员权限.

修改日志等级

设置ftpserver的日志级别。ftpserver的日志会输出到data/ossftp/目录下,可以通过控制页面的日志按钮在线查看。默认的日志界别为info,打印的日志信息较少,如果需要更详细的日志信息,可以修改为debug模式。如果希望减少日志的输出,可以设置级别为warning或error等。

设置bucketendpoints

ftpserver默认会探索bucket的所属location信息,随后将请求发到对应的region(如oss-cn-hangzhou.aliyuncs.com或oss-cn-beijing.aliyuncs.com),ftpserver会优先尝试内网访问oss。如果您设置了bucketendpoints,如设置为test-bucket-a.oss-cn-hangzhou.aliyuncs.com,那么当访问test-bucket-a时,就会使用oss-cn-hangzhou.aliyuncs.com域名。

注意

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

上述的所有修改其实都是修改的ftp根目录下的config.json,所以您可以直接修改该文件。

直接启动ftpserver(linux/mac)

可以直接启动ossftp目录下的ftpserver.py,免去web_server的开销。

1.python ossftp/ftpserver.py  

 配置修改方式同上。

可能遇到的问题

如果连接ftpserver时,遇到以下错误:

如何快速安装OSSFTP工具?阿里云OSS FTP安装图文详细教程

有两种可能:

输入的access_key_id和access_key_secret有误。

解决:请输入正确的信息后再重试。

所用的access_key信息为ram子账户的access_key,而子账户不具有listbuckets权限。

解决:当使用子账户访问时,请在控制页面中指定bucketendpoints,即告诉ftpserver某个bucket应该用什么endpoint来访问。同时,子账户也需要一些必须的权限,关于使用ram访问oss时的访问控制。

只读访问

ossftp工具需要的权限列表为listobjects、getobject、headobject。关于如何创建一个具有只读访问的ram子账户,请参考图文教程如何结合ram实现文件共享。

上传文件

如果允许ram子账户上传文件,还需要putobject。

删除文件

如果允许ram子账户删除文件,还需要deleteobject。

如果您在linux下运行ftpserver,然后用filezilla连接时遇到如下错误:

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

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

1.$ export lc_all=en_us.utf-8; export lang="en_us.utf-8"; locale

相关标签: OSS FTP