اپلیکیشن شما هر روز چند صد عکس پروفایل، فاکتور PDF و فایل پیوست از کاربران میگیرد. اولش همه را در پوشهٔ uploads کنار کد میریزید. چند ماه بعد پوشه چند ده گیگابایت شده، بکاپ کل سرویس کند شده و وقتی میخواهید برنامه را روی دو سرور اجرا کنید، فایلها فقط روی یکی از آنها هستند. اینجا بیشتر تیمها به Object Storage میرسند و اولین اسمی که میشنوند MinIO است.
جواب کوتاه سؤال «MinIO چیست» این است: یک سرور ذخیرهسازی آبجکت که همان API آمازون S3 را پیاده کرده و میتوانید آن را روی سرور خودتان یا بهشکل سرویس آماده اجرا کنید. پایینتر توضیح میدهیم Object Storage چه فرقی با فضای فایل معمولی دارد، MinIO چطور داده را نگه میدارد و چطور با چند دستور به آن وصل شوید.
MinIO چیست؟
MinIO یک نرمافزار ذخیرهسازی آبجکت (Object Storage) است که با زبان Go نوشته شده و از سال ۲۰۱۵ توسعه پیدا کرده است. ویژگی اصلیاش سازگاری با S3 است: هر برنامه، کتابخانه یا ابزاری که برای Amazon S3 ساخته شده، با عوض کردن آدرس Endpoint و کلیدهای دسترسی به MinIO هم وصل میشود. لازم نیست کد آپلود را از اول بنویسید.
در MinIO داده داخل باکتها (Bucket) نگه داشته میشود. هر فایل یک آبجکت است که سه بخش دارد: یک کلید یکتا مثل users/42/avatar.png، خود داده و متادیتا (نوع فایل، تاریخ، برچسبهای دلخواه). برنامهها با درخواستهای HTTP مثل PUT و GET آبجکت را مینویسند و میخوانند و هر درخواست با Access Key و Secret Key امضا میشود.
اگر با خود مفهوم S3 آشنا نیستید، اول مقالهٔ فضای ذخیرهسازی S3 چیست را بخوانید. MinIO در واقع یکی از رایجترین راهها برای داشتن همین فضا بیرون از AWS است.

Object Storage با فضای فایل و دیسک چه فرقی دارد؟
برای اینکه دقیق بدانید MinIO چیست و کجا به کار میآید، باید آن را کنار دو مدل دیگر ذخیرهسازی ببینید. سه مدل اصلی در سرورها داریم و MinIO در دستهٔ سوم است:
| ویژگی | Block Storage (دیسک) | File Storage (پوشه و فایل) | Object Storage (مثل MinIO) |
|---|---|---|---|
| ساختار | بلوکهای خام که سیستمعامل رویشان فایلسیستم میسازد | درخت پوشه و فایل | باکتهای تخت با کلید یکتا برای هر آبجکت |
| نحوهٔ دسترسی | اتصال مستقیم به یک سرور | NFS، SMB، FTP | HTTP و S3 API از هر جای شبکه |
| ویرایش فایل | تغییر بخشی از فایل ممکن است | تغییر بخشی از فایل ممکن است | آبجکت کامل دوباره نوشته میشود |
| متادیتا | ندارد | محدود (نام، تاریخ، دسترسی) | متادیتای دلخواه برای هر آبجکت |
| کاربرد مناسب | دیتابیس و سیستمعامل | اشتراک فایل بین کاربران یک تیم | فایلهای آپلودی، بکاپ، لاگ، رسانه و دادههای حجیم |
در عمل مهمترین تفاوت در ردیف «ویرایش فایل» است. Object Storage برای فایلی که مدام تکهتکه عوض میشود، مثل فایل دیتابیس، مناسب نیست. برای فایلی که یک بار نوشته و بارها خوانده میشود، مثل عکس محصول یا فایل بکاپ شبانه، انتخاب خوبی است.
MinIO به چه دردی میخورد؟ کاربردهای رایج
بعد از اینکه دیدیم MinIO چیست، ببینیم تیمها در عمل چه چیزهایی را در آن نگه میدارند:
- فایلهای آپلودی اپلیکیشن: عکس پروفایل، مدارک کاربران و پیوستها بهجای دیسک سرویس در باکت میروند. برنامه stateless میماند و میتوانید آن را روی چند کانتینر اجرا کنید.
- مقصد بکاپ: ابزارهایی مثل restic، rclone و Pluton مستقیم روی S3 مینویسند. اگر بکاپ دیتابیس روی همان سروری بماند که دیتابیس رویش است، با خرابی سرور هر دو از دست میروند. دربارهٔ اصول بکاپ در همه چیز دربارهٔ بکاپ اطلاعات و دربارهٔ یک ابزار آماده در Pluton چیست نوشتهایم.
- رسانهٔ وردپرس و فروشگاه: با افزونههایی مثل Media Cloud یا WP Offload Media، کتابخانهٔ رسانهٔ وردپرس به باکت منتقل میشود. مراحل کامل را در مستند اتصال وردپرس به MinIO میبینید.
- لاگ و دادههای تحلیلی: فایلهای لاگ روزانه، خروجی CSV و دادههای خام که حجمشان زیاد است و کمتر خوانده میشوند.
- داده و مدل در پروژههای هوش مصنوعی: دیتاستها، checkpointها و خروجی مدلها معمولاً در فضای S3 نگه داشته میشوند تا چند سرویس همزمان به آنها دسترسی داشته باشند.
MinIO چطور از داده محافظت میکند؟
وقتی MinIO روی چند دیسک یا چند سرور اجرا شود، از روشی به اسم Erasure Coding استفاده میکند. هر آبجکت به چند تکهٔ داده (Data Shard) و چند تکهٔ توازن (Parity Shard) شکسته میشود و هر تکه روی یک دیسک جدا میرود. اگر تعداد دیسکهای از دسترفته از تعداد تکههای توازن بیشتر نباشد، آبجکت از روی بقیهٔ تکهها بازسازی میشود.
طبق مستندات Erasure Coding در MinIO، مقدار Parity حداکثر تا نصف اندازهٔ مجموعهٔ دیسکها قابل تنظیم است. مثلاً در مجموعهای با ۱۶ دیسک، Parity از EC:0 تا EC:8 قابل انتخاب است. Parity بیشتر یعنی تحمل خرابی بیشتر و فضای قابل استفادهٔ کمتر.

