.\" generated with Ronn-NG/v0.10.1 .\" http://github.com/apjanke/ronn-ng/tree/0.10.1 .TH "HTTP" "1" "July 2026" "http developers" .SH "نام (NAME)" http \- سرور ساده HTTP برای میزبانی سریع و بی‌دردسر یک پوشه .SH "خلاصه دستور (SYNOPSIS)" \fBhttp\fR [OPTIONS] [DIRECTORY] .SH "توضیحات (DESCRIPTION)" Host These Things Please \- یک سرور ساده HTTP برای میزبانی سریع و بی‌دردسر یک پوشه\. .P هدف این است که برنامه‌ای وجود داشته باشد که به یک باینری ساده کامپایل شود و بتوان از طریق خط فرمان لینوکس به سرعت پوشه جاری را با استفاده از پروتکل HTTP میزبانی کرد\. همه‌چیز دارای مقادیر پیش‌فرض معقولی است تا نیازی \fIنباشد\fR که پارامترهایی مانند پورت مورد نظر را به آن پاس دهید\. .SH "گزینه‌ها (OPTIONS)" [DIR] .IP "" 4 .nf دایرکتوری مورد نظر برای میزبانی\. باید از قبل وجود داشته باشد\. پیش‌فرض: دایرکتوری کاری جاری\. .fi .IP "" 0 .P \-p \-\-port [PORT] .IP "" 4 .nf پورتی که سرور روی آن اجرا می‌شود\. باید عددی بین 1 تا 65'535 باشد\. مقدار 0 پورت تصادفی منتسب‌شده توسط سیستم‌عامل را انتخاب می‌کند\. پیش‌فرض: نخستین پورت آزاد از 8000 به بالا\. .fi .IP "" 0 .P \-a \-\-address [ADDRESS] .IP "" 4 .nf آدرس IP که سرور به آن متصل (bind) می‌شود\. پیش‌فرض: 0\.0\.0\.0\. .fi .IP "" 0 .P \-t \-\-temp\-dir [TEMP] .IP "" 4 .nf دایرکتوری موقت برای ذخیره داده‌های قابل نوشتن\. تنها در صورتی اثر دارد که \-\-allow\-write مشخص شده باشد یا \-\-no\-encode غیرفعال نباشد\. پیش‌فرض: $TEMP\. .fi .IP "" 0 .P \-\-ssl [TLS_IDENTITY_FILE] .IP "" 4 .nf فایل هویت TLS برای رمزگذاری ارتباطات\. رمز عبور از متغیر محیطی HTTP_SSL_PASS خوانده می‌شود، یا در صورت عدم وجود این متغیر، خالی فرض می‌شود\. پیش‌فرض: None\. .fi .IP "" 0 .P \-\-gen\-ssl .IP "" 4 .nf تولید گواهی TLS خودامضا (self\-signed) یک‌بارمصرف با استفاده از openssl و استفاده از آن در این نشست\. رمز عبور گواهی رشته خالی است، مگر در MacOS که به دلیل امتناع libssl پلتفرم از وارد کردن گواهی‌های بدون رمز، مقدار آن "password" است\. ناسازگار با \-\-ssl\. پیش‌فرض: false\. .fi .IP "" 0 .P \-\-auth [USERNAME[:PASSWORD]] .IP "" 4 .nf اطلاعات برای احراز هویت سراسری (global)\. معادل با \-\-path\-auth با مسیر ریشه و همان اطلاعات هویتی است\. این گزینه منسوخ شده و در انتشار بعدی با نسخه فعلی \-\-path\-auth جایگزین خواهد شد\. در طرح‌های جدید برای جلوگیری از رفتارهای پیش‌بینی‌نشده از \-\-path\-auth استفاده کنید\. پیش‌فرض: None\. .fi .IP "" 0 .P \-\-gen\-auth .IP "" 4 .nf تولید یک جفت نام‌کاربری:رمزعبور یک‌بارمصرف برای احراز هویت سراسری\. طوری عمل می‌کند که گویی \-\-auth با اعتبارنامه‌های تولیدشده مشخص شده است\. این گزینه منسوخ شده و در انتشار بعدی با نسخه فعلی \-\-gen\-path\-auth جایگزین خواهد شد\. در طرح‌های جدید برای جلوگیری از رفتارهای پیش‌بینی‌نشده از \-\-gen\-path\-auth استفاده کنید\. ناسازگار با \-\-auth\. پیش‌فرض: false\. .fi .IP "" 0 .P \-\-path\-auth [PATH=[USERNAME[:PASSWORD]]] .IP "" 4 .nf اطلاعات احراز هویت برای هر مسیر به صورت مجزا (per\-path)\. مسیر مشخص‌شده PATH برای دسترسی به این اعتبارنامه نیاز خواهد داشت\. اگر اعتبارنامه‌ای تعیین نشود، احراز هویت برای آن مسیر غیرفعال می‌شود، حتی اگر برای مسیرهای والد یا به صورت سراسری احراز هویت تعیین شده باشد\. این مسیرها می‌توانند به طور دلخواه تودرتو باشند\. مسیر PATH از نظر اسلش‌های ابتدا و انتها پاکسازی و نرمال می‌شود\. مشخص کردن چندباره یک PATH خطا محسوب می‌شود\. پیش‌فرض: خالی\. .fi .IP "" 0 .P \-\-gen\-path\-auth [PATH] .IP "" 4 .nf تولید یک جفت نام‌کاربری:رمزعبور یک‌بارمصرف برای احراز هویت در مسیر PATH\. نام کاربری از ۶ تا ۱۲ نویسه الفبایی\-عددی تصادفی تشکیل شده، در حالی که رمز عبور شامل ۱۰ تا ۲۵ نویسه تصادفی از بیشتر نویسه‌های قابل چاپ ASCII است\. مانند آن عمل می‌کند که \-\-path\-auth با مسیر PATH و اعتبارنامه تولیدشده تعیین شده باشد\. ناسازگار با \-\-path\-auth با مسیر PATH معادل\. پیش‌فرض: خالی\. .fi .IP "" 0 .P \-\-proxy [HEADER\-NAME:CIDR] .IP "" 4 .nf در نظر گرفتن HEADER\-NAME به عنوان هدر پروکسی forwarded\-for هنگامی که درخواست از نشانی درون شبکه مشخص‌شده توسط CIDR ارسال شده باشد\. اگر هدر تنظیم شده باشد ولی درخواست خارج از شبکه باشد، نادیده گرفته می‌شود\. به هر تعداد بار می‌تواند تکرار شود\. پیش‌فرض: none\. .fi .IP "" 0 .P \-\-proxy\-redir [HEADER\-NAME:CIDR] .IP "" 4 .nf در نظر گرفتن HEADER\-NAME به عنوان هدر پروکسی X\-Original\-URL هنگامی که درخواست از آدرس درون شبکه مشخص‌شده توسط CIDR ارسال شده باشد: این فقط برای هدرهای 303 See Other Location: هنگام تغییر مسیر ناشی از فایل ایندکس استفاده می‌شود\. به هر تعداد بار می‌تواند تکرار شود\. پیش‌فرض: none\. .fi .IP "" 0 .P \-m \-\-mime\-type [EXTENSION:MIME\-TYPE] .IP "" 4 .nf بازگرداندن MIME\-TYPE برای فایل‌های با پسوند EXTENSION\. اگر EXTENSION رشته خالی باشد، آن نوع MIME برای فایل‌های بدون پسوند بازگردانده می‌شود\. نوع MIME پیش‌فرض مطابق خروجی کریت mime_guess است (در صورت وجود)، در غیر این صورت برای فایل‌های باینری "application/octet\-stream" و برای متنی "text/plain"\. به هر تعداد بار می‌تواند تکرار شود\. پیش‌فرض: none\. .fi .IP "" 0 .P \-\-request\-bandwidth [BYTES] .IP "" 4 .nf محدود کردن پهنای باند هر درخواست به مقدار BYTES در ثانیه\. می‌تواند دارای پسوند پیشوندهای دودویی [KMGTPE] یا پیشوندهای SI [kmgtpe] باشد\. مقدار صفر محدودیت را غیرفعال می‌کند\. پیش‌فرض: 0\. .fi .IP "" 0 .P \-H \-\-header [NAME: VALUE]\|\.\|\.\|\. .IP "" 4 .nf افزودن هدرهای مشخص‌شده به تمام پاسخ‌ها\. فاصله‌های ابتدایی VALUE حذف می‌شوند\. .fi .IP "" 0 .P \-s \-\-no\-follow\-symlinks .IP "" 4 .nf دنبال نکردن پیوندهای نمادین (symlinks) هنگام دسترسی به فایل‌ها\. اگر پیوند نمادینی درخواست شود و این گزینه فعال باشد، طوری رفتار می‌شود که گویی اصلاً وجود ندارد\. .fi .IP "" 0 .P \-r \-\-sandbox\-symlinks .IP "" 4 .nf محدودسازی/قرنطینه کردن مقاصد پیوندهای نمادین تنها به زیرشاخه‌های مستقیم دایرکتوری میزبانی‌شده\. اگر فایلی خارج از زیرشاخه‌های مستقیم پوشه میزبانی‌شده درخواست شود و این فلگ روشن باشد، طوری رفتار می‌شود که گویی وجود ندارد\. .fi .IP "" 0 .P \-w \-\-allow\-write .IP "" 4 .nf مجاز شمردن عملیات نوشتن روی سرور\. عملیات نوشتن پشتیبانی‌شده کنونی: PUT و DELETE\. با درخواست‌های PUT، هدرهای X\-Last\-Modified/X\-OC\-MTime می‌توانند برحسب میلی‌ثانیه/ثانیه از مبدأ زمان (epoch) تعیین شوند و روی st_mtim فایل تنظیم می‌گردند\. به طور پیش‌فرض غیرفعال (false) است، زیرا معمولاً چیزی نیست که بخواهید به صورت تصادفی مجاز باشد\. .fi .IP "" 0 .P \-D \-\-convenient\-webdav .IP "" 4 .nf مجاز کردن درخواست‌های WebDAV از نوع MKCOL (ایجاد دایرکتوری) و MOVE (تغییر نام)\. این موارد از رابط کاربری وب قابل دسترسی هستند\. این‌ها درخواست‌های نوشتن هستند، بنابراین بدون فلگ \-w هیچ اثری ندارد\. پیش‌فرض: false\. .fi .IP "" 0 .P \-d \-\-webdav .IP "" 4 .nf پشتیبانی از درخواست‌های پروتکل WebDAV: MKCOL (ایجاد پوشه) MOVE (تغییر نام) PROPFIND (باز کردن در کلاینت WebDAV) COPY (کپی کردن فایل‌ها و پوشه‌ها) PROPPATCH (تنظیم ویژگی‌های فایل پس از بارگذاری با PUT) دستورات MKCOL و MOVE از رابط کاربری وب در دسترس هستند؛ سایر موارد، اتصال و مدیریت فایل را از طریق کلاینت WebDAV فعال می‌کنند\. به طور پیش‌فرض غیرفعال (false) است\. بر گزینه \-D اولویت دارد\. .fi .IP "" 0 .P \-A \-\-archives .IP "" 4 .nf اجازه درخواست بایگانی‌های tar و ZIP با استفاده از curl \-H 'Accept: application/tar' \|\.\|\.\|\. و با گنجاندن یک فرم در ایندکس‌های تولیدشده\. این ویژگی دو API تعریف می‌کند: 1\. درخواست GET + هدر Accept شامل هر یک از موارد زیر: application/tar application/x\-tar => tar application/zip application/x\-zip\-compressed => ZIP 2\. درخواست POST + مقادیر نشانگر تعبیه‌شده در ایندکس تولیدشده (روش POST در سایر حالات پشتیبانی نمی‌شود) نتایج از نظر منطقی معادل رفتن به مسیر درخواستی با دستور "cd \-L" (مشروط به گزینه‌های \-s و \-r) و سپس اجرای "tar \-c * \.*" است (بنابراین پیوندهای نمادین هرگز دنبال نمی‌شوند، به عنوان مثال)\. اگر فایلی یا پوشه‌ای باز نشود، از آن صرف‌نظر می‌شود و فرآیند بایگانی متوقف نمی‌گردد\. فایل‌های دارای st_nlink > 1 شناسایی شده و برای آرشیوهای tar جمع‌آوری می‌شوند\. فایل‌های ZIP تنها شامل فایل‌های معمولی، پوشه‌ها و پیوندهای نمادین هستند\. فایل‌هایی که در صورت درخواست مستقیم انکود می‌شدند، با DEFLATE فشرده می‌شوند (مشروط به گزینه \-e)\. اگر مسیر درخواستی یک فایل باشد، یک بایگانی تک‌فایلی ایجاد می‌شود\. پیش‌فرض: false\. .fi .IP "" 0 .P \-l \-\-no\-listings .IP "" 4 .nf تولید نکردن فهرست فایل‌های پوشه (directory listings)\. جدول رفتار گزینه \-\-no\-listings به همراه \-\-no\-indices: +\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+ | Path | Neither | \-i | \-l | \-l \-i | +============+=========+=========+=========+=========+ | /has\-index | index | listing | index | 404 | | /no\-index | listing | listing | 404 | 404 | +\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+ به طور پیش‌فرض غیرفعال (false) است چون عمدتاً برای اهداف اشکال‌زدایی کاربرد دارد\. .fi .IP "" 0 .P \-i \-\-no\-indices .IP "" 4 .nf ارائه ندادن خودکار فایل index در پوشه‌هایی که دارای آن هستند\. به طور پیش‌فرض غیرفعال (false) است چون عمدتاً برای اهداف اشکال‌زدایی کاربرد دارد\. .fi .IP "" 0 .TS allbox; \-I \-\-index\-readme [top bottom:]plain:README\|\.\|\.\|\. .TE .IP "" 4 .nf هنگام تولید فایل ایندکس، به دنبال فایل README در پوشه ایندکس‌شونده می‌گردد؛ اگر وجود داشته باشد، آن را خوانده و در موقعیت داده‌شده (پیش‌فرض bottom)، با قالب مشخص‌شده تزریق می‌کند (فرمت plain در تگ 
 قرار می‌گیرد)\.

