مشتری کوچک

ابزار خط فرمان Minio Client MC یک جایگزین مدرن برای دستورات UNIX مانند LS ، CAT ، CP ، Mirror و با پشتیبانی از هر دو سیستم فایل و خدمات ذخیره سازی ابری سازگار S3 ارائه می دهد.

ابزار MC Commandline برای سازگاری با AWS S3 API ساخته شده است و برای عملکرد و رفتار مورد انتظار با MINIO و AWS S3 آزمایش می شود.

Minio هیچ تضمینی برای سایر خدمات سازگار با S3 ارائه نمی دهد ، زیرا اجرای API S3 آنها ناشناخته است و بنابراین پشتیبانی نشده است. در حالی که دستورات MC ممکن است مطابق مستند کار کنند ، هرگونه استفاده از این دست در معرض خطر شماست.

MC نحو زیر را دارد:

مگس[گل جهانی]فرمان

برای لیستی از دستورات پشتیبانی شده ، به مرجع سریع دستور مراجعه کنید.

MC نرم افزار رایگان و منبع آزاد AGPLV3 (FOSS) است.

برنامه های ادغام MC ممکن است الزامات انطباق AGPLV3 را تحریک کنند. مجوز تجاری Minio بهترین گزینه برای برنامه هایی است که باعث تعهدات AGPLV3 می شود که در آن منبع باز برنامه گزینه ای نیست.

شروع سریع

1) MC را نصب کنید

ابزار خط فرمان MC را روی دستگاه میزبان نصب کنید. روی زبانه ای که مطابق با سیستم عامل یا محیط دستگاه میزبان است کلیک کنید:

لینوکس

دستورات زیر برای اجرای ابزار MC یک پسوند موقت به مسیر سیستم شما اضافه می کند. برای ایجاد اصلاحات دائمی در مسیر سیستم خود ، دستورالعمل های سیستم عامل خود را متعهد کنید.

از طرف دیگر ، MC را با پیمایش به پوشه والدین و اجرای آن اجرا کنید ./mc - -help

اینتل 64 بیتی

curl https://dl. min. io/client/mc/release/linux-amd64/mc-ایجاد DIRS-oخانه $/minio-binaries/mc chmod +xخانه $/Minio-Binaries/MCصادر کردن مسیر=مسیر:خانه $/ Minio-Binaries/ MC-Help

PPC 64 بیتی

curl https://dl. min. io/client/mc/release/linux-ppc64le/mc-ایجاد DIRS-o~/minio-binaries/mc chmod +xخانه $/Minio-Binaries/MCصادر کردن مسیر=مسیر:خانه $/ Minio-Binaries/ MC-Help

arm64

curl https://dl. min. io/client/mc/release/linux-arm64/mc-ایجاد DIRS-o~/minio-binaries/mc chmod +xخانه $/Minio-Binaries/MCصادر کردن مسیر=مسیر:خانه $/ Minio-Binaries/ MC-Help

سیستم عامل مک

نصب Minio/Stable/MC M C-Help

پنجره ها

پرونده زیر را در یک مرورگر باز کنید:

با کلیک بر روی آن ، یا با اجرای موارد زیر در دستور سریع یا PowerShell ، پرونده را اجرا کنید:

مسیرtomc.از پیش --کمک 

منبع

نصب از منبع برای توسعه دهندگان و کاربران پیشرفته در نظر گرفته شده است و به یک محیط کار Golang نیاز دارد. نحوه نصب Golang را ببینید.

دستورات زیر را در یک محیط ترمینال اجرا کنید تا MC را از منبع نصب کنید:

برو نصب github. com/minio/mc@latest

به روزرسانی MC از نصب های مبتنی بر منبع پشتیبانی نمی کند.

2) برای سرویس سازگار با S3 یک نام مستعار ایجاد کنید

مثال زیر به طور موقت تاریخ BASH را غیرفعال می کند تا خطر اعتبار اعتبار احراز هویت را در متن ساده کاهش دهد. این یک اقدام اساسی امنیتی است و تمام بردارهای حمله احتمالی را کاهش نمی دهد. برای وارد کردن اطلاعات حساس در خط فرمان ، بهترین روشهای امنیتی را برای سیستم عامل خود متعهد کنید.

برای اضافه کردن یک سرویس سازگار با آمازون S3 به پیکربندی MC از دستور MC Alias Set استفاده کنید.

BASH +Oتاریخمگسنام مستعار تنظیمنام میزبان alias Access_Key Secret_Key Bas h-oتاریخ 

