.\" Text automatically generated by txt2man .TH TURN 1 "17 May 2026" "" "" .SH "اطلاعات عمومی (GENERAL INFORMATION)" دستور turnadmin یک ابزار مدیریتی برای سرور TURN است. این ابزار می‌تواند برای مدیریت حساب‌های کاربری (افزودن/حذف کاربران، تولید کلیدهای TURN برای کاربران) استفاده شود. به دلایل امنیتی، ما ذخیره گذرواژه‌ها به صورت آشکار را توصیه نمی‌کنیم. گزینه بهتر، استفاده از «کلیدهای» از پیش پردازش‌شده است که پس از آن برای احراز هویت استفاده می‌شوند. این کلیدها توسط turnadmin تولید می‌شوند. دستور turnadmin پیوندی به باینری turnserver است، اما عملکردهای متفاوتی را ارائه می‌دهد. .PP یادداشت گزینه‌ها: turnadmin برای اکثر گزینه‌ها دارای نام‌های کوتاه و طولانی است. برخی گزینه‌ها فقط شکل طولانی و برخی گزینه‌ها فقط شکل کوتاه دارند. نحو استفاده از آن‌ها در صورت نیاز به آرگومان تا حدی متفاوت است: .PP شکل کوتاه باید به این صورت استفاده شود (برای مثال): .RE .PP $ turnadmin \-u ... .RS معادل شکل طولانی باید از نویسه "=" استفاده کند: .RE .PP $ turnadmin \-\-user= ... .RS اگر گزینه از نوع فلگ باشد (نیازی به آرگومان نباشد)، نحوه استفاده از آن‌ها یکسان است، برای مثال: .RE .PP $ turnadmin \-k ... .RS معادل است با: .RE .PP $ turnadmin \-\-key ... .RS همیشه باید از گزینه \-r در دستورات مربوط به اعتبارسنجی‌های بلندمدت استفاده کنید \- زیرا داده‌های مربوط به چندین قلمرو (realm) می‌توانند در همان پایگاه داده ذخیره شوند. .SH "نام (NAME)" turnadmin \- ابزار مدیریت حساب‌های کاربری و پایگاه داده سرور TURN .SH "خلاصه دستور (SYNOPSIS)" .nf .fam C $ turnadmin [command] [options] $ turnadmin [ \-h | \-\-help] .fam T .fi .fam T .fi .SH "توضیحات (DESCRIPTION)" دستورات: .TP .B \fB\-P\fP, \-\-generate\-encrypted\-password تولید و چاپ یک شکل رمزگذاری‌شده از گذرواژه در خروجی استاندارد (برای کاربر مدیر وب یا رابط خط فرمان CLI). این مقدار سپس می‌تواند به عنوان یک کلید امن برای ذخیره‌سازی گذرواژه روی دیسک یا در پایگاه داده استفاده شود. هر بار فراخوانی برای یک گذرواژه یکسان، نتیجه متفاوتی تولید می‌کند. قالب گذرواژه رمزگذاری‌شده به این صورت است: $5$<...salt...>$<...sha256(salt+password)...>. طول نمک (salt) برابر با ۱۶ نویسه و خروجی sha256 برابر با ۶۴ نویسه است. نویسه پنجم شناسه الگوریتم (sha256) است. تنها از sha256 به عنوان تابع درهم‌سازی پشتیبانی می‌شود. .TP .B \fB\-k\fP, \-\-key تولید کلید برای کاربر سازوکار اعتبارسنجی بلندمدت (long\-term credentials). .TP .B \fB\-a\fP, \-\-add افزودن یا به‌روزرسانی یک کاربر بلندمدت. .TP .B \fB\-A\fP, \-\-add\-admin افزودن یا به‌روزرسانی یک کاربر مدیر. .TP .B \fB\-d\fP, \-\-delete حذف یک کاربر بلندمدت. .TP .B \fB\-D\fP, \-\-delete\-admin حذف یک کاربر مدیر. .TP .B \fB\-l\fP, \-\-list فهرست کردن کاربران بلندمدت در پایگاه داده. .TP .B \fB\-L\fP, \-\-list\-admin فهرست کردن کاربران مدیر در پایگاه داده. .PP \fB\-s\fP, \-\-set\-secret= افزودن راز مشترک برای TURN REST API .TP .B \fB\-S\fP, \-\-show\-secret نمایش رازهای مشترک ذخیره‌شده برای TURN REST API .PP \fB\-X\fP, \-\-delete\-secret= حذف یک راز مشترک. \-\-delete\-all_secrets حذف تمام رازهای مشترک برای REST API. .RE .RS .TP .B \fB\-O\fP, \-\-add\-origin افزودن رابطه مبدا به قلمرو (origin\-to\-realm). .TP .B \fB\-R\fP, \-\-del\-origin حذف رابطه مبدا به قلمرو (origin\-to\-realm). .TP .B \fB\-I\fP, \-\-list\-origins فهرست کردن روابط مبدا به قلمرو (origin\-to\-realm). .TP .B \fB\-g\fP, \-\-set\-realm\-option تنظیم پارامترهای قلمرو: max\-bps، total\-quota، user\-quota. .TP .B \fB\-G\fP, \-\-list\-realm\-options فهرست کردن پارامترهای قلمرو. .TP .B \fB\-E\fP, \-\-generate\-encrypted\-password\-aes تولید و چاپ یک شکل رمزگذاری‌شده از گذرواژه با AES\-128 در خروجی استاندارد .RE .RS گزینه‌های با مقادیر الزامی: .TP .B \fB\-b\fP, \-\-db, \-\-userdb نام فایل پایگاه داده کاربران SQLite (پیش‌فرض \- /var/db/turndb یا /usr/local/var/db/turndb یا /var/lib/turn/turndb). .RE همین گزینه را در بخش turnserver مشاهده کنید. .RS .TP .B \fB\-e\fP, \-\-psql\-userdb رشته اتصال پایگاه داده کاربران PostgreSQL. گزینه \-\-psql\-userdb را در بخش turnserver مشاهده کنید. .TP .B \fB\-M\fP, \-\-mysql\-userdb رشته اتصال پایگاه داده کاربران MySQL. گزینه \-\-mysql\-userdb را در بخش turnserver مشاهده کنید. .TP .B \fB\-J\fP, \-\-mongo\-userdb رشته اتصال پایگاه داده کاربران MongoDB. گزینه \-\-mysql\-mongo را در بخش turnserver مشاهده کنید. .TP .B \fB\-N\fP, \-\-redis\-userdb رشته اتصال پایگاه داده کاربران Redis. گزینه \-\-redis\-userdb را در بخش turnserver مشاهده کنید. .TP .B \fB\-u\fP, \-\-user نام کاربری. .TP .B \fB\-r\fP, \-\-realm قلمرو (Realm). .TP .B \fB\-p\fP, \-\-password گذرواژه. .TP .B \fB\-x\fP, \-\-key\-path یک کلید ۱۲۸ بیتی در مسیر مشخص‌شده تولید می‌کند. .TP .B \fB\-f\fP, \-\-file\-key\-path حاوی یک کلید ۱۲۸ بیتی در مسیر مشخص‌شده است. .TP .B \fB\-v\fP, \-\-verify یک گذرواژه رمزگذاری‌شده پایه base64 مشخص‌شده را اعتبارسنجی می‌کند. .TP .B \fB\-o\fP, \-\-origin مبدا (Origin) .TP .B \fB\-\-max\-bps\fP تنظیم مقدار پارامتر max\-bps قلمرو. .TP .B \fB\-\-total\-quota\fP تنظیم مقدار پارامتر total\-quota قلمرو. .TP .B \fB\-\-user\-quota\fP تنظیم مقدار پارامتر user\-quota قلمرو. .TP .B \fB\-h\fP, \-\-help راهنما. .PP مثال‌های دستور: .PP تولید یک شکل رمزگذاری‌شده از یک گذرواژه: .PP $ turnadmin \-P \-p .PP تولید یک کلید: .PP $ turnadmin \-k \-u \-r \-p .PP افزودن/به‌روزرسانی یک کاربر در پایگاه داده: .PP $ turnadmin \-a [\-b | \-e | \-M | \-N ] \-u \-r \-p .PP حذف یک کاربر از پایگاه داده: .PP $ turnadmin \-d [\-b | \-e | \-M | \-N ] \-u \-r .PP فهرست کردن تمام کاربران بلندمدت در پایگاه داده MySQL: .PP $ turnadmin \-l \-\-mysql\-userdb="" \-r .PP فهرست کردن تمام کاربران مدیر در پایگاه داده Redis: .PP $ turnadmin \-L \-\-redis\-userdb="" .PP تنظیم راز مشترک در پایگاه داده MySQL: .PP $ turnadmin \-s \-\-mysql\-userdb="" \-r .PP نمایش راز مشترک ذخیره‌شده در پایگاه داده PostgreSQL: .PP $ turnadmin \-S \-\-psql\-userdb="" \-r .PP تنظیم رابطه مبدا به قلمرو در پایگاه داده MySQL: .PP $ turnadmin \-\-mysql\-userdb="" \-r \-o .PP حذف رابطه مبدا به قلمرو از پایگاه داده Redis: .PP $ turnadmin \-\-redis\-userdb="" \-o .PP فهرست کردن تمام روابط مبدا به قلمرو در پایگاه داده Redis: .PP $ turnadmin \-\-redis\-userdb="" \-I .PP فهرست کردن روابط مبدا به قلمرو در پایگاه داده PostgreSQL برای یک قلمرو مشخص: .PP $ turnadmin \-\-psql\-userdb="" \-I \-r .PP ایجاد فایل کلید جدید برای رمزگذاری گذرواژه mysql: .PP $ turnadmin \-E \-\-key\-path .PP ایجاد گذرواژه رمزگذاری‌شده mysql: .PP $ turnadmin \-E \-\-file\-key\-path \-p .PP اعتبارسنجی/رمزگشایی گذرواژه رمزگذاری‌شده: .PP $ turnadmin \-\-file\-key\-path \-v .RE .PP .RS راهنما: .PP $ turnadmin \-h .SH ======================================= .SS "مستندات (DOCS)" پس از نصب، دستور زیر را اجرا کنید: .PP $ man turnadmin .PP یا در دایرکتوری ریشه پروژه: .PP $ man \-M man turnadmin .PP تا صفحه راهنما را مشاهده کنید. .SH ===================================== .SS "فایل‌ها (FILES)" /etc/turnserver.conf .PP /var/db/turndb .PP /usr/local/var/db/turndb .PP /var/lib/turn/turndb .PP /usr/local/etc/turnserver.conf .SH ===================================== .SS "دایرکتوری‌ها (DIRECTORIES)" /usr/local/share/turnserver .PP /usr/local/share/doc/turnserver .PP /usr/local/share/examples/turnserver .SH ====================================== .SS "همچنین ببینید (SEE ALSO)" turnserver, turnutils .SH ====================================== .SS "منابع وب (WEB RESOURCES)" صفحه پروژه: https://github.com/coturn/coturn صفحه ویکی: https://github.com/coturn/coturn/wiki انجمن گفتگو: https://groups.google.com/forum/?fromgroups=#!forum/turn\-server\-project\-rfc5766\-turn\-server .SH ====================================== .SS "نویسندگان (AUTHORS)" فایل AUTHORS.md را در توزیع کد منبع coturn مشاهده کنید.