آخرین گزینه درون یک گروه اعمال خواهد شد\.

هر تعداد فایل README را می‌توان اضافه کرد و به همان ترتیب داده‌شده قرار می‌گیرند\.
تمام صفحه ایندکس به همراه فایل‌های گنجانده‌شده در حافظه رم نگهداری می‌شود\.
.fi
.IP "" 0
.P
\-e \-\-no\-encode
.IP "" 4
.nf
کدگذاری نکردن فایل‌های سیستم‌فایل\.

فایل‌های کدگذاری‌شده به جای نگهداری در حافظه در پوشه موقت ذخیره می‌شوند\.

به طور پیش‌فرض غیرفعال (false) است زیرا برای کاهش مصرف پهنای باند مفید است\.
.fi
.IP "" 0
.P
\-\-encoded\-filesystem FS_LIMIT \-\-encoded\-generated GEN_LIMIT
.IP "" 4
.nf
مصرف حداکثر فضای FS_LIMIT برای فایل‌های کدگذاری‌شده سیستم‌فایل (در TEMP) و
        حداکثر حافظه GEN_LIMIT برای پاسخ‌های کدگذاری‌شده تولیدشده\.

آرگومان‌ها یک عدد صحیح هستند که می‌توانند با پسوند k (کیلوبایت)،
m (مگابایت)، g (گیگابایت)، t (ترابایت) یا p (پتابایت) بدون حساسیت به بزرگی و کوچکی حروف،
و به صورت اختیاری با حرف b همراه باشند\.