• نام مستعار را با یک نام جایگزین کنید تا به سرویس S3 مرتبط شود. دستورات MC به طور معمول به عنوان یک استدلال برای شناسایی کدام سرویس S3 برای اجرای در برابر آن نیاز دارند.
• نام میزبان را با نقطه پایانی URL یا آدرس IP سرویس S3 جایگزین کنید.
• Access_Key و Secret_Key را با کلیدهای دسترسی و مخفی برای کاربر در سرویس S3 جایگزین کنید.

هر آرگومان را با مقادیر مورد نیاز جایگزین کنید. مشخص کردن فقط دستور ADD میزبان MC برای وارد کردن مقادیر مورد نیاز ، یک درخواست ورودی را شروع می کند.

هر یک از برگه های زیر حاوی یک مثال خاص ارائه دهنده است:

سرور کوچک

مگسنام مستعار تنظیمmyminio https://minioserver. example. net Access_Key کلید مخفی

ذخیره AWS S3

مگسنام مستعار تنظیمMys3 https://s3. amazon. com/endpoint Access_Key Secret

ذخیره سازی ابر گوگل

مگسنام مستعار تنظیمmygcs https://storage. googleapis. com/endpoint Access_Key کلید مخفی

3) اتصال را آزمایش کنید

از دستور MC Admin Info برای آزمایش اتصال به استقرار تازه اضافه شده MINIO استفاده کنید:

MC Admin Info Myminio

این دستور در صورت موفقیت اطلاعات مربوط به سرویس S3 را برمی گرداند. اگر ناموفق است ، هر یک از موارد زیر را بررسی کنید:

• دستگاه میزبان دارای اتصال به URL سرویس S3 (یعنی با استفاده از پینگ یا ردیابی) است.
• AccessKey و Secretkey مشخص شده با یک کاربر در سرویس S3 مطابقت دارد. کاربر باید اجازه انجام اقدامات مربوط به سرویس را داشته باشد. برای استقرار MINIO ، برای اطلاعات بیشتر در مورد مجوزهای دسترسی به کاربر ، به مدیریت دسترسی مراجعه کنید. برای سایر خدمات سازگار با S3 ، به مستندات مربوط به آن سرویس مراجعه کنید.

مرجع سریع فرمان

در جدول زیر دستورات MC آمده است:

مشتری Minio همچنین شامل یک برنامه دولت برای مدیریت استقرار MINIO است. برای مستندات کامل تر به مدیر MC مراجعه کنید.

جدول زیر شامل آن دستورات نیست.

دستورات MC Alias یک رابط مناسب برای مدیریت لیست میزبان سازگار با S3 که MC می تواند به آن متصل شود و عملیات را در برابر آن انجام دهد ، فراهم می کند.

دستور ناشناس MC از تنظیم یا حذف سیاست های ناشناس به یک سطل و محتوای آن پشتیبانی می کند. سطل هایی با سیاست های ناشناس امکان دسترسی عمومی را فراهم می کند که مشتریان بتوانند هرگونه اقدامی را که توسط این سیاست بدون تأیید اعتبار انجام می شود ، انجام دهند.

دستورات MC Batch به شما امکان می دهد یک یا چند کار شغلی را با استقرار MINIO انجام دهید.

دستور MC CAT محتویات یک پرونده یا شی را به پرونده یا شیء دیگر هماهنگ می کند. همچنین می توانید از دستور برای نمایش محتویات پرونده یا شیء مشخص شده برای STDOUT استفاده کنید. گربه عملکرد مشابهی با گربه دارد.

دستور MC CP اشیاء را از طریق یا از طریق MINIO ، که در آن منبع می تواند Minio یا یک سیستم فایل محلی باشد ، کپی می کند.

MC Diff MC تفاوت بین دو دایرکتوری سیستم فایل یا سطل Minio را محاسبه می کند. MC Diff فقط اشیاء را که از دست رفته یا از نظر اندازه متفاوت هستند لیست می کند. MC Diff محتویات اشیاء را با هم مقایسه نمی کند.

دستور MC DU استفاده از دیسک از سطل و پوشه ها را خلاصه می کند. همچنین می توانید از DU در برابر سیستم فایل محلی استفاده کنید تا نتایج مشابهی را به عنوان دستور DU تولید کنید.

دستورات رمزگذاری MC تنظیم ، به روزرسانی یا غیرفعال کردن حالت رمزگذاری پیش فرض سرور (SSE). Minio به طور خودکار اشیاء را با استفاده از حالت SSE مشخص شده رمزگذاری می کند.

