'\" t
.\"     Title: apt-transport-http
.\"    Author: تیم APT
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 04\ \&April\ \&2019
.\"    Manual: APT
.\"    Source: APT 3.3.3
.\"  Language: Persian
.\"
.TH "APT\-TRANSPORT\-HTTP" "1" "04\ \&April\ \&2019" "APT 3.3.3" "APT"
.\" -----------------------------------------------------------------
.\" * 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)"
apt-transport-http \- درایور انتقال APT برای دانلود از طریق پروتکل انتقال ابرمتن (HTTP)
.SH "توضیحات (DESCRIPTION)"
.PP
این درایور انتقال APT امکان استفاده از مخازنی را فراهم می‌کند که از طریق پروتکل انتقال ابرمتن (HTTP) قابل دسترسی هستند\&. این قابلیت به‌طور پیش‌فرض در دسترس بوده و احتمالاً پرکاربردترین روش در میان تمامی درایورهای انتقال است\&. توجه داشته باشید که یک درایور انتقال هرگز مستقیماً توسط کاربر فراخوانی نمی‌شود، بلکه توسط ابزارهای APT بر اساس پیکربندی کاربر استفاده می‌گردد\&.
.PP
پروتکل HTTP یک پروتکل انتقال رمزنگاری‌نشده است؛ به این معنی که کل ارتباط با سرور راه دور (یا پراکسی) می‌تواند توسط یک مهاجم با توانایی کافی که معمولاً «مرد میانی» (MITM) نامیده می‌شود، مشاهده شود\&. با این حال، چنین مهاجمی
\fIنمی‌تواند\fR
ارتباط را دستکاری کند تا امنیت سیستم شما به خطر بیفتد، چرا که مدل امنیت داده‌های APT مستقل از روش انتقال انتخاب‌شده است\&. این موضوع با جزئیات در
\fBapt-secure\fR(8)
توضیح داده شده است\&. مروری کلی بر روش‌های انتقال موجود در
\fBsources.list\fR(5)
ارائه شده است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های گوناگونی را می‌توان در یک فایل
\fBapt.conf\fR(5)
برای تغییر رفتار آن تنظیم کرد؛ این گزینه‌ها از پیکربندی پراکسی تا راهکارهای دور زدن محدودیت‌های خاص سرور را در بر می‌گیرند\&.
.SS "پیکربندی پراکسی (Proxy Configuration)"
.PP
متغیر محیطی
\fBhttp_proxy\fR
برای پیکربندی سراسری در سطح سیستم پشتیبانی می‌شود\&. پراکسی‌های ویژه APT را می‌توان از طریق گزینه
Acquire::http::Proxy
پیکربندی کرد\&. پراکسی‌هایی که فقط باید برای میزبان‌های خاصی استفاده شوند را می‌توان از طریق
Acquire::http::Proxy::\fIhost\fR
مشخص کرد\&. حتی کنترل دقیق‌تری را می‌توان از طریق تشخیص خودکار پراکسی به دست آورد که جزئیات بیشتر آن در ادامه آمده است\&. تمامی این گزینه‌ها از قالب URI زیر استفاده می‌کنند:
\fIscheme\fR://[[\fIuser\fR][:\fIpass\fR]@]\fIhost\fR[:\fIport\fR]/\&. طرح‌های URI پشتیبانی‌شده عبارتند از
socks5h
(پروتکل SOCKS5 به همراه تفکیک نام DNS از راه دور)،
http
و
https\&. جزئیات احراز هویت را می‌توان به جای درج مستقیم در URI، از طریق
\fBapt_auth.conf\fR(5)
ارائه کرد\&.
.PP
گزینه‌های مختلف پیکربندی APT از مقدار ویژه
DIRECT
پشتیبانی می‌کنند که به معنای عدم استفاده از هرگونه پراکسی است\&. متغیر محیطی
\fBno_proxy\fR
نیز برای همین منظور پشتیبانی می‌شود\&.
.PP
علاوه بر این، سه تنظیم برای کنترل حافظه موقت (کش) با پراکسی‌های سازگار با HTTP/1\&.1 در نظر گرفته شده است:
Acquire::http::No\-Cache
به پراکسی اعلام می‌کند که تحت هیچ شرایطی از پاسخ ذخیره‌شده در حافظه موقت خود استفاده نکند\&.
Acquire::http::Max\-Age
حداکثر عمر مجاز (به ثانیه) یک فایل نمایه در حافظه موقت پراکسی را تعیین می‌کند\&.
Acquire::http::No\-Store
مشخص می‌کند که پراکسی نباید فایل‌های آرشیو درخواستی را در حافظه موقت خود ذخیره کند، که می‌تواند برای جلوگیری از آلوده شدن حافظه موقت پراکسی با فایل‌های \&.deb (بزرگ) استفاده شود\&.
.SS "پیکربندی خودکار پراکسی (Automatic Proxy Configuration)"
.PP
Acquire::http::Proxy\-Auto\-Detect
می‌تواند برای مشخص کردن یک دستور خارجی جهت شناسایی پراکسی HTTP مورد استفاده قرار گیرد\&. اولین و تنها پارامتر آن، یک URI است که نشان‌دهنده میزبانِ مقصد است تا امکان پیکربندی مختص به میزبان فراهم شود\&. APT انتظار دارد که این دستور، پراکسی را در خروجی استاندارد (stdout) در یک خط واحد با همان قالب URI که پیش‌تر مشخص شد خروجی دهد، یا در صورتی که نباید از هیچ پراکسی استفاده شود، کلمه
DIRECT
را چاپ کند\&. عدم وجود هرگونه خروجی نشان می‌دهد که باید از تنظیمات عمومی پراکسی استفاده شود\&.
.PP
توجه داشته باشید که اگر یک پیکربندی پراکسی مختص میزبان از قبل از طریق
Acquire::http::Proxy::\fIhost\fR
تنظیم شده باشد، از تشخیص خودکار برای آن میزبان استفاده نخواهد شد\&.
.PP
برای نمونه‌های پیاده‌سازی، بسته‌های
\fBsquid-deb-proxy-client\fR(1)
و
\fBauto-apt-proxy\fR(1)
را ببینید\&.
.PP
این گزینه بر نام گزینه قدیمی
Acquire::http::ProxyAutoDetect
اولویت دارد\&.
.SS "پیکربندی اتصال (Connection Configuration)"
.PP
گزینه
Acquire::http::Timeout
زمان‌سنج مهلت زمانی (timeout) مورد استفاده توسط این روش را تنظیم می‌کند؛ این مقدار هم برای اتصال و هم برای مهلت زمانی دریافت داده‌ها اعمال می‌شود\&.
.PP
پهنای باند مصرفی را می‌توان با
Acquire::http::Dl\-Limit
محدود کرد که مقادیر عدد صحیح را بر حسب کیلوبایت بر ثانیه می‌پذیرد\&. مقدار پیش‌فرض 0 است که محدودیت را غیرفعال کرده و تلاش می‌کند از تمام پهنای باند موجود استفاده کند\&. توجه داشته باشید که این گزینه به‌طور ضمنی دانلود همزمان از چندین سرور را غیرفعال می‌کند\&.
.PP
تنظیم
Acquire::http::Pipeline\-Depth
می‌تواند برای فعال‌سازی خط‌لوله‌سازی HTTP (بخش 8\&.1\&.2\&.2 از RFC 2616) استفاده شود که برای مثال در اتصالات با تاخیر بالا (high\-latency) می‌تواند سودمند باشد\&. این تنظیم مشخص می‌کند که چه تعداد درخواست در یک خط‌لوله ارسال شوند\&. APT تلاش می‌کند وب‌سرورها و پراکسی‌های ناسازگار را در زمان اجرا شناسایی کرده و با آن‌ها سازگار شود، اما اگر می‌دانید که سرور شما با مشخصات HTTP/1\&.1 مطابقت ندارد، خط‌لوله‌سازی را می‌توان با تنظیم مقدار آن روی 0 غیرفعال کرد\&. این ویژگی به‌طور پیش‌فرض با مقدار 10 فعال است\&.
.PP
گزینه
Acquire::http::AllowRedirect
کنترل می‌کند که آیا APT تغییر مسیرها (redirects) را دنبال کند یا خیر، که به‌طور پیش‌فرض فعال است\&.
.PP
گزینه
Acquire::http::User\-Agent
می‌تواند برای تنظیم یک عامل کاربر (User\-Agent) متفاوت برای روش دانلود http استفاده شود، زیرا برخی پراکسی‌ها تنها در صورتی به کلاینت‌ها اجازه دسترسی می‌دهند که از یک شناسه شناخته‌شده استفاده کنند\&.
.PP
گزینه
Acquire::http::SendAccept
به‌طور پیش‌فرض فعال است و یک فیلد هدر
Accept: text/*
را برای درخواست‌های بدون پسوند فایل به سرور ارسال می‌کند تا از تلاش سرور برای مذاکره محتوا (content negotiation) جلوگیری نماید\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n \{\
.RS 4
.\}
.nf
Acquire::http {
	Proxy::example\&.org "DIRECT";
	Proxy "socks5h://apt:pass@127\&.0\&.0\&.1:9050";
	Proxy\-Auto\-Detect "/usr/local/bin/apt\-http\-proxy\-auto\-detect";
	No\-Cache "true";
	Max\-Age "3600";
	No\-Store "true";
	Timeout "10";
	Dl\-Limit "42";
	Pipeline\-Depth "0";
	AllowRedirect "false";
	User\-Agent "My APT\-HTTP";
	SendAccept "false";
};
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBapt.conf\fR(5)
\fBapt_auth.conf\fR(5)
\fBsources.list\fR(5)
.SH "اشکالات (BUGS)"
.PP
\m[blue]\fBصفحه اشکالات APT\fR\m[]\&\s-2\u[1]\d\s+2\&. اگر مایل به گزارش اشکال در APT هستید، لطفاً
/usr/share/doc/debian/bug\-reporting\&.txt
یا دستور
\fBreportbug\fR(1)
را ببینید\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBتیم APT\fR
.RS 4
.RE
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
صفحه اشکالات APT
.RS 4
\%https://bugs.debian.org/src:apt
.RE