SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Pasang MinIO di Ubuntu 24.04 VPS

Panduan lengkap membina storan objek MinIO pada Ubuntu 24.04. Anda akan belajar konfigurasi systemd, penggunaan mc, pautan presigned, serta cara menetapkan restic sebagai sandaran.

Verified Every command ran end-to-end on a fresh Ubuntu 24.04 server, July 30, 2026.

Apakah kelebihan storan objek layan diri dengan MinIO

MinIO ialah storan objek layan diri yang menggunakan API Amazon S3. Halakan restic atau S3 SDK ke pelayan anda sendiri, tukar satu tetapan endpoint, dan untuk bacaan objek harian, penulisan, penyenaraian serta pautan pra-tandatangan, itu sahaja yang diperlukan. Walau bagaimanapun, serasi tidak bermakna sama. Sebagai contoh, MinIO tidak melaksanakan ACL objek Amazon, jadi aplikasi yang bergantung pada gelagat ACL memerlukan lebih daripada sekadar endpoint baharu. Panduan ini membina satu nod pada Ubuntu 24.04: binari yang dikompilasi daripada sumber yang disahkan, pengguna sistem khusus, unit systemd yang menyimpan kelayakan root di luar fail unit, dan bucket yang digunakan oleh restic untuk membuat sandaran.

S3 (simple storage service) ialah API HTTP dan bukannya sistem fail. Anda meletakkan (PUT) objek ke dalam bucket di bawah satu key dan anda mendapatkannya semula (GET), dan dalam bucket standard tiada penulisan separa atau penamaan semula. Bucket direktori S3 Express One Zone milik Amazon adalah pengecualian, dengan panggilan tambah (append) dan namakan semula (rename) tersendiri, tetapi itu hanyalah satu kelas storan dan tiada apa-apa dalam panduan ini yang bergantung padanya. Alat sandaran menyukai model standard ini, kerana sesuatu objek sama ada sampai sepenuhnya atau tidak sampai langsung.

Satu nod menyimpan satu salinan data anda. Itulah pertukaran yang anda lakukan. Anda mendapat endpoint S3 yang anda kawal dengan harga sebuah VPS, dan anda juga mewarisi setiap tugas yang biasa dilakukan oleh penyedia awan, daripada menggantikan cakera yang rosak sehinggalah menampal (patch) perisian pelayan. Bahagian di penghujung panduan ini menyatakan dengan jelas bila pertukaran tersebut berbaloi.

Status edisi komuniti MinIO pada Oktober 2026

Baca bahagian ini sebelum anda memulakan binaan, kerana terdapat perubahan baru-baru ini. Pada Mei 2025, MinIO telah membuang ciri pentadbiran daripada konsol web dalam edisi komuniti. Apa yang tinggal dalam pelayar hanyalah pelayar objek, jadi bucket dan kunci akses kini diuruskan menggunakan klien baris perintah mc.

Kemudian pada tahun 2025, MinIO berhenti menerbitkan binari komuniti yang telah dipra-kompil. README projek tersebut menyatakan bahawa edisi komuniti hanya diedarkan sebagai kod sumber, dan sejak April 2026, repositori minio/minio telah diarkibkan di bawah notis THIS REPOSITORY IS NO LONGER MAINTAINED. Pelayan muat turun lama juga telah berhenti menyediakan fail komuniti. Disemak pada 20 Oktober 2026, setiap laluan dl.min.io yang digunakan oleh panduan ini untuk memuat turun binari pelayan, binari klien dan fail checksum mereka, memberikan respons 410 Gone, yang merupakan pembuangan sengaja dan bukannya gangguan perkhidmatan. Rujukan CLI AIStor kini menghala ke AIStor Client di bawah /aistor/mc/release/, yang tergolong dalam barisan komersial. Halaman muat turun di min.io kini menyenaraikan AIStor Server, AIStor Client, AIStor SDK dan beberapa alat tambah AIStor, serta mengiklankan percubaan AIStor selama dua bulan. Halaman harganya masih menyenaraikan tier AIStor percuma yang disasarkan kepada pembangun, penyelidik dan organisasi kecil yang menjalankan penempatan kendiri.