این سهمیه ممکن است به طور موقت در حین پاسخ‌دهی به یک درخواست فراتر رود\.
.fi
.IP "" 0
.P
\-\-encoded\-prune MAX_AGE
.IP "" 4
.nf
پاکسازی داده‌های ذخیره‌شده کدگذاری‌شده که سن آن‌ها بیشتر از MAX_AGE است\.

آرگومان برحسب ثانیه داده می‌شود و به صورت اختیاری می‌تواند با پسوندهای
s (ثانیه)، m (دقیقه)، h (ساعت) یا d (روز) بدون حساسیت به حروف همراه باشد\.
.fi
.IP "" 0
.P
\-x \-\-strip\-extensions
.IP "" 4
.nf
مجاز شمردن حذف پسوندهای ایندکس از مسیرهای ارائه‌شده:
یک درخواست برای /file ممکن است توسط فایل /file\.[s]htm[l] پاسخ داده شود\.

پیش‌فرض: false\.
.fi
.IP "" 0
.P
\-\-404 FALLBACK\-FILE
.IP "" 4
.nf
هنگام بازگرداندن پاسخ 404 به یک متد GET،
به جای صفحه خطای تولیدشده، فایل FALLBACK\-FILE به عنوان بدنه ارسال شود\.

مقدار FALLBACK\-FILE یک مسیر در سیستم فایل است و مشمول محدودیت‌های \-s/\-r نمی‌شود\.
.fi
.IP "" 0
.P
\-q \-\-quiet\|\.\|\.\|\.
.IP "" 4
.nf
کاهش تدریجی حجم خروجی لاگ‌ها\.

