ossftp支持在Windows、Linux、macOS等系统上运行,本文介绍如何快速安装和使用ossftp。

下载地址

您可以根据自己的系统环境下载ossftp安装文件。

  • Windows:ossftp-1.1.0-win.zip

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

  • Linux和macOS:ossftp-1.1.0-linux-mac.zip

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

安装步骤

  1. 解压已下载的安装包。
    安装包解压后的路径不能包含中文。
  2. 运行ossftp。
    ossftp运行后会默认打开本机的TCP 2048和TCP 8192端口。其中2048端口作为FTP服务端口,用于接收FTP请求;8192端口作为Web服务端口,用于打开ossftp的图形化管理界面。若您需要将服务提供给他人使用,请在防火墙配置中开放这两个端口。不同系统的运行方式如下:
    • 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. 通过浏览器访问ossftp的图形化管理界面,访问域名为http://127.0.0.1:8192

        若本机无图形化管理界面,可使用其他电脑访问ossftp图形化管理界面,访问域名为http://Linux服务器IP:8192

    • macOS系统

      解压后双击运行start.command程序,或者在命令行运行bash start.command命令。

  3. 在ossftp的图形化管理界面配置以下参数。fteserver
    参数 说明
    ossftp监听地址 填写需要使用FTP服务的客户端IP。

    如果是在本机上运行客户端,保持默认即可。

    ossftp监听端口 设置ossftp的接收访问请求的端口。不与其他端口冲突时,保存默认即可。
    ossftp被动端口范围起始端口 设置ossftp回应访问请求的起始端口。不与其他端口冲突时,保持默认即可。
    ossftp被动端口范围终止端口 设置ossftp回应访问请求的结束端口。不与其他端口冲突时,保持默认即可。
    ossftp日志等级 设置ossftp的日志输出等级。取值如下:
    • DEBUG:记录细粒度信息事件,一般用于调试程序。
    • INFO:记录软件正常运行发生的事件。
    • WARNING:记录不会对系统造成影响的非正常事件。
    • ERROR:记录会对系统造成影响,但不影响系统稳定性的非正常事件。
    • CRITICAL:记录导致系统无法正常工作的事件。
    Bucket endpoints 填写Bucket的访问域名。格式为BucketName.Endpoint。多个域名以英文逗号(,)隔开。

    例如examplebucket.oss-cn-hangzhou.aliyuncs.com

    Language 选择ossftp的显示语言。
  4. 设置完成后单击保存配置,之后单击重启
    不要单击退出,否则会导致ossftp停止运行。
  5. 安装FTP客户端。
    本示例以FileZilla软件为例。软件下载地址,请参见FileZilla
  6. 打开FileZilla,配置OSS访问信息后单击快速连接
    参数 说明
    主机 配置服务器IP地址。

    若服务器和客户端在一台设备上,使用默认地址127.0.0.1。

    用户名密码 填写连接ossftp的用户名和密码。您可以通过以下两种方式获得用户名和密码:
    • AccessKey
      • 使用AccessKey连接ossftp时,用户名由拥有Bucket访问权限的AccessKey ID和Bucket名称组成,格式为AccessKey ID/Bucket名称。例如Y6IoUOZReouXvWaXuwjvDch9******/examplebucket
      • 密码为与AccessKey ID成对的AccessKey Secret。

      AccessKey获取方式,请参见创建AccessKey

    • 自定义用户名

      您可以在ossftp服务端为客户端生成自定义用户名。配置方式,请参见附录:创建自定义登录账号

    端口 填写ossftp配置的监听端口。
    说明 ossftp服务器在同一时间只允许一台客户端连接,新发起的连接请求会导致已经连接的客户端断开。
  7. 上传和下载文件。
    在FileZilla工具控制台,将左侧本地站点内的文件拖动到右侧远程站点,即可完成文件上传操作;将远程站点的文件拖动到本地站点即可完成文件下载操作。

附录:创建自定义登录账号

打开ossftp安装目录中的config.json文件,并修改accounts内的参数,其他参数配置保持默认。配置示例如下:
{
  "modules":{
    "accounts":[
      {
        //填写拥有Bucket访问权限的AccessKey ID和AccessKey Secret。
        "access_id":"LTAI4FrfJPUSoKm4JH******",
        "access_secret":"Y6IoUOZReouXvWaXuwjvDch9******",
        //填写目标Bucket名称。
        "bucket_name":"examplebucket",
        //填写Bucket内文件的访问路径。填写后,该账号仅可以访问指定路径的文件;置空则表示允许访问Bucket内所有文件。
        "home_dir":"examplefolder/",
        //自定义登录密码。
        "login_password":"password1",
        //自定义登录用户名。
        "login_username":"user1"
      },
      {
        "access_id":"LTAI4FrfJPUSoKm4JH******",
        "access_secret":"Y6IoUOZReouXvWaXuwjvDch9******",
        "bucket_name":"examplebucket",
        "home_dir":"",
        "login_password":"password2",
        "login_username":"user2"
      }
    ],
    "launcher":{
      "auto_start":0,
      "control_port":8192,
      "language":"cn",
      "popup_webui":1,
      "show_systray":1
    },
    "ossftp":{
      "address":"127.0.0.1",
      "bucket_endpoints":"",
      "log_level":"INFO",
      "passive_ports_start":51000,
      "passive_ports_end":53000,
      "port":2048
    }
  }
}
配置文件保存后,您需要在ossftp的图形化管理界面重启ossftp服务,否则配置的账号不生效。