快速安装

下载地址

您可以根据自己的系统环境下载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的图形化管理界面配置以下参数。

   参数	说明
   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工具控制台，将左侧本地站点内的文件拖动到右侧远程站点，即可完成文件上传操作；将远程站点的文件拖动到本地站点即可完成文件下载操作。

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

{
  "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
    }
  }
}