Kod sumber masih ada, dan ia lebih baharu daripada binari terakhir. Keluaran komuniti terakhir ialah RELEASE.2025-10-15T17-29-55Z, diterbitkan pada 16 Oktober 2025 sebagai keluaran keselamatan: ia membaiki peningkatan keistimewaan melalui pintasan polisi sesi dalam akaun perkhidmatan dan STS, dan nota keluaran menasihatkan semua pengguna untuk menaik taraf dengan segera. Binari pra-kompil terakhir ialah binaan September 2025, jadi ia tidak pernah menerima pembaikan tersebut. Panduan ini mengkompil keluaran Oktober, dan kerana repositori tersebut telah diarkibkan, ia juga merupakan pembaikan terakhir yang akan diterima oleh edisi komuniti.

Fakta tersebut menentukan kandungan panduan ini seterusnya. Itulah sebabnya MinIO di sini mendengar pada 127.0.0.1 dan hanya mencapai internet melalui proksi yang anda kawal.

Pasang binari MinIO dan sahkan muat turun

MinIO ditulis dalam Go, dan README vendor membina perisian ini dengan satu arahan go install yang memerlukan Go 1.24 atau lebih baharu. Pasang Go daripada tarball rasmi terlebih dahulu. Pada 11 November 2026, keluaran stabil semasa di go.dev/dl ialah go1.27.4, yang dikeluarkan pada 10 November 2026 dengan pembetulan keselamatan pada cgo, arahan Go, pengkompil, pemaut dan pakej net/http, dan hash di bawah adalah yang diterbitkan pada halaman tersebut untuk arkib linux-amd64. Jika anda memilih versi Go yang lebih baharu, ambil hashnya daripada halaman yang sama. Flag -f menyebabkan curl gagal sekiranya berlaku ralat HTTP dan bukannya menyimpan halaman ralat di bawah nama yang anda minta, yang merupakan punca pengguna akhirnya menyahzip halaman 404 dan tertanya-tanya mengapa ia bukan arkib.

cd /tmp
GOVER=go1.27.4
curl -fsSL "https://go.dev/dl/$GOVER.linux-amd64.tar.gz" -o go.tar.gz

Bandingkan kedua-dua hash tersebut, dan bandingkan hash sahaja.

published=7226736c2339719cda28fbf3a54d71aa63bcefe376e98cef00034268dab24840
downloaded=$(sha256sum go.tar.gz | awk '{print $1}')
[ "$published" = "$downloaded" ] && echo "checksum ok"

Fahami dengan jelas apa yang dibuktikan oleh semakan ini. Padanan membuktikan muat turun adalah lengkap dan tidak rosak atau diubah semasa transit. Ia tidak membuktikan vendor boleh dipercayai. Itu adalah masalah berbeza dan tiada arahan sha256sum yang dapat menyelesaikannya.

sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go.tar.gz
export PATH=$PATH:/usr/local/go/bin
go version

Sekarang, bina keluaran komuniti akhir sebagai pengguna biasa anda. go install menyemak setiap modul yang dimuat turun, termasuk sumber MinIO sendiri, terhadap pangkalan data checksum awam Go di sum.golang.org, jadi modul yang diusik atau ditukar akan menghentikan proses binaan dengan ralat keselamatan dan bukannya menghasilkan binari.

go install github.com/minio/minio@RELEASE.2025-10-15T17-29-55Z
sudo install -o root -g root -m 755 ~/go/bin/minio /usr/local/bin/minio
minio --version
go version -m /usr/local/bin/minio | head -n 3

minio --version mencetak DEVELOPMENT.GOGET di mana nama keluaran sepatutnya berada, kerana go install tidak menggunakan flag binaan yang digunakan oleh vendor untuk melabel binari mereka sendiri. go version -m membaca maklumat modul yang disematkan oleh Go dalam setiap binari, dan baris mod github.com/minio/minio menyatakan commit yang anda bina. Permission denied di sini bermaksud mod adalah salah, dan command not found bermaksud /usr/local/bin tiada dalam PATH anda. Jika VPS kekurangan memori untuk proses kompilasi, jalankan go install yang sama pada mesin Linux lain dengan seni bina yang sama dan salin binari tersebut.

Cipta pengguna sistem dan direktori data

MinIO menerima muat naik daripada rangkaian, jadi ia tidak sepatutnya dijalankan sebagai root. Berikan ia akaun tanpa direktori home dan tanpa shell log masuk.

