نکات کلیدی
- HTTPS: توصیه می شود سرور را بر روی HTTPS راه اندازی کنید و از `path‑style` و منطقه (region) مناسب استفاده کنید.
- نسخهٔ Free فقط الگوهای تک‑نود را پشتیبانی می کند و سرور بدون فایل مجوز، عملیات S3 را رد می کند.
- فایل `config.env` را با دسترسی 600 محافظت کنید و با `drop-in` قابلیت های اضافی را حذف کنید؛ نبودن `config.env` را به خطا تبدیل کنید.
مقدمه
MinIO یک سرویس ذخیرهسازی شیء (Object Storage) است که با API سازگار با Amazon S3 کار میکند. در این مقاله بهطور دقیق به نحوه نصب، پیکربندی و نکات کلیدی مرتبط با نسخههای مختلف و امکانات امنیتی میپردازیم.
نسخههای موجود و انتخاب مناسب
- سورس کد با مجوز AGPLv3: نسخه Community که در ۲۵ آوریل ۲۰۲۶ و ۱۴ ژوئیه ۲۰۲۶ بهصورت read‑only در دسترس است.
- AIStor Free: نسخه تجاری با مجوز جدا، بهروزرسانی میشود ولی تنها یک نود را پشتیبانی میکند.
نکته: در تاریخ ۱۶ آبان ۱۴۰۵، فقط سورس کد و کلاینت `mc` از طریق سورس ساخته میشوند؛ باینری و کنسول دیگر منتشر نمیشود.
انتخاب درایو و کدگذاری
- یک درایو: برای محیطهای کوچک یا آزمایشی مناسب است.
- چند درایو با Erasure Coding: برای مقیاسپذیری و مقاومت در برابر خطا، از الگوریتمهای کدگذاری حذف (Erasure Coding) استفاده میشود.
مدیریت دسترسی و سیاستها
- Root: اعتبار root در سرور نگهداری میشود و هر برنامه میتواند سیاست (policy) و کاربر (user) خاص خود را تعریف کند.
- HTTPS: توصیه میشود سرور را بر روی HTTPS راهاندازی کنید و از `path‑style` و منطقه (region) مناسب استفاده کنید.
مراحل نصب ساده
- نصب Go:
“`bash sudo apt update && sudo apt install golang-go “`- دریافت سورس:
“`bash git clone cd minio “`
- ساخت با Go:
“`bash go build “`
- اجرای سرور:
“`bash ./minio server /data “`توجه: مسیر `/data` میتواند یک یا چند درایو باشد؛ برای Erasure Coding، چند مسیر را بهصورت `–address` مشخص کنید.
نکات امنیتی
- پورت ۹۰۰۰ را فقط برای سرورهای داخلی باز کنید.
- برای فایلهای حجیم، از Nginx بهعنوان reverse proxy استفاده کنید تا محدودیت پهنای باند اعمال شود.
- کلیدهای دسترسی را در فایل `~/.mc/config.json` ذخیره کنید و از `mc admin` برای مدیریت کاربران و سیاستها بهره ببرید.
جمعبندی
MinIO با استفاده از سورس کد AGPLv3 میتواند بهصورت رایگان بر روی سرورهای شخصی نصب شود. انتخاب درایو، پیکربندی HTTPS و مدیریت دسترسیها از مهمترین عوامل موفقیت در راهاندازی این سرویس هستند.
تاریخچهٔ تغییرات مدیریتی
- مه ۲۰۲۵: حذف امکانات مدیریتی کنسول وب و باقی ماندن مرورگر object.
- اکتبر ۲۰۲۵: توقف انتشار باینری و image داکر؛ README اعلام «فقط سورس».
- ۳ دسامبر ۲۰۲۵: معرفی حالت نگهداری (maintenance mode) در README.
- ۲۵ آوریل ۲۰۲۶: آرشیو مجدد مخزن minio/minio پس از آرشیو اولیه فوریه.
- ۱۴ ژوئیه ۲۰۲۶: آرشیو مخزن minio/mc (بنر GitHub همان مخزن).
- ۱۶ آبان ۱۴۰۵: باینریهای Community سرور و mc در dl.min.io پاسخ 410 دادند و مستندات به AIStor منتقل شد.
دریافت MinIO امروز
ساخت از سورس کافی است؛ نسخهٔ Go 1.24 یا بالاتر لازم است و ماژولها از proxy.golang.org دریافت میشوند. در صورت عدم دسترسی، روی ماشین دیگری کامپایل کرده و باینری را منتقل کنید. در آزمایش ما، ساخت با Go 1.24.7 حدود دو دقیقه و نیم زمان برد و باینری ۱۵۱ مگابایتی تولید شد.
برای نصب بر روی Ubuntu، بسته AIStor را با دستور
`sudo dpkg -i minio.deb`
نصب کنید. نسخهٔ Free فقط الگوهای تک‑نود را پشتیبانی میکند و سرور بدون فایل مجوز، عملیات S3 را رد میکند. کلاینت AIStor در مسیر `dl.min.io/aistor/mc` با همان مجوز منتشر میشود. پروژههای متن باز Garage و SeaweedFS نیز API سازگار با S3 ارائه میدهند.
چندین درایو یا یک درایو؟
مستندات erasure در پوشه docs مخزن MinIO توضیح میدهد که سرور درایوها را در مجموعههای ۲ تا ۱۶ تایی میچیند و هر object را بین درایوهای یک مجموعه تقسیم میکند. در سرور تک درایو، هنگام شروع نوشتن یک set(ها) و درایو(ها) در هر set ایجاد میشود؛ اگر درایو خراب شود، داده از دست میرود، بنابراین نسخهٔ دوم را در مکان دیگری نگه دارید.
مدیریت باکت، کاربر و policy
کلید root برای مدیریت کل سیستم است. هر برنامه کاربری با policy محدود به bucket خود ساخته میشود تا کلید لورفتهاش به دادههای دیگر دسترسی نداشته باشد. ابزار اصلی این کار کلاینت mc است.
نگهداری اطلاعات root
مخزن minio-service (حالا AIStor) دو فایل برای systemd پیشنهاد میکند:
- `/etc/default/minio` – مسیر داده و پورتها
- `/etc/minio/config.env` – متغیرهای `MINIO_ROOT_USER` و `MINIO_ROOT_PASSWORD`
مقادیر نمونه را تغییر دهید؛ برای رمز عبور، خروجی `openssl rand -base64 30` مناسب است. فایل unit این مخزن برای پایش سلامت دیسک، `CAP_SYS_ADMIN` و `CAP_DAC_OVERRIDE` را میدهد. با `CAP_DAC_OVERRIDE` بررسی مجوز فایل دور میشود؛ در نتیجه دسترسی ۶۰۰ محافظ نیست. در آزمایش ما، سرور بدون config.env با `minioadmin:minioadmin` بهصورت بیصدا بالا آمد. در drop‑in زیر، `AssertFileNotEmpty` این حالت را به خطای شروع تبدیل میکند و `AmbientCapabilities=` خالی قابلیتها را برمیدارد.
یادآوری: برای اطمینان از امنیت، حتماً فایل config.env را پر کنید و دسترسیهای لازم را محدود کنید.
تنظیمات اولیه و نکات امنیتی
- حفظ کلید root: در زمان نصب MinIO، کلید root را به هیچ برنامهای اختصاص ندهید؛ در صورت افشای فایل تنظیمات، تمام bucketها در معرض خطر قرار میگیرند.
- سیاستهای چندکاربری: ابتدا فایل JSON حاوی سیاست را تعریف کنید و سپس آن را به کاربر مورد نظر متصل کنید.
- مثال فایل سیاست: `app-uploads-rw.json` – این فایل فقط دسترسی نوشتن را به bucket `uploads` میدهد.
ایجاد کاربر و اعمال سیاست
- تعریف alias
“`bash mc alias set local “`
- ساخت bucket
“`bash mc mb local/app-uploads “`- ثبت سیاست
“`bash mc admin policy create local app-uploads-rw app-uploads-rw.json “`- ایجاد کاربر
“`bash mc admin user add local app-uploads “`- اتصال سیاست به کاربر
“`bash mc admin policy attach local app-uploads-rw –user=app-uploads “`- فعالسازی نسخهبندی
“`bash mc version enable local/app-uploads “`با استفاده از کلید کاربر `app-uploads`، تلاش برای نوشتن در bucket دیگر باعث دریافت خطای `Insufficient permissions to access this path` میشود. پیش از اجرای `mc version enable` خروجی `is un-versioned` بود؛ نسخهبندی پیشفرض نیست. هر bucket جدید به صورت خصوصی ایجاد میشود؛ برای دسترسی عمومی میتوانید با `mc anonymous set download local/public-assets` اجازه دانلود بدون کلید را بدهید.
اتصال برنامه به MinIO با استفاده از S3 API
- پارامترهای ضروری:
- `endpoint` با پورت 9000
- `access key` و `secret key` کاربر
- `region`
- پیکربندی Path‑Style:
MinIO بهصورت پیشفرض Path‑Style را میپذیرد؛ Virtual‑Host فعال میشود فقط زمانی که `MINIO_DOMAIN` تنظیم شود. بنابراین در کلاینت Path‑Style را روشن کنید.
تنظیم کلاینت برای endpoint شخصی
| مرحله | دستور | توضیح |
|---|---|---|
| 1 | `mc alias set app –path on` | تعریف alias با Path‑Style فعال |
| 2 | `AWS_ACCESS_KEY_ID` و `AWS_SECRET_ACCESS_KEY` | کلیدهای دسترسی برای برنامه restic |
| 3 | `region` | اگر `MINIO_SITE_REGION` را تعیین کردهاید، همان مقدار را استفاده کنید |
- مقدار region نادرست:
اگر `MINIO_SITE_REGION` تنظیم نشده باشد، سرور هر region را میپذیرد. با تنظیم `MINIO_SITE_REGION=ir-thr-1` و ارسال درخواست از region `us-east-1`، خطای `400` با پیام `the region is wrong; expecting ‘ir-thr-1’` دریافت میشود. برنامه restic نیز پیشفرض `us-east-1` را ارسال میکند؛ مطابقت region در دو طرف ضروری است.
جایگذاری گواهی HTTPS
گواهی SSL/TLS باید در تنظیمات سرور MinIO قرار گیرد تا ارتباط امن برقرار شود. این گواهی در مسیر `/etc/minio/certs` یا همان مسیر مشخصشده در فایل پیکربندی `minio.conf` قرار میگیرد. پس از اعمال تغییرات، سرویس MinIO را ریستارت کنید تا گواهی فعال گردد.
مستندات TLS و گواهینامههای MinIO
- در پوشهی `/etc/minio/certs` دو فایل `public.crt` و `private.key` قرار میگیرند؛ در صورت عدم وجود پوشه، سرور به صورت HTTP ساده اجرا میشود.
- گواهی SSL رایگان را از طریق Certbot دریافت کنید؛ فایل `fullchain.pem` را به نام `public.crt` و `privkey.pem` را به نام `private.key` کپی کنید.
- در بخش `–deploy-hook` دو فایل را کپی کرده و دستور `systemctl restart minio.service` را قرار دهید تا پس از تمدید گواهی اجرا شود.
محدودیت پورت کنسول (9001)
- کنسول Community عمدتاً برای مرورگرهای object طراحی شده است.
- پورت 9001 را به IP مدیر محدود کنید و پورت 9000 را فقط برای سرورهای برنامه باز نگه دارید.
- اگر بکاپهای شبانه با Restic روی همان bucket قرار دارند، سرور MinIO همانطور که یک نسخهی داده است، نیاز به مراقبت مشابه سرور اصلی دارد.
حذف امکانات مدیریتی در نسخهی ۲۰۲۵
- از مه ۲۰۲۵ امکانات مدیریتی حذف شد؛ برای ایجاد bucket از دستور `mc mb` و برای ایجاد کاربر و سیاست از `mc admin` استفاده کنید.
تفاوت MinIO و S3 آمازون
- MinIO نرمافزار مستقل است ولی API آن با S3 سازگار است؛ برنامهها با تغییر endpoint و کلیدها میتوانند به آن متصل شوند.
دسترسی به باینریهای آماده
- برای نسخه Community، مسیرهای `dl.min.io` پاسخ 410 میدهند؛ باینریها باید با `go install` ساخته شوند.
نسخه AIStor Free
- صفحهی قیمتگذاری MinIO آن را بهعنوان رایگان و تکنود معرفی میکند، با مجوز MinIO Software License و نه AGPLv3.
نگهداری بکاپ با سرور تکنود
- بهعنوان یکی از دو نسخه، سرور تکنود کافی است؛ اما اگر تنها نسخه باشد، کافی نیست.
تغییر رمز root
- در فایل `config.env` متغیرهای `MINIO_ROOT_USER` و `MINIO_ROOT_PASSWORD` را تغییر داده و سرویس را مجدداً راهاندازی کنید.
انتشار ایمیج Docker رسمی Community
- ایمیج رسمی منتشر نمیشود؛ باید باینری را از سورس بسازید و با Dockerfile مخزن و دستور `docker build` تصویر را خودتان تولید کنید.
نکات کلیدی پیش از نصب
- نسخه و مسیر بهروزرسانی را انتخاب کنید؛ سرور Community و `mc` آرشیو شدهاند و بهروزرسانی نمیگیرند؛ AIStor Free بهروزرسانی میشود ولی مجوز جدا دارد و تکنود است.
- فایل `config.env` را با دسترسی 600 محافظت کنید و با `drop-in` قابلیتهای اضافی را حذف کنید؛ نبودن `config.env` را به خطا تبدیل کنید.
- هر برنامه باید کاربر و سیاست خود را داشته باشد؛ endpoint را با پورت 9000، `path-style` و region مناسب تنظیم کنید.
- برای ذخیرهسازی داده، نسخه دوم را روی سرور دیگری نگه دارید؛ درایو erasure coding در این حالت کاربردی نیست.
پشت صحنه bucket و جلوی صحنه Nginx
- برای دانلود عمومی، Nginx لینک امن و زماندار ایجاد میکند؛ این تنظیمات جدا از سیاست هر bucket است.
انتخاب SDK یا کلاینت برای اتصال به S3
- نام دقیق SDK یا کتابخانهای که در برنامهتان برای ارتباط با سرویس S3 استفاده میشود، باید مشخص باشد؛ این اطلاعات برای تنظیمات و پیکربندی سرور ضروری است.
مخازن و منابع مرتبط
- minio/minio – مخزن اصلی در GitHub که آخرین بررسی آن در تاریخ ۱۶ آبان ۱۴۰۵ انجام شد.
- پوشه docs – مستندات جامع درون مخزن MinIO که راهنمای نصب و پیکربندی را در بر میگیرد.
- minio-service – فایلهای مربوط به سرویسسازی با systemd برای اجرای MinIO بر روی سیستمهای لینوکسی.
- مستندات نصب AIStor – راهنمای گامبهگام نصب AIStor بر روی سیستمعامل Ubuntu.
- گزارش It’s FOSS – خلاصهای از تغییرات اخیر در MinIO که در تاریخ ۲۷ آوریل ۲۰۲۶ منتشر شد.
نکات کلیدی
- اطمینان حاصل کنید که نسخهی SDK یا کلاینت انتخابی با نسخهی سرویس S3 هماهنگ باشد.
- مستندات مخزنهای GitHub را بهصورت دورهای بررسی کنید تا از بهروزرسانیهای امنیتی و عملکردی مطلع باشید.
- برای راهاندازی سرویس در محیطهای تولید، از فایلهای systemd در مخزن minio-service استفاده کنید تا امکان مدیریت آسانتر و مانیتورینگ بهینه فراهم شود.

کمپین ابتکار نو
کمپین ایده های نو
کمپین آینده روشن
کمپین طراحی مدرن