All Products
Search
Document Center

Object Storage Service:Use FileZilla to upload files from local sites to OSS

Last Updated:Mar 19, 2026

FileZilla is a simple and easy-to-use FTP client tool that works with ossftp, a local FTP proxy for Object Storage Service (OSS). This guide shows how to connect FileZilla to your OSS bucket and upload files.

How it works

ossftp runs locally on your machine and translates standard FTP requests into OSS API calls. FileZilla connects to ossftp on 127.0.0.1:2048 and uses your AccessKey ID and bucket name as the FTP username, and your AccessKey secret as the FTP password. Files you transfer in FileZilla are stored as objects in your OSS bucket.

Prerequisites

Before you begin, make sure you have:

Connect FileZilla to OSS

  1. Open the FileZilla client.

  2. Enter the following connection parameters in the FileZilla console:

    ParameterValueDescription
    Host127.0.0.1The IP address where ossftp is running. Use the default 127.0.0.1 if ossftp runs on the same machine as FileZilla.
    Username<AccessKey ID>/<bucket name>Your AccessKey ID followed by a forward slash and the bucket name — for example, Y6IoUOZReouXvWaXuwjvDch9******/examplebucket. To use a custom username instead, see Create custom logon users.
    Password<AccessKey secret>The AccessKey secret paired with your AccessKey ID — for example, sRaQg0i3SH9EqYXJSL1hlaR******. To use a custom password instead, see Create custom logon users.
    Port2048The listening port configured for ossftp. The default is 2048.

    To get your AccessKey ID and AccessKey secret, see Obtain an AccessKey pair.

  3. Click Quickconnect.

  4. Drag a file from the local site panel to the remote site panel to upload it to OSS.