تعیین این فلگ به تعداد N بار به شکل زیر عمل می‌کند:
  N == 0 – نمایش تمام خروجی‌ها
  N >= 1 – عدم نمایش خطوط وضعیت سرویس‌دهی ("IP was served something")
  N >= 2 – عدم نمایش پیام‌های راه‌اندازی به جز اطلاعات احراز هویت در صورت وجود
  N >= 3 – عدم نمایش تمام پیام‌های راه‌اندازی
.fi
.IP "" 0
.P
\-Q \-\-quiet\-time
.IP "" 4
.nf
عدم درج برچسب زمانی (timestamp) در ابتدای خطوط لاگ\.
.fi
.IP "" 0
.P
\-c \-\-no\-colour
.IP "" 4
.nf
عدم استفاده از رنگ‌ها در خروجی لاگ\.
.fi
.IP "" 0
.SH "نکات (NOTES)"
هنگام بازگرداندن فایل‌ها از سیستم فایل، مقدار \fBETag\fR بازگردانده‌شده بر پایه سیستم فایل، i\-node و زمان دقیق ویرایش فایل محاسبه می‌شود\.
.P
طبیعتاً این بدان معناست که هنگام ارائه فایل‌ها از سیستم‌های فایلی با زمان‌بندی نادقیق (مانند FAT با تفکیک‌پذیری زمانی ۱ ثانیه‌ای)، ممکن است تغییرات از دید برنامه‌های کاربری استفاده‌کننده از \fBETag\fR پنهان بماند (اگر فایلی در 2023\-02\-12T01:00:00\.100000000 تغییر یافته باشد، کلاینتی پاسخی برای 2023\-02\-12T01:00:00\.000000000 را درخواست و کش کرده باشد، و سپس فایل دوباره در 2023\-02\-12T01:00:00\.900000000 ویرایش شود، درخواست‌های بعدی با هدر \fBIf\-None\-Match: 2023\-02\-12T01:00:00\.000000000\fR همگی پاسخ 304 Not Modified دریافت خواهند کرد)\.
.P
این مورد مسئله چندان مهمی نیست؛ از FAT به عنوان یک سیستم فایل با کارایی بالا استفاده نکنید (یا درخواست را بدون کش مجدداً بارگذاری کنید)، و هدر \fBIf\-Modified\-Since\fR نیز طبق طراحی در تمامی بک‌اندها تحت تأثیر این ویژگی قرار دارد\.
.SH "مثال‌ها (EXAMPLES)"
\fBhttp\fR
.IP "" 4
.nf
میزبانی پوشه جاری روی نخستین پورت آزاد از 8000 به بالا،
بدون دنبال کردن پیوندهای نمادین، و بدون مجوز نوشتن\.

