All Products
Search
Document Center

Object Storage Service:Install ossftp

Last Updated:May 07, 2026

This topic describes how to install ossftp.

Procedure

  1. Download the ossftp installation package.

    Operating system

    Description

    Installation package

    Windows

    By default, Python 2.7 is not installed on Windows. The installation package includes Python 2.7. You can run ossftp directly after the package is decompressed.

    ossftp-1.2.0-win.zip

    Linux

    By default, Python 2.7 or Python 3.x is installed on Linux. The installation package contains only the required dependent libraries.

    ossftp-1.2.0-linux-mac.zip

    macOS

    By default, Python 2.7 or Python 3.x is installed on macOS. The installation package contains only the required dependent libraries.

    ossftp-1.2.0-linux-mac.zip

  2. Extract the ossftp installation package.

    Important

    Do not use non-ASCII characters in the extraction path.

  3. Run ossftp.

    Operating system

    Actions

    Windows

    Double-click start.vbs.

    Note

    If ossftp does not start, upgrade your version of Internet Explorer, or set another browser as your default.

    Linux

    Run the following command.

    bash start.sh

    macOS

    Double-click start.command.

    After ossftp starts, it opens the following ports on your local device by default:

    • TCP port 2048: Receives FTP requests.

    • TCP port 8192: Provides access to the ossftp graphical management interface.

    Note

    To provide the ossftp service to other users, open TCP port 2048 and TCP port 8192 in your firewall.

  4. Configure ossftp.

    1. Access the ossftp graphical management interface from a web browser.

      Device

      Domain name

      Local device

      http://127.0.0.1:8192

      Other devices

      http://<IP_address_of_the_Linux_server>:8192

    2. In the ossftp graphical management interface, configure the following parameters.

      Parameter

      Example

      Description

      Ossftp address

      127.0.0.1

      The IP address of the FTP client. If the client is running on the local device, keep the default value.

      Ossftp port

      2048

      The listening port for ossftp access requests. Keep the default value unless it conflicts with another port.

      Ossftp passive ports start

      51000

      The start of the passive port range that ossftp uses for responses. Keep the default value unless it conflicts with another port.

      Ossftp passive ports end

      53000

      The end of the passive port range that ossftp uses for responses. Keep the default value unless it conflicts with another port.

      Ossftp log level

      INFO

      The log output level for ossftp. Valid values:

      • DEBUG: Records fine-grained informational events, typically used for debugging.

      • INFO: Records events that occur during normal software operation.

      • WARNING: Records unexpected events that do not affect system operation.

      • ERROR: Records unexpected events that may affect system operation but not its stability.

      • CRITICAL: Records events that cause the system to stop working.

      Bucket endpoints

      examplebucket.oss-cn-hangzhou.aliyuncs.com

      The domain name for accessing a bucket. The required format is BucketName.Endpoint. Separate multiple domain names with commas.

      Language

      cn

      The display language for ossftp.

    3. Click save config and then restart to apply the new configuration.

      Important

      Do not click exit, as this will stop the ossftp process.