دستور رویداد MC از افزودن ، حذف و لیست اعلان های رویداد سطل پشتیبانی می کند.

دستور MC Find از جستجوی اشیاء در استقرار MINIO پشتیبانی می کند. همچنین می توانید از دستور برای جستجوی پرونده ها در سیستم فایل استفاده کنید.

فرمان MC اولین خطوط N یک شی را نشان می دهد ، جایی که n استدلالی است که به دستور مشخص شده است.

دستورات MC ILM قوانین مدیریت چرخه عمر شیء و ردیابی را در استقرار MINIO مدیریت می کنند.

فرماندهی MC Legalhold تنظیمات Hold Legal Hold (WORM) را برای شی (بازدید کنندگان) تنظیم ، حذف یا بازیابی می کند.

دستورات مجوز MC با ثبت نام خوشه برای Subnet Minio کار می کنند. از دستورات برای ثبت نام استقرار ، عدم ثبت نام استقرار ، نمایش اطلاعات در مورد مجوز فعلی خوشه یا به روزرسانی کلید مجوز برای یک خوشه استفاده کنید.

دستور MC LS سطل و اشیاء را در MINIO یا سرویس سازگار با S3 ذکر می کند.

دستور MC MB یک سطل یا فهرست جدید در مسیر مشخص شده ایجاد می کند.

دستور MC Mirror محتوا را با استقرار MINIO ، مشابه ابزار RSYNC همزمان می کند. MC Mirror از سیستم های فایل ، استقرار MINIO و سایر میزبان سازگار با S3 به عنوان منبع هماهنگ سازی پشتیبانی می کند.

دستور MC MV یک شی را از منبع به هدف منتقل می کند ، مانند استقرار Minio یا بین سطل ها در همان استقرار MINIO. MC MV همچنین از جابجایی اشیاء بین سیستم فایل محلی و MINIO پشتیبانی می کند.

دستور MC OD یک پرونده محلی را در یک مکان از راه دور در تعداد مشخصی از قطعات و اندازه های قسمت کپی می کند. این فرمان زمانی را که برای بارگذاری پرونده لازم است ، خروجی می کند.

دستور MC پینگ یک بررسی زنده در یک هدف مشخص را انجام می دهد.

فرمان MC PIPE محتوا را از stdin به یک شی هدف منتقل می کند.

دستورات سهمیه MC ، محدودیت سهمیه سخت را روی یک سطل پیکربندی ، نمایش یا حذف می کنند.

دستور MC RB یک یا چند سطل را در Minio یا یک سرویس سازگار با S3 دیگر حذف می کند.

برای از بین بردن فقط محتوای یک سطل ، به جای آن از MC RM استفاده کنید.

دستور نگه داشتن MC تنظیمات قفل نوشتن-یکدست (کرم) را برای یک شی یا شی (های) در یک سطل پیکربندی می کند. همچنین می توانید تنظیمات قفل شیء پیش فرض را برای یک سطل تنظیم کنید ، جایی که تمام اشیاء بدون تنظیمات قفل شیء صریح ، پیش فرض سطل را به ارث می برند.

دستور MC RM اشیاء را از یک سطل در استقرار Minio حذف می کند. برای حذف کامل یک سطل ، به جای آن از MC RB استفاده کنید.

برای مدیریت URL های پیش بینی شده برای بارگیری و بارگذاری اشیاء در یک سطل Minio از دستورات MC Share استفاده کنید.

دستور MC SQL یک رابط انتخابی S3 برای انجام نمایش داده های SQL در اشیاء در استقرار MINIO مشخص شده ارائه می دهد.

دستور MC Stat اطلاعات مربوط به اشیاء موجود در یک سطل Minio ، از جمله ابرداده شی را نشان می دهد.

دستورات پشتیبانی Minio Client MC ابزارهایی را برای تجزیه و تحلیل سلامت استقرار یا عملکرد و اجرای تشخیص ارائه می دهد. همچنین می توانید گزارش های بهداشتی تولید شده را برای تجزیه و تحلیل بیشتر توسط Minio Engineering بارگذاری کنید.

دستور MC TAG برچسب های مرتبط با یک سطل یا شی را اضافه ، حذف و لیست می کند.

دستور MC Tree تمام پیشوندهای داخل یک سطل Minio را در قالب درخت لیست می کند. این دستور به صورت اختیاری از لیست همه اشیاء داخل سطل در هر پیشوند ، از جمله ریشه سطل پشتیبانی می کند.

