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

功能简介

  • 主要特性
    • 跨平台:无论是Windows、Linux还是Mac,无论是32位还是64位操作系统,无论是图形界面还是命令行都可以运行。
    • 免安装: 解压后可直接运行。
    • 免设置:无需设置即可运行。
    • 透明化: FTP工具是Python写的,您可以看到完整的源码,我们稍后也会开源到Github。
  • 主要功能
    • 支持文件和文件夹的上传、下载、删除等操作。
    • 通过Multipart方式,分片上传大文件。
    • 支持大部分FTP指令,可以满足日常FTP的使用需求。
      说明
      • ossftp工具主要面向个人用户使用,生产环境请使用OSS SDK。
      • 在目前的1.0版本中,考虑到安装部署的简便,ossftp工具不支持TLS加密。由于FTP协议是明文传输的,为了防止您的密码泄漏,建议将FTP Server和Client运行在同一台机器上,通过127.0.0.1:port的方式来访问。
      • 不支持rename和move操作。
      • 安装包解压后的路径不能包含中文。
      • FTP Server的管理控制页面在低版本的IE中可能打不开。
      • FTP Server支持的Python版本:Python2.6和Python2.7。

下载地址

  • Windows:ossftp-1.0.3-win.zip

    Windows默认不会安装Python2.7,所以安装包中包含了Python2.7,解压后即可使用。

  • Linux/Mac:ossftp-1.0.3-linux-mac.zip

    Linux/Mac系统默认安装Python2.7或Python2.6,所以安装包中不再包含可执行的Python,只包含了相关依赖库。

快速运行

  1. 下载和您系统匹配的安装包。
  2. 将安装包解压后运行。
    • Windows系统

      解压后双击运行start.vbs即可。如双击无反应,请升级您的IE浏览器或设置其他浏览器为默认浏览器。

    • Linux系统
      1. 解压下载的文件:
        $ unzip ossftp-1.0.3-linux-mac.zip
      2. 进入解压后的文件夹,运行start.sh
        $ cd ossftp-1.0.3-linux-mac
        $ bash start.sh
      3. 使用一台可以访问这台服务器的,有图形化界面的电脑,通过浏览器访问FTP服务器操作界面。访问域名:http://ServerIP:8192
    • Mac系统

      解压后双击start.command,或者在终端运行$ bash start.command

  3. 上述步骤会启动一个FTP server,默认监听在127.0.0.1的2048端口。为了方便您对FTP server的状态进行管控,还会启动一个web服务器,监听在127.0.0.1的8192端口。

    • ossftp监听地址:填写需要使用FTP服务的客户端IP。如果是在本机上运行客户端,保持默认即可。
    • ossftp监听端口:ossftp的监听端口,默认即可。
    • ossftp日志等级:ossftp的日志输出等级,根据需求填写。
    • Bucket endpoints:填写Bucket的访问域名(格式为bucket_name.enpoint),多个域名以英文逗号(,)隔开。
    • Language:选择ossftp的显示语言。
    说明
    • 配置完成后需保存配置并重启生效。
    • 同一时间内只能存在一个服务器和一个连接。如果在一个服务器已连接的情况下新建连接,则之前连接会直接断开。
  4. 下载FileZilla客户端并安装。
  5. 配置OSS访问信息后单击快速连接

    • 主机:配置服务器IP地址,若服务器和客户端在一台设备上,使用默认地址:127.0.0.1。
    • 用户名:填写拥有Bucket访问权限的AccessKeyID和Bucket名称,格式为AccessKeyID/bucket_name,例如tSxyi******wPMEp/test-hz-jh-002
    • 密码:填写拥有Bucket访问权限的AccessKeySecret。
    • 端口:填写服务器配置的监听端口,默认填写2048。
      说明 AccessKeyID和AccessKeySecret的获取,请参见创建RAM用户中的创建AccessKey部分。