Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/martin68/apt-smart
apt-smart: Smart, automated, robust apt-get mirror selection for Debian, Ubuntu and Linux Mint
https://github.com/martin68/apt-smart
apt apt-get apt-smart debian linuxmint mirror mirrors python ubuntu
Last synced: 1 day ago
JSON representation
apt-smart: Smart, automated, robust apt-get mirror selection for Debian, Ubuntu and Linux Mint
- Host: GitHub
- URL: https://github.com/martin68/apt-smart
- Owner: martin68
- License: mit
- Created: 2019-08-31T08:41:52.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-05-31T07:22:13.000Z (about 4 years ago)
- Last Synced: 2024-06-19T07:51:19.196Z (23 days ago)
- Topics: apt, apt-get, apt-smart, debian, linuxmint, mirror, mirrors, python, ubuntu
- Language: Python
- Homepage: https://apt-smart.readthedocs.org/
- Size: 472 KB
- Stars: 293
- Watchers: 12
- Forks: 15
- Open Issues: 17
-
Metadata Files:
- Readme: README-zh-cn.rst
- Changelog: CHANGELOG.rst
- License: LICENSE.txt
Lists
- awesome-from-stars - martin68/apt-smart - smart: Smart, automated, robust apt-get mirror selection for Debian, Ubuntu and Linux Mint (HarmonyOS / Windows Manager)
- awesome-stars - martin68/apt-smart - apt-smart: Smart, automated, robust apt-get mirror selection for Debian, Ubuntu and Linux Mint (Python)
README
apt-smart: 智能的 Debian/Ubuntu/Linux Mint 镜像源自动选择工具
=================================================================
.. image:: https://travis-ci.org/martin68/apt-smart.svg?branch=master
:target: https://travis-ci.org/martin68/apt-smart
.. image:: https://coveralls.io/repos/martin68/apt-smart/badge.svg?branch=master
:target: https://coveralls.io/r/martin68/apt-smart?branch=master
`apt-smart` 提供健壮的 Debian_ 、 Ubuntu_ 和 `Linux Mint`_ apt-get_ 镜像源 (也称软件源) 自动选择。
它能智能发现镜像源、排序镜像源并且自动切换，以及实现健壮的包列表更新 (参见 features_). 目前在 Python 2.7, 3.4, 3.5,
3.6, 3.7, 3.8 和 PyPy 测试通过 (尽管test coverage目前还很低，参见 status_).
.. contents::
:local:
Why?
--------
作为 `apt-mirror-updater `_ 的继承者,
为你寻找最好镜像源的过程中 `apt-smart` 的智能、速度、准确性和健壮性方面都有提升和改进 (参见 changelog_)。
并且有计划增加反向代理模式——在设置好之后你就可以忘掉它，它在后台运行不需要root权限，在任何时候都指向最好的镜像源。
其他发行版如 Linux Mint（已完成！）， ROS等的支持也在计划之中。
.. _features:
Features
--------
**智能发现可用的镜像源**
通过查询 `Debian mirror list `_ 或 `Ubuntu
mirror list1 `_ 或 `Ubuntu
mirror list2 `_ 或 `Linux Mint mirror list `_ (自动选择镜像源列表)来
自动查找 Debian_ 、 Ubuntu_ 和 `Linux Mint`_ 镜像源。它能够智能地获取用户所在国家的镜像源。
**智能排序可用的镜像源**
可用镜像源按照如下方式排序：带宽、是否更新及时（up-to-date），并且排除了正在更新的镜像源 (参见 `issues with mirror updates`_)。
例如使用 `--list-mirrors` 参数将会有类似输出：
.. code-block:: sh
-----------------------------------------------------------------------------------------------------
| Rank | Mirror URL | Available? | Updating? | Last updated | Bandwidth |
-----------------------------------------------------------------------------------------------------
| 1 | http://archive.ubuntu.com/ubuntu | Yes | No | Up to date | 16.95 KB/s |
| 2 | http://mirrors.cqu.edu.cn/ubuntu | Yes | No | 3 hours behind | 427.43 KB/s |
| 3 | http://mirrors.nju.edu.cn/ubuntu | Yes | No | 5 hours behind | 643.27 KB/s |
| 4 | http://mirrors.tuna.tsinghua.e...| Yes | No | 5 hours behind | 440.09 KB/s |
| 5 | http://mirrors.cn99.com/ubuntu | Yes | No | 13 hours behind | 2.64 MB/s |
| 6 | http://mirrors.huaweicloud.com...| Yes | No | 13 hours behind | 532.01 KB/s |
| 7 | http://mirrors.dgut.edu.cn/ubuntu| Yes | No | 13 hours behind | 328.25 KB/s |
| 8 | http://mirrors.aliyun.com/ubuntu | Yes | No | 23 hours behind | 1.06 MB/s |
| 9 | http://ftp.sjtu.edu.cn/ubuntu | Yes | No | 23 hours behind | 647.2 KB/s |
| 10 | http://mirrors.yun-idc.com/ubuntu| Yes | No | 23 hours behind | 526.6 KB/s |
| 11 | http://mirror.lzu.edu.cn/ubuntu | Yes | No | 23 hours behind | 210.99 KB/s |
| 12 | http://mirrors.ustc.edu.cn/ubuntu| Yes | Yes | 8 hours behind | 455.02 KB/s |
| 13 | http://mirrors.sohu.com/ubuntu | No | No | Unknown | 90.28 bytes/s |
-----------------------------------------------------------------------------------------------------
**自动切换镜像源**
设置在 ``/etc/apt/sources.list`` 的镜像源可以用一条很简单的命令更改。你可以让它自动选择镜像源或者由你指定。
**健壮的包列表更新**
好几个 apt-get_ 的子命令在更新的过程中可能会失败 (参见 `issues with mirror updates`_) ，而`apt-smart` 通过
wrap ``apt-get update`` 可以在检测到错误时重试，并且在检测到当前镜像源在“更新中“时自动切换至另一个镜像
(因为曾经出现过“更新中“的状态持续很长时间，这有时是不可接受的，特别是在自动化维护的时候)
.. _status:
Status
------
尽管设置了自动测试，但项目还处于早期状态，所以:
.. warning:: `apt-smart` 弄坏你的系统可别怪我没警告过你哦! 但碰上最糟糕的情况恐怕也只有
``/etc/apt/sources.list`` 损坏了吧。程序在做任何更改前都会自动备份一次，
所以应该能手动恢复。
Installation
------------
`apt-smart` 可以在 PyPI_ 上找到，所以安装应该很简单（把下面命令全部一次性粘贴到终端窗口）:
.. code-block:: sh
sudo apt update
sudo apt install python-pip python-setuptools python-wheel -y # 不询问直接安装python-pip等依赖
pip install --user apt-smart # --user参数表示安装到per user site-packages directory
echo "export PATH=\$(python -c 'import site; print(site.USER_BASE + \"/bin\")'):\$PATH" >> ~/.bashrc
source ~/.bashrc # 设置per user site-packages directory到PATH
安装 Python 包有几种方法 (例如 `per user site-packages directory`_, 或 `virtual environments`_ 或 安装到系统全局)
在这里不详细展开叙述。
如果 apt-smart 有新版本发布了， 你可以通过如下命令升级：
.. code-block:: sh
pip install --user apt-smart --upgrade
**注意** ： apt-smart 是个 APT 的助手工具，而 **不是** apt/apt-get 命令的替代，所以通常 apt-smart 不应该用 ``sudo`` 或以 ``su`` 运行，
如果 apt-smart 需要 root 最高权限以继续（例如更改 sources.list），它会让用户输入密码。
Usage
-----
使用 `apt-smart` 有两种方法: 作为命令行工具 ``apt-smart`` 以及作为 Python API.
作为 Python API 的详细信息请参考文档—— `Read the Docs`_.
其命令行接口如下所示：
.. contents::
:local:
.. A DRY solution to avoid duplication of the `apt-smart --help' text:
..
.. [[[cog
.. from humanfriendly.usage import inject_usage
.. inject_usage('apt_smart.cli')
.. ]]]
**Usage:** `apt-smart [OPTIONS]`
The apt-smart program automates robust apt-get mirror selection for
Debian and Ubuntu by enabling discovery of available mirrors, ranking of
available mirrors, automatic switching between mirrors and robust package list
updating.
**Supported options:**
.. csv-table::
:header: Option, Description
:widths: 30, 70
"``-r``, ``--remote-host=SSH_ALIAS``","Operate on a remote system instead of the local system. The ``SSH_ALIAS``
argument gives the SSH alias of the remote host. It is assumed that the
remote account has root privileges or password-less sudo access."
"``-f``, ``--find-current-mirror``","Determine the main mirror that is currently configured in
/etc/apt/sources.list and report its URL on standard output."
"``-F``, ``--file-to-read=local_file_absolute_path``","Read a local absolute path (path and filename must NOT contain whitespace) file
containing custom mirror URLs (one URL per line) to add custom mirrors to rank."
"``-b``, ``--find-best-mirror``","Discover available mirrors, rank them, select the best one and report its
URL on standard output."
"``-l``, ``--list-mirrors``",List available (ranked) mirrors on the terminal in a human readable format.
"``-L``, ``--url-char-len=int``","An integer to specify the length of chars in mirrors' URL to display when
using ``--list-mirrors``, default is 34"
"``-c``, ``--change-mirror=MIRROR_URL``",Update /etc/apt/sources.list to use the given ``MIRROR_URL``.
"``-a``, ``--auto-change-mirror``","Discover available mirrors, rank the mirrors by connection speed and update
status and update /etc/apt/sources.list to use the best available mirror."
"``-u``, ``--update``, ``--update-package-lists``","Update the package lists using ""apt-get update"", retrying on failure and
automatically switch to a different mirror when it looks like the current
mirror is being updated."
"``-U``, ``--ubuntu``","Ubuntu mode for Linux Mint to deal with upstream Ubuntu mirror instead of Linux Mint mirror.
e.g. ``--auto-change-mirror`` ``--ubuntu`` will auto-change Linux Mint's upstream Ubuntu mirror"
"``-x``, ``--exclude=PATTERN``","Add a pattern to the mirror selection blacklist. ``PATTERN`` is expected to be
a shell pattern (containing wild cards like ""?"" and ""\*"") that is matched
against the full URL of each mirror."
"``-v``, ``--verbose``",Increase logging verbosity (can be repeated).
"``-V``, ``--version``",Show version number and Python version.
"``-R``, ``--create-chroot=local_dir_absolute_path``",Create chroot with the best mirror in a local directory with absolute_path
"``-q``, ``--quiet``",Decrease logging verbosity (can be repeated).
"``-h``, ``--help``"," Show this message and exit.
Note: since apt-smart uses `urlopen` method in The Python Standard Library,
you can set Environment Variables to make apt-smart connect via HTTP proxy, e.g. in terminal type:
export {http,https,ftp}_proxy='http://user:[email protected]:1080'
These will not persist however (no longer active after you close the terminal),
so you may wish to add the line to your ~/.bashrc"
.. [[[end]]]
.. _issues with mirror updates:
Issues with mirror updates
--------------------------
最常见的 ``apt-get update`` 错误是 'hash sum mismatch' (参见 `Debian bug #624122`_)。
当错误产生的时候，一个名为 ``Archive-Update-in-Progress-*`` 的文件有时会出现
该镜像源的首页 (参见 `Debian bug #110837`_). 这个状态有时会持续很长时间。
My working theory about these 'hash sum mismatch' errors is that they are
caused by the fact that mirror updates aren't atomic, apparently causing
``apt-get update`` to download a package list whose datafiles aren't consistent
with each other. If this assumption proves to be correct (and also assuming
that different mirrors are updated at different times :-) then the command
``apt-smart --update-package-lists`` should work around this annoying
failure mode (by automatically switching to a different mirror when 'hash sum
mismatch' errors are encountered).
Publishing `apt-smart` to the world is my attempt to contribute to
this situation instead of complaining in bug trackers (see above) where no
robust and automated solution is emerging (at the time of writing). Who knows,
maybe some day these issues will be resolved by moving logic similar to what
I've implemented here into ``apt-get`` itself. Of course it would also help if
mirror updates were atomic...
Contact
-------
The latest version of `apt-smart` is available on PyPI_ and GitHub_.
The documentation is hosted on `Read the Docs`_ and includes a changelog_. For
bug reports please create an issue on GitHub_.
License
-------
This software is licensed under the `MIT license`_.
© 2020 martin68
© 2018 Peter Odding.
.. External references:
.. _apt-get: https://en.wikipedia.org/wiki/Advanced_Packaging_Tool
.. _at work: http://www.paylogic.com/
.. _changelog: https://apt-smart.readthedocs.io/en/latest/changelog.html
.. _Debian bug #110837: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=110837
.. _Debian bug #624122: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=624122
.. _Debian: https://en.wikipedia.org/wiki/Debian
.. _documentation: https://apt-smart.readthedocs.io
.. _GitHub: https://github.com/martin68/apt-smart
.. _Linux Mint: https://linuxmint.com
.. _MIT license: http://en.wikipedia.org/wiki/MIT_License
.. _per user site-packages directory: https://www.python.org/dev/peps/pep-0370/
.. _PyPI: https://pypi.python.org/pypi/apt-smart
.. _Read the Docs: https://apt-smart.readthedocs.io
.. _Ubuntu: https://en.wikipedia.org/wiki/Ubuntu_(operating_system)
.. _virtual environments: http://docs.python-guide.org/en/latest/dev/virtualenvs/