全部产品
Search
文档中心

Object Storage Service:Instal ossutil

更新时间:Nov 28, 2025

Anda dapat menggunakan ossutil untuk mengunggah file besar secara cepat, mengunduh, atau menghapus file berdasarkan awalan tertentu. ossutil berjalan di Windows, Linux, dan macOS. Unduh dan instal versi yang sesuai dengan sistem operasi Anda.

Peningkatan versi

Kami menyarankan Anda menginstal dan menggunakan ossutil 2.0 yang telah ditingkatkan. Untuk informasi lebih lanjut tentang instalasi, lihat Instal ossutil.

Fitur utama ossutil 2.0:

  • Struktur perintah baru: Mendukung perintah multi-level, termasuk perintah tingkat API seperti ossutil api put-bucket-acl dan perintah tingkat tinggi seperti ossutil config.

  • Manajemen konfigurasi yang ditingkatkan: Menyederhanakan proses konfigurasi awal. Setelah instalasi, Anda hanya perlu menyediakan ID AccessKey, Rahasia AccessKey, dan ID wilayah untuk menyelesaikan konfigurasi dasar. Anda juga dapat menentukan beberapa file konfigurasi menggunakan parameter --profile guna meningkatkan fleksibilitas.

  • Parameter filter yang luas: Untuk perintah pemrosesan batch seperti ls, cp, dan rm, ossutil 2.0 mendukung berbagai kondisi filter berdasarkan path, ukuran file, waktu modifikasi, dan metadata objek. Fitur ini secara signifikan meningkatkan presisi dan efisiensi operasi.

  • Format output yang fleksibel: Parameter baru --output-format memungkinkan Anda mengatur format output menjadi JSON, YAML, atau XML untuk memenuhi berbagai kebutuhan pemrosesan data. Opsi --output-query juga diperkenalkan untuk memfilter output dan mengambil informasi yang diperlukan.

  • Keamanan yang ditingkatkan: Untuk meningkatkan keamanan, ossutil 2.0 mendukung pengaturan parameter sensitif melalui variabel lingkungan. Hal ini mencegah ekspos kunci secara langsung di baris perintah dan mengurangi ancaman kebocoran informasi. Selain itu, opsi baru --dry-run memungkinkan Anda memverifikasi perilaku perintah sebelum menjalankannya guna memastikan operasi berjalan dengan benar.

Versi

  • Versi saat ini: 1.7.19

  • Versi sebelumnya: Untuk informasi lebih lanjut tentang kode sumber dan riwayat rilis versi ossutil, lihat GitHub.

Tautan unduhan

Tautan unduhan

Checksum SHA256

Linux x86 32bit

f8a4a7e1df8529b06a3f3cca194a1c99163cb3b8ab3b5d64228c207c3ae63b86

Linux x86 64bit

dcc512e4a893e16bbee63bc769339d8e56b21744fd83c8212a9d8baf28767343

Linux ARM 32bit

ffe8b479e5fd3c0e146a14cd32e8ef5736d23f6c8de157944288ee09db2d7b1d

Linux ARM 64bit

f612c2a88d4d28363e254168d521fac5df632f2547ba84eaebacf6497dc04d57

macOS 64bit

9cf82a53fe24d8b5cc3dfb441787e0ea19c24dd7a1246653d5f1a28b7923d6fe

macOS ARM 64bit

10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5

Windows x86 32bit

772469ef02b91e893f7211acf732c2c07cd93214552ed7cf84157d3d9b9fb799

Windows x86 64bit

8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77

Unduh dan instal ossutil