sudo groupadd -r minio-user
sudo useradd -M -r -g minio-user -s /usr/sbin/nologin minio-user
sudo mkdir -p /var/lib/minio/data
sudo chown -R minio-user:minio-user /var/lib/minio
sudo chmod 750 /var/lib/minio

-r mencipta akaun sistem dengan UID di bawah 1000, yang mengekalkannya di luar julat yang digunakan untuk pengguna manusia. -M melangkau direktori home, kerana akaun yang tidak pernah log masuk tidak perlu menyimpan apa-apa di dalamnya. Semak hasilnya dengan id minio-user, dan dengan stat -c '%U %a' /var/lib/minio, yang sepatutnya memaparkan minio-user 750.

Direktori data mestilah boleh ditulis oleh pengguna tersebut, bukan sekadar boleh dibaca. Pada permulaan pertama, MinIO mencipta direktori .minio.sys di dalam volum untuk menyimpan konfigurasinya sendiri, jadi direktori yang dimiliki oleh root akan menyebabkan MinIO keluar semasa permulaan dengan mesej yang berakhir dengan permission denied. Peraturan yang sama terpakai untuk setiap servis yang anda jalankan dengan cara ini, dan pengguna servis dengan keistimewaan minimum pada VPS membincangkan perkara ini dengan lebih lanjut.

Letakkan kelayakan root dalam fail persekitaran

Kelayakan root membuka setiap bucket, jadi ia tidak sepatutnya berada dalam unit file yang boleh dibaca oleh semua pengguna. Cipta fail tersebut dengan mod yang betul terlebih dahulu dan tulis kandungannya kemudian, supaya kata laluan tidak terdedah dalam fail yang boleh dibaca walaupun untuk seketika.

sudo install -o root -g root -m 600 /dev/null /etc/default/minio
printf 'MINIO_ROOT_USER=minio-root\nMINIO_ROOT_PASSWORD=%s\nMINIO_VOLUMES="/var/lib/minio/data"\nMINIO_OPTS="--address 127.0.0.1:9000 --console-address 127.0.0.1:9001"\n' "$(openssl rand -base64 24)" | sudo tee /etc/default/minio > /dev/null
sudo sed -n 's/^MINIO_ROOT_PASSWORD=//p' /etc/default/minio

tee memotong fail sedia ada dan bukannya mencipta semula fail tersebut, jadi mod kekal pada 600 dan pemiliknya kekal sebagai root. Ini dilakukan dengan sengaja. systemd membaca EnvironmentFile sebagai root sebelum ia menurunkan keistimewaan kepada User=, yang bermaksud akaun servis tidak perlu membaca kelayakannya sendiri. Sebaik sahaja servis berjalan, sahkan ia dengan sudo -u minio-user cat /etc/default/minio. Perintah tersebut mesti memaparkan Permission denied.

Dua kelakuan MinIO perlu diketahui sebelum anda memulakannya. Tanpa MINIO_ROOT_USER dan tanpa MINIO_ROOT_PASSWORD dalam persekitarannya, MinIO tidak akan menolak untuk bermula. Ia bermula dengan kelayakan lalai yang didokumentasikan iaitu minioadmin:minioadmin, yang merupakan pasangan pertama yang dicuba oleh mana-mana pengimbas, dan ia kelihatan berfungsi sepenuhnya semasa melakukannya. Kata laluan di bawah 8 aksara akan ditolak sebaliknya: MinIO keluar semasa permulaan dengan ralat yang menyatakan kelayakan tidak sah, kerana kunci akses memerlukan sekurang-kurangnya 3 aksara dan kunci rahsia sekurang-kurangnya 8 aksara.

MINIO_VOLUMES ialah laluan data dan MINIO_OPTS menyimpan flag. Melakukan binding kepada 127.0.0.1 bermakna tiada apa-apa di luar VPS ini yang boleh mencapai API S3 buat masa ini, yang merupakan tetapan lalai yang betul. Anda membukanya secara sengaja kemudian, melalui proksi yang memegang sijil.

Tulis unit systemd

Cipta /etc/systemd/system/minio.service:

[Unit]
Description=MinIO object storage
Documentation=https://github.com/minio/minio
Wants=network-online.target
After=network-online.target

[Service]
User=minio-user
Group=minio-user
EnvironmentFile=/etc/default/minio
ExecStart=/usr/local/bin/minio server $MINIO_VOLUMES $MINIO_OPTS
Restart=always
RestartSec=5
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target

