.\" Manpage for cjdroute.conf
.\"

.TH cjdroute.conf 5 "2014-03-16" "" "Cjdns Reference"

.SH "نام (NAME)"
cjdroute.conf \- فایل پیکربندی Cjdns

.SH "توضیحات (DESCRIPTION)"
فایل
.I cjdroute\&.conf
موتور مسیریابی cjdns یعنی
.BR cjdns (8)
را عموماً از طریق
.BR cjdroute (1)
پیکربندی می‌کند\&.
.PP
این پیکربندی در قالبی برگرفته از JSON نوشته شده است که همچنین از کامنت‌های سنتی C مانند کامنت‌های تک‌خطی (//) و چندخطی (/* و */) پشتیبانی می‌کند\&. علاوه بر این، مقادیر استفاده‌نشده JSON در
.I cjdroute\&.conf
توسط cjdns نادیده گرفته می‌شوند و می‌توانند به عنوان نوعی کامنت منطبق با استاندارد JSON مورد استفاده قرار گیرند.

.SH "پیکربندی (CONFIGURATION)"
\fB"privateKey":\fR "\&.\&.\&."
.RS 4
کلید خصوصی گره شما\&. این کلید باید مخفی نگه داشته شود زیرا محرمانگی و یکپارچگی داده‌های شما به آن وابسته است.
.RE
.PP

\fB"publicKey":\fR "\&.\&.\&."
.RS 4
کلید عمومی گره شما که بر اساس کلید خصوصی تولید می‌شود\&. دانستن این کلید برای همگان بلامانع است\&.
.RE
.PP

\fB"ipv6":\fR "\&.\&.\&."
.RS 4
آدرس IPv6 گره شما هنگام حضور در شبکه\&. این آدرس با استفاده از ۱۶ بایت اول هش دوگانه SHA-512 از کلید عمومی شما ایجاد می‌شود\&. تمام آدرس‌های IPv6 در cjdns باید با "fc" شروع شوند، در غیر این صورت نامعتبر هستند\&.
.RE
.PP

\fB"authorizedPasswords":\fR [\&.\&.\&.]
.RS 4
آرایه‌ای از گذرواژه‌ها که می‌توانند برای اتصال (همتاسازی / peer) به گره شما استفاده شوند\&.
.PP
\fI"password":\fR "..."
.RS 4
گذرواژه‌ای که می‌تواند برای همتاسازی با گره شما استفاده شود\&.
.RE
.PP
\fI"user":\fR "..."
.RS 4
یک رشته خوانا برای انسان که مشخص می‌کند کدام گذرواژه توسط یک همتا در رابط مدیریتی استفاده می‌شود\&. در صورت عدم درج، گذرواژه با موقعیت مکانی‌اش در آرایه (شروع از 0) شناسایی خواهد شد.
.RE
.PP
مثال:
.br
"authorizedPasswords":
.br
[
    { "password": "AnExamplePassword", "user": "Bob" },
    { "password": "YetAnotherExample", "user": "Alice" },
    { "password": "j3fus4r3gkhv80xdz1yqc0qvn1p91hr", "user": "Eve" }
.br
]
.RE
.PP

\fB"admin":\fR {\&.\&.\&.}
.RS 4
شیئی که مشخص می‌کند سرور RPC مدیریتی به چه آدرسی متصل (bind) شود و همچنین گذرواژه سرور RPC مدیریتی را تعیین می‌کند\&. دو رشته الزامی عبارتند از "bind" که باید در قالب "IP:PORT" باشد، و "password" که ترجیحاً باید یک رشته طولانی و تصادفی از نویسه‌ها باشد.
.RE
.PP

\fB"interfaces":\fR {\&.\&.\&.}
.RS 4
شیئی که مشخص می‌کند cjdns به کدام رابط‌ها متصل شود و با کدام همتاها ارتباط برقرار کند\&. دو رابط مختلف وجود دارد: UDPInterface و ETHInterface، که هر دو آرایه هستند\&. در هر آرایه گزینه‌های گوناگونی وجود دارد
.PP
\fI"bind":\fR "\&.\&.\&."
.RS 4
تعیین می‌کند رابط به چه مقداری متصل (bind) شود\&. در UDPInterface، این مقدار یک رشته IP:PORT مانند "0\&.0\&.0\&.0:12345" است، در حالی که در ETHInterface یک رابط شبکه مانند "eth0" می‌باشد\&.
.RE
.PP
\fI"beacon":\fR عدد صحیح
.RS 4
این گزینه فقط در ETHInterface یافت می‌شود و مشخص می‌کند که آیا بیکن‌های اتصال خودکار باید ارسال شوند یا شنود گردند\&. این قابلیت برای یک شبکه محلی با پیکربندی خودکار (zeroconf) کاربرد دارد\&.
.PP
.RS 4
0 \-\- غیرفعال\&.
.br
1 \-\- پذیرش بیکن‌های ورودی و تلاش برای اتصال به فرستنده\&.
.br
2 \-\- پذیرش بیکن‌های ورودی و انتشار همگانی (broadcast) بیکن‌ها در شبکه محلی\&.
.RE
.RE
.PP
\fI"connectTo":\fR {\&.\&.\&.}
.RS 4
مشخص می‌کند که cjdns باید با رابط مشخص‌شده به کدام گره‌ها متصل شود\&. می‌توان چندین گره را در یک "connectTo" قرار داد به شرطی که با کاما از یکدیگر جدا شوند\&. اگر گره‌ای آفلاین باشد یا در حین اجرا آفلاین شود، cjdns در فواصل زمانی منظم برای برقراری مجدد اتصال تلاش خواهد کرد\&. تنها تفاوت این گزینه در UDPInterface و ETHInterface این است که UDPInterface به یک "IP:PORT" متصل می‌شود در حالی که ETHInterface به یک آدرس MAC وصل می‌گردد\&.
.PP
مثال UDPInterface:
.br
"connectTo":
.br
{
.RS 4
"1\&.2\&.3\&.4:54321":
.br
{
    "login": "login From Your Peer's authorizedPasswords",
    "password": "password From Your Peer's authorizedPasswords",
    "publicKey": "Your Peer's publicKey\&.k"
.br
},
.br
"5\&.6\&.7\&.8:46321":
.br
{
    "login": "cueball",
    "password": "Correct Horse Battery Staple",
    "publicKey": "Other Peer's publicKey\&.k"
.br
}
.RE
}
.RE
.RE
.PP

\fB"router":\fR {\&.\&.\&.}
.RS 4
شیئی که اطلاعات پیکربندی مسیریاب (router) را در بر دارد
.PP
\fI"interface":\fR {\&.\&.\&.}
.RS 4
نوع رابط استفاده‌شده برای اتصال به شبکه cjdns را مشخص می‌کند\&. این بخش به یک رشته "type" و به صورت اختیاری به یک رشته "tunDevice" نیاز دارد\&. رشته "type" نوع رابط استفاده‌شده را تعریف می‌کند، هرچند در حال حاضر تنها "TUNInterface" پشتیبانی می‌شود\&. رشته "tunDevice" نام یک دستگاه TUN پایدار را برای استفاده مشخص می‌کند که برای اجرای cjdroute با کاربری مجزا به جای کاربر root مفید است\&.
.RE
.PP
\fI"ipTunnel":\fR {\&.\&.\&.}
.RS 4
سیستمی برای تونل‌سازی ICANN IPv4 و ICANN IPv6 از طریق cjdns\&. این روش از لایه سوئیچ cjdns به عنوان بستر VPN استفاده می‌کند\&.
.PP
\fBنکته:\fR صرفاً ویرایش فایل پیکربندی برای راه‌اندازی درگاه ipTunnel کافی نیست\&. لطفاً برای اطلاعات بیشتر فایل tunnel/README.md را در مخزن گیت cjdns مطالعه فرمایید
.PP
\fI"allowedConnections":\fR [\&.\&.\&.]
.RS 4
گره‌هایی که مجاز به اتصال به ما هستند (مشخص‌شده با کلید عمومی‌شان) و آدرس(های) IP که باید به آن‌ها اختصاص یابد\&. مشخص کردن تنها یک آدرس نیز بلامانع است\&.
.PP
مثال:
.PP
"allowedConnections":
.br
[
.br
    {
        "publicKey": "f64hfl7c4uxt6krmhPutTheRealAddressOfANodeHere7kfm5m0.k",
        "ip4Address": "192.168.1.24",
        "ip4Prefix": 24,
        "ip6Address": "2001:123:ab::10",
        "ip6Prefix": 0
.br
    },
.br
    {
        "publicKey": "ydq8csdk8p8ThisIsJustAnExampleAddresstxuyqdf27hvn2z0.k",
        "ip4Address": "192.168.1.25",
        "ip4Prefix": 24
.br
    }
.br
]
.RE
.PP
\fI"outgoingConnections":\fR [\&.\&.\&.]
.RS 4
آرایه‌ای از گره‌ها برای برقراری اتصال و درخواست آدرس‌های IP.
.PP
مثال:
.PP
"outgoingConnections":
.br
[
    "6743gf5tw80ExampleExampleExampleExamplevlyb23zfnuzv0.k",
    "pw9tfmr8pcrExampleExampleExampleExample8rhg1pgwpwf80.k",
    "g91lxyxhq0kExampleExampleExampleExample6t0mknuhw75l0.k"
.br
]

.RE
.RE
.RE
.PP

\fB"security":\fR [\&.\&.\&.]
.RS 4
آرایه‌ای که تعیین می‌کند پس از راه‌اندازی، برنامه به چه کاربری تغییر هویت دهد و آیا فرایند Angel از این تغییر کاربر مستثنی شود یا خیر\&.
.PP
\fI"setuser":\fR "username"
.RS 4
کاربری که پس از راه‌اندازی، جهت حفظ امنیت، به آن جابه‌جا می‌شود\&. مقدار پیش‌فرض "nobody" است\&.
.PP
.RE
\fI"exemptAngel":\fR عدد صحیح
.RS 4
مشخص می‌کند که آیا فرایند Angel از تغییر کاربر مستثنی شود یا خیر\&. فرایند Angel بخش کوچک و ایزوله‌ای از کد است که خارج از محیط محدود (sandbox) سخت‌گیرانه هسته قرار دارد اما ترافیک شبکه را مدیریت نمی‌کند\&. این گزینه باید فعال باشد تا ipTunnel بتواند آدرس‌های IP را به طور خودکار روی دستگاه TUN تنظیم کند\&.
.PP
0 \-\- غیرفعال (False)
.br
1 \-\- فعال (True)
.RE
.RE
.PP

\fB"logging":\fR {\&.\&.\&.}
.RS 4
مقدار "logTo":"stdout" را اضافه کرده یا از حالت کامنت خارج کنید تا cjdns به جای ارائه گزارش‌ها از طریق سوکت مدیریتی، لاگ‌ها را در خروجی استاندارد بنویسد
.RE
.PP

\fB"noBackground":\fR عدد صحیح
.RS 4
در صورت تنظیم روی مقداری غیر از صفر، cjdns به پس‌زمینه منشعب (fork) نمی‌شود\&. استفاده از این گزینه همراه با "logTo":"stdout" توصیه می‌شود\&.
.RE
.PP
\fB"dns":\fR {\&.\&.\&.}
.RS 4
این بخش برای پیکربندی قابلیت‌های DNS اضافه‌شده به cjdns استفاده می‌شود\&. متأسفانه در حال حاضر مستنداتی برای این بخش DNS در دسترس نیست\&.
.PP
\fI"keys":\fR [\&.\&.\&.]
.RS 4
.RE
.PP
\fI"servers":\fR [\&.\&.\&.]
.RS 4
.RE
.PP
\fI"MinSignatures":\fR عدد صحیح
.RS 4
.RE
.RE


.SH "فایل‌ها (FILES)"
.BI /etc/cjdroute.conf
.RS 4
یک مسیر معمول برای قرارگیری فایل پیکربندی\&.
.RE

.SH "همچنین ببینید (SEE ALSO)"
.BR cjdroute (1),
.BR cjdns (8)