نمونه خروجی:
  p:\eRust\ehttp> http
  Hosting "\." on port 8000 without TLS and no authentication\|\.\|\.\|\.
  Ctrl\-C to stop\.

  127\.0\.0\.1:47880 was served directory listing for \e\e?\eP:\eRust\ehttp
  127\.0\.0\.1:47902 was served file \e\e?\eP:\eRust\ehttp\ehttp\.1\.html as text/html
  127\.0\.0\.1:47916 was served file S:\eRust\-target\edoc\emain\.css as text/css
  127\.0\.0\.1:48049 asked for OPTIONS
  127\.0\.0\.1:47936 used disabled request method DELETE
  127\.0\.0\.1:48222 used disabled request method PUT
  ^C

با فرض اینکه `P:\eRust\ehttp\etarget` یک پیوند نمادین به `S:\eRust\-target` باشد،
درخواست‌های زیر به ترتیب ارسال شده‌اند:

  GET /
  GET /http\.1\.html
  GET /target/doc/main\.css
  OPTIONS
  DELETE 
  PUT 

خروجی بالا به عنوان مرجع برای سایر مثال‌ها استفاده شده است\.
.fi
.IP "" 0
.P
\fBhttp \-s\fR
.IP "" 4
.nf
مشابه مثال نخست، اما پیوندهای نمادین دنبال نمی‌شوند\.

