Ubuntu 24.04 वर MinIO कसे सेटअप करावे
Ubuntu 24.04 VPS वर MinIO इन्स्टॉल करण्यासाठी पूर्ण मार्गदर्शक. यामध्ये source build, systemd configuration, mc कमांड्स आणि restic बॅकअप सेटअपची सविस्तर माहिती दिली आहे.
MinIO मुळे तुम्हाला self-hosted object storage कशा प्रकारे मिळते
MinIO हे Amazon S3 API शी संवाद साधणारे self-hosted object storage आहे. तुमच्या स्वतःच्या server कडे restic किंवा S3 SDK निर्देशित करा, endpoint ची एक setting बदला आणि रोजच्या object reads, writes, listings आणि presigned links साठी एवढेच पुरेसे असते. मात्र compatible म्हणजे identical नाही. उदाहरणार्थ, MinIO Amazon चे object ACLs लागू करत नाही. त्यामुळे ACL च्या वर्तनावर अवलंबून असलेल्या application साठी फक्त नवीन endpoint पुरेसा नसतो. या मार्गदर्शकात Ubuntu 24.04 वर single node तयार केला आहे: verified source मधून compiled binary, dedicated system user, root credentials unit file मध्ये न ठेवणारी systemd unit आणि restic ज्यामध्ये backup घेते असा bucket.
S3 (simple storage service) हे filesystem ऐवजी HTTP API आहे. तुम्ही एखादा object key अंतर्गत bucket मध्ये PUT करता आणि तो पुन्हा GET करता. Standard bucket मध्ये partial write किंवा rename नसते. Amazon चे S3 Express One Zone directory buckets याला अपवाद आहेत. त्यांच्यासाठी append आणि rename calls स्वतंत्रपणे उपलब्ध आहेत. मात्र ते एक storage class आहे आणि या मार्गदर्शकातील कोणतीही गोष्ट त्यावर अवलंबून नाही. Backup tools standard model पसंत करतात, कारण object पूर्णपणे पोहोचला किंवा पोहोचलाच नाही, अशी स्पष्ट स्थिती असते.
एका node वर तुमच्या डेटाची एकच copy असते. तुम्ही स्वीकारत असलेला हा trade-off आहे. VPS च्या किमतीत तुम्हाला नियंत्रित करता येणारा S3 endpoint मिळतो. त्याचबरोबर cloud provider करत असलेली प्रत्येक जबाबदारीही तुमच्यावर येते. त्यात failed disk बदलणे आणि server software patch करणे यांचा समावेश होतो. हा trade-off कधी योग्य ठरतो, हे शेवटच्या भागाजवळ स्पष्टपणे सांगितले आहे.
MinIO community edition ची October 2026 मधील स्थिती
यावर आधारित रचना करण्यापूर्वी हा भाग वाचा, कारण त्यात अलीकडे बदल झाला आहे. May 2025 मध्ये MinIO ने community edition मधील web console मधून administration features काढून टाकली. Browser मध्ये आता object browser उरला आहे. त्यामुळे buckets आणि access keys यांचे व्यवस्थापन त्याऐवजी mc command line client वापरून करावे लागते.
2025 मध्ये नंतर MinIO ने pre-compiled community binaries प्रकाशित करणे थांबवले. Project README नुसार community edition आता केवळ source code म्हणून वितरित केली जाते. तसेच April 2026 पासून minio/minio repository THIS REPOSITORY IS NO LONGER MAINTAINED या सूचनेखाली archived आहे. जुन्या download server नेही community files देणे थांबवले आहे. 20 October 2026 रोजी केलेल्या तपासणीत, या मार्गदर्शकाने पूर्वी download करण्यासाठी वापरलेले प्रत्येक dl.min.io path — server binary, client binary आणि त्यांच्या checksum files — 410 Gone उत्तर देत होते. हे outage नसून जाणीवपूर्वक केलेले removal आहे. AIStor CLI reference आता /aistor/mc/release/ अंतर्गत असलेल्या AIStor Client कडे निर्देश करते. हे commercial line चा भाग आहे. min.io वरील download page आता AIStor Server, AIStor Client, AIStor SDK आणि काही AIStor add-ons दाखवते. त्यावर दोन महिन्यांच्या AIStor trial ची जाहिरातही आहे. Pricing page वर standalone deployments चालवणाऱ्या developers, researchers आणि छोट्या organisations साठी मोफत AIStor tier अजूनही सूचीबद्ध आहे.
Source code अजून उपलब्ध आहे आणि तो शेवटच्या binary पेक्षा नवीन आहे. अंतिम community release RELEASE.2025-10-15T17-29-55Z आहे. ती 16 October 2025 रोजी security release म्हणून प्रकाशित झाली. या release मध्ये service accounts आणि STS मधील session policy bypass द्वारे होणारी privilege escalation दुरुस्त केली आहे. Release notes मध्ये सर्व users ना तात्काळ upgrade करण्याचा सल्ला दिला आहे. शेवटची pre-compiled binary September 2025 ची build होती. त्यामुळे तिला हा fix मिळाला नाही. हा मार्गदर्शक October release compile करतो. Repository archived असल्यामुळे community edition ला मिळणारा हा शेवटचा fix देखील आहे.
या एका वस्तुस्थितीचा या मार्गदर्शकाच्या उर्वरित भागावर परिणाम होतो. म्हणूनच येथे MinIO 127.0.0.1 वर listen करते आणि तुमच्या नियंत्रणाखालील proxy मार्फतच internet पर्यंत पोहोचते.
MinIO binary स्थापित करा आणि डाउनलोडची पडताळणी करा
MinIO Go मध्ये लिहिलेले आहे. Vendor README मध्ये ते एकाच go install command ने build केले जाते. यासाठी Go 1.24 किंवा त्यानंतरची आवृत्ती आवश्यक आहे. प्रथम अधिकृत tarball मधून Go स्थापित करा. 11 November 2026 रोजी go.dev/dl वरील सध्याची stable release go1.27.4 आहे. ती 10 November 2026 रोजी प्रसिद्ध झाली असून cgo, Go command, compiler, linker आणि net/http package साठी security fixes समाविष्ट करते. खालील hash linux-amd64 archive साठी त्या पृष्ठावर प्रकाशित केलेला आहे. तुम्ही Go ची त्यापेक्षा नवीन आवृत्ती निवडल्यास, त्याच पृष्ठावरून तिचा hash घ्या. -f flag मुळे HTTP error आल्यास curl error page जतन न करता fail होते. अन्यथा मागितलेल्या नावाने 404 page जतन होऊ शकते आणि ते archive का नाही याचा प्रश्न निर्माण होतो.
cd /tmp
GOVER=go1.27.4
curl -fsSL "https://go.dev/dl/$GOVER.linux-amd64.tar.gz" -o go.tar.gzदोन्ही hashes ची तुलना करा. फक्त hashes चीच तुलना करा.
published=7226736c2339719cda28fbf3a54d71aa63bcefe376e98cef00034268dab24840
downloaded=$(sha256sum go.tar.gz | awk '{print $1}')
[ "$published" = "$downloaded" ] && echo "checksum ok"ही तपासणी नेमके काय सिद्ध करते हे स्पष्ट समजा. Hash जुळल्यास डाउनलोड पूर्ण झाले आहे आणि transfer दरम्यान ते खराब किंवा बदलले गेलेले नाही, हे सिद्ध होते. यावरून vendor विश्वासार्ह आहे, हे सिद्ध होत नाही. तो वेगळा विषय आहे. कोणतेही sha256sum command तो सोडवत नाही.
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go.tar.gz
export PATH=$PATH:/usr/local/go/bin
go versionआता तुमचा नेहमीचा user वापरून अंतिम community release build करा. go install डाउनलोड केलेल्या प्रत्येक module ची, MinIO च्या स्वतःच्या source सहित, Go च्या public checksum database sum.golang.org विरुद्ध पडताळणी करते. त्यामुळे tampered किंवा बदललेला module आढळल्यास binary तयार करण्याऐवजी build security error सह थांबते.
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ज्या ठिकाणी पूर्वी release name दिसत असे, तेथे minio --version DEVELOPMENT.GOGET दाखवते. याचे कारण go install vendor ने स्वतःच्या binaries वर वापरलेले build flags लागू करत नाही. go version -m प्रत्येक binary मध्ये Go ने embed केलेली module information वाचते. तिची mod github.com/minio/minio line तुम्ही build केलेला commit दर्शवते. येथे Permission denied दिसल्यास mode चुकीचा आहे. command not found दिसल्यास /usr/local/bin तुमच्या PATH वर उपलब्ध नाही. Compile साठी VPS कडे पुरेशी memory नसल्यास, त्याच architecture च्या दुसऱ्या Linux machine वर तेच go install चालवा आणि binary तिकडे copy करा.
system user आणि data directory तयार करा
MinIO नेटवर्कवरून upload स्वीकारते, त्यामुळे ते root म्हणून चालवू नका. त्याला home directory आणि login shell नसलेले account द्या.
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 हे UID 1000 पेक्षा कमी असलेले system account तयार करते. त्यामुळे ते वापरकर्त्यांसाठी राखीव श्रेणीबाहेर राहते. -M home directory तयार करणे वगळते, कारण login न करणाऱ्या account ला home directory ठेवण्याची गरज नसते. id minio-user वापरून निकाल तपासा. stat -c '%U %a' /var/lib/minio देखील वापरा. त्यातून minio-user 750 दिसले पाहिजे.
data directory त्या user साठी writable असली पाहिजे; केवळ readable असणे पुरेसे नाही. पहिल्यांदा सुरू झाल्यावर MinIO volume मध्ये स्वतःची configuration ठेवण्यासाठी .minio.sys directory तयार करते. त्यामुळे root-owned directory असल्यास MinIO startup दरम्यान permission denied ने समाप्त होणारा संदेश दाखवून बंद होते. अशा प्रकारे चालवलेल्या प्रत्येक service साठी हाच नियम लागू होतो. VPS वरील least-privilege service users मध्ये याचे योग्य स्पष्टीकरण दिले आहे.
root क्रेडेन्शियल्स environment फाइलमध्ये ठेवा
root क्रेडेन्शियल्समुळे प्रत्येक bucket उघडता येतो. त्यामुळे ती unit file मध्ये ठेवू नका, कारण ती सर्व वापरकर्त्यांना वाचता येते. प्रथम योग्य mode सह फाइल तयार करा आणि त्यानंतरच त्यात लिहा. त्यामुळे password अगदी क्षणभरासाठीसुद्धा वाचता येणाऱ्या फाइलमध्ये राहणार नाही.
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/miniotee विद्यमान फाइल नव्याने तयार करण्याऐवजी ती truncate करते. त्यामुळे mode 600 आणि मालक root कायम राहतो. हे जाणीवपूर्वक केले आहे. systemd विशेषाधिकार User= कडे कमी करण्यापूर्वी root म्हणून EnvironmentFile वाचते. त्यामुळे service account ला स्वतःचे क्रेडेन्शियल्स वाचण्याची गरज पडत नाही. सेवा सुरू झाल्यानंतर sudo -u minio-user cat /etc/default/minio वापरून याची पडताळणी करा. त्या command ने Permission denied मुद्रित केले पाहिजे.
सेवा सुरू करण्यापूर्वी MinIO च्या दोन वर्तनांची माहिती असणे उपयुक्त आहे. त्याच्या environment मध्ये MINIO_ROOT_USER आणि MINIO_ROOT_PASSWORD नसल्यास MinIO सुरू होण्यास नकार देत नाही. ते दस्तऐवजीकृत default credentials minioadmin:minioadmin सह सुरू होते. कोणताही scanner प्रथम हीच जोडी वापरून पाहतो. असे असतानाही MinIO पूर्णपणे निरोगी असल्यासारखे दिसते. त्याऐवजी 8 characters पेक्षा लहान password नाकारला जातो. MinIO startup वेळी credentials अवैध असल्याचे error देऊन बंद होते, कारण access key मध्ये किमान 3 characters आणि secret key मध्ये किमान 8 characters आवश्यक असतात.
MINIO_VOLUMES हा data path आहे आणि MINIO_OPTS मध्ये flags असतात. 127.0.0.1 शी bind केल्यामुळे या VPS च्या बाहेरून कोणीही अद्याप S3 API पर्यंत पोहोचू शकत नाही. हा योग्य default आहे. नंतर certificate धारण करणाऱ्या proxy मार्फत ते जाणीवपूर्वक उघडा.
systemd unit लिहा
/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.targetEnvironmentFile वर सुरुवातीला - नाही आणि हा टायपो नसून जाणीवपूर्वक घेतलेला निर्णय आहे. डॅश असल्यास, एखादी फाइल उपलब्ध नसली तरी systemd ती दुर्लक्षित करून MinIO सुरू करते. त्यामुळे हटवलेली फाइल किंवा चुकीचा path यामुळे minioadmin:minioadmin वर चालणारा server कोणतीही सूचना न देता उपलब्ध होतो. डॅश नसल्यास, फाइल उपलब्ध नसताना MinIO सुरू होण्यापूर्वीच unit fail होते आणि journalctl -u minio मध्ये Failed to load environment files: No such file or directory दिसते. शांतपणे default password स्वीकारणाऱ्या server पेक्षा सुरू होण्यास नकार देणारी unit लक्षात येणे खूप सोपे असते.
$MINIO_VOLUMES आणि $MINIO_OPTS यांना मुद्दाम quotes दिलेल्या नाहीत, कारण systemd unquoted variables मधील whitespace नुसार त्यांना स्वतंत्र arguments मध्ये विभागते. त्यामुळे MINIO_OPTS मधील चार शब्द minio server साठी चार arguments बनतात. MinIO startup वेळी soft file descriptor limit inherited hard limit पर्यंत वाढवते. systemd चे default मूल्य soft साठी 1024 आणि hard साठी 524288 आहे. त्यामुळे LimitNOFILE=65536 सेट केल्यास MinIO ची effective limit 65536 पर्यंत कमी होईल. या unit मध्ये तो override दिलेला नाही.
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/liveis-active ने active दाखवले पाहिजे आणि health endpoint ने 200 उत्तर दिले पाहिजे. journalctl -u minio -n 20 --no-pager मध्ये server ज्या API address वर listening करत आहे तो दाखवला जातो. Unit वारंवार restart होत असल्यास, प्रत्येक restart पूर्वीचा error journal मध्ये वाचा. RestartSec=5 असल्यामुळे वारंवार होणारे exits systemd च्या default start limit पेक्षा जास्त होत नाहीत. ही limit दहा सेकंदांत पाच starts इतकी आहे, त्यामुळे unit retry करत राहते. Start request repeated too quickly याचा अर्थ configured start-rate limit गाठली आहे.
अधिक isolation हवे असल्यास [Service] विभागात ProtectSystem=full आणि ProtectHome=true जोडा. दोन्हींना host kernel कडून mount namespaces आवश्यक असतात. OpenVZ किंवा LXC सारख्या host kernel share करणाऱ्या container virtualisation मध्ये ते fail होऊ शकतात. अशा वेळी unit status=226/NAMESPACE दाखवते. त्या दोन lines काढल्यावर ती सुरू होते. ही unit स्वतः एक सामान्य unit आहे. उर्वरित directives साठी VPS वरील systemd services आणि timers पहा.
mc स्थापित करा आणि round trip सिद्ध करा
MinIO client म्हणजे mc. ते apt install mc वापरून स्थापित करू नका. ते पॅकेज Midnight Commander या MinIO शी असंबंधित file manager साठी आहे.
जुना community मार्ग https://dl.min.io/client/mc/release/linux-amd64/mc, 410 Gone कडे निर्देश करतो. AIStor CLI reference आता https://dl.min.io/aistor/mc/release/linux-amd64/mc येथील AIStor Client कडे निर्देश करते आणि licensed AIStor Server deployments साठी त्यात exclusive functionality असल्याचे सांगते. त्या reference मध्ये community server विरुद्ध ते वापरण्याबद्दल काहीही सांगितलेले नाही. त्यामुळे या मार्गदर्शकात community client वापरला आहे. minio/mc repository July 2026 पासून archived आहे. त्यामुळे त्यातील शेवटचे release RELEASE.2025-08-13T08-35-41Z, याच Go toolchain वापरून build करा. Checksum database या download साठीही उपलब्ध आहे.
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/mcServer ची alias म्हणून नोंदणी करा. त्यानंतर त्यामधून एक object हलवा.
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.txtmc ls ने hello.txt त्याच्या size सह दाखवले पाहिजे. mc cat ने hello object storage print केले पाहिजे. हा round trip server कार्यरत असल्याचा वास्तविक पुरावा आहे, कारण त्यातून इतर प्रत्येक client पाठवेल त्याच signed S3 requests पाठवल्या जातात. दुसरे मत हवे असल्यास mc admin info local server status दाखवते.
Machine अजून रिकामी असताना, आता आणखी एक तपासणी करा.
mc alias set defaultcheck http://127.0.0.1:9000 minioadmin minioadminही command fail झाली पाहिजे. ती यशस्वी झाली, तर environment file process पर्यंत पोहोचलेली नाही आणि तुमचा server default credentials वर चालू आहे. Machine वर इतर कोणतीही प्रक्रिया सुरू होण्यापूर्वी हे दुरुस्त करा.
mc aliases साध्या text स्वरूपात ~/.mc/config.json मध्ये साठवते. त्यामुळे ही credentials command चालवणाऱ्या व्यक्तीच्या home directory मध्ये राहतात. mc ही command sudo अंतर्गत चालवल्यास root credentials /root/.mc/config.json मध्ये साठवली जातात. root alias एका administrator account पुरती ठेवा आणि प्रत्येक application ला स्वतःची key द्या.
एका ऑब्जेक्टसाठी presigned URL देणे
Presigned URL ही एक सामान्य HTTPS लिंक असते, ज्याला एक स्वाक्षरी (signature) आणि कालबाह्यता (expiry) जोडलेली असते. ज्याच्याकडे ही लिंक आहे, तो व्यक्ती कोणत्याही खात्याशिवाय किंवा क्लायंटशिवाय ते एक ऑब्जेक्ट मिळवू शकतो.
mc share download --expire 12h local/backups/hello.txtआउटपुटमध्ये क्वेरी स्ट्रिंगमध्ये X-Amz-Signature आणि X-Amz-Expires समाविष्ट असतात. याबद्दल दोन गोष्टी लोकांना आश्चर्यचकित करतात. ही लिंक तुम्ही वापरलेल्या अलियासमधील एंडपॉईंटवरून तयार केली जाते, त्यामुळे 127.0.0.1 वरील अलियास अशी लिंक तयार करतो जी फक्त हे मशीन उघडू शकते: ज्या लिंक्स तुम्हाला इतरांना पाठवायच्या आहेत, त्यांच्यासाठी तुमच्या पब्लिक होस्टनेमवर दुसरा अलियास तयार करा. तसेच, प्रत्येक लिंकसाठी स्वतंत्रपणे रद्द (revoke) करण्याचे बटण नसते. स्वाक्षरी कालबाह्य होईपर्यंत किंवा ज्या की (key) ने ती स्वाक्षरी केली आहे ती काढून टाकेपर्यंत किंवा बदलेपर्यंत ती वैध राहते. रूट क्रेडेंशियल्सने स्वाक्षरी केलेल्या लिंकसाठी याचा अर्थ ते क्रेडेंशियल्स बदलणे असा होतो, त्यामुळे कमी कालावधीची एक्सपायरी ठेवणे हाच व्यावहारिक उपाय आहे. S3 स्वाक्षरी फॉरमॅटनुसार सात दिवस हा कमाल कालावधी आहे.
restic साठी स्वतंत्र key आणि bucket द्या
root credentials प्रत्येक bucket वाचू आणि हटवू शकतात. त्यामुळे backup job मध्ये त्यांचा वापर करू नका. एक bucket, त्या bucketपुरती मर्यादित policy आणि इतर कोणतेही अधिकार नसलेला user तयार करा.
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-backupMinIO मध्ये अंगभूत readwrite policy उपलब्ध आहे. तिच्यामुळे एक command कमी लागली असती, पण ती server वरील प्रत्येक bucket ला पूर्ण प्रवेश देते. वरील policy मध्ये bucket चे नाव जाणीवपूर्वक दोनदा दिले आहे: bucket ची listing कार्यरत राहण्यासाठी एकदा arn:aws:s3:::restic म्हणून आणि त्यातील objects साठी एकदा arn:aws:s3:::restic/* म्हणून. S3 मध्ये bucket आणि त्यातील objects ही स्वतंत्र resources आहेत. त्यामुळे त्यांपैकी केवळ एकाचे नाव असलेली policy client मध्ये बिघाड असल्यासारखी दिसणारी त्रुटी निर्माण करते.
या मर्यादेवर विश्वास ठेवण्यापूर्वी तिची चाचणी घ्या.
mc alias set resticuser http://127.0.0.1:9000 restic-backup "$RESTIC_KEY"
mc ls resticuser/restic
mc ls resticuser/backupsपहिला ls यशस्वी होतो आणि दुसरा Access Denied सह अयशस्वी होतो. ज्या policy ची चाचणी केलेली नाही, ती केवळ अंदाज असते.
आता restic ला bucket कडे निर्देशित करा. restic S3 credentials प्रमाणित AWS environment variables मधून वाचतो. त्यामुळे restic-specific credential file आवश्यक नाही.
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 snapshotsrestic init repository password विचारतो. हा password repository encrypt करतो. त्यामुळे MinIO कडे केवळ ciphertext साठवला जातो आणि password हरवल्यास backup गमावला जातो. systemd timer ने सुरू केलेल्या run कडे input देण्यासाठी terminal नसतो. त्यामुळे scheduled backups साठी RESTIC_PASSWORD_FILE ला mode 600 असलेल्या file कडे सेट करा.
वरील कोणत्याही command पेक्षा placement चा एक नियम अधिक महत्त्वाचा आहे. संरक्षित करत असलेल्या data प्रमाणेच त्याच VPS वर restic repository ठेवल्यास खराब rm पासूनच संरक्षण मिळते; इतर कोणत्याही समस्येपासून नाही. MinIO node वेगळ्या machine वर असावा आणि शक्य असल्यास वेगळ्या region मध्ये असावा. VPS वरील restic backups यावर आधारित scheduling आणि retention समाविष्ट करते.
nginx सह TLS समाप्त करा
MinIO localhost वर चालत असल्यामुळे nginx हा सार्वजनिक प्रवेशबिंदू आहे. certbot आणि nginx सह Let's Encrypt प्रमाणपत्रे मध्ये सांगितल्याप्रमाणे प्रथम प्रमाणपत्र जारी करा. त्यानंतर हा server block वापरा.
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;
}
}या ओळींपैकी अनेक ओळी आवश्यक आहेत. client_max_body_size 0 हे default 1 MB body limit काढून टाकते. अन्यथा MinIO ला विनंती मिळण्यापूर्वीच 413 Request Entity Too Large मुळे त्यापेक्षा मोठे upload नाकारले जातात. proxy_request_buffering off upload थेट पुढे पाठवते. कारण default पद्धत संपूर्ण request आधी temporary file मध्ये साठवते. त्यामुळे मोठ्या object साठी disk space दुप्पट लागते. proxy_set_header Host $http_host ही सूक्ष्म बाब आहे. S3 signature मध्ये Host header समाविष्ट असतो. त्यामुळे proxy ने तो पुन्हा लिहिल्यास प्रत्येक request SignatureDoesNotMatch सह अयशस्वी होते, जरी access log मध्ये सामान्य request आल्याचे दिसत असले तरी.
MinIO ला त्याचे public name देखील सांगा. त्यामुळे त्याने तयार केलेल्या links localhost ऐवजी proxy कडे निर्देश करतील.
echo 'MINIO_SERVER_URL=https://s3.example.com' | sudo tee -a /etc/default/minio
sudo systemctl restart minioFirewall configuration लहान ठेवा. SSH आणि HTTPS ला परवानगी द्या. ports 9000 आणि 9001 साठी कोणताही rule ठेवू नका. कारण 127.0.0.1 शी bind केलेला address firewall काहीही सांगत असला तरी दुसऱ्या machine वरून पोहोचण्यायोग्य नसतो. VPS वरील ufw firewall ची मूलतत्त्वे येथे commands दिले आहेत.
Single-node MinIO कधी पुरेसे असते आणि खरे S3 कधी निवडावे
येथे single node म्हणजे एकच drive. त्यामुळे deployment मध्ये parity किंवा दुसरी copy नसते. प्रत्येक object ची durability ही एका VPS disk च्या durabilityएवढीच असते. MinIO चे community documentation hosted community docs ऑक्टोबर 2025 मध्ये काढून टाकल्यानंतर minio/docs repository मध्ये source स्वरूपात उपलब्ध आहे. त्याच्या server README नुसार source मधून compile केलेल्या binaries वापरणाऱ्या production environments ची जोखीम वापरणाऱ्याची स्वतःची असते. Bucket साठी object locking सुरू करता येते. पण एका VPS वर ते फक्त S3 API द्वारे होणारी deletion थांबवते. मशीनवर root access असलेली व्यक्ती disk वरील files तरीही काढू शकते. त्यामुळे या setup साठी कोणालाही immutable retention policy चे आश्वासन देऊ नका.
दुसऱ्या region मधील दुसऱ्या VPS वर restic target म्हणून आणि development कामासाठी तसेच CI artifacts साठी S3 endpoint म्हणून हे योग्य ठरते. अशा वेळी bucket हरवल्यास फक्त rebuild करावा लागतो आणि त्यापेक्षा मोठे नुकसान होत नाही. लहान application मधील user uploads साठीही हे योग्य असू शकते. मात्र recovery plan तुमच्या नियंत्रणात असावा आणि restore प्रत्यक्षात तपासलेला असावा.
Contract किंवा regulator object lock अथवा multi-region durability मागत असल्यास managed S3 निवडा. Disk भरल्यामुळे 03:00 वाजता तुम्हालाच page मिळू नये असे वाटत असल्यासही managed S3 निवडा. Frozen code हे देखील महत्त्वाचे आणि स्पष्ट कारण आहे. 20 October 2026 रोजी community edition archived असून तिचे maintenance आता केले जात नाही. तिचे शेवटचे release RELEASE.2025-10-15T17-29-55Z आहे आणि हे guide तेच compile करते. यानंतर कोणतीही समस्या दुरुस्त केली जाणार नाही. त्यामुळे ते चालवणे म्हणजे ही अट स्वीकारणे. किंवा MinIO च्या commercial AIStor line कडे, अथवा दुसऱ्या self-hosted store कडे स्थलांतर करणे. self-hosted MinIO चे पर्याय यांची तुलना करते.
एक मर्यादा स्पष्ट करणे आवश्यक आहे, कारण हा मुद्दा वारंवार उपस्थित होतो. Object storage हा database नाही. Standard bucket मध्ये प्रत्येक write पूर्ण object replace करते. Amazon ने S3 Express One Zone साठी जोडलेल्या append call मुळेही फक्त object च्या शेवटी data जोडला जातो. त्यामुळे S3 bucket वरील live SQL file धीमी आणि असुरक्षित असते. Database local disk वर ठेवा आणि त्याचा backup bucket मध्ये घ्या: production मध्ये VPS वर SQLite चालवणे या विभाजनाचे वर्णन करते.
अपयशाचे प्रकार आणि तुम्हाला दिसणारे संदेश
systemctl enable --now नंतर युनिट लगेच बंद पडते. journalctl -u minio -n 30 --no-pager वाचा. Failed to load environment files: No such file or directory चा अर्थ असा की /etc/default/minio गहाळ आहे किंवा युनिटमध्ये त्याचा पाथ चुकीचा लिहिला आहे. permission denied ने संपणाऱ्या संदेशाचा अर्थ असा की सर्व्हिस अकाउंटला डेटा डिरेक्टरीमध्ये लिहिण्याची परवानगी नाही, म्हणून stat -c '%U' /var/lib/minio/data कमांड minio-user आउटपुट देते का ते तपासा.
minioadmin:minioadmin अजूनही लॉग इन होत आहे. एन्व्हायरनमेंट फाईल प्रोसेसपर्यंत पोहोचलीच नाही. युनिटमध्ये EnvironmentFile=/etc/default/minio समाविष्ट असल्याची खात्री करा, sudo systemctl daemon-reload रन करा आणि त्यानंतर सर्व्हिस रीस्टार्ट करा. MinIO त्याचे रूट क्रेडेंशियल्स फक्त स्टार्टअपच्या वेळी वाचते, त्यामुळे रीस्टार्ट न करता ती फाईल बदलल्यास काहीही फरक पडत नाही.
स्टार्टअपच्या वेळी Address already in use. दुसरी एखादी प्रोसेस 9000 पोर्ट वापरत आहे. MinIO चे पोर्ट बदलण्यापूर्वी sudo ss -ltnp | grep :9000 वापरून ती प्रोसेस शोधा.
प्रॉक्सीद्वारे 1 MB पेक्षा जास्त आकाराच्या फाईल्स अपलोड होत नाहीत. nginx ने 413 Request Entity Too Large उत्तर दिले आणि MinIO ला ती विनंती मिळालीच नाही. सर्व्हर ब्लॉक मध्ये client_max_body_size 0 सेट करा.
SignatureDoesNotMatch. एकतर सिक्रेट की चुकीची आहे, किंवा क्लायंट आणि MinIO च्या दरम्यान असलेल्या एखाद्या घटकाने Host हेडर बदलले आहे, ज्यावर सिग्नेचर अवलंबून असते.
RequestTimeTooSkewed. क्लायंट किंवा सर्व्हरवरील घड्याळाची वेळ चुकीची आहे. प्रत्येक साईन केलेल्या S3 विनंतीमध्ये एक टाइमस्टॅम्प असतो आणि MinIO, Amazon S3 प्रमाणेच, अशा हेडर-साईन विनंतीला नाकारते ज्याचा टाइमस्टॅम्प त्याच्या स्वतःच्या वेळेपेक्षा 15 मिनिटांपेक्षा जास्त फरकावर असतो. प्री-साईन लिंक्सची तपासणी त्यांच्या एक्सपायरी वेळेनुसार केली जाते. timedatectl तपासा आणि टाइम सिंक्रोनाइझेशन सक्रिय असल्याची खात्री करा.
तुम्हाला माहित असलेल्या बकेटवर Access Denied. की (key) दुसऱ्या बकेटसाठी मर्यादित आहे. पॉलिसी प्रत्यक्षात काय परवानगी देते हे पाहण्यासाठी mc admin policy info local restic-rw रन करा आणि रिसोर्स लाईन्स मधील बकेटच्या नावाची तुलना करा.
FAQ
वास्तविक बॅकअपसाठी single-node MinIO पुरेसे आहे का?
संरक्षित करत असलेल्या डेटापासून वेगळ्या मशीनवर चालणारे restic target म्हणून ते पुरेसे आहे. मात्र ते तुमची एकमेव प्रत असू नये. single-drive deployment मध्ये parity शून्य असते. त्यामुळे MinIO मध्ये दुसरी अंतर्गत प्रत नसते. त्या VPS च्या डिस्कवरील डेटा नष्ट झाल्यास objects देखील नष्ट होतात. दुसरे target दुसऱ्या ठिकाणी ठेवा. प्रक्रिया कार्यरत आहे याची खात्री करण्यासाठी किमान एकदा दोन्ही target मधून restore करून पाहा.
sha256sum -c MinIO मधील checksum file वर का अपयशी ठरते?
या मार्गदर्शकात वापरलेल्या प्रत्येक community binary आणि checksum file साठी, तपासणी 20 October 2026 रोजी केली तेव्हा जुन्या dl.min.io paths ने 410 Gone ला उत्तर दिले. त्या file मधील hash नंतरचे label release चे नाव दर्शवते, जसे minio.RELEASE.2025-09-07T16-13-09Z. मात्र डाउनलोड केलेल्या file चे सामान्य नाव minio असते. sha256sum -c checksum file मध्ये लिहिलेले नाव असलेली file शोधते. ती सापडत नाही. त्यामुळे No such file or directory आणि WARNING: 1 listed file could not be read असा अहवाल मिळतो. Download योग्य आहे. Hash strings थेट तुलना करा आणि label कडे दुर्लक्ष करा. त्याला कोणताही security अर्थ नाही.
MinIO admin web console कुठे गेले?
May 2025 मध्ये MinIO ने community edition console मधून administration features काढून टाकली. Web interface मध्ये फक्त object browser ठेवण्यात आला. आता buckets आणि users चे व्यवस्थापन mc client द्वारे केले जाते. त्यासाठी mc admin user add आणि mc admin policy attach यांसारखे commands वापरा. हा community edition मधील अपेक्षित मार्ग आहे; workaround नाही. म्हणून या मार्गदर्शकात सर्व काम command line वरून केले आहे.
MinIO ला S3 backend म्हणून restic कडे कसे निर्देशित करायचे?
AWS_ACCESS_KEY_ID आणि AWS_SECRET_ACCESS_KEY मध्ये MinIO access key आणि त्याचा secret सेट करा. त्यानंतर s3:https://s3.example.com/restic या स्वरूपातील repository string वापरा. त्यातील शेवटचा path element bucket चे नाव असतो. प्रथम mc mb वापरून bucket तयार करा. एका bucket साठी मर्यादित केलेल्या key ला buckets तयार करण्याची परवानगी नसते. Upload करण्यापूर्वी restic स्वतःच्या repository password ने सर्व डेटा encrypt करते. त्यामुळे MinIO मध्ये ciphertext साठवला जातो आणि तुमच्या files त्याला कधीही दिसत नाहीत.
MinIO nginx च्या मागे चालवणे आवश्यक आहे का?
Client त्याच मशीनवर नसल्यास TLS (transport layer security) आवश्यक आहे. TLS नसल्यास प्रत्येक object access key ID आणि request signature सह network वर plain text मध्ये पाठवला जातो. Secret key स्वतः client च्या बाहेर कधीही जात नाही. S3 signing त्या key चा वापर फक्त client वर locally करून signature compute करते. मात्र मार्गातील कोणतीही व्यक्ती तुमचा डेटा वाचू शकते आणि timestamp valid असेपर्यंत captured request पुन्हा वापरू शकते. Port 443 वर certbot कडून मिळालेल्या certificate सह proxy वापरणे TLS मिळवण्याचा सर्वात सोपा मार्ग आहे. यामुळे certificate renewal चे काम MinIO पासून वेगळे राहते. --certs-dir ला public.crt आणि private.key असलेली directory दाखवून MinIO स्वतःही TLS terminate करू शकते. मात्र renewal झालेल्या private key साठी service account ला read access द्यावा लागतो. त्याच परिणामासाठी हे अतिरिक्त काम आहे.