RAD(1) Radicle CLI Manual RAD(1)

rad - ابزارهای خط فرمان Radicle

rad *

رابط خط فرمان (CLI) Radicle مجموعه‌ای از ابزارهاست که برای کاربران پشتهٔ همکاری کد همتا‌به‌همتای (peer-to-peer) Radicle طراحی شده است. این ابزار خط فرمان قابلیت مدیریت پروفایل‌های Radicle و انتشار مخازن در شبکهٔ Radicle را فراهم می‌کند.

چند نیازمندی مهم برای اجرای CLI رادیکال وجود دارد: نخست، باید نسخهٔ جدیدی از git (نسخهٔ 2.34.0 یا جدیدتر) نصب شده باشد. می‌توانید وضعیت نصب را با اجرای git --version بررسی کنید. دوم، ssh-agent باید نصب و در حال اجرا باشد. برای دور زدن ssh-agent، می‌توان متغیر محیطی RAD_PASSPHRASE را تنظیم کرد. به بخش محیط (ENVIRONMENT) مراجعه کنید.

بیایید ببینیم چگونه می‌توان Radicle را راه‌اندازی و یک مخزن را از شبکه کلون کرد.

پیش از شروع، با اجرای دستور زیر مطمئن شوید که باینری rad در سیستم شما در دسترس است:

$ rad

این دستور پایه است و خروجی آن تمامی زیردستورهای (sub-commands) موجود را نمایش خواهد داد.

هنگام استفاده از Radicle برای نخستین بار، باید یک پروفایل جدید Radicle ایجاد کنید. یک پروفایل صرفاً یک جفت‌کلید رمزنگاری است که با مقداری فضای ذخیره‌سازی در دستگاه محلی شما پیوند دارد. Radicle همه‌چیز را در دایرکتوری خانه (home) رادیکال ذخیره می‌کند که در بیشتر سیستم‌ها به‌طور پیش‌فرض ~/.radicle است. برای ایجاد پروفایل خود، دستور زیر را اجرا کنید:

$ rad auth

با وارد کردن یک نام مستعار (alias) و یک عبارت عبور (passphrase) برای محافظت از جفت‌کلید خود، مراحل را دنبال کنید. پس از پایان مراحل، DID (شناسه نامتمرکز یا Decentralized Identifier) جدید Radicle شما نمایش داده خواهد شد. این شناسه، دستگاه شما و همچنین تمام کدهایی را که منتشر می‌کنید مشخص می‌سازد. آن را آزادانه با همکاران به اشتراک بگذارید. نام مستعار شما یک نام غیریکتا است که در سراسر شبکه برای شناسایی گره (node) شما به اشتراک گذاشته می‌شود و همیشه می‌توانید بعداً آن را تغییر دهید.

پس از اجرای rad auth، باید یک پروفایل و جفت‌کلید جدید در دایرکتوری خانهٔ Radicle خود داشته باشید. این جفت‌کلید برای شناسایی همتاها در سراسر شبکه و همچنین امضای کدها و سایر مصنوعات (artifacts) منتشرشده در شبکه استفاده می‌شود.

برای جلوگیری از نیاز به وارد کردن مجدد عبارت عبور در هر بار نیاز به امضا، rad auth کلید خصوصی شما را به ssh-agent اضافه می‌کند.

همیشه می‌توانید مسیر کامل دایرکتوری خانهٔ Radicle خود را با دستور زیر نمایش دهید:

$ rad self --home

زیردستور self برای استعلام اطلاعات پروفایل مفید است. می‌توانید آن را بدون هیچ آرگومانی اجرا کنید تا تمام اطلاعات پروفایل شما، از جمله DID نمایش داده شود:

$ rad self

سامانه Radicle یک سیستم peer-to-peer است. بدین معنا که هیچ کلاینت یا سروری وجود ندارد؛ فقط گره‌ها هستند و هر کاربر باید گره متعلق به خود را اجرا کند. این امر تضمین می‌کند که هیچ نقطه شکست واحدی وجود نداشته باشد و شبکه Radicle بتواند تا زمانی که کاربرانی برای اجرای گره‌ها وجود دارند، به حیات خود ادامه دهد.

