All Products
Search
Document Center

Object Storage Service:Instal OSS FTP

Last Updated:Mar 20, 2026

OSS FTP (ossftp) memungkinkan Anda mengakses bucket OSS melalui klien FTP standar apa pun. Halaman ini menjelaskan cara mengunduh, menginstal, dan mengonfigurasi OSS FTP di Windows, Linux, atau macOS.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

  • Akun Alibaba Cloud dengan setidaknya satu bucket OSS

  • Titik akhir bucket dalam format BucketName.Endpoint (misalnya, examplebucket.oss-cn-hangzhou.aliyuncs.com)

  • Port TCP 2048 dan 8192 tersedia di komputer lokal

  • (Jika melayani pengguna lain melalui jaringan) Aturan firewall yang mengizinkan lalu lintas inbound pada port TCP 2048 dan 8192

Panduan cepat

  1. Unduh paket instalasi untuk sistem operasi Anda (lihat Unduh paket instalasi).

  2. Ekstrak paket ke jalur yang tidak mengandung karakter Tionghoa.

  3. Jalankan OSS FTP sesuai sistem operasi Anda (lihat Jalankan OSS FTP).

  4. Buka http://127.0.0.1:8192 di browser, masukkan titik akhir bucket Anda, lalu klik Save config, kemudian Restart.

Unduh paket instalasi

OSS FTP 1.2.0 tersedia untuk Windows, Linux, dan macOS.

Windows

Unduh ossftp-1.2.0-win.zip.

Paket Windows menyertakan Python 2.7. Tidak diperlukan instalasi Python terpisah.

Linux

Unduh ossftp-1.2.0-linux-mac.zip.

Linux secara default telah menyertakan Python 2.7 atau Python 3.x. Paket hanya berisi library dependensi yang diperlukan.

macOS

Unduh ossftp-1.2.0-linux-mac.zip.

macOS secara default telah menyertakan Python 2.7 atau Python 3.x. Paket hanya berisi library dependensi yang diperlukan.

Ekstrak paket

Ekstrak file .zip yang telah diunduh ke direktori lokal.

Penting

Jalur ekstraksi tidak boleh mengandung karakter Tionghoa. OSS FTP gagal dijalankan jika jalurnya mencakup karakter Tionghoa.

Jalankan OSS FTP

Jalankan OSS FTP sesuai sistem operasi Anda:

OSAction
WindowsKlik ganda start.vbs.
LinuxJalankan bash start.sh.
macOSKlik ganda start.command.
Pada Windows, jika OSS FTP tidak dapat dijalankan, lakukan upgrade Internet Explorer ke versi yang lebih baru atau atur browser lain sebagai default.

Setelah OSS FTP dijalankan, layanan ini membuka dua port TCP di komputer lokal:

PortPurpose
2048Server FTP — menerima permintaan FTP
8192Server web — menyediakan antarmuka manajemen grafis
Untuk melayani pengguna lain di jaringan, buka kedua port tersebut dalam konfigurasi firewall Anda.

Konfigurasi OSS FTP

  1. Buka antarmuka manajemen grafis di browser:

    DeviceURL
    Komputer lokalhttp://127.0.0.1:8192
    Perangkat jarak jauhhttp://<alamat IP Server Linux>:8192
  2. Atur parameter konfigurasi:

    ParameterExampleDescription
    ossftp address127.0.0.1Alamat IP klien yang menggunakan layanan FTP. Jika klien dijalankan di komputer lokal, pertahankan nilai default.
    ossftp port2048Port yang menerima permintaan untuk OSS FTP. Pertahankan nilai default jika tidak bentrok dengan port lain.
    ossftp passive ports start51000Nomor port awal dari range port pasif. Pertahankan nilai default jika tidak bentrok dengan port lain.
    ossftp passive ports end53000Nomor port akhir dari range port pasif. Pertahankan nilai default jika tidak bentrok dengan port lain.
    ossftp log levelINFOTingkat output log. Nilai yang valid: DEBUG | INFO | WARNING | ERROR | CRITICAL. Lihat Tingkat log untuk detail selengkapnya.
    Bucket endpointsexamplebucket.oss-cn-hangzhou.aliyuncs.comTitik akhir yang digunakan untuk mengakses bucket, dalam format BucketName.Endpoint. Pisahkan beberapa titik akhir dengan koma (,).
    LanguagecnBahasa tampilan untuk OSS FTP.

    OSS FTP configuration interface

  3. Klik Save config, lalu klik Restart agar pengaturan diterapkan.

    Penting

    Jangan klik Exit. Mengklik Exit akan menghentikan OSS FTP.

Tingkat log

LevelDescription
DEBUGMencatat event informasi detail. Gunakan untuk debugging.
INFOMencatat event yang terjadi selama operasi normal.
WARNINGMencatat event abnormal yang tidak memengaruhi perilaku sistem.
ERRORMencatat event abnormal yang memengaruhi sistem tetapi tidak mengganggu keandalannya.
CRITICALMencatat event yang menyebabkan OSS FTP berhenti bekerja.