Tiada - di hadapan EnvironmentFile, dan ini adalah keputusan sengaja, bukan kesilapan taip. Dengan tanda sengkang tersebut, systemd akan mengabaikan fail yang tiada dan tetap memulakan MinIO. Oleh itu, fail yang dipadamkan atau laluan yang tersalah eja akan menyebabkan pelayan berjalan pada minioadmin:minioadmin secara senyap. Tanpa tanda sengkang, fail yang tiada akan menyebabkan unit gagal sebelum MinIO sempat berjalan, dan journalctl -u minio akan memaparkan Failed to load environment files: No such file or directory. Unit yang enggan bermula adalah lebih mudah dikesan berbanding pelayan yang menerima kata laluan lalai secara senyap.

$MINIO_VOLUMES dan $MINIO_OPTS sengaja tidak diletakkan dalam tanda petikan, kerana systemd memisahkan pemboleh ubah tanpa tanda petikan mengikut ruang putih kepada argumen berasingan. Begitulah cara empat perkataan dalam MINIO_OPTS menjadi empat argumen kepada minio server. MinIO meningkatkan had deskriptor fail lembutnya kepada had keras yang diwarisi semasa permulaan. Nilai lalai systemd ialah 1024 untuk lembut dan 524288 untuk keras, jadi menetapkan LimitNOFILE=65536 akan merendahkan had berkesan MinIO kepada 65536. Unit ini tidak menyertakan penggantian tersebut.

sudo systemctl daemon-reload
sudo systemctl enable --now minio
systemctl is-active minio
curl -fsS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:9000/minio/health/live

is-active sepatutnya mencetak active, dan titik akhir kesihatan (health endpoint) sepatutnya menjawab 200. journalctl -u minio -n 20 --no-pager menunjukkan alamat API yang sedang didengar oleh pelayan. Jika unit terus dimulakan semula, baca ralat sebelum setiap permulaan semula dalam jurnal. Dengan RestartSec=5, keluar berulang kali tidak melebihi had permulaan lalai systemd iaitu lima kali dalam sepuluh saat, jadi unit akan terus mencuba semula. Start request repeated too quickly bermaksud had kadar permulaan yang dikonfigurasikan telah dicapai.

Untuk pengasingan yang lebih baik, tambahkan ProtectSystem=full dan ProtectHome=true ke dalam bahagian [Service]. Kedua-duanya memerlukan ruang nama lekap (mount namespaces) daripada kernel hos. Pada virtualisasi kontena yang berkongsi kernel hos, seperti OpenVZ atau LXC, ia mungkin gagal, dan unit tersebut kemudian melaporkan status=226/NAMESPACE. Buang kedua-dua baris tersebut dan ia akan bermula. Unit ini adalah unit biasa, dan servis dan pemasa systemd pada VPS merangkumi arahan selebihnya.

Pasang mc dan sahkan pusingan lengkap

MinIO client ialah mc. Jangan pasangnya menggunakan apt install mc. Pakej tersebut ialah Midnight Commander, iaitu pengurus fail yang tiada kaitan dengan MinIO.

Laluan komuniti lama, https://dl.min.io/client/mc/release/linux-amd64/mc, menjawab 410 Gone. Rujukan CLI AIStor kini menghala ke AIStor Client di https://dl.min.io/aistor/mc/release/linux-amd64/mc dan menyifatkannya sebagai mempunyai fungsi eksklusif untuk penempatan AIStor Server berlesen. Rujukan tersebut tidak menyebut tentang penggunaannya terhadap pelayan komuniti, jadi panduan ini kekal menggunakan klien komuniti. Repositori minio/mc telah diarkibkan sejak Julai 2026, jadi bina keluaran terakhirnya, RELEASE.2025-08-13T08-35-41Z, dengan rantaian alat Go yang sama. Pangkalan data checksum juga merangkumi muat turun ini.

go install github.com/minio/mc@RELEASE.2025-08-13T08-35-41Z
sudo install -o root -g root -m 755 ~/go/bin/mc /usr/local/bin/mc

Daftarkan pelayan sebagai alias, kemudian pindahkan objek melaluinya.

MINIO_PASS=$(sudo sed -n 's/^MINIO_ROOT_PASSWORD=//p' /etc/default/minio)
mc alias set local http://127.0.0.1:9000 minio-root "$MINIO_PASS"
mc mb local/backups
echo "hello object storage" > /tmp/hello.txt
mc cp /tmp/hello.txt local/backups/hello.txt
mc ls local/backups
mc cat local/backups/hello.txt