گره Radicle یک فرایند سبک‌وزن است که در پس‌زمینه اجرا می‌شود و اتصالات با گره‌های دیگر و همچنین تکثیر داده‌ها (data replication) را مدیریت می‌کند. برای بررسی وضعیت گره خود، این دستور را اجرا کنید:

$ rad node status

اگر گره در حال اجرا نیست، می‌توانید آن را با دستور زیر راه‌اندازی کنید:

$ rad node start

این کار گره را در پیش‌زمینه (foreground) راه‌اندازی می‌کند. کافی است --daemon را اضافه کنید تا گره در پس‌زمینه اجرا شود.

در صورت تبدیل شدن به دیمن، گره تمام خروجی‌ها را در فایلی در دایرکتوری خانگی Radicle شما ثبت می‌کند. در بیشتر سیستم‌ها، این مسیر ~/.radicle/node/node.log خواهد بود.

همچنین می‌توانید در هر زمان با استفاده از دستور زیر آخرین گزارش‌ها را مشاهده کنید:

$ rad node logs

پس از راه‌اندازی گره شما، تلاش خواهد کرد به همتاها (peers) در شبکه متصل شود.

توجه داشته باشید که اگر گره خود را طوری تنظیم کنید که با استفاده از systemd(1) راه‌اندازی شود، گزارش‌ها به ژورنال سیستم ارسال خواهند شد. این گزارش‌ها را می‌توان با journalctl(1) مشاهده کرد:

$ journalctl -u radicle-node -S today

برای اتصال به یک همتای مشخص، می‌توان از زیردستور connect استفاده کرد: برای مثال، جهت اتصال به یک گره عمومی (community node)، می‌توانید دستور زیر را اجرا کنید:

$ rad node connect z6MkrLMMsiPWUcNPHcRajuMi9mDfYckSoJyPwwnknocNYPm7@iris.radicle.network:8776

آرگومان ارائه‌شده به connect، نشانی (address) گره نامیده می‌شود. این نشانی از یک شناسه گره (NID)، به دنبال آن نماد @، و نام host و port تشکیل شده است. می‌توانید NID خود را با rad node status مشاهده کنید.

برای دائمی کردن این اتصالات، به گونه‌ای که همیشه در هنگام راه‌اندازی آزموده شوند، نشانی‌ها را به فایل پیکربندی خود در ~/.radicle/config.json، زیر فیلد "connect" اضافه کنید.

اکنون که به شبکه متصل شده‌اید، می‌توانیم کلون کردن مخزنی را که روی Radicle میزبانی می‌شود امتحان کنیم.

برای کلون کردن یک مخزن از شبکه Radicle، باید به یک سید (seed) متصل باشید که میزبان مخزن است. در نهایت، این امر ضروری نخواهد بود، اما در حال حاضر، اتصال مستقیم با سیدی که از آن کلون می‌کنید الزامی است. پس از برقراری اتصال، می‌توانید با ارائه یک شناسه مخزن (RID)، دستور rad clone را برای کلون کردن یک مخزن اجرا کنید. شناسه‌های RID در واقع URNهای منحصربه‌فرد جهانی هستند که یک مخزن را در Radicle مشخص می‌کنند. برای مثال، بیایید مخزن heartwood در Radicle را کلون کنیم:

$ rad clone rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5

در صورت موفقیت‌آمیز بودن دستور، یک checkout از مخزن در مسیر ./heartwood خواهید داشت، به همراه ریموت تنظیم‌شده rad، که می‌توانید از آن واکشی (pull) کرده و به آن ارسال (push) نمایید.

ریموت rad از این نظر خاص است که هنگام واکشی (fetch)، همیشه شاخه authoritative (دارای مرجعیت) مخزن را بازمی‌گرداند. این شاخه به عنوان آخرین کامیت در شاخه پیش‌فرض مخزن تعریف می‌شود که حد نصابی از نمایندگان (delegates) آن را منتشر کرده باشند.

در پشت صحنه، دستور clone چند کار مهم را انجام می‌دهد:

•مشترک دریافت به‌روزرسانی‌ها از این مخزن می‌شود؛ به این فرایند tracking (ردیابی) می‌گویند.
•یک رونوشت از مخزن را در فضای ذخیره‌سازی محلی شما ایجاد می‌کند، که یک نسخه تکثیرشده (replica) در اختیار شبکه قرار می‌دهد.
•یک ریموت Git برای هر delegate (نماینده) مخزن ایجاد می‌کند. این افراد معمولاً نگه‌دارندگان مخزن هستند.
•یک فورک (fork) از مخزن ایجاد می‌کند که تحت کلید عمومی شما قرار دارد.
•یک ریموت rad ایجاد می‌کند که می‌توانید برای به‌روزرسانی فورک خود، تغییرات را به آن push کنید.

می‌توانید تمام مخازن تکثیرشده و محلی در دسترس را با دستور زیر مشاهده کنید:

$ rad ls --all

به طور پیش‌فرض، گره شما مشترک به‌روزرسانی‌های تمام همتاها خواهد شد. این رفتار را می‌توان با ارسال --scope followed هنگام کلون کردن تغییر داد. همچنین می‌توان بعداً از طریق دستور rad seed آن را تغییر داد..SS "انتشار مخزن در Radicle"

برای انتشار یک مخزن Git موجود در شبکهٔ Radicle، به نسخهٔ کاری رفته و دستور rad init را اجرا کنید:

$ cd my-repo
$ rad init

از شما خواسته می‌شود یک نام برای مخزن و شاخهٔ پیش‌فرض وارد کنید. پس از ایجاد مخزن، شناسهٔ مخزن (RID) نمایش داده خواهد شد. این شناسه را با همکاران خود به اشتراک بگذارید تا بتوانند مخزن شما را شبیه‌سازی (clone) کنند.

توجه داشته باشید که مخزن جدید شما تنها توسط گره‌هایی بازتولید (replicate) می‌شود که به آن‌ها متصل هستید و یا خط‌مشی ردیابی باز دارند، یا به شناسهٔ گره (Node ID) شما اعتماد دارند.

دستور rad init یک ریموت ویژه در نسخهٔ کاری شما به نام rad ایجاد می‌کند. ارسال (push) به این ریموت، تغییرات را در فضای ذخیره‌سازی محلی شما و در شبکه منتشر می‌کند.

می‌توانید اطلاعات مربوط به ریموت rad را با دستور زیر مشاهده کنید:

$ git remote show rad

می‌توانید با اجرای دستور زیر از ریشهٔ هر مخزن Git، شناسهٔ مخزن (RID) را نمایش دهید:

$ rad .

همچنین می‌توانید با اجرای دستور زیر بارِ هویت (identity payload) مخزن را که شامل نام، توضیحات و شاخهٔ پیش‌فرض آن است مشاهده کنید:

$ rad inspect --payload

~/.radicle

پوشهٔ خانگی رادیکل (Radicle Home). این مکان پیش‌فرض برای فایل‌های پیکربندی Radicle، کلیدها و فضای ذخیره‌سازی مخزن است. می‌توان آن را با تنظیم متغیر محیطی RAD_HOME کنترل کرد.

~/.radicle/config.json

فایل پیکربندی پیش‌فرض برای Radicle. برای نمایش مکان دقیق آن در سیستم خود، می‌توانید از دستور rad self --config استفاده کنید.

متغیرهای محیطی گوناگونی توسط rad استفاده می‌شوند.

RAD_HOME

مکان پوشهٔ خانگی Radicle شما را تنظیم می‌کند. در صورت عدم تنظیم، پوشهٔ خانگی Radicle شما در مسیر ~/.radicle قرار خواهد گرفت.

RAD_PASSPHRASE

اگر مایلید ssh-agent را دور بزنید، می‌توانید عبارت عبور خود را در این متغیر محیطی ذخیره کنید. توجه داشته باشید که این کار امن نیست و معادل داشتن یک کلید محرمانهٔ رمزنگاری‌نشده است.

تیم Radicle

2026-08-28 rad 1.0.0