Object Storage Service:Install OSS FTP

Prerequisites

Before you begin, ensure that you have:

• An Alibaba Cloud account with at least one OSS bucket

• A bucket endpoint in the format BucketName.Endpoint (for example, examplebucket.oss-cn-hangzhou.aliyuncs.com)

• TCP ports 2048 and 8192 available on the local computer

• (If serving other users over the network) Firewall rules that allow inbound traffic on TCP ports 2048 and 8192

Quick start

1. Download the installation package for your OS (see Download the installation package).

2. Extract the package to a path that contains no Chinese characters.

3. Launch OSS FTP for your OS (see Run OSS FTP).

4. Open http://127.0.0.1:8192 in a browser, enter your bucket endpoint, and click Save config, then Restart.

Download the installation package

OSS FTP 1.2.0 is available for Windows, Linux, and macOS.

Extract the package

Extract the downloaded .zip file to a local directory.

Run OSS FTP

Start OSS FTP for your operating system:

On Windows, if OSS FTP does not start, upgrade Internet Explorer to a newer version, or set a different browser as the default.

After OSS FTP starts, it opens two TCP ports on the local computer:

To serve other users on the network, open both ports in your firewall configuration.

Configure OSS FTP

1. Open the graphical management interface in a browser:

   Device	URL
   Local computer	http://127.0.0.1:8192
   Remote device	http://<IP address of the Linux server>:8192

2. Set the configuration parameters:

   Parameter	Example	Description
   ossftp address	127.0.0.1	IP address of the client using the FTP service. If the client runs on the local computer, keep the default value.
   ossftp port	2048	Port that receives requests for OSS FTP. Keep the default value if it does not conflict with other ports.
   ossftp passive ports start	51000	Starting port number of the passive port range. Keep the default value if it does not conflict with other ports.
   ossftp passive ports end	53000	Ending port number of the passive port range. Keep the default value if it does not conflict with other ports.
   ossftp log level	INFO	Log output level. Valid values: DEBUG | INFO | WARNING | ERROR | CRITICAL. See Log levels for details.
   Bucket endpoints	examplebucket.oss-cn-hangzhou.aliyuncs.com	Endpoint used to access the bucket, in the format BucketName.Endpoint. Separate multiple endpoints with commas (,).
   Language	cn	Display language for OSS FTP.

   

3. Click Save config, then click Restart for the settings to take effect.

   Important

   Do not click Exit. Clicking Exit stops OSS FTP.

Log levels