{ "content": [ { "type": "text", "text": "# apt-transport-http (man)\n\n## NAME\n\napt-transport-http - APT transport for downloading via the Hypertext Transfer Protocol (HTTP)\n\n## DESCRIPTION\n\nThis APT transport allows the use of repositories accessed via the Hypertext Transfer\nProtocol (HTTP). It is available by default and probably the most used of all transports.\nNote that a transport is never called directly by a user but used by APT tools based on user\nconfiguration.\n\n## Sections\n\n- **NAME**\n- **DESCRIPTION**\n- **OPTIONS**\n- **EXAMPLES**\n- **SEE ALSO**\n- **BUGS**\n- **AUTHOR**\n- **NOTES**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "apt-transport-http", "section": "", "mode": "man", "summary": "apt-transport-http - APT transport for downloading via the Hypertext Transfer Protocol (HTTP)", "synopsis": null, "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [], "examples": [ "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\";", "};" ], "see_also": [ { "name": "apt.conf", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/apt.conf/5/json" }, { "name": "aptauth.conf", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/aptauth.conf/5/json" }, { "name": "sources.list", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/sources.list/5/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 12, "subsections": [] }, { "name": "OPTIONS", "lines": 62, "subsections": [] }, { "name": "EXAMPLES", "lines": 15, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "BUGS", "lines": 3, "subsections": [] }, { "name": "AUTHOR", "lines": 2, "subsections": [] }, { "name": "NOTES", "lines": 4, "subsections": [] } ], "sections": { "NAME": { "content": "apt-transport-http - APT transport for downloading via the Hypertext Transfer Protocol (HTTP)\n", "subsections": [] }, "DESCRIPTION": { "content": "This APT transport allows the use of repositories accessed via the Hypertext Transfer\nProtocol (HTTP). It is available by default and probably the most used of all transports.\nNote that a transport is never called directly by a user but used by APT tools based on user\nconfiguration.\n\nHTTP is an unencrypted transport protocol meaning that the whole communication with the\nremote server (or proxy) can be observed by a sufficiently capable attacker commonly referred\nto as a \"man in the middle\" (MITM). However, such an attacker can not modify the\ncommunication to compromise the security of your system, as APT's data security model is\nindependent of the chosen transport method. This is explained in detail in apt-secure(8). An\noverview of available transport methods is given in sources.list(5).\n", "subsections": [] }, "OPTIONS": { "content": "Various options can be set in an apt.conf(5) file to modify its behavior, ranging from proxy\nconfiguration to workarounds for specific server limitations.\n\nProxy Configuration\nThe environment variable httpproxy is supported for system wide configuration. Proxies\nspecific to APT can be configured via the option Acquire::http::Proxy. Proxies which should\nbe used only for certain hosts can be specified via Acquire::http::Proxy::host. Even more\nfine-grained control can be achieved via proxy autodetection, detailed further below. All\nthese options use the URI format scheme://[[user][:pass]@]host[:port]/. Supported URI schemes\nare socks5h (SOCKS5 with remote DNS resolution), http and https. Authentication details can\nbe supplied via aptauth.conf(5) instead of including it in the URI directly.\n\nThe various APT configuration options support the special value DIRECT meaning that no proxy\nshould be used. The environment variable noproxy is also supported for the same purpose.\n\nFurthermore, there are three settings provided for cache control with HTTP/1.1 compliant\nproxy caches: Acquire::http::No-Cache tells the proxy not to use its cached response under\nany circumstances. Acquire::http::Max-Age sets the allowed maximum age (in seconds) of an\nindex file in the cache of the proxy. Acquire::http::No-Store specifies that the proxy\nshould not store the requested archive files in its cache, which can be used to prevent the\nproxy from polluting its cache with (big) .deb files.\n\nAutomatic Proxy Configuration\nAcquire::http::Proxy-Auto-Detect can be used to specify an external command to discover the\nHTTP proxy to use. The first and only parameter is a URI denoting the host to be contacted,\nto allow for host-specific configuration. APT expects the command to output the proxy on\nstdout as a single line in the previously specified URI format or the word DIRECT if no proxy\nshould be used. No output indicates that the generic proxy settings should be used.\n\nNote that auto-detection will not be used for a host if a host-specific proxy configuration\nis already set via Acquire::http::Proxy::host.\n\nSee the squid-deb-proxy-client(1) and auto-apt-proxy(1) packages for example implementations.\n\nThis option takes precedence over the legacy option name Acquire::http::ProxyAutoDetect.\n\nConnection Configuration\nThe option Acquire::http::Timeout sets the timeout timer used by the method; this value\napplies to the connection as well as the data timeout.\n\nThe used bandwidth can be limited with Acquire::http::Dl-Limit which accepts integer values\nin kilobytes per second. The default value is 0 which deactivates the limit and tries to use\nall available bandwidth. Note that this option implicitly disables downloading from multiple\nservers at the same time.\n\nThe setting Acquire::http::Pipeline-Depth can be used to enable HTTP pipelining (RFC 2616\nsection 8.1.2.2) which can be beneficial e.g. on high-latency connections. It specifies how\nmany requests are sent in a pipeline. APT tries to detect and work around misbehaving\nwebservers and proxies at runtime, but if you know that yours does not conform to the\nHTTP/1.1 specification, pipelining can be disabled by setting the value to 0. It is enabled\nby default with the value 10.\n\nAcquire::http::AllowRedirect controls whether APT will follow redirects, which is enabled by\ndefault.\n\nAcquire::http::User-Agent can be used to set a different User-Agent for the http download\nmethod as some proxies allow access for clients only if the client uses a known identifier.\n\nAcquire::http::SendAccept is enabled by default and sends an Accept: text/* header field to\nthe server for requests without file extensions to prevent the server from attempting content\nnegotiation.\n", "subsections": [] }, "EXAMPLES": { "content": "Acquire::http {\nProxy::example.org \"DIRECT\";\nProxy \"socks5h://apt:pass@127.0.0.1:9050\";\nProxy-Auto-Detect \"/usr/local/bin/apt-http-proxy-auto-detect\";\nNo-Cache \"true\";\nMax-Age \"3600\";\nNo-Store \"true\";\nTimeout \"10\";\nDl-Limit \"42\";\nPipeline-Depth \"0\";\nAllowRedirect \"false\";\nUser-Agent \"My APT-HTTP\";\nSendAccept \"false\";\n};\n", "subsections": [] }, "SEE ALSO": { "content": "apt.conf(5) aptauth.conf(5) sources.list(5)\n", "subsections": [] }, "BUGS": { "content": "APT bug page[1]. If you wish to report a bug in APT, please see\n/usr/share/doc/debian/bug-reporting.txt or the reportbug(1) command.\n", "subsections": [] }, "AUTHOR": { "content": "APT team\n", "subsections": [] }, "NOTES": { "content": "1. APT bug page\nhttp://bugs.debian.org/src:apt\n\nAPT 2.4.14 04 April 2019 APT-TRANSPORT-HTTP(1)", "subsections": [] } } } }