funget
HTTP 文件传输工具，提供单线程下载、Range 并发下载、断点续传和 PUT/POST 上传。 核心由 Rust 实现，同时提供 Python 库和独立命令行二进制两种用法。
安装
命令行是独立的原生二进制，不需要 Python 环境。下面四条渠道装出来的
funget 命令是同一套实现，funget --version 报同一个版本号。
pip install funget 不在其中 —— 它装的是 Python 库，不带 funget 命令，
见后面的「作为 Python 库」。
apt（Debian / Ubuntu）
funget 没有进 Debian 官方档案，所以要先加一次 farfarfun 的包源。加过之后
apt install / apt upgrade 就和系统自带的包一样：
curl -fsSL https://farfarfun.github.io/packages/farfarfun.gpg \
| sudo tee /usr/share/keyrings/farfarfun.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/farfarfun.gpg] https://farfarfun.github.io/packages/deb stable main" \
| sudo tee /etc/apt/sources.list.d/farfarfun.list
sudo apt update && sudo apt install funget
amd64 和 arm64 都有。包里是静态链接的二进制，没有任何依赖，Debian 12 /
Ubuntu 22.04 这类较老的发行版同样能装。源是组织共用的
(farfarfun/packages)，加一次之后别的
farfarfun 工具也能直接 apt install。
Homebrew（macOS / Linux）
同理，先加一次 tap：
brew tap farfarfun/packages https://github.com/farfarfun/packages
brew trust farfarfun/packages
brew install funget
tap 那行要把 URL 写出来，因为 brew tap a/b 默认去找 github.com/a/homebrew-b，
而那个仓库同时还是 apt 源，不叫 homebrew-packages。trust 那行也不能省：
Homebrew 6.0 起第三方 tap 默认不可信，不 trust 就只能写全名
brew install farfarfun/packages/funget。这两行加过一次之后就是裸名字装。
formula 装的是预编好的二进制，不从源码编；它由
farfarfun/packages 按每次 release 的
SHA256SUMS 统一渲染，和 APT 索引共用一个仓库。
cargo
cargo install funget
裸二进制
从 Releases 直接取，适合 CI 镜像和不想加源的机器。推荐静态链接的 musl 版，哪个发行版都能跑：
curl -fsSL https://github.com/farfarfun/funget/releases/latest/download/funget-x86_64-unknown-linux-musl.tar.gz \
| tar -xz
sudo install -m 0755 funget /usr/local/bin/
Release 里也有不打包的裸文件（funget-x86_64-unknown-linux-gnu、
funget-aarch64-apple-darwin、funget-x86_64-pc-windows-msvc.exe 等）。
Linux 的 gnu 裸文件是动态链接的，需要 glibc 2.39 或更高；它存在的理由是
musl 静态版不走 glibc 的 NSS，靠 mDNS / LDAP / nss-* 插件解析主机名的环境只有
gnu 版能用。其余情况一律优先 musl。
附件的校验和在同一个 release 的 SHA256SUMS 里。
作为 Python 库
pip install funget
需要 Python 3.12 或更高版本。无任何运行时依赖，各平台提供预编译 wheel， 安装时不需要 Rust 工具链。
**这条渠道只给 Python API，不装 funget 命令。**命令行走上面四条渠道的任意
一条 —— 它们和 wheel 里的扩展模块是同一套引擎，只是分发方式不同。这么分是因为
把 CLI 链进扩展模块会让每个 pip install funget 的人都下载一份 clap
（约 500 KB，占扩展体积的 12%），而需要命令行的人装的通常也不是 wheel；顺带
也不再出现 pip 的 funget 和 /usr/bin/funget 在 PATH 里打架。
作为 Rust 库
下载/上传引擎本身发布在 crates.io 上，可以脱离 Python 和 CLI 单独使用：
[dependencies]
funget-core = "0.2"
crate 的版本线是独立的 0.x —— 它的公开模块当初是为跨 crate 复用而 pub 的，
不是按公共 Rust API 设计的，所以在 0.x 期间仍会调整。详见
crates/funget-core/README.md。
命令行
funget download https://httpbin.org/bytes/1024 -o file.bin
funget download https://httpbin.org/bytes/1024 --worker 8 --block-size 50
funget download https://httpbin.org/bytes/1024 -o file.bin --resume # 中断后重跑继续
funget upload ./file.bin https://httpbin.org/put
funget info https://httpbin.org/bytes/1024
download、upload、info 三个子命令共用一组 HTTP 开关，短选项与 curl 对齐：
| 开关 | 说明 |
|---|---|
-H, --header LINE |
追加请求头，格式 Name: value，可重复 |
-u, --user USER:PASSWORD |
Basic 认证。按第一个冒号切分，-u user: 是空密码 |
-A, --user-agent NAME |
覆盖默认的 funget/<版本号> |
--timeout SECONDS |
连接与读取超时。download 默认 30，upload 默认 60 |
-x, --proxy URL |
支持 http://、https://、socks5://、socks5h:// |
-k, --insecure |
接受无效证书（含主机名不匹配） |
--cacert FILE |
追加信任的 PEM 证书，可重复；一个文件里放整条证书链也可以 |
--no-native-certs |
不读系统证书库，只用内置的 webpki 根证书 |
--no-location |
不跟随重定向。funget 默认跟随，所以这里是反向开关（curl 是正向的 -L） |
--max-redirs N |
最多跟随多少跳，默认 10 |
download 和 upload 另有 -s, --silent 关掉进度条（非 TTY 环境本来就不画）。
不传 -x 时沿用 HTTP_PROXY / HTTPS_PROXY / NO_PROXY 环境变量，与 curl 一致。
运行 funget --help 或 funget <command> --help 查看完整参数。
证书
TLS 信任的是内置 webpki 根证书与系统证书库的并集，所以企业私有 CA、内网自签
证书这类场景只要机器上装好了就能直接用。极少数机器的系统证书库 rustls 一张都解析
不了（截断过的 ca-certificates bundle 等），客户端会构造失败，用
--no-native-certs 退回只用内置根证书。
Python API
download() 会先检查文件大小和 Range 支持：超过 10 MiB 且服务器支持 Range 时并发下载，否则使用单线程。
from funget import download
ok = download(
"https://httpbin.org/bytes/1024",
"./downloads/file.bin",
overwrite=True,
)
也可以显式选择下载方式：
from funget import multi_thread_download, simple_download
simple_download(
"https://httpbin.org/bytes/1024", "./downloads/small.bin", chunk_size=64 * 1024
)
multi_thread_download(
"https://httpbin.org/bytes/1024",
"./downloads/large.bin",
worker_num=8,
block_size=50,
)
上传支持 PUT 和 multipart POST：
from pathlib import Path
from tempfile import TemporaryDirectory
from funget import single_upload
with TemporaryDirectory() as directory:
filepath = Path(directory) / "example-upload.txt"
filepath.write_text("funget upload example\n", encoding="utf-8")
single_upload("https://httpbin.org/put", str(filepath), method="PUT")
single_upload("https://httpbin.org/post", str(filepath), method="POST")
该示例使用公开测试服务，运行时需要网络连接。生产环境请使用接受相应
PUT 或 multipart POST 请求的上传地址。
断点续传
传 resume=True 后，中断的下载在下次调用时从断点继续，单线程和并发两条路径都支持：
from funget import download
download("https://example.com/huge.iso", "./huge.iso", resume=True)
续传期间会在目标文件旁维护 huge.iso.funget.json 状态文件，下载成功后自动删除。
远端文件若发生变化（ETag、Last-Modified 或大小不匹配），续传状态会被丢弃并重新下载，
不会拼出一个损坏的文件。默认关闭，不开启时行为与旧版完全一致。
参数
所有公开 API 均返回 bool，不抛异常。常用参数：
| 参数 | 单位 | 说明 |
|---|---|---|
worker_num |
个 | 并发下载的分块并发数 |
block_size |
MiB | 多线程下载分块大小 |
chunk_size |
字节 | 单线程下载或上传读取块大小 |
max_retries |
次 | 失败后的最大重试次数，退避 2^n 秒 |
timeout |
秒 | 单次读取超时（不是整体下载超时） |
headers |
- | 自定义 HTTP 请求头 |
auth |
- | (用户名, 密码) 二元组，走 Basic 认证 |
resume |
- | 是否启用断点续传，默认 False |
filesize |
字节 | 已知文件大小，传了就跳过 HEAD 探测 |
insecure |
- | 接受无效证书，默认 False。对应 CLI 的 -k |
cacert |
- | 追加信任的 PEM 证书路径，对应 CLI 的 --cacert |
proxy |
- | 代理地址，不传则读 HTTP_PROXY / HTTPS_PROXY / NO_PROXY |
insecure、cacert、proxy 与 resume、filesize 一样只能按关键字传
（keyword-only）—— 原有签名是冻结的，新能力一律往后追加。完整签名见
src/funget/__init__.pyi。
重定向默认跟随，最多 10 跳；Python 侧不开放这两个旋钮，CLI 的 --no-location /
--max-redirs 是排障用的。
关于 farfarfun
farfarfun 是一个专注于实用工具库的开源组织， 涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。
- 🏠 组织主页：https://github.com/farfarfun
- 📦 PyPI：https://pypi.org/user/niuliangtao/
- 📧 联系：farfarfun@qq.com
本项目基于 MIT 协议开源。
Metadata
Release files for funget 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| funget-1.2.0.tar.gz | 74.9 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| funget-1.2.0-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details |
| funget-1.2.0-cp312-abi3-musllinux_1_2_x86_64.whl | CPython 3.12 | abi3 | Linux musl 1.2+ x86-64 | Details |
| funget-1.2.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| funget-1.2.0-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| funget-1.2.0-cp312-abi3-macosx_11_0_arm64.whl | CPython 3.12 | abi3 | macOS 11.0+ ARM64 | Details |
| funget-1.2.0-cp312-abi3-macosx_10_12_x86_64.whl | CPython 3.12 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 11.5 MB
Release files / funget-1.2.0.tar.gz
| Download URL | funget-1.2.0.tar.gz |
|---|---|
| Size | 74.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
922c4655187830aad0af9742bd517dec1ae460a94ead129620a64ef5bcb4fbb4
|
|
BLAKE2b-256 checksum How to use checksums |
44d07e1207a267c39666fa83f8cd121b8425013ae50fd80a2b01eea3cd891869
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / funget-1.2.0-cp312-abi3-win_amd64.whl
| Download URL | funget-1.2.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 1.9 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
e883431aa2d7a79bd0084a2f84e40d70ecc6016ff5ac51aeb1c4e1b0f32045cd
|
|
BLAKE2b-256 checksum How to use checksums |
6a288c7eba6d262f744f8ef6b1da52e2959b21da5a1f82ffaabaecb79a65fb51
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / funget-1.2.0-cp312-abi3-musllinux_1_2_x86_64.whl
| Download URL | funget-1.2.0-cp312-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.1 MB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
2549a22a74f51bbecfc3800572a11dd2ed72ec12a1a9d6e047dfdad33decb713
|
|
BLAKE2b-256 checksum How to use checksums |
b794d39ad00e948e86301d8b39e3b2eb5b38939da3028d01748d2f3c12de722b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / funget-1.2.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | funget-1.2.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.9 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
4bf37f2284ec6f4cc599c451d24a7fc57f7cf9b6ca340e0571739534af5fb6c0
|
|
BLAKE2b-256 checksum How to use checksums |
512732ad04ccc4838e13b057e42a94f1a29842a8db8aa56f38c1e54b7aa11933
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / funget-1.2.0-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | funget-1.2.0-cp312-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 1.8 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
91eba16742beb56ec2e4cf190e53d019ee730c05117e30b3f67ef280ff76cd24
|
|
BLAKE2b-256 checksum How to use checksums |
4e814ceae5a0b015bea03f301a0d247f221003cd742457fc5eb5e6261653b1e4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / funget-1.2.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | funget-1.2.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
eb44952ddc05265ac9d04ad3ed04b7900cbe464ec2fce7bb9acc70452d8d72d1
|
|
BLAKE2b-256 checksum How to use checksums |
d871ba568331feb1535181af65ccd363e5a2059dd36aec70e8b5bf947fd70f13
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / funget-1.2.0-cp312-abi3-macosx_10_12_x86_64.whl
| Download URL | funget-1.2.0-cp312-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 1.8 MB |
| Tags | CPython 3.12 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
c8782c47a4dde4caef3e49cf19035b7f10ce235e9bafb588f7d9e51b2c749c27
|
|
BLAKE2b-256 checksum How to use checksums |
70802f43d8859f9994736b3bb6442d00d3d3c4811f771027faed01448b89a5db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