Linux

  1. Instal ossutil.

    sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
    Catatan
    • Paket instalasi harus didekompresi. Pastikan alat dekompresi, seperti unzip atau 7z, telah terinstal.

    • Setelah instalasi, ossutil diinstal di direktori /usr/bin/.

  2. Konfigurasikan ossutil.

    1. Masukkan perintah konfigurasi.

      ossutil config
    2. Atur path file konfigurasi sesuai prompt.

      Enter the configuration file name. The file name can include a path (default: /home/user/.ossutilconfig, press Enter to use the default path.
      If you set another path, you must add the --config-file option to specify the path when you run commands): 

      Secara default, file konfigurasi berada di path /home/user/.ossutilconfig. Jika Anda menentukan path kustom untuk file konfigurasi, Anda harus menambahkan opsi -c untuk menentukan file konfigurasi setiap kali menjalankan perintah. Misalnya, jika file konfigurasi disimpan di /home/config, perintah untuk menjalankan ls adalah sebagai berikut:

      ossutil ls oss://examplebucket -c /home/config
    3. Atur bahasa untuk tool tersebut saat diminta. Masukkan CH atau EN. Secara default, bahasa tool sama dengan bahasa sistem operasi. Konfigurasi ini berlaku setelah perintah config berhasil dijalankan.

    4. Saat diminta, atur bahasa untuk ossutil.

      Masukkan CH atau EN. Secara default, ossutil menggunakan bahasa yang sama dengan sistem operasi Anda. Konfigurasi ini berlaku setelah perintah config berhasil dijalankan.

    5. Saat diminta, atur parameter Endpoint, AccessKey ID, AccessKey Secret, dan STSToken. Jika Anda menggunakan kredensial akses temporary dari Security Token Service (STS) untuk mengakses OSS, Anda harus mengonfigurasi parameter STSToken. Jika tidak, biarkan parameter ini kosong dan tekan Enter.

      Tabel berikut menjelaskan parameter-parameter tersebut.

      Parameter

      Diperlukan

      Deskripsi

      endpoint

      Ya

      Masukkan Endpoint wilayah tempat bucket berada. Sebagai contoh, pada contoh ini digunakan titik akhir publik Singapura. Atur ke https://oss-ap-southeast-1.aliyuncs.com.

      Jika Anda ingin mengakses OSS dari produk Alibaba Cloud lainnya dalam wilayah yang sama dengan OSS, gunakan Endpoint jaringan internal. Atur ke https://oss-ap-southeast-1-internal.aliyuncs.com.

      Untuk informasi lebih lanjut tentang Endpoint setiap wilayah, lihat Wilayah dan Endpoint.

      Penting

      accessKeyID

      Ya

      Masukkan AccessKey akun Anda. Untuk informasi lebih lanjut tentang cara mendapatkan AccessKey, lihat Buat AccessKey.

      Gunakan skrip ROS untuk membuat AccessKey secara cepat bagi Pengguna RAM yang memiliki izin manajemen OSS

      Pada halaman Create Stack di konsol Resource Orchestration Service (ROS), pada bagian Security Confirmation, pilih I confirm that Alibaba Cloud ROS may create RAM resources, lalu klik Create.

      1.png

      Setelah stack dibuat, salin AccessKey yang dibuat dari tab Outputs.

      image

      accessKeySecret

      Ya

      stsToken

      Tidak

      Parameter ini hanya diperlukan ketika Anda menggunakan kredensial akses temporary dari STS untuk mengakses OSS. Jika tidak, biarkan parameter ini kosong dan tekan Enter. Untuk informasi lebih lanjut tentang cara menghasilkan stsToken, lihat AssumeRole - Dapatkan kredensial identitas temporary suatu role.

  3. Verifikasi bahwa ossutil telah terinstal.

    ossutil

    Jika daftar perintah ossutil yang didukung ditampilkan di layar, berarti ossutil telah berhasil diinstal.

Windows

  1. Instal ossutil.

    1. Klik tautan unduh untuk mengunduh paket instalasi Windows.

    2. Dekompresi paket instalasi dan klik ganda file ossutil.bat.

  2. Konfigurasikan ossutil.

    1. Masukkan perintah konfigurasi.

      ossutil config
    2. Atur path file konfigurasi sesuai prompt.

      Enter the configuration file name. The file name can include a path (default: C:\\Users\user\.ossutilconfig, press Enter to use the default path.
      If you set another path, you must add the --config-file option to specify the path when you run commands): 

      Secara default, file konfigurasi berada di path C:\\Users\user\.ossutilconfig. Jika Anda menentukan path kustom untuk file konfigurasi, Anda harus menambahkan opsi -c untuk menentukan file konfigurasi setiap kali menjalankan perintah. Misalnya, jika file konfigurasi disimpan di c:\ossutil\config, perintah untuk menjalankan ls adalah sebagai berikut:

      ossutil ls oss://examplebucket -c c:\ossutil\config
    3. Saat diminta, atur bahasa untuk ossutil. Masukkan CH atau EN. Secara default, ossutil menggunakan bahasa yang sama dengan sistem operasi Anda. Konfigurasi ini berlaku setelah perintah config berhasil dijalankan.

    4. Saat diminta, atur parameter Endpoint, AccessKey ID, AccessKey Secret, dan STSToken. Jika Anda menggunakan kredensial akses temporary dari STS untuk mengakses OSS, Anda harus mengonfigurasi parameter STSToken. Jika tidak, biarkan parameter ini kosong dan tekan Enter.

      Tabel berikut menjelaskan parameter-parameter tersebut.

      Parameter

      Diperlukan

      Deskripsi

      endpoint

      Ya

      Masukkan Endpoint wilayah tempat bucket berada. Sebagai contoh, untuk menggunakan titik akhir publik wilayah China (Hangzhou), atur parameter ini ke https://oss-cn-hangzhou.aliyuncs.com.

      Jika Anda ingin mengakses OSS dari produk Alibaba Cloud lainnya dalam wilayah yang sama dengan OSS, gunakan Endpoint jaringan internal. Atur ke https://oss-cn-hangzhou-internal.aliyuncs.com.

      Untuk informasi lebih lanjut tentang Endpoint setiap wilayah, lihat Wilayah dan Endpoint.

      accessKeyID

      Ya

      Masukkan AccessKey akun Anda. Untuk informasi lebih lanjut tentang cara mendapatkan AccessKey, lihat Buat AccessKey.

      Gunakan skrip ROS untuk membuat AccessKey secara cepat bagi Pengguna RAM yang memiliki izin manajemen OSS

      Pada halaman Create Stack di konsol ROS, pilih kotak centang konfirmasi di bawah Security Confirmation, lalu klik Create.

      1.png

      Setelah stack dibuat, salin AccessKey yang dibuat dari tab Outputs.

      1.png

      accessKeySecret

      Ya

      stsToken

      Tidak

      Parameter ini hanya diperlukan ketika Anda menggunakan kredensial akses temporary dari STS untuk mengakses OSS. Jika tidak, biarkan parameter ini kosong dan tekan Enter. Untuk informasi lebih lanjut tentang cara menghasilkan stsToken, lihat AssumeRole - Dapatkan kredensial identitas temporary suatu role.

  3. Anda dapat memverifikasi bahwa ossutil telah terinstal.

    ossutil

    Jika daftar semua perintah ossutil yang didukung ditampilkan, berarti instalasi berhasil.