فرمان MC UNDO به دلیل عملکرد قرار دادن یا حذف در یک مسیر مشخص ، تغییرات را معکوس می کند.

دستور بروزرسانی MC به طور خودکار MC Binier را به آخرین نسخه پایدار به روز می کند.

دستور MC نسخه پیکربندی نسخه را برای یک سطل Minio امکان پذیر ، تعلیق و بازیابی می کند.

فرماندهی MC Watch برای رویدادهای موجود در سطل مینیو مشخص شده یا مسیر سیستم فایل محلی. برای خدمات S3 ، از MC Event Add برای پیکربندی اعلان های رویداد سطل در خدمات سازگار با S3 استفاده کنید.

فایل پیکربندی

MC از یک فایل پیکربندی فرمت شده JSON استفاده می کند که برای ذخیره انواع خاصی از اطلاعات ، مانند نام مستعار برای هر سرویس سازگار با S3 پیکربندی شده استفاده می شود.

برای لینوکس و OSX ، مکان فایل پیکربندی پیش فرض است~/. mc/config. json.

برای ویندوز ، MC سعی می کند با تلاش متغیرهای خاص محیط ، یک مسیر فایل پیش فرض را بسازد. اگر یک متغیر غیرقانونی باشد ، MC به متغیر بعدی حرکت می کند. در صورت عدم موفقیت همه تلاش ها ، MC خطایی را برمی گرداند. لیست زیر هر مکان ممکن برای فایل را به ترتیب MC توصیف می کند:

1. صفحه اصلی . mc config. json
2. userprofile . mc config. json
3. homedrive+homepath . mc config. json

می توانید از-config-dir استفاده کنید

گواهینامه ها

Minio Client گواهینامه ها و CAS را برای استقرار در مسیرهای زیر ذخیره می کند:

لینوکس ، مکوس و سایر سیستم های مانند یونیکس:

~/. mc/certs/# گواهینامه ها ~/. mc/certs/cas/# مقامات گواهی 

C:Uسر و صدا[نام کاربری]mccerts # گواهینامه هاج:Uسر و صدا[نام کاربری]mccertsCAs # مقامات گواهی 

هنگام ایجاد نام مستعار جدید ، مشتری Minio گواهی همسالان را واگذار می کند ، اثر انگشت کلید عمومی را محاسبه می کند و از کاربر می پرسد که آیا گواهی استقرار را قبول می کند یا خیر. اگر تصمیم دارید به گواهی اعتماد کنید ، مشتری Minio گواهی را به مسیر مرجع گواهینامه ذکر شده در بالا اضافه می کند.

در محیط های آزمایش ، می توانید با عبور از پرچ م-امنیت ، از دستورات انتخاب شده Minio Client استفاده کنید.

گزینه های جهانی

همه دستورات از گزینه های جهانی زیر پشتیبانی می کنند:

خروجی کلامی را به کنسول امکان پذیر می کند.

به عنوان مثال ، عملیات زیر خروجی Verbose را به دستور MC LS اضافه می کند:

M C-Debug LS Play

-کنفیر

مسیر یک پرونده پیکربندی فرمت شده JSON که MC برای ذخیره داده ها از آن استفاده می کند. برای اطلاعات بیشتر در مورد نحوه استفاده MC از پرونده پیکربندی ، به پرونده پیکربندی مراجعه کنید.

خطوط JSON خروجی را به کنسول امکان پذیر می کند.

به عنوان مثال ، عملیات زیر خروجی خطوط JSON را به دستور MC LS اضافه می کند:

M C-Json LS Play

--بدون رنگ

موضوع رنگ داخلی را برای خروجی کنسول غیرفعال می کند. برای پایانه های گنگ مفید است.

خروجی کنسول را سرکوب می کند.

تأیید گواهینامه TLS/SSL را غیرفعال می کند. امکان اتصال TLS به سرورها با گواهینامه های نامعتبر را فراهم می کند. هنگام استفاده از این گزینه در برابر میزبان S3 غیرقابل اعتماد ، احتیاط کنید.

نسخه فعلی MC را نشان می دهد.

خلاصه ای از استفاده از فرمان را در ترمینال نشان می دهد.

این کار تحت مجوز بین المللی Creative Commons Attribution 4. 0 مجوز است. 2020-Present ، Minio ، Inc.

حریم خصوصی شما برای ما مهم است: ما از کوکی ها استفاده می کنیم تا تجربه بهتری به شما ارائه دهیم. در صورت تمایل ، همیشه می توانید خط مشی رازداری ما را مرور کنید.