{"id":20167705,"url":"https://github.com/terceiro/auto-apt-proxy","last_synced_at":"2025-04-10T01:33:49.316Z","repository":{"id":48244363,"uuid":"368621798","full_name":"terceiro/auto-apt-proxy","owner":"terceiro","description":"automatic detector of common APT proxy settings. Mirror of https://salsa.debian.org/debian/auto-apt-proxy/","archived":false,"fork":false,"pushed_at":"2025-03-04T16:43:40.000Z","size":162,"stargazers_count":7,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T03:11:46.791Z","etag":null,"topics":["apt","debian","proxy"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/terceiro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-18T17:55:39.000Z","updated_at":"2025-03-04T16:43:43.000Z","dependencies_parsed_at":"2025-01-16T17:58:17.606Z","dependency_job_id":"43ba3942-1eda-4bdd-a794-f11899dd5826","html_url":"https://github.com/terceiro/auto-apt-proxy","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terceiro%2Fauto-apt-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terceiro%2Fauto-apt-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terceiro%2Fauto-apt-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terceiro%2Fauto-apt-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/terceiro","download_url":"https://codeload.github.com/terceiro/auto-apt-proxy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248140868,"owners_count":21054362,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apt","debian","proxy"],"created_at":"2024-11-14T00:54:47.291Z","updated_at":"2025-04-10T01:33:49.307Z","avatar_url":"https://github.com/terceiro.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NAME\n\nauto-apt-proxy - autodetect common APT proxy setups\n\n# USAGE\n\n**auto-apt-proxy**\n\n**auto-apt-proxy** *[COMMAND [ARGS ...]]*\n\n# DESCRIPTION\n\n**auto-apt-proxy** is an APT proxy autodetector, and detects common setups by\nchecking localhost, your gateway and other \"interesting\" machines on your\nnetwork for well-known APT proxies such as apt-cacher-ng and others.\n\nWhen called with no arguments, **auto-apt-proxy** simply prints the address of\na detected proxy to the standard output. This package installs an APT\nconfiguration file that makes APT use **auto-apt-proxy** to detect a proxy on\nevery invocation of APT.\n\nWhen called with arguments, they are assumed to be a command. Such command will\nbe executed with the common environment variables used for specifying HTTP\nproxies (*http_proxy*, *HTTP_PROXY*) set to the detected proxy. This way the\nexecuted command will be able to transparently use any detected APT proxy. Note\nthat for this to work, any programs invoked by the given command must have\ntheir own support for detecting HTTP proxies from those environment variables,\nand for using them.\n\n# CONFIGURATION\n\nWhen your apt proxy is installed on localhost or your default gateway,\nit should Just Work.  If you install it somewhere else, you can create\nan explicit SRV record to tell auto-apt-proxy about it.\n\nSuppose your corporate domain is \"example.com\", and\napt-cacher-ng is installed on \"apt-cacher-ng.example.com\", and\nauto-apt-proxy is installed on \"alices-laptop.example.com\".\n\nThe appropriate SRV record in dnsmasq.conf would look like this:\n\n    srv-host=_apt_proxy._tcp.example.com,apt-cacher-ng.example.com,3142\n\nThe appropriate nsd/bind zonefile entry would look like this (untested):\n\n    _apt_proxy._tcp.@  IN SRV 0 0 3142 apt-cacher-ng.@\n\nAs an alternative to an SRV record, one can also define a special hostname\nwhich needs to be resolved via DNS or local */etc/hosts* file, called\n**apt-proxy**.  For example, if your network has a local apt proxy at 9.9.9.9,\nthen add this line to */etc/hosts*:\n\n    9.9.9.9    apt-proxy\n\nIf `avahi-browse` is installed, then **auto-apt-proxy** will try to\nfind any proxies announced via mDNS. If, for some reason, you would prefer the\nname of the announced proxy to be resolved via NSS rather than the somewhat\narbitrary order provided by Avahi, you can set `AUTO_APT_PROXY_AVAHI_NAME`\nenvironment variable to any non-empty string. `AUTO_APT_PROXY_AVAHI_NAME` does\nnot change which proxy is used if multiple mDNS provided proxies are available.\n\n# PRECEDENCE BETWEEN MULTIPLE POSSIBLE PROXIES\n\n**auto-apt-proxy** will look for possible proxies in the following order:\n\n- A locally running proxy on 127.0.0.1\n- A locally running proxy on other local addresses\n- A proxy running on the `apt-proxy` on DNS or local hostname resolution\n  (`/etc/hosts`).\n- A proxy on the network default gateway\n- A proxy running in the host and port declared in the `_apt_proxy_` SRV DNS\n  record\n- A proxy running and announced via mDNS (avahi).\n\n# CACHING\n\nBy default, auto-apt-proxy will cache its results for 60 seconds.\n\nTo disable the cache, set the `AUTO_APT_PROXY_NO_CACHE` environment variable to\nany non-empty string.\n\n# EXAMPLES\n\n$ **auto-apt-proxy**\n\nJust prints the detected APT proxy\n\n$ **auto-apt-proxy** debootstrap sid /my/chroot\n\nCreates a new Debian *chroot* downloading packages from the local proxy.\n\n# COPYRIGHT\n\nCopyright (C) 2016-2020 Antonio Terceiro\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterceiro%2Fauto-apt-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fterceiro%2Fauto-apt-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterceiro%2Fauto-apt-proxy/lists"}