چند قابلیت دیگر هم برای امنیت داده در MinIO هست:
- Versioning: با روشن کردن نسخهبندی روی باکت، بازنویسی یا حذف یک آبجکت نسخهٔ قبلی را پاک نمیکند و میتوانید آن را برگردانید.
- Object Lock: آبجکت برای مدت مشخصی غیرقابل حذف و تغییر میشود. برای بکاپهایی که نباید حتی با کلید ادمین پاک شوند، مثلاً در برابر باجافزار، کاربرد دارد.
- Lifecycle: قانون میگذارید که مثلاً بکاپهای قدیمیتر از ۳۰ روز خودکار حذف شوند.
- رمزنگاری: داده هم در مسیر (TLS) و هم روی دیسک (Server-Side Encryption) قابل رمزنگاری است.
Erasure Coding جای بکاپ را نمیگیرد. اگر کسی با کلید درست یک باکت را پاک کند، همهٔ تکهها با هم پاک میشوند. برای دادهٔ مهم، یک نسخهٔ دیگر جای دیگر نگه دارید.
اتصال به MinIO با ابزار mc
وقتی میدانید MinIO چیست، قدم بعدی وصل شدن به آن است. سریعترین راه ابزار خط فرمان mc است. بعد از نصب، یک alias با آدرس سرویس و کلیدها میسازید و بعد با دستورهایی شبیه دستورهای لینوکس با باکتها کار میکنید. آدرس و کلیدهای زیر نمونهاند؛ مقدار واقعی را از داشبورد سرویس خودتان بردارید:
# connect to your MinIO service
mc alias set myminio https://minio.example.com ACCESS_KEY SECRET_KEY
# create a bucket and upload a file
mc mb myminio/uploads
mc cp ./report.pdf myminio/uploads/docs/report.pdf
mc ls myminio/uploads/docs
# share a private file with a link that expires in 2 hours
mc share download --expire 2h myminio/uploads/docs/report.pdf
دستور آخر یک لینک امضاشده (Presigned URL) میسازد. فایل خصوصی میماند و فقط کسی که لینک را دارد تا زمان انقضا میتواند آن را دانلود کند. پیشفرض انقضا در mc هفت روز است و طبق مستندات Amazon S3 لینک امضاشده با امضای نسخهٔ ۴ حداکثر هفت روز اعتبار دارد.
اگر میخواهید فایلهای یک باکت بدون لینک امضاشده در دسترس باشند، مثلاً تصاویر سایت، سطح دسترسی باکت را با mc anonymous set download myminio/uploads فقطخواندنی کنید. public اجازهٔ آپلود ناشناس را هم میدهد و تقریباً هیچوقت انتخاب درستی نیست. راهنمای کامل این دستورها در مستند اتصال به MinIO با mc آمده است. اگر رابط گرافیکی را ترجیح میدهید، Cyberduck و S3 Browser هم کار میکنند.
اتصال برنامه به MinIO با کد
چون MinIO همان API آمازون را دارد، از SDK رسمی AWS استفاده میکنید و فقط Endpoint را عوض میکنید. نمونه در پایتون با کتابخانهٔ boto3:
import boto3
s3 = boto3.client(
"s3",
endpoint_url="https://minio.example.com",
aws_access_key_id="ACCESS_KEY",
aws_secret_access_key="SECRET_KEY",
)
s3.upload_file("avatar.png", "uploads", "users/42/avatar.png")
url = s3.generate_presigned_url(
"get_object",
Params={"Bucket": "uploads", "Key": "users/42/avatar.png"},
ExpiresIn=3600,
)
print(url)
در لاراول هم درایور s3 سیستم فایل همین کار را میکند. بعد از نصب پکیج league/flysystem-aws-s3-v3، این متغیرها را در .env بگذارید:
FILESYSTEM_DISK=s3
AWS_ACCESS_KEY_ID=ACCESS_KEY
AWS_SECRET_ACCESS_KEY=SECRET_KEY
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=uploads
AWS_ENDPOINT=https://minio.example.com
AWS_USE_PATH_STYLE_ENDPOINT=true
گزینهٔ AWS_USE_PATH_STYLE_ENDPOINT را فراموش نکنید. SDK بهطور پیشفرض نام باکت را به اول دامنه میچسباند (مثل uploads.minio.example.com) و اگر DNS برای این حالت تنظیم نشده باشد، اتصال خطا میدهد. با این گزینه آدرس بهشکل minio.example.com/uploads ساخته میشود. برای جنگو، Node.js، Flask و ASP.NET Core هم در مستندات MinIO چابکان راهنمای جدا هست.
MinIO، Amazon S3، Nextcloud یا FTP؟
یکی از سؤالهایی که بعد از «MinIO چیست» پیش میآید، فرقش با گزینههای آشناتر است. این چهار گزینه گاهی جای هم پیشنهاد میشوند، ولی برای مخاطب متفاوتی ساخته شدهاند:
| گزینه | چه کسی با آن کار میکند | نقطهٔ قوت | محدودیت |
|---|---|---|---|
| MinIO | برنامهها و اسکریپتها از طریق API | سازگار با S3، قابل اجرا روی زیرساخت دلخواه | رابط کاربری برای همکاری تیمی ندارد |
| Amazon S3 | برنامهها روی زیرساخت AWS | مرجع اصلی API و اکوسیستم بزرگ ابزارها | پرداخت و دسترسی از ایران با مشکل روبهروست |
| Nextcloud | آدمها از طریق وب و اپ موبایل | همگامسازی، اشتراکگذاری و ویرایش اسناد تیمی | برای ذخیرهٔ فایلهای برنامه از طریق API ساخته نشده |
| FTP | توسعهدهنده برای جابهجایی دستی فایل | ساده و آشنا، با هر کلاینت FTP | بدون متادیتا، لینک امضاشده و نسخهبندی |
قاعدهٔ ساده این است که اگر فایل را برنامه مینویسد و میخواند، سراغ MinIO یا هر فضای S3 دیگر بروید. اگر آدمها فایل را باز میکنند و با هم به اشتراک میگذارند، Nextcloud مناسبتر است. مقایسهٔ مفصل ابزارهای اشتراک فایل تیمی را در جایگزین گوگل درایو برای تیمها نوشتهایم.
MinIO را خودتان نصب کنید یا سرویس آماده بگیرید؟
دانستن اینکه MinIO چیست نیمی از تصمیم است. نیم دیگر این است که چه کسی آن را اجرا کند:
| موضوع | نصب روی سرور خودتان | سرویس آمادهٔ MinIO در چابکان |
|---|---|---|
| راهاندازی | ساخت از سورس یا ایمیج، تنظیم سرویس systemd یا کانتینر، TLS و دامنه | ساخت سرویس از داشبورد در چند دقیقه |
| بهروزرسانی و امنیت | دنبال کردن نسخهها و بستن پورتها با شماست | زیرساخت و شبکه را چابکان نگه میدارد |
| بکاپ | باید مقصد دوم و اسکریپت بکاپ را خودتان بسازید | بکاپ خودکار سرویس از داشبورد در دسترس است |
| کنترل | دسترسی کامل به سیستمعامل و تنظیمات سطح پایین | دسترسی از طریق S3 API، mc و کلاینتهای گرافیکی |
| مناسب برای | تیمی که چند سرور و دیسک دارد و میخواهد کلاستر خودش را بسازد | تیمی که فقط یک Endpoint سازگار با S3 برای برنامهاش میخواهد |
اگر سرور خودتان را ترجیح میدهید، یک سرور ابری بگیرید و قبل از هر چیز رمز پیشفرض minioadmin را عوض کنید و پورتها را پشت فایروال ببرید. اگر فقط فضای سازگار با S3 برای برنامه لازم دارید، فضای ذخیرهسازی MinIO چابکان را از بخش برنامههای آماده بسازید؛ آدرس Endpoint و کلیدها در داشبورد سرویس است و همان کدهای بالا بدون تغییر کار میکنند. برای مقایسهٔ پلنها جدول تعرفهٔ همان صفحه را ببینید. بقیهٔ گزینهها مثل Nextcloud و فضای FTP هم در صفحهٔ فضای ذخیرهسازی ابری فهرست شدهاند.
برنامهای که به MinIO وصل میشود میتواند روی هاست ابری چابکان یا هاست داکر اجرا شود. وقتی فایلها در باکت باشند، دیسک خود سرویس سبک میماند و جابهجایی برنامه بین سرویسها هم سادهتر میشود.
اشتباههای رایج در کار با MinIO
- باکت public برای فایلهای خصوصی: مدارک کاربران، فاکتورها و بکاپها را هیچوقت در باکت عمومی نگذارید. باکت را خصوصی نگه دارید و برای هر دانلود لینک امضاشده بسازید.
- کلید ادمین در کد برنامه: برای هر برنامه یک کاربر یا کلید جدا با دسترسی محدود به همان باکت بسازید تا اگر کلید لو رفت، فقط همان باکت در خطر باشد.
- کلید در مخزن گیت: Access Key و Secret Key جایشان در متغیرهای محیطی است، نه در فایلهای کد.
- یکجا بودن داده و بکاپ: بکاپ دیتابیسی که روی همان MinIO برنامه ذخیره شده، در برابر خرابی همان سرویس محافظتی ندارد. یک نسخه را جای دیگری هم نگه دارید.
- نامگذاری بینظم کلیدها: از پیشوند ثابت مثل
users/42/یاbackups/db/2026-11-14/استفاده کنید تا لیست کردن، قوانین Lifecycle و پاک کردن گروهی ساده بماند.
سؤالات متداول
MinIO چیست به زبان ساده؟
اگر بخواهیم در یک جمله بگوییم MinIO چیست: یک فضای ذخیرهسازی فایل برای برنامههاست که با همان زبان Amazon S3 حرف میزند. برنامه فایل را با یک درخواست HTTP در باکت میگذارد و هر وقت لازم داشت، با کلید آن آبجکت برمیدارد.
MinIO رایگان است؟
نسخهٔ Community با مجوز AGPLv3 منتشر شده و میتوانید آن را روی سرور خودتان نصب کنید. اگر نمیخواهید خودتان نصب و بهروزرسانی را انجام دهید، سرویس آمادهٔ MinIO را از داشبورد چابکان بسازید و فقط Endpoint و کلیدها را به برنامه بدهید.
آیا برنامهای که برای Amazon S3 نوشته شده با MinIO کار میکند؟
در بیشتر موارد بله. Endpoint را به آدرس MinIO و کلیدها را به کلیدهای سرویس خودتان تغییر میدهید و معمولاً گزینهٔ Path-Style را هم روشن میکنید. قابلیتهایی که مخصوص زیرساخت AWS هستند، مثل اتصال مستقیم به سرویسهای دیگر آمازون، در MinIO وجود ندارند.
MinIO جای دیتابیس را میگیرد؟
نه. MinIO برای فایلهاست، نه برای دادههای ساختاریافتهای که باید روی آنها کوئری بزنید. معمولاً مسیر یا کلید فایل در دیتابیس ذخیره میشود و خود فایل در باکت. دربارهٔ انتخاب دیتابیس در MySQL یا PostgreSQL نوشتهایم.
فرق MinIO با Nextcloud چیست؟
MinIO برای برنامهها ساخته شده و از طریق API کار میکند. Nextcloud برای آدمهاست: رابط وب، اپ موبایل، همگامسازی پوشه و اشتراک فایل بین اعضای تیم دارد. Nextcloud حتی میتواند فضای S3 را بهعنوان محل ذخیرهٔ فایلهایش استفاده کند.
MinIO را با داکر اجرا کنم؟
برای محیط توسعه میتوانید از Dockerfile مخزن یک ایمیج بسازید و کنار برنامه اجرا کنید؛ مقالهٔ Docker Compose چیست برای این کار کمک میکند. ایمیجهای قدیمی Community دیگر بهروز نمیشوند، پس برای محیط عملیاتی یا نسخه را خودتان بهروز نگه دارید یا از سرویس آماده استفاده کنید.