Paano Magpatakbo ng MinIO sa Sariling Ubuntu VPS
Magpatakbo ng MinIO sa isang Ubuntu 24.04 VPS para sa sariling S3 API, gamit ang verified source build, systemd, mc, presigned URLs, at restic.
Ano ang ibinibigay sa iyo ng self-hosted object storage gamit ang MinIO
Ang MinIO ay self-hosted object storage na gumagamit ng Amazon S3 API. Ituro ang restic o isang S3 SDK sa sarili mong server, baguhin ang isang endpoint setting, at para sa karaniwang pagbasa, pagsulat, pag-lista ng mga object, at paggawa ng presigned link, iyon na ang kailangan. Gayunman, magkaiba ang compatible at identical. Halimbawa, hindi ipinapatupad ng MinIO ang object ACL ng Amazon, kaya ang application na umaasa sa gawi ng ACL ay mangangailangan ng higit pa sa bagong endpoint. Sa gabay na ito, bubuo tayo ng single node sa Ubuntu 24.04: isang binary na na-compile mula sa verified source, isang dedicated system user, isang systemd unit na hindi naglalagay ng root credentials sa unit file, at isang bucket na paglalagyan ng backup mula sa restic.
Ang S3 (simple storage service) ay isang HTTP API, hindi filesystem. Nag-PUT ka ng object sa isang bucket gamit ang isang key at nag-GET ka nito para makuha muli. Sa isang standard bucket, walang partial write at walang rename. Exception ang Amazon S3 Express One Zone directory bucket, na may sarili nitong mga tawag para sa append at rename. Gayunman, isang storage class lamang ito at walang bahagi ng gabay na ito ang umaasa rito. Ang mga backup tool ay angkop sa standard model dahil ang isang object ay maaaring dumating nang buo o hindi talaga dumating.
Isang kopya lamang ng iyong data ang hawak ng isang node. Iyan ang trade-off na pinipili mo. Makakakuha ka ng S3 endpoint na kontrolado mo sa halaga ng isang VPS, ngunit mamanahin mo rin ang lahat ng trabahong dating ginagawa ng cloud provider, mula sa pagpapalit ng sirang disk hanggang sa pag-patch ng server software. Malinaw na ipinapaliwanag sa bandang dulo kung kailan kapaki-pakinabang ang trade-off na iyon.
Ang estado ng MinIO community edition noong October 2026
Basahin muna ang bahaging ito bago mo ito gamitin bilang pundasyon, dahil nagbago ito kamakailan. Noong May 2025, inalis ng MinIO ang mga administration feature sa web console ng community edition. Object browser na lamang ang nananatili sa browser, kaya ang pamamahala ng buckets at access keys ay ginagawa na sa mc command line client.
Kalaunan noong 2025, itinigil ng MinIO ang pag-publish ng mga pre-compiled community binary. Ayon sa project README, source code lamang ang distribution ng community edition, at mula April 2026 ay naka-archive na ang minio/minio repository sa ilalim ng notice na THIS REPOSITORY IS NO LONGER MAINTAINED. Hindi na rin nagsisilbi ng community files ang dating download server. Nang suriin noong 20 October 2026, lahat ng dl.min.io path na dating ginagamit ng guide na ito para mag-download—ang server binary, client binary, at mga checksum file ng mga ito—ay sumasagot ng 410 Gone. Sinasadya ang pagtanggal na ito at hindi ito outage. Tinutukoy na ngayon ng AIStor CLI reference ang AIStor Client sa ilalim ng /aistor/mc/release/, na kabilang sa commercial line. Nakalista ngayon sa download page sa min.io ang AIStor Server, AIStor Client, AIStor SDK, at ilang AIStor add-on, at may alok itong dalawang-buwang AIStor trial. Nakalista pa rin sa pricing page nito ang libreng AIStor tier para sa mga developer, researcher, at maliliit na organisasyong nagpapatakbo ng standalone deployment.
Nananatili pa rin ang source, at mas bago ito kaysa sa huling binary. Ang huling community release ay RELEASE.2025-10-15T17-29-55Z, na inilabas noong 16 October 2025 bilang security release. Inaayos nito ang privilege escalation sa pamamagitan ng session policy bypass sa service accounts at STS, at ipinapayo ng release notes sa lahat ng user na mag-upgrade agad. Ang huling pre-compiled binary ay ang September 2025 build, kaya hindi nito natanggap ang fix na iyon. Kino-compile ng guide na ito ang October release, at dahil naka-archive na ang repository, ito na rin ang huling fix na matatanggap ng community edition.
Ang isang katotohanang ito ang humuhubog sa natitirang bahagi ng guide. Ito ang dahilan kung bakit nakikinig ang MinIO dito sa 127.0.0.1 at nakakarating lamang sa internet sa pamamagitan ng proxy na ikaw ang kumokontrol.
I-install ang MinIO binary at i-verify ang download
Nakasulat sa Go ang MinIO, at bina-build ito ng vendor README gamit ang iisang go install command na nangangailangan ng Go 1.24 o mas bago. I-install muna ang Go mula sa official tarball. Noong 11 November 2026, ang kasalukuyang stable release sa go.dev/dl ay go1.27.4. Inilabas ito noong 10 November 2026 na may security fixes para sa cgo, Go command, compiler, linker, at net/http package. Ang hash sa ibaba ang inilathala sa page na iyon para sa linux-amd64 archive. Kung mas bagong Go ang pipiliin mo, kunin ang hash nito mula sa parehong page. Dahil sa -f flag, mabibigo ang curl kapag HTTP error ang natanggap sa halip na i-save ang error page gamit ang pangalan na hiniling mo. Ganito napupunta ang ilan sa pag-unpack ng 404 page at pagtataka kung bakit hindi ito archive.
cd /tmp
GOVER=go1.27.4
curl -fsSL "https://go.dev/dl/$GOVER.linux-amd64.tar.gz" -o go.tar.gzIhambing ang dalawang hash, at mga hash lamang ang ihambing.
published=7226736c2339719cda28fbf3a54d71aa63bcefe376e98cef00034268dab24840
downloaded=$(sha256sum go.tar.gz | awk '{print $1}')
[ "$published" = "$downloaded" ] && echo "checksum ok"Linawin kung ano ang pinatutunayan ng check na ito. Pinatutunayan ng magkatugmang hash na kumpleto ang download at hindi ito nasira o nabago habang ipinapadala. Hindi nito pinatutunayang mapagkakatiwalaan ang vendor. Ibang problema iyon, at walang sha256sum command ang makalulutas nito.
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go.tar.gz
export PATH=$PATH:/usr/local/go/bin
go versionI-build ngayon ang final community release bilang normal mong user. Sinusuri ng go install ang bawat module na dina-download nito, kabilang ang sariling source ng MinIO, laban sa public checksum database ng Go sa sum.golang.org. Kaya ihihinto ng security error ang build kapag may module na pinakialaman o pinalitan, sa halip na gumawa ng binary.
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 3Ipinapakita ng minio --version ang DEVELOPMENT.GOGET kung saan dating lumalabas ang release name, dahil hindi ginagamit ng go install ang build flags na ginamit ng vendor para lagyan ng impormasyon ang sarili nitong binaries. Binabasa ng go version -m ang module information na ini-embed ng Go sa bawat binary, at tinutukoy ng mod github.com/minio/minio line nito ang commit na bina-build mo. Ang Permission denied dito ay nangangahulugang mali ang mode, at ang command not found ay nangangahulugang wala ang /usr/local/bin sa iyong PATH. Kung kapos sa memory ang VPS para sa compilation, patakbuhin ang parehong go install sa ibang Linux machine na may kaparehong architecture at kopyahin ang binary papunta rito.
Gumawa ng system user at data directory
Tumatanggap ang MinIO ng mga upload mula sa network, kaya hindi ito dapat tumakbo bilang root. Bigyan ito ng account na walang home directory at walang login shell.
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/minioAng -r ay gumagawa ng system account na may UID na mababa sa 1000, na nagpapanatili rito sa labas ng range na ginagamit para sa mga tao. Nilalaktawan ng -M ang home directory, dahil ang account na hindi kailanman nag-lo-login ay walang dapat itago sa loob nito. Suriin ang resulta gamit ang id minio-user, at gamit ang stat -c '%U %a' /var/lib/minio, na dapat mag-print ng minio-user 750.
Ang data directory ay dapat na writable ng user na iyon, hindi lang readable. Sa unang pag-start, gumagawa ang MinIO ng .minio.sys directory sa loob ng volume para hawakan ang sarili nitong configuration, kaya ang directory na pagmamay-ari ng root ay magiging sanhi ng pag-exit ng MinIO habang nag-i-startup na may mensaheng nagtatapos sa permission denied. Ang parehong tuntunin ay nalalapat sa bawat serbisyong pinapatakbo mo sa ganitong paraan, at ang least-privilege service users on a VPS ay tumatalakay dito nang maayos.
Ilagay ang root credentials sa isang environment file
Ang root credentials ay nagbibigay ng access sa lahat ng bucket, kaya hindi dapat ito ilagay sa unit file na nababasa ng kahit sino. Gawin ang file gamit ang tamang mode bago ito sulatan, para hindi man lang magkaroon ng pagkakataon na mabasa ang password sa isang file.
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/minioAng tee ay pinuputol (truncate) ang isang existing file sa halip na gumawa ng bago, kaya ang mode ay mananatiling 600 at ang may-ari ay mananatiling root. Sinadya ito. Binabasa ng systemd ang EnvironmentFile bilang root bago nito ibaba ang privileges sa User=, na nangangahulugang hindi na kailangang basahin ng service account ang sarili nitong credentials. Kapag tumatakbo na ang service, i-verify ito gamit ang sudo -u minio-user cat /etc/default/minio. Ang command na iyon ay dapat mag-print ng Permission denied.
May dalawang behavior ang MinIO na dapat mong malaman bago ito simulan. Kung walang MINIO_ROOT_USER at walang MINIO_ROOT_PASSWORD sa environment nito, hindi tatanggi ang MinIO na mag-start. Mag-i-start ito gamit ang default credentials na minioadmin:minioadmin, na siyang unang sinusubukan ng anumang scanner, at magmumukha itong maayos habang ginagawa iyon. Ang password na kulang sa 8 characters ay tatanggihan sa halip: mag-e-exit ang MinIO sa startup na may error na nagsasabing invalid ang credentials, dahil ang access key ay nangangailangan ng hindi bababa sa 3 characters at ang secret key ay hindi bababa sa 8.
Ang MINIO_VOLUMES ang path ng data at ang MINIO_OPTS ang naglalaman ng mga flag. Ang pag-bind sa 127.0.0.1 ay nangangahulugang wala pang makaka-reach sa S3 API mula sa labas ng VPS na ito, na siyang tamang default. Bubuksan mo ito nang kusa sa susunod, sa pamamagitan ng isang proxy na may hawak na certificate.
Isulat ang systemd unit
Gumawa ng /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.targetWalang nauunang - sa EnvironmentFile, at sinadya ito. Kapag may dash, binabalewala ng systemd ang nawawalang file at sinisimulan pa rin ang MinIO. Dahil dito, ang naburang file o maling path ay tahimik na nag-iiwan ng server na tumatakbo gamit ang minioadmin:minioadmin. Kapag walang dash, magfa-fail ang unit dahil sa nawawalang file bago pa man tumakbo ang MinIO, at ipapakita ng journalctl -u minio ang Failed to load environment files: No such file or directory. Mas madaling mapansin ang unit na tumatangging magsimula kaysa server na tahimik na tumatanggap ng default password.
Sadyang walang quotation marks ang $MINIO_VOLUMES at $MINIO_OPTS dahil hinahati ng systemd ang mga variable na walang quotation marks sa whitespace at ginagawang magkakahiwalay na argument. Sa ganitong paraan, nagiging apat na argument sa minio server ang apat na salita sa MINIO_OPTS. Itinataas ng MinIO ang soft file descriptor limit nito sa minana nitong hard limit kapag nagsisimula. Ang default ng systemd ay 1024 para sa soft limit at 524288 para sa hard limit, kaya bababaan ng pagtatakda sa LimitNOFILE=65536 ang aktuwal na limit ng MinIO sa 65536. Hindi isinama ng unit ang override na iyon.
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/liveDapat mag-print ang is-active ng active, at dapat sumagot ang health endpoint ng 200. Ipinapakita ng journalctl -u minio -n 20 --no-pager ang API address na pinakikinggan ng server. Kung patuloy na nagre-restart ang unit, basahin sa journal ang error bago ang bawat restart. Gamit ang RestartSec=5, hindi lalampas sa default start limit ng systemd na limang start sa loob ng sampung segundo ang paulit-ulit na pag-exit, kaya patuloy na magta-try ang unit. Ibig sabihin ng Start request repeated too quickly, naabot na ang naka-configure na start-rate limit.
Para sa mas mahigpit na isolation, idagdag ang ProtectSystem=full at ProtectHome=true sa seksyong [Service]. Pareho silang nangangailangan ng mount namespace mula sa host kernel. Sa container virtualisation na gumagamit ng shared host kernel, gaya ng OpenVZ o LXC, maaaring mag-fail ang mga ito, at iuulat ng unit ang status=226/NAMESPACE. Alisin ang dalawang linyang iyon at magsisimula ito. Ordinaryong unit ang unit na ito, at saklaw ng systemd services at timer sa isang VPS ang iba pang directive.
I-install ang mc at patunayan ang round trip
Ang MinIO client ay mc. Huwag itong i-install gamit ang apt install mc. Ang package na iyon ay Midnight Commander, isang file manager na walang kaugnayan sa MinIO.
Ang lumang community path na https://dl.min.io/client/mc/release/linux-amd64/mc ay tumutugon sa 410 Gone. Ang AIStor CLI reference ay tumutukoy na ngayon sa AIStor Client sa https://dl.min.io/aistor/mc/release/linux-amd64/mc at inilalarawan itong may exclusive functionality para sa mga licensed AIStor Server deployment. Walang sinasabi ang reference na iyon tungkol sa paggamit nito laban sa isang community server, kaya community client ang ginagamit ng gabay na ito. Na-archive na ang minio/mc repository mula July 2026, kaya i-build ang huling release nito, RELEASE.2025-08-13T08-35-41Z, gamit ang parehong Go toolchain. Saklaw din ng checksum database ang download na ito.
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/mcI-register ang server bilang alias, pagkatapos ay maglipat ng object sa pamamagitan nito.
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.txtDapat ilista ng mc ls ang hello.txt kasama ang size nito, at dapat i-print ng mc cat ang hello object storage. Ito ang tunay na patunay na gumagana ang server, dahil ginagawa nito ang parehong signed S3 requests na gagawin ng lahat ng ibang client. Ini-print ng mc admin info local ang status ng server kung gusto mo ng karagdagang beripikasyon.
Magsagawa ngayon ng isa pang check habang wala pang laman ang box.
mc alias set defaultcheck http://127.0.0.1:9000 minioadmin minioadminDapat mag-fail ang command na ito. Kung nagtagumpay ito, hindi nakarating ang environment file sa process at tumatakbo ang server gamit ang default credentials. Ayusin muna ito bago may ibang kumabit sa machine.
Sine-save ng mc ang mga alias sa ~/.mc/config.json bilang plain text, kaya napupunta ang mga credential na iyon sa home directory ng sinumang nagpatakbo ng command. Kapag pinatakbo ang mc sa ilalim ng sudo, mapupunta ang root credentials sa /root/.mc/config.json. Panatilihin ang root alias sa iisang administrator account at bigyan ang bawat application ng sarili nitong key.
Magbigay ng isang object gamit ang presigned URL
Ang presigned URL ay isang karaniwang HTTPS link na may kasamang signature at expiry. Maaaring kunin ng sinumang may hawak ng link ang object na iyon nang walang account at walang client.
mc share download --expire 12h local/backups/hello.txtKasama sa output ang X-Amz-Signature at X-Amz-Expires sa query string. May dalawang bagay dito na ikinagugulat ng mga tao. Ginagawa ang link batay sa endpoint sa alias na ginamit mo. Kaya ang alias sa 127.0.0.1 ay lumilikha ng link na mabubuksan lamang ng machine na ito. Gumawa ng pangalawang alias sa iyong public hostname para sa mga link na balak mong ipadala. Wala ring revoke button para sa bawat link. Mananatiling valid ang signature hanggang sa mag-expire ito o maalis o mapalitan ang key na lumagda rito. Kung root credentials ang ginamit sa pag-sign, nangangahulugan ito ng pag-rotate sa mga credential na iyon. Kaya ang maikling expiry ang praktikal na control. Pitong araw ang maximum na pinapahintulutan ng S3 signature format.
Bigyan ang restic ng sarili nitong key at bucket
Ang root credentials ay may kakayahang magbasa at magbura ng kahit anong bucket, kaya hindi dapat hawak ng isang backup job ang mga ito. Gumawa ng bucket, isang policy na limitado lamang sa bucket na iyon, at isang user na walang ibang access.
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-backupAng MinIO ay may built-in na readwrite policy na mas mabilis i-setup, ngunit nagbibigay ito ng full access sa lahat ng bucket sa server. Ang policy sa itaas ay sadyang binanggit ang bucket nang dalawang beses: una bilang arn:aws:s3:::restic para gumana ang pag-list ng bucket, at pangalawa bilang arn:aws:s3:::restic/* para sa mga object sa loob nito. Sa S3, ang bucket at ang mga object nito ay magkahiwalay na resource, kaya ang policy na nagpapangalan lamang sa isa sa mga ito ay magdudulot ng error na mukhang sira ang client.
I-test ang limitasyon bago mo ito pagkatiwalaan.
mc alias set resticuser http://127.0.0.1:9000 restic-backup "$RESTIC_KEY"
mc ls resticuser/restic
mc ls resticuser/backupsAng unang ls ay magtatagumpay at ang pangalawa ay mabibigo na may Access Denied. Ang policy na hindi mo pa na-test ay isa lamang hula.
Ngayon, ituro ang restic sa bucket. Binabasa ng restic ang S3 credentials mula sa standard AWS environment variables, kaya walang file na partikular sa restic ang kailangan.
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 snapshotsAng restic init ay hihingi ng repository password. Ang password na iyon ang nag-e-encrypt sa repository, kaya ciphertext lang ang iniimbak ng MinIO, at ang pagkawala ng password ay nangangahulugan ng pagkawala ng backup. Ang run na sinimulan ng isang systemd timer ay walang terminal na mapag-ta-type-an, kaya i-set ang RESTIC_PASSWORD_FILE sa isang mode 600 na file para sa mga naka-schedule na backup.
Isang placement rule ang mas mahalaga kaysa sa kahit anong command sa itaas. Ang restic repository na nasa parehong VPS ng data na pinoprotektahan nito ay makakatulong lamang laban sa maling rm at wala nang iba pa. Ang MinIO node ay dapat nasa ibang machine, mas mainam kung nasa ibang region. Ang restic backups sa isang VPS ay tumatalakay sa scheduling at retention bukod pa rito.
I-terminate ang TLS gamit ang nginx
Ang MinIO ay tumatakbo sa localhost, kaya ang nginx ang nagsisilbing public surface. I-issue muna ang certificate, gaya ng inilarawan sa Let's Encrypt certificates gamit ang certbot at nginx, pagkatapos ay gamitin ang server block na ito.
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;
}
}Ang ilan sa mga linyang iyan ay kritikal. Ang client_max_body_size 0 ay nagtatanggal ng default na 1 MB body limit, na kung hindi ay magreresulta sa pag-reject ng anumang mas malaking upload na may 413 Request Entity Too Large bago pa man makita ng MinIO ang request. Ang proxy_request_buffering off ay nag-i-stream ng upload nang direkta, dahil ang default ay ini-spool muna ang buong request sa isang temporary file, at ang malalaking object ay mangangailangan ng doble na disk space. Ang proxy_set_header Host $http_host ang mapanlinlang: ang S3 signature ay sumasaklaw sa Host header, kaya ang proxy na nag-re-rewrite nito ay magdudulot ng failure sa bawat request na may SignatureDoesNotMatch, habang ang access log ay nagpapakita ng normal na request na dumarating.
Ipaalam din sa MinIO ang public name nito, para ang mga link na ginagawa nito ay tumuturo sa proxy sa halip na sa localhost.
echo 'MINIO_SERVER_URL=https://s3.example.com' | sudo tee -a /etc/default/minio
sudo systemctl restart minioMananatiling maliit ang firewall. Payagan ang SSH at HTTPS, at huwag lagyan ng anumang rule ang port 9000 at 9001, dahil ang address na naka-bind sa 127.0.0.1 ay hindi maaabot mula sa ibang machine anuman ang sabihin ng firewall. Ang ufw firewall basics sa isang VPS ay naglalaman ng mga command.
Kapag sapat ang single-node MinIO, at kung kailan kailangan mo ng tunay na S3
Ang single node dito ay nangangahulugang isang drive lamang. Walang parity at walang pangalawang kopya sa loob ng deployment. Ang durability ng bawat object ay nakadepende sa durability ng disk ng isang VPS. Available bilang source sa minio/docs repository ang community documentation ng MinIO matapos alisin ang hosted community docs noong October 2025. Nakasaad sa server README nito na ang mga production environment na gumagamit ng mga binary na ni-compile mula sa source ay ginagamit sa sariling pananagutan. Maaaring i-on ang object locking para sa isang bucket, ngunit sa isang VPS, pinipigilan lamang nito ang deletion sa pamamagitan ng S3 API. Maaari pa ring alisin ng sinumang may root sa machine ang mga file sa disk. Kaya huwag mangako ng immutable retention policy para sa setup na ito.
Angkop ito bilang restic target sa pangalawang VPS sa ibang region, at bilang S3 endpoint para sa development work at CI artifacts, kung saan ang pagkawala ng bucket ay nangangahulugan lamang ng rebuild. Makatuwiran din ito para sa user uploads sa maliit na application, basta ikaw ang may-ari ng recovery plan at aktuwal mong nasubukan ang restore.
Pumili ng managed S3 kapag hinihingi ng kontrata o regulator ang object lock o multi-region durability. Piliin din ito kung ayaw mong ikaw ang ma-page sa 03:00 dahil napuno ang disk. Ang frozen codebase ay isa pang makatotohanang dahilan. Noong 20 October 2026, naka-archive na at hindi na maintained ang community edition. Ang huling release nito, RELEASE.2025-10-15T17-29-55Z, ang ginagamit ng guide na ito sa pag-compile. Wala nang aayusin pagkatapos nito. Kapag pinatakbo mo ito, tinatanggap mo ang kalagayang iyon. Maaari ka ring lumipat sa commercial AIStor line ng MinIO o sa ibang self-hosted store. Inihahambing ng mga alternatibo sa self-hosted MinIO ang mga opsyong ito.
Mahalagang linawin ang isang hangganan dahil madalas itong nagiging tanong. Ang object storage ay hindi database. Sa karaniwang bucket, pinapalitan ng bawat write ang buong object. Kahit ang append call na idinagdag ng Amazon para sa S3 Express One Zone ay nagdaragdag lamang ng data sa dulo. Dahil dito, mabagal at hindi ligtas ang live SQL file sa isang S3 bucket. Panatilihin ang database sa local disk at i-back up ito sa bucket: inilalarawan ng pagpapatakbo ng SQLite sa production sa VPS ang paghihiwalay na ito.
Mga failure mode at mga mensaheng makikita mo
Agad nagfa-fail ang unit pagkatapos ng systemctl enable --now. Basahin ang journalctl -u minio -n 30 --no-pager. Ibig sabihin ng Failed to load environment files: No such file or directory ay nawawala ang /etc/default/minio o mali ang spelling ng path nito sa unit. Kapag nagtatapos sa permission denied ang mensahe, hindi writable ng service account ang data directory, kaya tingnan kung nagpi-print ang stat -c '%U' /var/lib/minio/data ng minio-user.
Naka-login pa rin ang minioadmin:minioadmin. Hindi nakarating sa proseso ang environment file. Tiyaking naglalaman ang unit ng EnvironmentFile=/etc/default/minio, patakbuhin ang sudo systemctl daemon-reload, at pagkatapos ay i-restart ang service. Isang beses lang binabasa ng MinIO ang root credentials sa startup, kaya walang mababago kapag in-edit ang file nang hindi nagre-restart.
Address already in use sa startup. May ibang proseso na gumagamit ng port 9000. Hanapin ito gamit ang sudo ss -ltnp | grep :9000 bago baguhin ang port ng MinIO.
Nagfa-fail ang mga upload na lampas 1 MB kapag dumadaan sa proxy. Nagbalik ang nginx ng 413 Request Entity Too Large at hindi nakita ng MinIO ang request. Itakda ang client_max_body_size 0 sa server block.
SignatureDoesNotMatch. Maaaring mali ang secret key, o binago ng isang component sa pagitan ng client at MinIO ang Host header, na kasama sa signature.
RequestTimeTooSkewed. Mali ang oras sa client o server. May timestamp ang bawat signed S3 request, at tinatanggihan ng MinIO, gaya ng Amazon S3, ang header-signed request na mahigit 15 minuto ang layo ng timestamp sa sarili nitong clock. Sa halip, sinusuri ang presigned links batay sa expiry ng mga ito. Tingnan ang timedatectl at kumpirmahing aktibo ang time synchronisation.
Access Denied sa isang bucket na alam mong umiiral. Naka-scope ang key sa ibang bucket. I-print kung ano talaga ang pinapahintulutan ng policy gamit ang mc admin policy info local restic-rw at ihambing ang pangalan ng bucket sa mga resource line.
FAQ
Sapat na ba ang single-node MinIO para sa aktuwal na mga backup?
Sapat ito bilang restic target na tumatakbo sa ibang machine kaysa sa data na pinoprotektahan nito. Hindi ito sapat bilang nag-iisa mong kopya. Ang deployment na may iisang drive ay walang parity, kaya walang pangalawang kopya sa loob ng MinIO. Kung mawalan ng data ang disk ng VPS na iyon, mawawala ang mga object. Magpanatili ng pangalawang target sa ibang lokasyon, at magsagawa ng restore mula sa dalawang target nang kahit isang beses upang matiyak na gumagana ang proseso.
Bakit nagfa-fail ang sha256sum -c sa checksum file ng MinIO?
Ang lumang dl.min.io paths ay nagbalik ng 410 Gone para sa bawat community binary at checksum file na ginamit ng gabay na ito noong sinuri noong 20 October 2026. Ang label pagkatapos ng hash sa loob ng file na iyon ang tumutukoy sa release, gaya ng minio.RELEASE.2025-09-07T16-13-09Z, samantalang karaniwang minio ang pangalan ng na-download na file. Hinahanap ng sha256sum -c ang file na may pangalang nakasulat sa checksum file, ngunit hindi nito ito makita. Dahil dito, iniuulat nito ang No such file or directory at WARNING: 1 listed file could not be read. Maayos ang download. Direktang paghambingin ang mga hash string at huwag pansinin ang label, dahil wala itong kahulugang pangseguridad.
Saan napunta ang MinIO admin web console?
Inalis ng MinIO ang mga feature para sa administration mula sa console ng community edition noong May 2025. Naiwan ang object browser sa web interface. Pinamamahalaan na ngayon ang buckets at users gamit ang mc client, sa pamamagitan ng mga command gaya ng mc admin user add at mc admin policy attach. Ito ang itinakdang paraan sa community edition, hindi workaround. Kaya ginagawa ng gabay na ito ang lahat mula sa command line.
Paano ko ituturo ang restic sa MinIO bilang S3 backend?
Itakda ang AWS_ACCESS_KEY_ID at AWS_SECRET_ACCESS_KEY sa MinIO access key at katumbas nitong secret. Pagkatapos, gumamit ng repository string na may anyong s3:https://s3.example.com/restic, kung saan ang huling path element ang pangalan ng bucket. Gawin muna ang bucket gamit ang mc mb, dahil walang permission ang key na naka-scope sa isang bucket na gumawa ng bucket. Ine-encrypt ng restic ang lahat gamit ang sarili nitong repository password bago i-upload. Kaya ciphertext lamang ang iniimbak ng MinIO at hindi nito nakikita ang iyong mga file.
Kailangan ko bang patakbuhin ang MinIO sa likod ng nginx?
Kailangan mo ng TLS (transport layer security) kapag wala sa parehong machine ang client, dahil kung wala nito, dumadaan sa network nang plain text ang bawat object, pati ang access key ID at request signature. Hindi umaalis sa client ang secret key mismo, dahil ginagamit lamang ito ng S3 signing nang lokal upang kalkulahin ang signature. Gayunman, mababasa pa rin ng sinumang nasa pagitan ng network path ang iyong data at maaaring i-replay ang nakuhang request habang valid ang timestamp nito. Ang proxy sa port 443 na may certificate mula sa certbot ang pinakasimpleng paraan para magkaroon ng TLS. Inilalayo rin nito sa MinIO ang certificate renewal. Maaari ring ang MinIO mismo ang mag-terminate ng TLS kung ituturo mo ang --certs-dir sa directory na naglalaman ng public.crt at private.key. Gayunman, kailangang magkaroon ng read access ang service account sa na-renew na private key. Dagdag na trabaho ito para sa parehong resulta.