مدیریت کاربران (User Management)

در دستورهای زیر، کاربران با یک شناسهٔ Jabber ID با نام jid و به شکل معمول user@domain مشخص می‌شوند.

adduser jid

یک کاربر با شناسهٔ Jabber ID داده‌شده به عنوان jid به سرور اضافه می‌کند. از شما خواسته خواهد شد تا گذرواژهٔ کاربر را وارد کنید.

passwd jid

گذرواژهٔ یک کاربر موجود با شناسهٔ jid را تغییر می‌دهد. از شما خواسته خواهد شد تا گذرواژهٔ جدید کاربر را وارد کنید.

deluser jid

یک کاربر موجود با شناسهٔ jid را از سرور حذف می‌کند.

مدیریت دیمن (Daemon Management)

اگرچه prosodyctl دستورهایی برای مدیریت دیمن prosody دارد، اما چنانچه Prosody را از طریق مخازن بسته توزیع خود نصب کرده‌اید، توصیه می‌شود از امکانات مدیریت دیمن توزیع خود استفاده کنید.

برای انجام دستورهای کنترل دیمن، prosodyctl نیاز دارد مقدار pidfile در /etc/prosody/prosody.cfg.lua مشخص شده باشد. عدم تعیین آن باعث بروز خطای prosodyctl خواهد شد.

start

دیمن سرور prosody را آغاز می‌کند. در صورت اجرا به عنوان root، prosodyctl پیش از اجرا تلاش می‌کند تا به کاربری به نام “prosody” تغییر هویت دهد. این عملیات تا پنج ثانیه برای آغاز به کار سرور منتظر می‌ماند و مسدود (block) می‌شود.

stop

دیمن سرور prosody را متوقف می‌کند. این عملیات تا پنج ثانیه برای توقف کامل سرور منتظر می‌ماند و مسدود (block) می‌شود.

restart

دیمن سرور prosody را مجدداً راه‌اندازی می‌کند. معادل با اجرای prosodyctl stop و سپس prosodyctl start است.

reload

سیگنالی به دیمن سرور prosody می‌فرستد تا پیکربندی را بازخوانی کرده و فایل‌های ثبت وقایع (log) را دوباره باز کند.

status

وضعیت کنونی اجرای دیمن سرور prosody را چاپ می‌کند.

گواهی‌ها (Certificates)

ابزار prosodyctl می‌تواند گواهی‌های خودامضا، درخواست‌های صدور گواهی و کلیدهای خصوصی را برای استفاده در Prosody ایجاد کند. دستورها به شکل prosodyctl cert subcommand هستند. این دستورها فهرستی از میزبان‌ها (hosts) را برای گنجانده شدن در گواهی دریافت می‌کنند.

request hosts

ایجاد یک فایل درخواست صدور گواهی (CSR) برای ارسال به مرجع صدور گواهی (CA). می‌توان چندین میزبان را مشخص کرد؛ زیردامنه‌ها به‌طور خودکار گنجانده می‌شوند.

generate hosts

تولید یک گواهی خودامضا (self-signed).

key host [size]

تولید یک کلید خصوصی با اندازهٔ `size' بیت (پیش‌فرض 2048 است). در صورت نیاز، به‌طور خودکار توسط `request' و `generate' فراخوانی می‌شود.

config hosts

تولید یک فایل پیکربندی برای فهرست میزبان‌ها. در صورت نیاز، به‌طور خودکار توسط `request' و `generate' فراخوانی می‌شود.

import hosts paths

کپی کردن گواهی‌های مربوط به میزبان‌ها در مسیر گواهی‌ها و بازخوانی مجدد prosody.

اشکال‌زدایی (Debugging)

ابزار prosodyctl همچنین می‌تواند اطلاعاتی را پیرامون محیط، وابستگی‌ها و موارد مشابه جهت کمک به اشکال‌زدایی نمایش دهد.

about

محیط، مسیرهای گوناگون مورد استفاده توسط Prosody و وابستگی‌های نصب‌شده را نشان می‌دهد.

check [what]

بررسی‌های سلامت گوناگونی را روی پیکربندی، تنظیمات DNS و گواهی‌های TLS پیکربندی‌شده انجام می‌دهد. مقدار what می‌تواند یکی از موارد config، dns، certs، disabled و connectivity باشد تا تنها همان بررسی اجرا شود.

سازگاری با Ejabberd (Ejabberd Compatibility)

نرم‌افزار ejabberd یک سرور XMPP دیگر است که ابزار کنترلی مشابه‌ای به نام ejabberdctl را برای هدایت عملیات سرور خود فراهم می‌کند. ابزار prosodyctl دستورهایی را پیاده‌سازی کرده است که با ejabberdctl سازگار هستند. برای مشاهدهٔ جزئیات کارکرد این دستورها، به ejabberdctl(8) مراجعه کنید.

register user server password
unregister user server