نمونه تغییر خروجی:
  127\.0\.0\.1:47916 requested to GET nonexistent entity S:\eRust\-target\edoc\emain\.css
.fi
.IP "" 0
.P
\fBhttp \-w\fR
.IP "" 4
.nf
مشابه مثال نخست، اما با اجازه عملیات نوشتن\.

نمونه تغییر خروجی:
  127\.0\.0\.1:47936 deleted file \e\e?\eP:\eRust\ehttp\ehttp\.1\.html
  127\.0\.0\.1:48222 created \e\e?\eP:\eRust\ehttp\eindex\.html, size: 1033554B

درخواست متناظر:
  DELETE /http\.1\.html
  PUT /index\.html with request body containing roughly 1MB of data

یک تغییر رفتاری دیگر این است که در این حالت، پوشه (و فایل)
با نام "T:/\-=\- TEMP \-=\-/http\-P\-Rust\-http/writes/" و
"T:/\-=\- TEMP \-=\-/http\-P\-Rust\-http/writes/index\.html" ایجاد شدند در حالی که فایل
"P:\eRust\ehttp\ehttp\.1\.html" حذف گردید (روی پوشه‌ها نیز کار می‌کند)\.
.fi
.IP "" 0
.P
\fBhttp \-w \-t "\.\./TEMP"\fR
.IP "" 4
.nf
مشابه مثال پیشین، اما با استفاده از یک دایرکتوری موقت متفاوت\.

تغییرات رفتاری: پوشه و فایل ایجادشده با نام‌های
"P:/Rust/TEMP/http\-P\-Rust\-http/writes/" و
"P:/Rust/TEMP/http\-P\-Rust\-http/writes/index\.html" نام‌گذاری می‌شوند\.
.fi
.IP "" 0
.P
\fBhttp \-p 6969\fR
.IP "" 4
.nf
مشابه مثال نخست، اما روی پورت 6969 میزبانی می‌شود\.

با فرض آزاد بودن پورت، نمونه تغییر خروجی:
  Hosting "\." on port 6969 without TLS and no authentication\|\.\|\.\|\.

اگر پورت اشغال باشد، نمونه تغییر خروجی:
  Starting server failed: port taken\.
  
.fi
.IP "" 0
.P
\fBhttp \-a 192\.168\.65\.1\fR
.IP "" 4
.nf
مشابه مثال نخست، اما روی آدرس 192\.168\.65\.1 گوش فرا می‌دهد\.

با فرض اینکه آدرس قابل استفاده باشد، نمونه تغییر خروجی:
  Hosting "\." on port 8000 under address 192\.168\.65\.1 without TLS and no authentication\|\.\|\.\|\.

اگر آدرس غیرقابل دسترسی باشد یا وجود نداشته باشد، نمونه تغییر خروجی:
  Starting server failed: The requested address is not valid in its context\.
  (os error 10049)\.
  
.fi
.IP "" 0
.P
\fBHTTP_SSL_PASS=pwd http \-\-ssl cert/http8k\.p12\fR
.IP "" 4
.nf
مشابه مثال نخست، اما ارتباط با فایل هویت cert/http8k\.p12 و با رمز عبور "pwd"
رمزگذاری می‌شود\.

با فرض صحیح بودن رمز عبور، نمونه تغییر خروجی:
  Hosting "\." on port 8000 TLS certificate from "cert/http8k\.p12"
  and no authentication\|\.\|\.\|\.
.fi
.IP "" 0
.P
\fBhttp \-\-gen\-ssl\fR
.IP "" 4
.nf
مشابه مثال نخست، اما ارتباط با یک فایل هویت خودامضای تازه‌تولیدشده
رمزگذاری می‌شود\.

