TOR-GENCERT(1) Tor Manual TOR-GENCERT(1)

tor-gencert - تولید گواهی‌ها و کلیدها برای مراجع دایرکتوری تور (Tor)

tor-gencert [-h|--help] [-v] [-r|--reuse] [--create-identity-key] [-i id_file] [-c cert_file] [-m num] [-a address:port]

دستور tor-gencert گواهی‌ها و کلیدهای خصوصی را برای استفاده توسط مراجع دایرکتوری تور (Tor directory authorities) که از پروتکل دایرکتوری نسخه ۳ تور (مورد استفاده در Tor 0.2.0 و نسخه‌های بعدی) استفاده می‌کنند، تولید می‌کند. اگر یک مرجع دایرکتوری را اجرا نمی‌کنید، نیازی به استفاده از tor-gencert ندارید.

هر مرجع دایرکتوری دارای یک «کلید هویت» (identity key) مرجع بلندمدت است (که متمایز از کلید هویتی است که به عنوان سرور تور استفاده می‌کند)؛ این کلید باید به صورت آفلاین در مکانی امن نگهداری شود. این کلید برای تایید و صدور «کلیدهای امضا» (signing keys) کوتاه‌مدت‌تر به کار می‌رود؛ کلیدهایی که به صورت آنلاین نگهداری شده و توسط مرجع دایرکتوری برای امضای رای‌ها و اسناد اجماع استفاده می‌شوند.

پس از استفاده از این برنامه برای تولید کلید امضا و گواهی، آن فایل‌ها را در زیرپوشه keys فرآیند تور خود کپی کرده و سیگنال SIGHUP را به تور ارسال کنید. کلید هویت را هرگز کپی نکنید (DO NOT COPY THE IDENTITY KEY).

-v

نمایش خروجی با جزئیات کامل (verbose).

-h یا --help

نمایش متن راهنما و خروج.

-r یا --reuse

تولید یک گواهی جدید، بدون ایجاد کلید امضای جدید. این گزینه می‌تواند برای تغییر آدرس یا طول عمر مرتبط با یک کلید مشخص به کار رود.

--create-identity-key

تولید یک کلید هویت جدید. این گزینه را تنها باید در اولین باری که tor-gencert را اجرا می‌کنید به کار ببرید؛ در آینده، باید از همان کلید هویتی که از قبل موجود است استفاده کنید.

-i FILENAME

خواندن کلید هویت از فایل مشخص‌شده. اگر فایل موجود نباشد و گزینه --create-identity-key مشخص شده باشد، کلید هویت در این فایل ایجاد می‌شود. مقدار پیش‌فرض: "./authority_identity_key"

-s FILENAME

نوشتن کلید امضا در فایل مشخص‌شده. مقدار پیش‌فرض: "./authority_signing_key"

-c FILENAME

نوشتن گواهی در فایل مشخص‌شده. مقدار پیش‌فرض: "./authority_certificate"

-m NUM

تعداد ماه‌هایی که گواهی باید معتبر باشد. مقدار پیش‌فرض: 12.

--passphrase-fd FILEDES

توصیف‌گر فایل (file descriptor) برای خواندن عبارت عبور (passphrase). خواندن در اولین نویسه NUL یا خط جدید پایان می‌یابد. پیش‌فرض: خواندن از ترمینال.

-a address:port

در صورت تعیین، ترکیب address:port به عنوان پورت دایرکتوری ترجیحی این مرجع در گواهی آن اعلان می‌شود. اگر آدرس یک نام هاست (hostname) باشد، نام هاست قبل از انتشار به یک آدرس IP تبدیل (resolve) می‌شود.

این برنامه احتمالاً روی ویندوز اجرا نمی‌شود. این مسئله بزرگی نیست، زیرا به هر حال ترجیح داده نمی‌شود که مراجع دایرکتوری روی ویندوز اجرا شوند.

tor(1)

همچنین فایل "dir-spec.txt" را که همراه با تور توزیع شده است ببینید.

Tor Project, Inc.

نویسنده.
06/25/2026 Tor