This topic describes how to install ossftp.

Procedure

  1. Download the installation package of ossftp.
    Operating systemDescriptionInstallation package
    WindowsBy 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
    LinuxBy 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. Decompress the downloaded installation package.
    Important The path to which the installation package is decompressed cannot contain Chinese characters.
  3. Run ossftp.
    Operating systemOperation
    WindowsDouble-click start.vbs.
    Note If ossftp is not started, upgrade the version of your Internet Explorer, or specify another browser as the default browser.
    Linux

    Run the following command:

    bash start.sh
    macOSDouble-click start.command.
    By default, after ossftp is run, the following ports of the local computer are enabled:
    • TCP port 2048: This port is used to receive FTP requests for the FTP server.
    • TCP port 8192: This port is used to open the graphical management interface of ossftp for the Web server.
    Note To use ossftp to provide services for other users, enable the two ports in firewall configurations.
  4. Configure ossftp.
    1. Use a browser to access the graphical management interface of ossftp.
      DeviceDomain name
      Local devicehttp://127.0.0.1:8192
      Other deviceshttp://<IP address of the Linux server>:8192
    2. Configure the parameters described in the following table on the graphical management interface of ossftp.
      fteserver
      ParameterExampleDescription
      ossftp address127.0.0.1Specify the IP address of the client that needs to use the FTP service. If the client is running on the local computer, keep the default settings.
      ossftp port2048Specify the port that receives requests for ossftp. If the default port does not conflict with other ports, keep the default port.
      ossftp passive ports start51000Specify the starting port number of the range to respond to requests for ossftp. If the default port does not conflict with other ports, keep the default port.
      ossftp passive ports end53000Specify the ending port number of the range to respond to requests for ossftp. If the default port does not conflict with other ports, keep the default port.
      ossftp log levelINFOSpecify the log output level of ossftp. Valid values:
      • DEBUG: ossftp records information events in detail. DEBUG logs are used to debug programs.
      • INFO: ossftp records events that occur when software runs properly.
      • WARNING: ossftp records abnormal events that do not affect the system.
      • ERROR: ossftp records abnormal events that affect the system but do not affect system reliability.
      • CRITICAL: ossftp records events that cause the system to fail to work.
      Bucket endpointsexamplebucket.oss-cn-hangzhou.aliyuncs.comSpecify the domain name that is used to access the bucket. The domain name must be in the following format: BucketName.Endpoint. Separate multiple domain names with commas (,).
      LanguagecnSpecify the display language for ossftp.
    3. Click Save config. Then, click Restart for the configurations to take effect.
      Important Do not click Exit. Otherwise, ossftp stops running.