mc ls sepatutnya menyenaraikan hello.txt berserta saiznya, dan mc cat sepatutnya mencetak hello object storage. Pusingan lengkap itu adalah bukti sebenar bahawa pelayan berfungsi, kerana ia membuat permintaan S3 bertandatangan yang sama seperti yang akan dibuat oleh mana-mana klien lain. mc admin info local mencetak status pelayan jika anda mahukan pendapat kedua.

Jalankan satu lagi semakan sekarang, sementara pelayan masih kosong.

mc alias set defaultcheck http://127.0.0.1:9000 minioadmin minioadmin

Perintah ini mesti gagal. Jika ia berjaya, fail persekitaran tidak sampai kepada proses tersebut dan pelayan anda sedang berjalan menggunakan kelayakan lalai. Betulkan perkara itu sebelum sebarang perkara lain menyentuh mesin tersebut.

mc menyimpan alias dalam ~/.mc/config.json dalam bentuk teks biasa, jadi kelayakan tersebut berada dalam direktori utama sesiapa sahaja yang menjalankan perintah itu. Menjalankan mc di bawah sudo meletakkan kelayakan root dalam /root/.mc/config.json. Simpan alias root pada satu akaun pentadbir dan berikan setiap aplikasi kuncinya sendiri.

Mengedarkan satu objek dengan URL pra-tandatangan

URL pra-tandatangan ialah pautan HTTPS biasa yang disertakan dengan tandatangan dan tempoh tamat. Sesiapa sahaja yang memegang pautan tersebut boleh mengambil objek itu tanpa memerlukan akaun atau klien.

mc share download --expire 12h local/backups/hello.txt

Output tersebut membawa X-Amz-Signature dan X-Amz-Expires dalam rentetan pertanyaan (query string). Terdapat dua perkara mengenainya yang sering mengejutkan pengguna. Pautan dibina daripada titik akhir (endpoint) dalam alias yang anda gunakan, jadi alias pada 127.0.0.1 menghasilkan pautan yang hanya boleh dibuka oleh mesin ini: buat alias kedua pada nama hos awam anda untuk pautan yang ingin anda hantar. Selain itu, tiada butang untuk membatalkan pautan secara individu. Tandatangan kekal sah sehingga ia tamat tempoh atau kunci yang menandatanganinya dibuang atau ditukar. Bagi pautan yang ditandatangani dengan kelayakan root, ini bermakna anda perlu menukar kelayakan tersebut, jadi menetapkan tempoh tamat yang singkat adalah kawalan yang praktikal. Tujuh hari ialah tempoh maksimum yang dibenarkan oleh format tandatangan S3.

Berikan restic kunci dan bucket sendiri

Kredensial root boleh membaca dan memadam setiap bucket, jadi tugasan sandaran (backup) tidak boleh memegangnya. Cipta bucket, polisi yang dihadkan kepada bucket tersebut, dan pengguna yang tidak mempunyai akses lain.

mc mb local/restic
cat > /tmp/restic-rw.json <<'EOF'
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": ["arn:aws:s3:::restic"]
    },
    {
      "Effect": "Allow",
      "Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject"],
      "Resource": ["arn:aws:s3:::restic/*"]
    }
  ]
}
EOF
RESTIC_KEY=$(openssl rand -base64 24)
mc admin policy create local restic-rw /tmp/restic-rw.json
mc admin user add local restic-backup "$RESTIC_KEY"
mc admin policy attach local restic-rw --user restic-backup

