导语:termux-sync 任意文件写入漏洞(CVE-2026-86046)是近期移动端工具链中极具代表性的“不可信输入被当作可信路径”案例——一个看似无害的备份恢复功能,因信任清单中的 source 字段并裸调 tarfile.extract,直接打开了通往 $HOME 任意写入与本地代码执行的大门。
一、漏洞全景:termux-sync 任意文件写入的攻击面定位
<p class="doc-p" termux-sync 任意文件写入漏洞的严重性评级为 High(CVSS 7.1),影响 pip 包 termux-sync 1.2.3 及以下版本,1.2.4 修复。它并非传统意义上的远程网络漏洞,而是一个典型的“信任边界错位”问题:备份文件被当作可信数据,但其内容(manifest.json 中的 source 字段)实际上完全由攻击者控制。
在 Termux 这类移动端 Linux 环境中,用户主目录 $HOME 下存放着 .bashrc、.profile、各类脚本与配置。一旦攻击者能够向这些位置写入内容,下一次用户启动 shell 或执行脚本时,注入的 export 语句或恶意命令即被触发,形成从“文件写入”到“本地代码执行”的完整利用链。
该漏洞的触发条件极低:受害者只需恢复一份来自共享渠道、被入侵的 GitHub / Google Drive 存储后端或本地被替换的备份文件,即可被写入任意文件。备份恢复是用户主动执行的高信任操作,攻击者恰恰利用了这份信任。
企业级架构规范
flowchart TD
subgraph 投递层 ["攻击投递与信任边界 (Delivery Tier)"]
A["恶意备份包 (home.tar.gz + manifest.json)"] --> B["共享渠道 / 被入侵云存储后端"]
B --> C["受害者执行 termux-sync restore"]
end
subgraph 解析层 ["清单解析与路径决策 (Manifest Tier)"]
C --> D["读取 manifest files.*.source"]
D --> E["src_dir = Path(source).parent"]
end
subgraph 提取层 ["无监狱解压引擎 (Extraction Tier)"]
E --> F["tarfile.extract(member, dest_path)"]
F --> G["无路径校验 / 无 filter 过滤"]
end
subgraph 影响层 ["写入落点与代码执行 (Impact Tier)"]
G --> H["$HOME/.bashrc 等启动文件覆盖"]
G --> I["任意用户可写目录落盘"]
H --> J["下次 shell 启动触发本地代码执行"]
end
二、源码级根因拆解:两处信任缺失如何叠加成 RCE
2.1 第一处缺陷:manifest.source 被直接当作解压根目录
恢复流程中,每个归档条目的目标目录由清单字段推导而来:
src_dir = Path(info.get("source", ...)).parent
extract_archive(archive, src_dir, ...)
问题在于 info.get("source") 完全来自不可信的 manifest.json。攻击者只需将 files.home.source 设置为 $HOME/dummy_for_parent,其 .parent 即为 $HOME,解压根目录便被劫持到用户主目录。代码中没有任何校验确保 source 落在预期的恢复根之下。
2.2 第二处缺陷:tarfile.extract 无路径监狱、无 filter
with tarfile.open(archive_path, "r:*") as tf:
for member in tf.getmembers():
tf.extract(member, dest_path, set_attrs=True)
这段代码对每个 tar member 直接调用 extract,既没有校验成员路径是否逃逸出 dest_path(路径穿越),也没有使用 Python 3.12+ 提供的 filter="data" 安全过滤器。两处缺陷叠加,使得写入目的地完全由攻击者控制。
即使修复了 source 字段校验,若仍保留裸 tarfile.extract,攻击者依然可以通过 tar 成员中的 ../ 路径穿越或符号链接实现逃逸。修复必须双管齐下:固定解压根 + 启用 filter=”data”。
2.3 第三处隐患:backup_name 未做 basename 净化
公告同时指出,用于临时路径拼接的 backup_name 未校验是否包含 .. 或路径分隔符。这意味着即便解压根被固定,临时文件路径仍可能被操纵,形成二次写入面。正确做法是对其取 basename 并拒绝任何分隔符。
三、复现验证:仅用良性标记确认 termux-sync 任意文件写入
研究者采用“良性标记”方式复现,未使用任何破坏性载荷,验证了三个关键结论:
- 任意路径写入:在
$HOME下成功创建PWNED_BY_TERMUX_SYNC_RESTORE.txt,证明写入目的地由 manifest.source 完全控制。 - 攻击者选定根目录覆盖:通过构造
config条目的 source,成功在受害者模拟目录下覆盖important.conf,内容变为secret=ATTACKER_CONTROLLED。 - 启动文件风格注入:模拟的
.bashrc_sim中被注入export ATTACKER=1,直接印证了从文件写入到代码执行的升级路径。
| 验证维度 | 攻击者控制点 | 实际结果 | 风险等级 |
|---|---|---|---|
| 写入根目录 | manifest files.*.source | parent(source) 即解压目标 | 高危 |
| 成员路径 | tar member name | 无路径监狱,可穿越 | 高危 |
| 临时路径 | backup_name | 未净化 .. 与分隔符 | 中高危 |
| 代码执行 | .bashrc 覆盖 | 下次 shell 启动触发 | 严重 |
四、修复方案与工程加固:把备份当作不可信输入
4.1 官方修复方向(1.2.4)
- 不再信任 manifest 中的 source 作为解压根,改用应用固定的目标目录映射。
- 对 backup_name 执行 basename 净化,拒绝包含
..与路径分隔符的输入。 - 解压时启用
tarfile的filter="data"或等价边界检查,拒绝任何逃逸成员。 - 在文档与代码层面明确:备份文件属于不可信输入。
4.2 加固后的安全解压参考实现
import os
import tarfile
from pathlib import Path
ALLOWED_ROOTS = {
"home": Path.home(),
"config": Path.home() / ".config" / "termux-sync",
}
def safe_extract(archive_path: Path, dest_root: Path):
dest_root = dest_root.resolve()
with tarfile.open(archive_path, "r:*") as tf:
for member in tf.getmembers():
target = (dest_root / member.name).resolve()
if not str(target).startswith(str(dest_root) + os.sep):
raise ValueError(f"path escape detected: {member.name}")
tf.extractall(dest_root, filter="data")
def restore(manifest: dict):
for key, info in manifest.get("files", {}).items():
dest_root = ALLOWED_ROOTS.get(key)
if dest_root is None:
raise ValueError(f"unknown restore root: {key}")
backup_name = Path(info["backup_name"]).name
if backup_name in ("", ".", "..") or "/" in backup_name or "\" in backup_name:
raise ValueError("invalid backup_name")
safe_extract(Path(backup_name), dest_root)
安全解压的核心不是“过滤危险字符”,而是“先解析、后校验、再落盘”的路径监狱模型:任何成员在写入前都必须 resolve 并验证其前缀属于固定根目录,同时借助 Python 官方 filter=”data” 作为第二道防线。
4.3 升级与自查命令
点击展开:升级 termux-sync 与本地自查命令
# 升级到修复版本 pip install --upgrade "termux-sync>=1.2.4" # 确认当前版本 pip show termux-sync | grep -i version # 自查:检查近期恢复是否产生异常文件 find "$HOME" -maxdepth 2 -name 'PWNED*' -o -name '*.bashrc_sim' 2>/dev/null # 检查 shell 启动文件是否被注入可疑内容 grep -nE 'ATTACKER|curl|wget' "$HOME/.bashrc" "$HOME/.profile" 2>/dev/null
五、架构师视角的通用防御范式
termux-sync 任意文件写入漏洞并非孤例,它折射出备份/恢复类工具普遍存在的三类反模式,值得所有涉及归档解压的系统引以为戒:
- 反模式一:把数据当配置。清单中的路径字段本质是数据,却被当作可信配置直接参与路径决策。正确做法是数据只做映射键,目标路径由代码白名单决定。
- 反模式二:裸调标准库解压 API。tarfile / zipfile 的默认行为历史上多次引发穿越漏洞,必须显式启用安全过滤器并做前缀校验。
- 反模式三:临时路径拼接不净化。任何参与文件系统路径拼接的外部字符串,都应先取 basename 并拒绝分隔符与
..。
在 CI 中引入静态检查规则:禁止直接调用 tarfile.extract / extractall 而不带 filter 参数,可将此类漏洞在编码阶段拦截。配合依赖扫描(pip-audit / Dependabot)可覆盖已知 CVE 的升级提醒。
从更宏观的供应链安全视角看,备份文件与插件包、模型权重、配置文件一样,都属于“跨信任边界流动的不可信输入”。把“备份即不可信”写进威胁模型,是每一个涉及恢复功能的系统必须完成的基础功课。
本文核心技术背景源自 GitHub Advisory Database 官方安全公告:
GHSA-259w-wmqg-fp76 / CVE-2026-86046 (djunekz/termux-sync)
漏洞报告与致谢:Niranj R Mahaswar (@NiranjMahaswar)。