macOS

  1. Instal ossutil.

    sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
    Catatan

    Secara default, ossutil diinstal di direktori /usr/local/bin.

  2. Konfigurasikan ossutil.

    1. Masukkan perintah konfigurasi.

      ossutil config
    2. Atur path file konfigurasi sesuai prompt.

      Enter the configuration file name. The file name can include a path (default: /Users/user/.ossutilconfig, press Enter to use the default path.
      If you set another path, you must add the --config-file option to specify the path when you run commands): 

      Secara default, file konfigurasi berada di path /Users/user/.ossutilconfig.

      Jika Anda menentukan path kustom untuk file konfigurasi, Anda harus menambahkan opsi -c untuk menentukan file konfigurasi setiap kali menjalankan perintah. Misalnya, jika file konfigurasi disimpan di /home/config, perintah untuk menjalankan ls adalah sebagai berikut:

      ossutil ls oss://examplebucket -c /home/config
    3. Saat diminta, atur bahasa untuk ossutil. Masukkan CH atau EN. Secara default, ossutil menggunakan bahasa yang sama dengan sistem operasi Anda. Konfigurasi ini berlaku setelah perintah config berhasil dijalankan.

    4. Saat diminta, atur parameter Endpoint, AccessKey ID, AccessKey Secret, dan STSToken. Jika Anda menggunakan kredensial akses temporary dari STS untuk mengakses OSS, Anda harus mengonfigurasi parameter STSToken. Jika tidak, biarkan parameter ini kosong dan tekan Enter.

      Tabel berikut menjelaskan parameter-parameter tersebut.

      Parameter

      Diperlukan

      Deskripsi

      endpoint

      Ya

      Masukkan Endpoint wilayah tempat bucket berada. Sebagai contoh, pada contoh ini digunakan titik akhir publik Singapura. Atur ke https://oss-ap-southeast-1.aliyuncs.com.

      Jika Anda ingin mengakses OSS dari produk Alibaba Cloud lainnya dalam wilayah yang sama dengan OSS, gunakan Endpoint jaringan internal. Atur ke https://oss-ap-southeast-1-internal.aliyuncs.com.

      Untuk informasi lebih lanjut tentang Endpoint setiap wilayah, lihat Wilayah dan Endpoint.

      Penting

      accessKeyID

      Ya

      Masukkan AccessKey akun Anda. Untuk informasi lebih lanjut tentang cara mendapatkan AccessKey, lihat Buat AccessKey.

      Gunakan skrip ROS untuk membuat AccessKey secara cepat bagi Pengguna RAM yang memiliki izin manajemen OSS

      Pada halaman Create Stack di konsol ROS, pilih kotak centang konfirmasi di bawah Security Confirmation, lalu klik Create.

      1.png

      Setelah stack dibuat, salin AccessKey yang dibuat dari tab Outputs.

      1.png

      accessKeySecret

      Ya

      stsToken

      Tidak

      Parameter ini hanya diperlukan ketika Anda menggunakan kredensial akses temporary dari STS untuk mengakses OSS. Jika tidak, biarkan parameter ini kosong dan tekan Enter. Untuk informasi lebih lanjut tentang cara menghasilkan stsToken, lihat AssumeRole - Dapatkan kredensial identitas temporary suatu role.

  3. Verifikasi bahwa ossutil telah terinstal.

    ossutil

    Jika daftar perintah ossutil yang didukung ditampilkan di layar, berarti ossutil telah berhasil diinstal.

Referensi

Setelah Anda menginstal ossutil, Anda dapat melakukan operasi seperti mengunggah, mengunduh, menyalin, dan menghapus file. Untuk informasi lebih lanjut, lihat cp (unggah file), cp (unduh file), cp (salin file), dan rm (hapus).