MinIO menyediakan polisi terbina dalam readwrite yang mungkin lebih ringkas, namun ia memberikan akses penuh kepada setiap bucket pada pelayan. Polisi di atas menamakan bucket tersebut dua kali dengan sengaja: sekali sebagai arn:aws:s3:::restic supaya penyenaraian bucket berfungsi, dan sekali sebagai arn:aws:s3:::restic/* untuk objek di dalamnya. Dalam S3, bucket dan objeknya adalah sumber yang berasingan, jadi polisi yang hanya menamakan salah satu daripadanya akan gagal dengan cara yang kelihatan seperti klien yang rosak.

Uji had tersebut sebelum anda mempercayainya.

mc alias set resticuser http://127.0.0.1:9000 restic-backup "$RESTIC_KEY"
mc ls resticuser/restic
mc ls resticuser/backups

ls yang pertama berjaya dan yang kedua gagal dengan Access Denied. Polisi yang belum anda uji hanyalah satu andaian.

Sekarang, halakan restic ke bucket tersebut. restic membaca kredensial S3 daripada pemboleh ubah persekitaran AWS standard, jadi tiada fail kredensial khusus restic yang terlibat.

sudo apt install -y restic
export AWS_ACCESS_KEY_ID=restic-backup
export AWS_SECRET_ACCESS_KEY="$RESTIC_KEY"
restic -r s3:http://127.0.0.1:9000/restic init
restic -r s3:http://127.0.0.1:9000/restic backup /etc
restic -r s3:http://127.0.0.1:9000/restic snapshots

restic init meminta kata laluan repositori. Kata laluan itu menyulitkan repositori, jadi MinIO hanya menyimpan teks sifer, dan kehilangan kata laluan bermakna kehilangan sandaran. Pelaksanaan yang dimulakan oleh pemasa systemd tidak mempunyai terminal untuk menaip, jadi tetapkan RESTIC_PASSWORD_FILE kepada fail mod 600 untuk sandaran berjadual.

Satu peraturan penempatan lebih penting daripada mana-mana arahan di atas. Repositori restic pada VPS yang sama dengan data yang dilindunginya hanya melindungi anda daripada rm yang buruk dan tiada yang lain. Nod MinIO sepatutnya berada pada mesin yang berbeza, sebaik-baiknya di wilayah yang berbeza. sandaran restic pada VPS merangkumi penjadualan dan pengekalan di samping perkara ini.

Menamatkan TLS dengan nginx

MinIO berjalan pada localhost, jadi nginx bertindak sebagai permukaan awam. Dapatkan sijil terlebih dahulu seperti yang diterangkan dalam Sijil Let's Encrypt dengan certbot dan nginx, kemudian gunakan blok server ini.

server {
    listen 443 ssl;
    server_name s3.example.com;

    ignore_invalid_headers off;
    client_max_body_size 0;
    proxy_buffering off;
    proxy_request_buffering off;

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_connect_timeout 300;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        chunked_transfer_encoding off;
        proxy_pass http://127.0.0.1:9000;
    }
}

Beberapa baris tersebut adalah kritikal. client_max_body_size 0 membuang had saiz badan 1 MB lalai, yang jika tidak, akan menolak sebarang muat naik yang lebih besar dengan 413 Request Entity Too Large sebelum MinIO melihat permintaan tersebut. proxy_request_buffering off menstrim muat naik secara terus, kerana tetapan lalai akan menyimpan keseluruhan permintaan ke dalam fail sementara terlebih dahulu, dan objek yang besar akan memerlukan ruang cakera dua kali ganda. proxy_set_header Host $http_host adalah tetapan yang penting: tandatangan S3 merangkumi header Host, jadi proksi yang menulis semula header tersebut akan menyebabkan setiap permintaan gagal dengan SignatureDoesNotMatch manakala log akses menunjukkan permintaan biasa sampai.

Beritahu MinIO nama awamnya juga, supaya pautan yang dijana menghala ke proksi dan bukannya ke localhost.

echo 'MINIO_SERVER_URL=https://s3.example.com' | sudo tee -a /etc/default/minio
sudo systemctl restart minio

Firewall kekal ringkas. Benarkan SSH dan HTTPS, dan jangan buat sebarang peraturan untuk port 9000 dan 9001, kerana alamat yang terikat pada 127.0.0.1 tidak boleh dicapai dari mesin lain tidak kira apa pun peraturan firewall. Asas firewall ufw pada VPS mengandungi arahan tersebut.

Bilakah MinIO nod tunggal mencukupi, dan bilakah anda memerlukan S3 sebenar

Nod tunggal di sini bermaksud satu pemacu, jadi tiada pariti dan tiada salinan kedua di dalam penempatan tersebut, dan ketahanan setiap objek adalah ketahanan satu cakera VPS. Dokumentasi komuniti MinIO tersedia sebagai sumber dalam repositori minio/docs selepas dokumentasi komuniti yang dihoskan diturunkan pada Oktober 2025. README pelayannya menyatakan bahawa persekitaran pengeluaran yang menggunakan binari yang dikompilasi daripada sumber melakukannya atas risiko sendiri. Penguncian objek (object locking) boleh dihidupkan untuk baldi (bucket), tetapi pada satu VPS ia hanya menghalang pemadaman melalui API S3. Sesiapa yang mempunyai akses root pada mesin tersebut masih boleh membuang fail pada cakera, jadi jangan menjanjikan sesiapa polisi pengekalan yang tidak boleh diubah (immutable) pada persediaan ini.

Ia merupakan pilihan yang baik sebagai sasaran restic pada VPS kedua di wilayah lain, dan sebagai titik akhir S3 untuk kerja pembangunan serta artifak CI, di mana kehilangan baldi hanya menyebabkan anda perlu membina semula dan tiada kesan lain. Ia juga munasabah untuk muat naik pengguna dalam aplikasi kecil, selagi anda memiliki pelan pemulihan dan anda telah benar-benar menguji pemulihan tersebut.

Pilih S3 terurus apabila kontrak atau pengawal selia meminta penguncian objek atau ketahanan berbilang wilayah, atau apabila anda lebih suka tidak menjadi orang yang dihubungi pada jam 03:00 kerana cakera penuh. Kod yang dibekukan adalah satu lagi sebab yang jujur. Setakat 20 Oktober 2026, edisi komuniti telah diarkibkan dan tidak lagi diselenggara, dan keluaran terakhirnya, RELEASE.2025-10-15T17-29-55Z, adalah yang dikompilasi oleh panduan ini. Tiada apa-apa selepas itu akan dibaiki, jadi menjalankannya bermakna menerima perkara tersebut, atau beralih kepada barisan komersial AIStor MinIO atau ke storan layan diri yang lain, yang dibandingkan dalam alternatif MinIO layan diri.

Satu sempadan perlu dinyatakan kerana ia sering timbul. Storan objek bukanlah pangkalan data. Dalam baldi standard, setiap penulisan menggantikan keseluruhan objek, malah panggilan tambah (append) yang ditambah oleh Amazon untuk S3 Express One Zone hanya menambah data pada penghujung, jadi fail SQL langsung pada baldi S3 adalah perlahan dan tidak selamat. Simpan pangkalan data pada cakera tempatan dan buat sandaran ke dalam baldi tersebut sebaliknya: menjalankan SQLite dalam pengeluaran pada VPS menerangkan pembahagian tersebut.

Mod kegagalan dan mesej yang akan anda lihat

Unit gagal sejurus selepas systemctl enable --now. Baca journalctl -u minio -n 30 --no-pager. Failed to load environment files: No such file or directory bermaksud /etc/default/minio tiada atau laluannya tersalah eja dalam unit tersebut. Mesej yang berakhir dengan permission denied bermaksud direktori data tidak boleh ditulis oleh akaun servis, jadi pastikan stat -c '%U' /var/lib/minio/data memaparkan minio-user.

minioadmin:minioadmin masih log masuk. Fail persekitaran tidak sampai kepada proses tersebut. Sahkan unit mengandungi EnvironmentFile=/etc/default/minio, jalankan sudo systemctl daemon-reload, kemudian mulakan semula servis. MinIO membaca kelayakan rootnya sekali sahaja semasa permulaan, jadi menyunting fail tersebut tanpa memulakan semula tidak akan mengubah apa-apa.

Address already in use semasa permulaan. Proses lain sedang menggunakan port 9000. Cari proses tersebut dengan sudo ss -ltnp | grep :9000 sebelum anda menukar port MinIO.

Muat naik melebihi 1 MB gagal melalui proksi. nginx menjawab 413 Request Entity Too Large dan MinIO tidak menerima permintaan tersebut. Tetapkan client_max_body_size 0 dalam blok server.

SignatureDoesNotMatch. Sama ada kunci rahsia salah, atau sesuatu antara klien dan MinIO telah menulis semula pengepala Host, yang dilindungi oleh tandatangan tersebut.

RequestTimeTooSkewed. Jam pada klien atau pelayan tidak tepat. Setiap permintaan S3 yang ditandatangani membawa cap masa, dan MinIO, seperti Amazon S3, menolak permintaan yang ditandatangani pengepala jika cap masanya melebihi 15 minit daripada jam pelayan. Pautan pra-tandatangan disemak berdasarkan tempoh tamatnya. Semak timedatectl dan pastikan penyegerakan masa aktif.

Access Denied pada baldi (bucket) yang anda tahu wujud. Kunci tersebut dihadkan kepada baldi yang berbeza. Paparkan apa yang sebenarnya dibenarkan oleh polisi dengan mc admin policy info local restic-rw dan bandingkan nama baldi dalam baris sumber.

FAQ

Adakah MinIO nod tunggal mencukupi untuk sandaran sebenar?

Ia mencukupi sebagai sasaran restic yang dijalankan pada mesin berasingan daripada data yang dilindunginya. Ia tidak mencukupi jika dijadikan satu-satunya salinan anda. Penggunaan satu pemacu (single-drive) tidak mempunyai pariti, jadi tiada salinan kedua di dalam MinIO. Jika cakera VPS tersebut kehilangan data, objek akan hilang. Simpan sasaran kedua di tempat lain, dan lakukan pemulihan daripada kedua-dua sasaran sekurang-kurangnya sekali supaya anda tahu proses tersebut berfungsi.

Mengapakah sha256sum -c gagal pada fail checksum MinIO?

Laluan dl.min.io lama menjawab 410 Gone untuk setiap binari komuniti dan fail checksum yang digunakan panduan ini apabila disemak pada 20 Oktober 2026. Label selepas hash di dalam fail tersebut menamakan keluaran (release), contohnya minio.RELEASE.2025-09-07T16-13-09Z, manakala fail yang dimuat turun biasanya dipanggil minio. sha256sum -c mencari fail dengan nama yang tertulis di dalam fail checksum, tidak menemuinya, lalu melaporkan No such file or directory dan WARNING: 1 listed file could not be read. Muat turun tersebut adalah selamat. Bandingkan rentetan hash secara terus dan abaikan label tersebut, kerana ia tidak membawa sebarang makna keselamatan.

Ke manakah perginya konsol web pentadbir MinIO?

MinIO telah membuang ciri pentadbiran daripada konsol edisi komuniti pada Mei 2025, dan hanya meninggalkan pelayar objek dalam antara muka web. Bucket dan pengguna kini diuruskan dengan klien mc, menggunakan arahan seperti mc admin user add dan mc admin policy attach. Itu adalah laluan yang disasarkan dalam edisi komuniti dan bukannya penyelesaian sementara (workaround), itulah sebabnya panduan ini melakukan segala-galanya daripada baris arahan.

Bagaimanakah cara menghalakan restic ke MinIO sebagai backend S3?

Tetapkan AWS_ACCESS_KEY_ID dan AWS_SECRET_ACCESS_KEY kepada access key MinIO dan secret-nya, kemudian gunakan rentetan repositori dalam bentuk s3:https://s3.example.com/restic, di mana elemen laluan terakhir ialah nama bucket. Cipta bucket terlebih dahulu dengan mc mb, kerana kunci yang dihadkan kepada satu bucket tidak mempunyai kebenaran untuk mencipta bucket. restic menyulitkan segala-galanya dengan kata laluan repositorinya sendiri sebelum dimuat naik, jadi MinIO hanya menyimpan ciphertext dan tidak akan melihat fail anda.

Adakah saya perlu menjalankan MinIO di sebalik nginx?

Anda memerlukan TLS (transport layer security) apabila klien tidak berada pada mesin yang sama. Tanpa TLS, setiap objek merentasi rangkaian dalam teks biasa (plain text), bersama-sama dengan ID access key dan tandatangan permintaan. Secret key itu sendiri tidak pernah meninggalkan klien, kerana penandatanganan S3 hanya menggunakannya secara setempat untuk mengira tandatangan tersebut. Walau bagaimanapun, sesiapa sahaja di sepanjang laluan rangkaian masih boleh membaca data anda dan memainkan semula (replay) permintaan yang ditangkap selagi cap masa (timestamp) masih sah. Proksi pada port 443 dengan sijil daripada certbot ialah cara paling mudah untuk mendapatkan TLS, dan ia memastikan pembaharuan sijil diuruskan di luar MinIO. MinIO juga boleh menamatkan TLS sendiri jika anda menghalakan --certs-dir ke direktori yang menyimpan public.crt dan private.key, tetapi akaun servis kemudiannya memerlukan akses baca kepada kunci peribadi yang diperbaharui, yang merupakan kerja tambahan untuk hasil yang sama.

Adakah artikel ini berguna?

#minio#s3#object-storage#self-hosted#vps