MOSQUITTO_PASSWD(1)                Commands                MOSQUITTO_PASSWD(1)

نام (NAME)
       mosquitto_passwd - مدیریت فایل‌های گذرواژه برای mosquitto

خلاصه دستور (SYNOPSIS)
       mosquitto_passwd [-H hash] [-c | -D] passwordfile username

       mosquitto_passwd [-H hash] -b passwordfile username password

       mosquitto_passwd -U passwordfile

توضیحات (DESCRIPTION)
       mosquitto_passwd ابزاری برای مدیریت فایل‌های گذرواژه برای کارگزار MQTT
       mosquitto است.

       نام‌های کاربری نباید شامل «:» باشند. گذرواژه‌ها در قالبی شبیه به crypt(3)
       ذخیره می‌شوند.

گزینه‌ها (OPTIONS)
       -b
           اجرا در حالت دسته‌ای (batch mode). این گزینه امکان مشخص کردن گذرواژه
           را در خط فرمان فراهم می‌کند که می‌تواند راحت باشد، اما باید با احتیاط
           استفاده شود چرا که گذرواژه در خط فرمان و در تاریخچه دستورات قابل
           مشاهده خواهد بود.

       -c
           ایجاد یک فایل گذرواژه جدید. اگر فایل از قبل وجود داشته باشد،
           بازنویسی خواهد شد. اگر نام فایل با یک خط تیره - مشخص شود، خروجی به
           stdout ارسال می‌شود. این کار در اصل تنها با گزینه -b معنا دارد.

       -D
           حذف کاربر مشخص‌شده از فایل گذرواژه.

       -H
           انتخاب هش مورد استفاده. می‌تواند یکی از argon2id، sha512-pbkdf2، یا
           sha512 باشد. مقدار پیش‌فرض argon2id است. گزینه sha512 جهت ایجاد
           فایل‌های گذرواژه برای سازگاری با Mosquitto نسخه 1.6 و قدیمی‌تر ارائه
           شده است.

       -U
           از این گزینه می‌توان برای ارتقا/تبدیل یک فایل گذرواژه حاوی
           گذرواژه‌های متن ساده به فایلی با گذرواژه‌های هش‌شده استفاده کرد. این
           گزینه فایل مشخص‌شده را تغییر می‌دهد. برنامه بررسی نمی‌کند که آیا
           گذرواژه‌ها از قبل هش شده‌اند یا خیر، بنابراین اجرای آن روی فایلی که
           حاوی گذرواژه‌های هش‌شده است، بر اساس هش‌های قبلی هش‌های جدیدی تولید
           می‌کند و فایل گذرواژه را غیرقابل استفاده خواهد کرد.

       passwordfile
           فایل گذرواژه‌ای که باید تغییر داده شود.

       username
           نام کاربری برای افزودن/به‌روزرسانی/حذف.

       password
           گذرواژه‌ای که در حالت دسته‌ای استفاده می‌شود.

وضعیت خروج (EXIT STATUS)
       دستور mosquitto_passwd در صورت موفقیت مقدار صفر و در صورت بروز خطا
       مقدار غیرصفر بازمی‌گرداند.

مثال‌ها (EXAMPLES)
       افزودن کاربر به یک فایل گذرواژه جدید:

       •   mosquitto_passwd -c /etc/mosquitto/passwd ral

       افزودن کاربر به یک فایل گذرواژه موجود:

       •   mosquitto_passwd /etc/mosquitto/passwd ral

       افزودن کاربر به یک فایل گذرواژه موجود با ارسال گذرواژه در خط فرمان:

       •   mosquitto_passwd -b /etc/mosquitto/passwd ral z2Dr0BsvtZ

       به‌روزرسانی گذرواژه یک کاربر در یک فایل گذرواژه موجود:

       •   mosquitto_passwd /etc/mosquitto/passwd ral

       افزودن کاربر به یک فایل گذرواژه موجود با استفاده از هش sha512 برای
       سازگاری با Mosquitto 1.6:

       •   mosquitto_passwd -H sha512 /etc/mosquitto/passwd ral

       حذف یک کاربر از فایل گذرواژه:

       •   mosquitto_passwd -D /etc/mosquitto/passwd ral

متغیرهای محیطی (ENVIRONMENT VARIABLES)
       MOSQUITTO_UNSAFE_ALLOW_SYMLINKS
           به‌طور پیش‌فرض، بارگذاری فایل‌های حساس که مسیر آن‌ها شامل یک پیوند
           نمادین (symbolic link) باشد رد خواهد شد. این متغیر محیطی را به هر
           مقداری تنظیم کنید تا بارگذاری فایل‌ها از طریق پیوندهای نمادین مجاز
           شود. توجه داشته باشید که استفاده از این متغیر می‌تواند شما را در
           معرض حملات پیوند نمادین قرار دهد و بنابراین فقط باید در مواردی
           استفاده شود که کاملاً مطمئن هستید این موضوع خطری ندارد.

اشکالات (BUGS)
       اطلاعات مربوط به اشکالات mosquitto در نشانی زیر قابل مشاهده است:
       https://github.com/eclipse-mosquitto/mosquitto/issues

همچنین ببینید (SEE ALSO)
       mosquitto(7), mosquitto(8), mosquitto.conf(5), mqtt(7)

نویسنده (AUTHOR)
       Roger Light <roger@atchoo.org>

Mosquitto Project                 04/03/2026               MOSQUITTO_PASSWD(1)