نمونه تغییر خروجی:
  Hosting "\." on port 8000 with TLS certificate from
  "$TEMP/http\-P\-Rust\-http/tls/tls\.p12" and no authentication\|\.\|\.\|\.
.fi
.IP "" 0
.P
\fBhttp \-\-path\-auth /=Pirate\fR
.IP "" 4
.nf
مشابه مثال نخست، اما تمامی کلاینت‌ها ملزم به ورود با نام کاربری "Pirate" هستند\.

نمونه تغییر خروجی:
  Hosting "\." on port 8000 without TLS and basic authentication\|\.\|\.\|\.
  Basic authentication credentials:
  Path  Username  Password
  /     Pirate

در صورت درخواست بدون احراز هویت:
  127\.0\.0\.1:15141 requested to GET http://127\.0\.0\.1:8005/ without authorisation

ارسال اعتبارنامه نامعتبر:
  127\.0\.0\.1:15142 requested to GET http://127\.0\.0\.1:8005/ with invalid credentials
  "Pirate:memelord11"

ارسال اعتبارنامه معتبر:
  127\.0\.0\.1:15142 correctly authorised to GET http://127\.0\.0\.1:8005/
  127\.0\.0\.1:15142 was served directory listing for \e\e?\eP:\eRust\ehttp
.fi
.IP "" 0
.P
\fBhttp \-\-path\-auth /=Pirate:memelord42\fR
.IP "" 4
.nf
مشابه مثال نخست، اما ملزم کردن همه کلاینت‌ها به ورود با
نام کاربری "Pirate" و رمز عبور "memelord42"\.

نمونه تغییر خروجی:
  Hosting "\." on port 8000 without TLS and basic authentication\|\.\|\.\|\.
  Basic authentication credentials:
  Path  Username  Password
  /     Pirate    memelord42

پیام‌های لاگ هنگام ارسال درخواست‌ها در بالا را ببینید\.
.fi
.IP "" 0
.P
\fBhttp \-\-gen\-path\-auth /\fR
.IP "" 4
.nf
مشابه مثال نخست، اما با تولید یک جفت نام‌کاربری:رمزعبور
و ملزم کردن همه کلاینت‌ها به ورود با آن اطلاعات\.

نمونه تغییر خروجی:
  Hosting "\." on port 8000 without TLS and basic authentication\|\.\|\.\|\.
  Basic authentication credentials:
  Path  Username  Password
  /     jOvm8yCp  &gK=h&$\-$HElLPb9HO%

پیام‌های لاگ هنگام ارسال درخواست‌ها در بالا را ببینید\.
.fi
.IP "" 0
.P
\fBhttp \-\-path\-auth /=admin:admin \-\-gen\-path\-auth /target/debug \-\-path\-auth target/doc= \-\-path\-auth target/\.rustc_info\.json= \-\-path\-auth target/release/=releases\fR
.IP "" 4
.nf
مشابه مثال نخست، اما دسترسی بدون احراز هویت به /target/doc و /target/\.rustc_info\.json مجاز است،
دسترسی به /target/release با نام کاربری "releases" و بدون رمز عبور امکان‌پذیر است،
دسترسی به /target/debug نیازمند یک جفت نام‌کاربری:رمزعبور تصادفی تولیدشده است،
و سایر مسیرها با "admin:admin" محافظت می‌شوند\.

نمونه تغییر خروجی:
  Hosting "\." on port 8000 without TLS and basic authentication\|\.\|\.\|\.
  Basic authentication credentials:
  Path                      Username  Password
  /                         admin     admin
  /target/\.rustc_info\.json
  /target/debug             PYld448   l=Z~vdp,zAt^، nabijaczleweli <\fInabijaczleweli@nabijaczleweli\.xyz\fR>، pheki، Adrian Herath <\fIadrianisuru@gmail\.com\fR>، cyqsimon، jim4067، Orhun Parmaksız <\fIorhunparmaksiz@gmail\.com\fR>، Kian\-Meng Ang <\fIkianmeng@cpan\.org\fR>، Theodore Ni، و Thorbjørn Lindeijer <\fIbjorn@lindeijer\.nl\fR>\.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
<\fIhttps://github\.com/thecoshman/http/issues\fR>
.SH "همچنین ببینید (SEE ALSO)"
<\fIhttps://github\.com/thecoshman/http\fR>