'\" t
.\"     Title: meek-server
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net>
.\"      Date: 09/14/2021
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "MEEK\-SERVER" "1" "09/14/2021" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
meek-server \- افزونه انتقال سرور meek
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBmeek\-server\fR \fB\-\-acme\-hostnames\fR=\fIHOSTNAME\fR [\fIOPTIONS\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور meek\-server یک افزونه انتقال برای Tor است که یک جریان داده را به صورت دنباله‌ای از درخواست‌ها و پاسخ‌های HTTP کدگذاری می‌کند\&.
.sp
شما باید گواهی‌های TLS را پیکربندی کنید\&. دو روش برای برپایی گواهی‌ها وجود دارد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-acme\-hostnames\fR=\fIHOSTNAME\fR
(به همراه گزینه اختیاری
\fB\-\-acme\-email\fR=\fIEMAIL\fR)
به‌طور خودکار با استفاده از Let\(cqs Encrypt گواهی‌هایی را برای
\fIHOSTNAME\fR
دریافت می‌کند\&. هنگامی که از این گزینه استفاده می‌کنید، meek\-server باید بتواند روی پورت 80 شنود کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-cert\fR=\fIFILENAME\fR
و
\fB\-\-key\fR=\fIFILENAME\fR
به شما امکان می‌دهند از گواهی تهیه‌شده توسط خودتان از منابع خارجی استفاده کنید\&.
.RE
.sp
پیکربندی meek\-server معمولاً در یک فایل torrc قرار می‌گیرد\&. در اینجا یک نمونه پیکربندی با استفاده از گواهی‌های خودکار Let\(cqs Encrypt آمده است:
.sp
.if n \{\
.RS 4
.\}
.nf
ExtORPort auto
ServerTransportListenAddr meek 0\&.0\&.0\&.0:443
ServerTransportPlugin meek exec \&./meek\-server \-\-acme\-hostnames meek\-server\&.example \-\-log meek\-server\&.log
.fi
.if n \{\
.RE
.\}
.sp
در اینجا یک نمونه پیکربندی با استفاده از گواهی‌های تهیه‌شده از منابع خارجی آمده است:
.sp
.if n \{\
.RS 4
.\}
.nf
ExtORPort auto
ServerTransportListenAddr meek 0\&.0\&.0\&.0:8443
ServerTransportPlugin meek exec \&./meek\-server 8443 \-\-cert cert\&.pem \-\-key key\&.pem \-\-log meek\-server\&.log
.fi
.if n \{\
.RE
.\}
.sp
برای شنود روی پورت‌های 80 و 443 در لینوکس، بدون نیاز به اجرا با دسترسی ریشه (root)، می‌توانید از برنامه setcap (بخشی از libcap2) استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
setcap \*(Aqcap_net_bind_service=+ep\*(Aq /usr/local/bin/meek\-server
.fi
.if n \{\
.RE
.\}
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-acme\-email\fR=\fIEMAIL\fR
.RS 4
آدرس ایمیل اختیاری برای ثبت جهت دریافت اعلان‌های Let\(cqs Encrypt هنگام استفاده از
\fB\-\-acme\-hostnames\fR\&.
.RE
.PP
\fB\-\-acme\-hostnames\fR=\fIHOSTNAME\fR[,\fIHOSTNAME\fR]\&...
.RS 4
فهرستی از نام‌های میزبان که با کاما از هم جدا شده‌اند تا هنگام دریافت گواهی‌های خودکار از Let\(cqs Encrypt لحاظ شوند\&. دستور meek\-server یک شنونده ویژه روی پورت 80 باز می‌کند تا پیام‌های ACME را مدیریت کند؛ این شنونده از شنونده تعیین‌شده توسط
ServerTransportListenAddr
مجزا است\&. گواهی‌ها در دایرکتوری pt_state/meek\-certificate\-cache درون دایرکتوری وضعیت tor ذخیره خواهند شد\&.
.RE
.PP
\fB\-\-cert\fR=\fIFILENAME\fR
.RS 4
نام یک فایل گواهی TLS با کدگذاری PEM\&. الزامی است مگر اینکه از
\fB\-\-acme\-hostnames\fR
یا
\fB\-\-disable\-tls\fR
استفاده شود\&.
.RE
.PP
\fB\-\-disable\-tls\fR
.RS 4
استفاده از HTTP معمولی به جای HTTPS\&. این گزینه صرفاً برای مقاصد آزمایشی است\&. در محیط عملیاتی از آن استفاده نکنید\&.
.RE
.PP
\fB\-\-key\fR=\fIFILENAME\fR
.RS 4
نام یک فایل کلید خصوصی TLS با کدگذاری PEM\&. الزامی است مگر اینکه از
\fB\-\-acme\-hostnames\fR
یا
\fB\-\-disable\-tls\fR
استفاده شود\&.
.RE
.PP
\fB\-\-log\fR=\fIFILENAME\fR
.RS 4
نام فایلی که پیام‌های گزارش در آن نوشته شوند (پیش‌فرض stderr)\&.
.RE
.PP
\fB\-\-port\fR=\fIPORT\fR
.RS 4
پورت برای شنود\&. این گزینه متغیر محیطی
TOR_PT_SERVER_BINDADDR
تنظیم‌شده توسط tor را لغو می‌کند\&. در بیشتر موارد باید به جای استفاده از گزینه
\fB\-\-port\fR\c
، گزینه
\fBServerTransportListenAddr\fR
را در torrc تنظیم کنید\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک پیام راهنما و خروج\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBhttps://trac\&.torproject\&.org/projects/tor/wiki/doc/meek\fR
.SH "گزارش باگ‌ها (BUGS)"
.sp
لطفاً باگ‌ها را در \fBhttps://trac\&.torproject\&.org/projects/tor\fR گزارش دهید\&.