全部产品
Search

搜索本产品

    Object Storage Service：Instal ossutil

    文档中心

    Object Storage Service：Instal ossutil

    更新时间：Mar 21, 2026

    ossutil adalah alat baris perintah untuk mengelola objek di Object Storage Service (OSS). Alat ini memungkinkan Anda mengunggah, mengunduh, menyalin, dan menghapus objek pada Windows, Linux, dan macOS.

    Penting

    Kami menyarankan Anda menginstal dan menggunakan ossutil 2.0 untuk proyek baru. ossutil 2.0 hanya memerlukan ID AccessKey, Rahasia AccessKey, dan ID wilayah untuk konfigurasi awal; alat ini juga menyediakan opsi filter yang lebih kaya untuk operasi batch, mendukung format output JSON/YAML/XML, serta memungkinkan Anda meneruskan parameter sensitif melalui Variabel lingkungan. Lihat Instal ossutil 2.0. Jika Anda memiliki skrip yang sudah ada yang bergantung pada perintah ossutil 1.x, lanjutkan dengan panduan ini.

    Untuk memulai, unduh paket yang sesuai dengan sistem operasi Anda, instal dan konfigurasikan ossutil dengan Titik akhir dan Pasangan Kunci Akses Anda, lalu verifikasi instalasi tersebut.

    Unduh ossutil

    Versi terbaru adalah 1.7.19. Unduh paket yang sesuai dengan sistem operasi dan arsitektur CPU Anda. Untuk memverifikasi unduhan, bandingkan checksum SHA-256 file tersebut dengan nilai dalam tabel berikut.

    PlatformUnduhChecksum SHA-256
    Linux x86 32-bitossutil-v1.7.19-linux-386.zipf8a4a7e1df8529b06a3f3cca194a1c99163cb3b8ab3b5d64228c207c3ae63b86
    Linux x86 64-bitossutil-v1.7.19-linux-amd64.zipdcc512e4a893e16bbee63bc769339d8e56b21744fd83c8212a9d8baf28767343
    Linux ARM 32-bitossutil-v1.7.19-linux-arm.zipffe8b479e5fd3c0e146a14cd32e8ef5736d23f6c8de157944288ee09db2d7b1d
    Linux ARM 64-bitossutil-v1.7.19-linux-arm64.zipf612c2a88d4d28363e254168d521fac5df632f2547ba84eaebacf6497dc04d57
    macOS 64-bitossutil-v1.7.19-mac-amd64.zip9cf82a53fe24d8b5cc3dfb441787e0ea19c24dd7a1246653d5f1a28b7923d6fe
    macOS ARM 64-bitossutil-v1.7.19-mac-arm64.zip10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5
    Windows x86 32-bitossutil-v1.7.19-windows-386.zip772469ef02b91e893f7211acf732c2c07cd93214552ed7cf84157d3d9b9fb799
    Windows x86 64-bitossutil-v1.7.19-windows-amd64.zip8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77

    Untuk versi sebelumnya dan catatan rilis, lihat rilis ossutil di GitHub.

    Instal dan konfigurasikan ossutil

    Linux

    1. Jalankan perintah berikut untuk mengunduh dan menginstal ossutil:

      Penginstal memerlukan alat dekompresi seperti unzip atau 7z. Secara default, ossutil diinstal ke /usr/bin/.
         sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash

    2. Jalankan perintah konfigurasi:

         ossutil config

    3. Saat diminta, masukkan path untuk file konfigurasi, atau tekan Enter untuk menggunakan path default (/home/user/.ossutilconfig):

         Silakan masukkan nama file konfigurasi; nama file dapat mencakup jalur (bawaan: C:\Users\user\.ossutilconfig, penekanan tombol Enter akan menggunakan file bawaan.
   Jika Anda menentukan opsi ini ke file lain, Anda harus menentukan opsi --config-file ke file tersebut saat menggunakan perintah lain):

      Jika Anda menyimpan file konfigurasi ke path kustom (misalnya, /home/config), tambahkan -c ke setiap perintah ossutil:

         ossutil ls oss://examplebucket -c /home/config

    4. Pilih bahasa tampilan. Masukkan CH untuk Bahasa Tiongkok atau EN untuk Bahasa Inggris. Nilai default mengikuti bahasa sistem operasi Anda.

    5. Masukkan Titik akhir, ID AccessKey, dan Rahasia AccessKey saat diminta. Jika Anda menggunakan kredensial sementara dari Security Token Service (STS), masukkan juga nilai stsToken. Pengaturan cepat dengan ROS Untuk membuat Pasangan Kunci Akses bagi Pengguna RAM dengan akses penuh ke OSS secara cepat, gunakan wizard Resource Orchestration Service (ROS). Di bagian Security Confirmation, pilih I confirm that Alibaba Cloud ROS may create RAM resources, lalu klik Create. 1.png Setelah stack dibuat, salin Pasangan Kunci Akses dari tab Outputs. 1.png

      Penting

      Mulai 20 Maret 2025, pengguna OSS baru harus menggunakan nama domain kustom (CNAME) untuk operasi API data pada bucket di wilayah Tiongkok Daratan. Titik akhir publik default dibatasi untuk operasi tersebut. Lihat pengumuman perubahan kebijakan untuk daftar lengkap operasi yang terdampak. Jika Anda mengakses OSS melalui HTTPS, ikat Sertifikat SSL yang valid ke domain kustom Anda.

      ParameterWajibDeskripsi
      endpointYaTitik akhir untuk wilayah bucket Anda. Misalnya, titik akhir publik untuk Singapura adalah https://oss-ap-southeast-1.aliyuncs.comSingapura. Untuk mengakses OSS dari layanan Alibaba Cloud lainnya dalam wilayah yang sama, gunakan titik akhir internal: https://oss-ap-southeast-1-internal.aliyuncs.com. Untuk daftar lengkapnya, lihat Wilayah dan titik akhir.
      accessKeyIDYaID AccessKey Pengguna RAM Anda. Untuk membuat Pasangan Kunci Akses, lihat Buat Pasangan Kunci Akses untuk Pengguna RAM.
      accessKeySecretYaRahasia AccessKey Pengguna RAM Anda.
      stsTokenTidakHanya diperlukan saat menggunakan kredensial sementara dari STS. Biarkan kosong jika tidak digunakan. Untuk menghasilkan token STS, lihat AssumeRole.

    Windows

    1. Unduh paket Windows dari tabel di atas.

    2. Ekstrak paket tersebut dan jalankan ossutil.bat.

    3. Jalankan perintah konfigurasi:

         ossutil config

    4. Saat diminta, masukkan path untuk file konfigurasi, atau tekan Enter untuk menggunakan path default (C:\Users\user\.ossutilconfig):

         Please enter the config file name,the file name can include path(default C:\Users\user\.ossutilconfig, carriage return will use the default file.
   If you specified this option to other file, you should specify --config-file option to the file when you use other commands):

      Jika Anda menyimpan file konfigurasi ke path kustom (misalnya, c:\ossutil\config), tambahkan -c ke setiap perintah ossutil:

         ossutil ls oss://examplebucket -c c:\ossutil\config

    5. Pilih bahasa tampilan. Masukkan EN untuk Bahasa Inggris. Nilai default mengikuti bahasa sistem operasi Anda.

    6. Masukkan Titik akhir, ID AccessKey, Rahasia AccessKey, dan opsional stsToken. Lihat tabel parameter di bagian Linux di atas.

    macOS

    1. Jalankan perintah berikut untuk mengunduh dan menginstal ossutil:

      Secara default, ossutil diinstal ke /usr/local/bin.
      ossutil

    2. Jalankan perintah konfigurasi:

         ossutil config

    3. Saat diminta, masukkan path untuk file konfigurasi, atau tekan Enter untuk menggunakan path default (/Users/user/.ossutilconfig):

         Please enter the config file name,the file name can include path(default /Users/user/.ossutilconfig, carriage return will use the default file.
   If you specified this option to other file, you should specify --config-file option to the file when you use other commands):

      Jika Anda menyimpan file konfigurasi ke path kustom (misalnya, /home/config), tambahkan -c ke setiap perintah ossutil:

         ossutil ls oss://examplebucket -c /home/config

    4. Pilih bahasa tampilan. Masukkan CH untuk Bahasa Tiongkok atau EN untuk Bahasa Inggris. Nilai default mengikuti bahasa sistem operasi Anda.

    5. Masukkan Titik akhir, ID AccessKey, Rahasia AccessKey, dan opsional stsToken. Lihat tabel parameter di bagian Linux di atas.

    Verifikasi instalasi

    Jalankan ossutil tanpa argumen:

    ossutil

    Instalasi yang berhasil akan menampilkan output bantuan ossutil:

    NAME:
   ossutil - A tool to manage your oss objects

USAGE:
   ossutil [global options] command [command options] [arguments...]

VERSION:
   v1.7.19
...

    Langkah selanjutnya

    Setelah instalasi, gunakan ossutil untuk mengelola objek Anda: