Ubuntu 24.04 پر MinIO سیٹ اپ کرنے کا مکمل طریقہ
Ubuntu 24.04 پر MinIO کو بطور self-hosted S3 اسٹوریج انسٹال کریں۔ اس گائیڈ میں سورس بلڈ، systemd سروس کنفیگریشن، mc کمانڈ لائن کے استعمال اور restic بیک اپ کا طریقہ شامل ہے۔
MinIO کے ساتھ self-hosted object storage سے آپ کو کیا ملتا ہے
MinIO، self-hosted object storage ہے جو Amazon S3 API کے ساتھ کام کرتا ہے۔ اپنے server کی طرف restic یا کسی S3 SDK کو متوجہ کریں، endpoint کی ایک setting تبدیل کریں، اور روزمرہ object reads، writes، listings اور presigned links کے لیے اتنا ہی کافی ہوتا ہے۔ تاہم compatible ہونے کا مطلب identical ہونا نہیں ہے۔ مثال کے طور پر MinIO، Amazon کے object ACLs نافذ نہیں کرتا۔ اس لیے ACL کے رویے پر منحصر application کو صرف نیا endpoint دینے سے زیادہ configuration درکار ہوگی۔ اس guide میں Ubuntu 24.04 پر single node بنایا گیا ہے: verified source سے compiled binary، dedicated system user، ایسا systemd unit جو root credentials کو unit file سے باہر رکھتا ہے، اور ایسا bucket جس میں restic backups محفوظ کرتا ہے۔
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 ہے اور اس guide میں اس پر انحصار نہیں کیا گیا۔ Backup tools standard model کو پسند کرتے ہیں، کیونکہ object یا تو مکمل طور پر پہنچتا ہے یا بالکل نہیں پہنچتا۔
ایک node آپ کے data کی ایک copy رکھتا ہے۔ یہی وہ trade-off ہے جو آپ کرتے ہیں۔ VPS کی لاگت پر آپ کو اپنے control میں ایک S3 endpoint ملتا ہے، لیکن cloud provider کے ہر اس کام کی ذمہ داری بھی آپ پر آ جاتی ہے جو وہ پہلے کرتا تھا، failed disk تبدیل کرنے سے لے کر server software patch کرنے تک۔ آخر کے قریب موجود section واضح طور پر بتاتا ہے کہ یہ trade-off کب مناسب ہے۔
MinIO Community Edition کی اکتوبر 2026 میں صورتِ حال
اس پر مبنی deployment بنانے سے پہلے یہ حصہ پڑھیں، کیونکہ حال ہی میں اس میں تبدیلی ہوئی ہے۔ مئی 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 کی صورت میں تقسیم ہوتی ہے، اور اپریل 2026 سے minio/minio repository کو THIS REPOSITORY IS NO LONGER MAINTAINED نوٹس کے تحت archive کر دیا گیا ہے۔ پرانے download server نے بھی community files فراہم کرنا بند کر دیا ہے۔ 20 October 2026 کو جانچنے پر اس guide میں download کے لیے استعمال ہونے والے تمام dl.min.io paths، یعنی 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 اب بھی ایک free AIStor tier درج کرتا ہے، جو standalone deployments چلانے والے developers، researchers اور چھوٹی organisations کے لیے ہے۔
Source code اب بھی موجود ہے، اور یہ آخری binary سے نیا ہے۔ آخری community release RELEASE.2025-10-15T17-29-55Z ہے، جو 16 October 2025 کو security release کے طور پر شائع ہوئی۔ اس میں service accounts اور STS میں session policy bypass کے ذریعے privilege escalation درست کی گئی ہے، اور release notes تمام users کو فوراً upgrade کرنے کا مشورہ دیتے ہیں۔ آخری pre-compiled binary September 2025 کی build تھی، اس لیے اسے یہ fix نہیں ملا۔ یہ guide October release کو compile کرتی ہے، اور repository کے archived ہونے کی وجہ سے یہ وہ آخری fix بھی ہے جو Community Edition کو ملے گا۔
یہ ایک حقیقت اس guide کے باقی حصے کا طریقہ متعین کرتی ہے۔ اسی وجہ سے یہاں MinIO 127.0.0.1 پر listen کرتا ہے اور internet تک صرف اس proxy کے ذریعے پہنچتا ہے جسے آپ control کرتے ہیں۔
MinIO بائنری انسٹال کریں اور ڈاؤن لوڈ کی تصدیق کریں
MinIO کو Go میں لکھا گیا ہے، اور vendor README اسے ایک ہی go install کمانڈ سے build کرتی ہے۔ اس کے لیے Go 1.24 یا اس کے بعد کا ورژن درکار ہے۔ پہلے official 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 کے لیے شائع کیا گیا hash ہے۔ اگر آپ Go کا نیا ورژن منتخب کریں تو اسی صفحے سے اس کا hash لیں۔ -f flag HTTP error کی صورت میں curl کو ناکام بناتا ہے، بجائے اس کے کہ error page کو آپ کے بتائے ہوئے نام سے محفوظ کرے۔ ورنہ لوگ 404 page کو unpack کرنے کی کوشش کرتے ہیں اور حیران ہوتے ہیں کہ یہ 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"واضح رہیں کہ یہ check کیا ثابت کرتا ہے۔ Match ہونے سے ثابت ہوتا ہے کہ download مکمل ہے اور transit کے دوران خراب یا تبدیل نہیں ہوا۔ اس سے 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اب final community release کو اپنے normal user کے طور پر build کریں۔ go install ہر اس module کو check کرتا ہے جسے وہ download کرتا ہے، بشمول MinIO کے اپنے source کے، Go کے public checksum database sum.golang.org کے مقابلے میں۔ اس لیے tampered یا تبدیل کیا گیا module security error کے ساتھ build روک دیتا ہے، بجائے اس کے کہ 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 3minio --version وہاں DEVELOPMENT.GOGET دکھاتا ہے جہاں پہلے release name استعمال ہوتا تھا، کیونکہ go install ان build flags کو apply نہیں کرتا جو vendor نے اپنی binaries پر stamp کرنے کے لیے استعمال کیے تھے۔ go version -m وہ module information پڑھتا ہے جسے Go ہر binary میں embed کرتا ہے، اور اس کی mod github.com/minio/minio line اس commit کا نام بتاتی ہے جسے آپ نے build کیا ہے۔ یہاں Permission denied کا مطلب ہے کہ mode غلط ہے، اور command not found کا مطلب ہے کہ /usr/local/bin آپ کے PATH پر موجود نہیں ہے۔ اگر compile کے لیے VPS میں memory کم ہو تو اسی architecture کی کسی دوسری Linux machine پر وہی go install چلائیں اور binary کو وہاں copy کر دیں۔
سسٹم صارف اور ڈیٹا ڈائریکٹری بنانا
MinIO نیٹ ورک سے اپ لوڈز وصول کرتا ہے، لہذا اسے root کے طور پر نہیں چلنا چاہیے۔ اسے ایک ایسا اکاؤنٹ دیں جس کی کوئی home ڈائریکٹری نہ ہو اور نہ ہی کوئی 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/minio-r ایک سسٹم اکاؤنٹ بناتا ہے جس کا UID 1000 سے کم ہوتا ہے، جو اسے عام صارفین کی رینج سے باہر رکھتا ہے۔ -M ہوم ڈائریکٹری کو چھوڑ دیتا ہے، کیونکہ جو اکاؤنٹ کبھی لاگ ان نہیں ہوتا اس کے پاس رکھنے کے لیے کچھ نہیں ہوتا۔ نتیجے کو id minio-user کے ساتھ چیک کریں، اور stat -c '%U %a' /var/lib/minio کے ساتھ، جسے minio-user 750 پرنٹ کرنا چاہیے۔
ڈیٹا ڈائریکٹری کو اس صارف کے لیے صرف پڑھنے کے قابل (readable) نہیں بلکہ لکھنے کے قابل (writable) بھی ہونا چاہیے۔ پہلی بار شروع ہونے پر MinIO اپنی کنفیگریشن رکھنے کے لیے والیوم کے اندر ایک .minio.sys ڈائریکٹری بناتا ہے، لہذا root کی ملکیت والی ڈائریکٹری MinIO کو اسٹارٹ اپ کے دوران ایک ایسے پیغام کے ساتھ بند کر دیتی ہے جو permission denied پر ختم ہوتا ہے۔ یہی اصول ہر اس سروس پر لاگو ہوتا ہے جسے آپ اس طرح چلاتے ہیں، اور VPS پر کم سے کم استحقاق والے سروس صارفین اس کا مکمل احاطہ کرتا ہے۔
root credentials کو ایک environment file میں رکھیں
root credentials ہر bucket تک رسائی دیتی ہیں، اس لیے انہیں unit file میں نہیں ہونا چاہیے، کیونکہ وہ ہر کسی کے پڑھنے کے لیے دستیاب ہوتی ہے۔ پہلے درست mode کے ساتھ فائل بنائیں اور پھر اس میں لکھیں، تاکہ پاس ورڈ کسی بھی لمحے ایسی فائل میں نہ ہو جسے پڑھا جا سکے۔
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، EnvironmentFile کو root کے طور پر پڑھتا ہے اس سے پہلے کہ وہ privileges کو User= پر منتقل کرے، جس کا مطلب ہے کہ service account کو کبھی بھی اپنے credentials پڑھنے کی ضرورت نہیں ہوتی۔ ایک بار جب service چل جائے، تو sudo -u minio-user cat /etc/default/minio کے ساتھ اس کی تصدیق کریں۔ اس کمانڈ کو Permission denied پرنٹ کرنا چاہیے۔
MinIO کے دو رویوں کو شروع کرنے سے پہلے جاننا ضروری ہے۔ اگر environment میں MINIO_ROOT_USER اور MINIO_ROOT_PASSWORD نہ ہوں، تو MinIO شروع ہونے سے انکار نہیں کرتا۔ یہ دستاویزی default credentials minioadmin:minioadmin کے ساتھ شروع ہوتا ہے، جو کہ پہلا جوڑا ہے جسے کوئی بھی scanner آزماتا ہے، اور ایسا کرتے ہوئے یہ مکمل طور پر ٹھیک نظر آتا ہے۔ 8 حروف سے کم پاس ورڈ مسترد کر دیا جاتا ہے: MinIO سٹارٹ اپ پر اس غلطی کے ساتھ بند ہو جاتا ہے کہ credentials غلط ہیں، کیونکہ access key کے لیے کم از کم 3 حروف اور secret key کے لیے کم از کم 8 حروف درکار ہوتے ہیں۔
MINIO_VOLUMES ڈیٹا کا راستہ ہے اور 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 missing file کو نظرانداز کرتا ہے اور MinIO کو پھر بھی start کر دیتا ہے۔ اس طرح deleted file یا غلط لکھا ہوا path خاموشی سے آپ کو minioadmin:minioadmin پر چلنے والا server دے دیتا ہے۔ ڈیش کے بغیر missing file کی وجہ سے unit، MinIO کے run ہونے سے پہلے ہی fail ہو جاتی ہے، اور journalctl -u minio، Failed to load environment files: No such file or directory دکھاتا ہے۔ جو unit start ہونے سے انکار کر دے، اسے ایسے server کے مقابلے میں محسوس کرنا کہیں آسان ہے جو خاموشی سے default password قبول کر رہا ہو۔
$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 limits soft کے لیے 1024 اور hard کے لیے 524288 ہیں، اس لیے LimitNOFILE=65536 مقرر کرنے سے MinIO کی مؤثر 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 وہ API address دکھاتا ہے جس پر server listening کر رہا ہے۔ اگر unit مسلسل restart ہو رہی ہو تو journal میں ہر restart سے پہلے موجود error پڑھیں۔ RestartSec=5 کے ساتھ مسلسل exits، systemd کی default start limit یعنی دس seconds میں پانچ starts سے زیادہ نہیں ہوتے، اس لیے unit retry کرتی رہتی ہے۔ Start request repeated too quickly کا مطلب ہے کہ configured start-rate limit تک پہنچ گئی ہے۔
مزید isolation کے لیے [Service] section میں ProtectSystem=full اور ProtectHome=true شامل کریں۔ دونوں کو host kernel سے mount namespaces درکار ہوتے ہیں۔ ایسی container virtualisation میں جو host kernel share کرتی ہو، مثلاً OpenVZ یا LXC، یہ fail ہو سکتے ہیں، اور unit پھر status=226/NAMESPACE report کرتی ہے۔ یہ دونوں lines ہٹا دیں تو unit start ہو جاتی ہے۔ unit خود ایک عام unit ہے، اور VPS پر systemd services اور timers باقی directives کا احاطہ کرتا ہے۔
mc انسٹال کریں اور round trip ثابت کریں
MinIO client mc ہے۔ اسے apt install mc کے ساتھ انسٹال نہ کریں۔ وہ package Midnight Commander ہے، جو file manager ہے اور MinIO سے متعلق نہیں ہے۔
پرانا community path https://dl.min.io/client/mc/release/linux-amd64/mc، 410 Gone کا جواب دیتا ہے۔ AIStor CLI reference اب AIStor Client کی طرف https://dl.min.io/aistor/mc/release/linux-amd64/mc پر اشارہ کرتی ہے اور اسے licensed AIStor Server deployments کے لیے exclusive functionality رکھنے والا client بیان کرتی ہے۔ اس reference میں community server کے خلاف اسے استعمال کرنے کے بارے میں کچھ نہیں کہا گیا، اس لیے یہ guide 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 کے طور پر register کریں، پھر اس کے ذریعے ایک 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 کے ساتھ list کرنا چاہیے، اور mc cat کو hello object storage print کرنا چاہیے۔ یہ round trip اس بات کا حقیقی ثبوت ہے کہ server کام کر رہا ہے، کیونکہ اس میں وہی signed S3 requests بھیجی جاتی ہیں جو ہر دوسرا client بھیجے گا۔ اگر آپ دوسری تصدیق چاہتے ہیں تو mc admin info local server status print کرتا ہے۔
اب ایک اور check چلائیں، جب تک box خالی ہے۔
mc alias set defaultcheck http://127.0.0.1:9000 minioadmin minioadminیہ command fail ہونی چاہیے۔ اگر یہ کامیاب ہو جائے تو environment file process تک نہیں پہنچی، اور آپ کا server default credentials کے ساتھ چل رہا ہے۔ machine پر کسی اور process کے اثرانداز ہونے سے پہلے اسے درست کریں۔
mc aliases کو ~/.mc/config.json میں plain text کے طور پر محفوظ کرتا ہے، اس لیے یہ credentials اس شخص کی home directory میں موجود رہتے ہیں جس نے command چلائی تھی۔ mc کو 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آؤٹ پٹ میں query string کے اندر X-Amz-Signature اور X-Amz-Expires شامل ہوتے ہیں۔ اس کے بارے میں دو باتیں لوگوں کو حیران کرتی ہیں۔ لنک اس alias میں موجود endpoint سے بنتا ہے جو آپ نے استعمال کیا، لہذا 127.0.0.1 پر موجود alias ایک ایسا لنک تیار کرتا ہے جسے صرف یہی مشین کھول سکتی ہے: ان لنکس کے لیے جو آپ بھیجنا چاہتے ہیں، اپنے public hostname پر ایک دوسرا alias بنائیں۔ نیز، فی لنک منسوخی (revoke) کا کوئی بٹن نہیں ہوتا۔ دستخط تب تک درست رہتا ہے جب تک اس کی میعاد ختم نہ ہو جائے یا اسے سائن کرنے والی کلید (key) کو ہٹا یا تبدیل نہ دیا جائے، اور root credentials کے ساتھ سائن کیے گئے لنک کے لیے اس کا مطلب انہیں تبدیل کرنا (rotate) ہے، لہذا مختصر میعاد ہی عملی کنٹرول ہے۔ S3 signature فارمیٹ کے مطابق زیادہ سے زیادہ میعاد 7 دن ہے۔
restic کو اس کی اپنی key اور bucket دیں
root credentials ہر bucket کو پڑھ اور حذف کر سکتے ہیں، لہذا بیک اپ جاب کے پاس یہ credentials نہیں ہونے چاہئیں۔ ایک 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 موجود ہے جو ایک کمانڈ کم کر سکتی تھی، لیکن وہ سرور پر موجود ہر bucket تک مکمل رسائی دیتی ہے۔ اوپر دی گئی policy میں bucket کا نام جان بوجھ کر دو بار لکھا گیا ہے: ایک بار arn:aws:s3:::restic کے طور پر تاکہ bucket کی لسٹنگ کام کر سکے، اور ایک بار arn:aws:s3:::restic/* کے طور پر اس کے اندر موجود objects کے لیے۔ S3 میں bucket اور اس کے objects الگ الگ resources ہیں، لہذا ایسی policy جو صرف ایک کا نام لے، وہ اس طرح ناکام ہوتی ہے جیسے client خراب ہو۔
اعتبار کرنے سے پہلے حد (limit) کو ٹیسٹ کریں۔
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 معیاری AWS environment variables سے S3 credentials پڑھتا ہے، لہذا اس میں restic کی اپنی کوئی مخصوص credential فائل شامل نہیں ہوتی۔
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 پاس ورڈ مانگتا ہے۔ یہ پاس ورڈ repository کو encrypt کرتا ہے، لہذا MinIO صرف ciphertext اسٹور کرتا ہے، اور پاس ورڈ کھو جانے کا مطلب بیک اپ کا ضائع ہونا ہے۔ systemd ٹائمر سے شروع ہونے والی run کے پاس ٹائپ کرنے کے لیے کوئی ٹرمینل نہیں ہوتا، لہذا شیڈولڈ بیک اپس کے لیے RESTIC_PASSWORD_FILE کو mode 600 والی فائل پر سیٹ کریں۔
ایک تعیناتی کا اصول اوپر دی گئی کسی بھی کمانڈ سے زیادہ اہم ہے۔ جس ڈیٹا کی حفاظت کے لیے restic repository اسی VPS پر ہو جہاں وہ ڈیٹا موجود ہے، تو وہ آپ کو صرف ایک خراب rm سے بچا سکتی ہے، اس کے علاوہ کسی اور چیز سے نہیں۔ MinIO نوڈ ایک الگ مشین پر ہونا چاہیے، اور بہتر ہے کہ وہ کسی دوسرے ریجن میں ہو۔ VPS پر restic بیک اپس اس کے علاوہ شیڈولنگ اور ریٹینشن کا احاطہ کرتا ہے۔
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 ڈیفالٹ 1 MB باڈی لمٹ کو ہٹا دیتا ہے، ورنہ MinIO کے درخواست موصول کرنے سے پہلے ہی کسی بھی بڑی اپ لوڈ کو 413 Request Entity Too Large کے ساتھ مسترد کر دیا جاتا ہے۔ proxy_request_buffering off اپ لوڈ کو براہ راست آگے بھیجتا ہے (stream کرتا ہے)، کیونکہ ڈیفالٹ سیٹنگ پوری درخواست کو پہلے ایک عارضی فائل میں محفوظ کرتی ہے، جس کے لیے بڑی فائل کی صورت میں دوگنی ڈسک اسپیس درکار ہوتی ہے۔ proxy_set_header Host $http_host ایک باریک نکتہ ہے: S3 دستخط (signature) Host ہیڈر کا احاطہ کرتا ہے، لہذا اگر کوئی پراکسی اسے تبدیل (rewrite) کر دے تو ہر درخواست SignatureDoesNotMatch کے ساتھ ناکام ہو جائے گی، جبکہ access log میں درخواست معمول کے مطابق آتی ہوئی دکھائی دے گی۔
MinIO کو اس کا عوامی نام بھی بتائیں، تاکہ اس کی تیار کردہ لنکس localhost کے بجائے پراکسی کی طرف اشارہ کریں۔
echo 'MINIO_SERVER_URL=https://s3.example.com' | sudo tee -a /etc/default/minio
sudo systemctl restart minioفائر وال کو محدود رکھیں۔ SSH اور HTTPS کی اجازت دیں، اور 9000 اور 9001 پورٹس کے لیے کوئی رول نہ بنائیں، کیونکہ 127.0.0.1 پر bind ہونے والا ایڈریس کسی بھی صورت میں دوسری مشین سے ناقابل رسائی ہوتا ہے، قطع نظر اس کے کہ فائر وال کی سیٹنگ کیا ہے۔ VPS پر ufw فائر وال کی بنیادی معلومات میں متعلقہ کمانڈز موجود ہیں۔
جب single-node MinIO کافی ہو، اور کب حقیقی S3 منتخب کرنا چاہیے
یہاں single node سے مراد ایک drive ہے۔ اس لیے deployment میں نہ parity ہوتی ہے اور نہ دوسری copy۔ ہر object کی durability ایک VPS disk کی durability کے برابر ہوتی ہے۔ MinIO کی community documentation hosted community docs کو October 2025 میں ہٹا دیے جانے کے بعد minio/docs repository میں source کی صورت میں دستیاب ہے۔ اس کا server README کہتا ہے کہ source سے compile کیے گئے binaries استعمال کرنے والے production environments یہ کام اپنی ذمہ داری پر کرتے ہیں۔ کسی bucket کے لیے object locking فعال کی جا سکتی ہے، لیکن ایک VPS پر یہ صرف S3 API کے ذریعے deletion روکتی ہے۔ جس شخص کے پاس machine پر root access ہو، وہ disk پر موجود files پھر بھی حذف کر سکتا ہے۔ اس لیے اس setup کے بارے میں کسی کو immutable retention policy کی ضمانت نہ دیں۔
یہ دوسرے region میں موجود دوسرے VPS پر restic target کے طور پر موزوں ہے۔ یہ development work اور CI artifacts کے لیے S3 endpoint کے طور پر بھی مناسب ہے، جہاں bucket ضائع ہونے کا نقصان صرف rebuild تک محدود ہو۔ چھوٹی application میں user uploads کے لیے بھی یہ قابل عمل ہے، بشرطیکہ recovery plan آپ کے اختیار میں ہو اور آپ نے restore کا عملی test کیا ہو۔
Managed S3 منتخب کریں جب کسی contract یا regulator کو object lock یا multi-region durability درکار ہو۔ اسے اس وقت بھی منتخب کریں جب آپ 03:00 بجے disk بھر جانے کی وجہ سے آنے والے page کا ذمہ دار نہیں بننا چاہتے۔ frozen code بھی ایک واضح وجہ ہے۔ 20 October 2026 تک community edition archive ہو چکی ہے اور اب maintained نہیں ہے۔ اس کی آخری release RELEASE.2025-10-15T17-29-55Z ہے، جسے یہ guide compile کرتی ہے۔ اس کے بعد کی کوئی خرابی fix نہیں کی جائے گی۔ اس software کو چلانے کا مطلب یہ حقیقت قبول کرنا ہے، یا 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 شامل کی ہے، وہ بھی صرف data کو آخر میں شامل کرتی ہے۔ اس لیے S3 bucket پر live SQL file رکھنا سست اور غیر محفوظ ہے۔ Database کو local disk پر رکھیں اور اس کا backup bucket میں بنائیں۔ VPS پر production میں 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 ہیڈر کو دوبارہ لکھ دیا ہے، جس کا احاطہ دستخط (signature) کرتا ہے۔
RequestTimeTooSkewed۔ کلائنٹ یا سرور کی گھڑی غلط ہے۔ ہر دستخط شدہ S3 درخواست میں ایک ٹائم اسٹیمپ ہوتا ہے، اور MinIO، Amazon S3 کی طرح، ایسی ہیڈر-سائنڈ درخواست کو مسترد کر دیتا ہے جس کا ٹائم اسٹیمپ اس کی اپنی گھڑی سے 15 منٹ سے زیادہ کا فرق رکھتا ہو۔ پری-سائنڈ لنکس کو ان کی میعاد ختم ہونے کی تاریخ کے مطابق چیک کیا جاتا ہے۔ timedatectl چیک کریں اور تصدیق کریں کہ ٹائم سنکرونائزیشن فعال ہے۔
ایسی بکٹ پر Access Denied جس کے بارے میں آپ جانتے ہیں کہ وہ موجود ہے۔ کی (key) کسی دوسری بکٹ تک محدود ہے۔ mc admin policy info local restic-rw کے ساتھ یہ پرنٹ کریں کہ پالیسی اصل میں کیا اجازت دیتی ہے اور ریسورس لائنوں میں بکٹ کے نام کا موازنہ کریں۔
FAQ
کیا حقیقی backups کے لیے single-node MinIO کافی ہے؟
یہ restic target کے طور پر کافی ہے، بشرطیکہ یہ اس data سے الگ machine پر چل رہا ہو جس کی حفاظت کی جا رہی ہے۔ لیکن یہ آپ کی واحد copy کے طور پر کافی نہیں ہے۔ single-drive deployment میں parity صفر ہوتی ہے، اس لیے MinIO کے اندر دوسری copy موجود نہیں ہوتی۔ اگر اس VPS کی disk کا data ضائع ہو جائے تو objects بھی ختم ہو جائیں گے۔ دوسری target کسی اور جگہ رکھیں، اور کم از کم ایک بار دونوں targets سے restore کریں تاکہ یقین ہو کہ process کام کرتا ہے۔
sha256sum -c کی MinIO کی checksum file پر failure کیوں ہوتی ہے؟
پرانی dl.min.io paths نے اس guide میں استعمال ہونے والی ہر community binary اور checksum file کے لیے 410 Gone فراہم کیا تھا، جب 20 October 2026 کو ان کی جانچ کی گئی۔ اس file میں hash کے بعد موجود label release کا نام بتاتا ہے، مثلاً minio.RELEASE.2025-09-07T16-13-09Z، جبکہ download کی گئی 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 کہاں گیا؟
MinIO نے May 2025 میں 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 نہیں۔ اسی لیے یہ guide ہر کام command line سے کرتی ہے۔
MinIO کو S3 backend کے طور پر restic سے کیسے منسلک کروں؟
AWS_ACCESS_KEY_ID اور AWS_SECRET_ACCESS_KEY کو MinIO access key اور اس کے secret پر set کریں، پھر s3:https://s3.example.com/restic کی شکل والی repository string استعمال کریں، جہاں آخری path element bucket کا نام ہے۔ پہلے mc mb سے bucket بنائیں، کیونکہ صرف ایک bucket تک محدود key کو buckets بنانے کی permission نہیں ہوتی۔ Upload سے پہلے restic ہر چیز کو اپنے repository password سے encrypt کرتا ہے، اس لیے MinIO کو ciphertext ملتا ہے اور وہ آپ کی files دیکھ نہیں سکتا۔
کیا MinIO کو nginx کے پیچھے چلانا ضروری ہے؟
جب کوئی client اسی machine پر نہ ہو تو TLS (transport layer security) ضروری ہے، کیونکہ اس کے بغیر ہر object access key ID اور request signature کے ساتھ plain text میں network سے گزرتا ہے۔ Secret key خود client سے باہر نہیں جاتی، کیونکہ S3 signing اسے صرف locally استعمال کرکے signature calculate کرتی ہے۔ تاہم network path پر موجود کوئی بھی شخص آپ کا data پڑھ سکتا ہے اور timestamp valid رہنے تک captured request کو دوبارہ چلا سکتا ہے۔ port 443 پر certbot کے certificate کے ساتھ proxy استعمال کرنا TLS حاصل کرنے کا آسان ترین طریقہ ہے، اور اس سے certificate renewal MinIO سے الگ رہتی ہے۔ اگر --certs-dir کو public.crt اور private.key رکھنے والی directory کی طرف point کریں تو MinIO خود بھی TLS terminate کر سکتا ہے۔ لیکن اس صورت میں service account کو renewed private key تک read access درکار ہوگی، جو اسی نتیجے کے لیے اضافی کام ہے۔