CVE-2026-129167:Seafile SeaDoc 路径穿越漏洞,恶意 ZIP 文件可导致远程代码执行
CVE-2026-129167:Seafile SeaDoc 路径穿越漏洞,恶意 ZIP 文件可导致远程代码执行
摘要: 2026 年 11 月 13 日,Seafile SeaDoc 文档转换组件披露高危漏洞 CVE-2026-129167,CVSS 4.0 评分为 9.2。攻击者在持有公开分享令牌的条件下,可以利用 Confluence 文档导入接口的文件名校验缺陷,将文件写入预期目录之外,并借助 Python 模块导入机制执行代码。漏洞涉及 SeaDoc Converter 2.0.4 至 2.0.11 之前版本,以及 3.0.0 至 3.0.8 之前版本。项目仓库已有对应修复提交。
一、漏洞概述
Seafile 是一款开源文件同步与协作平台,SeaDoc 为其提供在线文档编辑和转换能力。
企业使用这类系统时,通常会开放文档上传、分享、导入和格式转换功能。为了处理不同格式的文件,服务端需要下载、解压和解析用户提供的内容。
CVE-2026-129167 就发生在 SeaDoc Converter 的 Confluence 文档转换接口中。
| 项目 | 详细信息 |
|---|---|
| CVE 编号 | CVE-2026-129167 |
| 影响软件 | Seafile SeaDoc Converter |
| 漏洞类型 | 绝对路径穿越、远程代码执行 |
| CWE 编号 | CWE-36 |
| 公开日期 | 2026 年 11 月 13 日 |
| CVSS 4.0 | 9.2 / Critical |
| CVSS 3.1 | 8.1 / High |
| 受影响版本 | 2.0.4 至低于 2.0.11;3.0.0 至低于 3.0.8 |
| 修复版本 | 2.0.11、3.0.8 |
| 攻击前提 | 能访问相关接口,并持有公开分享令牌 |
| 可能后果 | 任意路径文件写入、远程代码执行 |
上述版本范围及评分来自 2026 年 11 月 13 日发布的 CVE 记录。项目仓库中的 cb43162 提交可以直接验证相关文件名校验逻辑已经修改。<Cite refs={[“turn320636view0”,“turn320636search4”,“turn697191view1”]}/>
二、漏洞原理:文件名为什么会影响 Python 代码执行?
1. 正常的文档导入过程
SeaDoc Converter 提供了 Confluence 文档导入功能。
服务端接收导入请求后,可以根据指定的下载地址获取 ZIP 文件,再将其中的内容解压到工作目录。
正常流程如下:
用户发起文档导入
|
v
提交文件名和下载地址
|
v
SeaDoc Converter 下载 ZIP
|
v
确定文档解压目录
|
v
解压并转换文档
|
v
返回转换结果
这里有一个关键操作:服务端需要根据文件名确定解压目录。
假设工作目录为:
/tmp/wiki/
用户上传的文件名为:
project.html.zip
程序可以提取 project 作为目录名称,最终生成:
/tmp/wiki/project/
这属于正常的文件路径拼接。
2. 漏洞发生在哪里?
受影响代码位于:
seadoc_converter/server/apis.py
涉及的接口是:
/api/v1/confluence-to-wiki/
在修复前,代码对 filename 的检查主要关注它是否为空。
后续逻辑会去掉 .html.zip 后缀,生成 space_key,再通过 os.path.join() 构造目标目录。
可以用以下 Python 代码解释问题:
import os
extract_dir = "/tmp/wiki"
space_key = "project"
space_dir = os.path.join(
extract_dir,
space_key
)
print(space_dir)
# /tmp/wiki/project
但 Python 的 os.path.join() 有一个重要特性:如果后面的参数是绝对路径,前面的目录可能被覆盖。
例如:
import os
print(os.path.join(
"/tmp/wiki",
"/var/tmp/example"
))
输出为:
/var/tmp/example
这样一来,原本应该限制在 /tmp/wiki 下的文件操作,就可能转向其他目录。
如果程序直接使用用户提交的文件名构造路径,攻击者便可能利用绝对路径绕过预期的目录限制。
3. 为什么最终会发展成远程代码执行?
公开漏洞描述指出,攻击者可以利用文件名控制解压位置,使恶意 ZIP 内容进入 Python 库搜索路径。
随后,通过文件转换请求触发相关模块导入。
攻击链可以概括为:
攻击者持有公开分享令牌
|
v
调用 Confluence 文档导入接口
|
v
提交包含绝对路径的文件名
|
v
绕过原有文件名校验
|
v
ZIP 内容被写入预期目录之外
|
v
恶意文件进入 Python 模块搜索路径
|
v
后续文件转换触发模块导入
|
v
执行攻击者控制的 Python 代码
Python 模块在首次导入时,会执行模块顶层代码。
因此,当攻击者能够影响 Python 模块搜索路径中的文件内容时,就可能将普通文件写入漏洞转化为代码执行。
这里还涉及一个重要条件:攻击者必须使文件落入能够被后续导入操作访问的位置,并成功触发对应模块加载。
这也是该漏洞 CVSS 4.0 中攻击复杂度较高、存在额外攻击条件的重要背景。
三、官方补丁修改了什么?
此次漏洞的一个优势是可以直接检查项目代码修改。
Seafile 开发者在 GitHub 提交 cb43162 中修改了 apis.py。
原来的文件名检查逻辑较为简单:
if not filename:
return {"error_msg": "path invalid."}, 400
补丁增加了多项验证。
下面是与官方修改对应的核心逻辑:
if (
not isinstance(filename, str)
or not filename.endswith(".html.zip")
or any(
char in filename
for char in ("/", "\\", "\x00")
)
):
return {"error_msg": "path invalid."}, 400
此外,补丁还检查从文件名提取的 space_key,拒绝空字符串、. 和 ..。
这些修改具有明确目的:
- 要求文件名为字符串。
- 要求使用预期的
.html.zip后缀。 - 拒绝路径分隔符。
- 拒绝空字节。
- 拒绝特殊目录名称。
通过限制文件名只能作为普通文件名使用,可以阻止其直接指定绝对路径。
该提交修改了一个文件,共增加 7 行、删除 1 行。
值得注意的是,补丁采用了较直接的输入校验方式。
在更复杂的文件处理系统中,开发者还应结合规范化路径检查、解压目标目录限制及 ZIP 内部文件名验证,建立多层保护。
四、影响范围与攻击条件
漏洞影响 SeaDoc Converter 的两个版本分支。
| 版本分支 | 受影响范围 | 修复目标 |
|---|---|---|
| 2.0.x | 2.0.4 至 2.0.11 之前 | 2.0.11 |
| 3.0.x | 3.0.0 至 3.0.8 之前 | 3.0.8 |
需要重点检查部署了 SeaDoc 文档转换服务的 Seafile 环境,尤其是开放文档分享、Confluence 导入和在线转换功能的实例。
攻击者需要具备访问相关接口的网络条件,并持有有效的公开分享令牌。
因此,风险评估需要同时考虑软件版本、接口可达性、分享令牌的获取条件,以及后续文件转换流程。
对公网开放文档协作功能的系统应优先排查。
对于仅使用 Seafile 基础文件同步功能、未部署 SeaDoc Converter 的环境,可以先核实实际组件清单。
五、风险:有 PoC 吗?是否已被利用?
1. CVSS 评分
公开记录给出的 CVSS 4.0 向量为:
CVSS:4.0/AV:N/AC:H/AT:P/PR:N/UI:N/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N
其中:
| 指标 | 含义 |
|---|---|
| AV:N | 可以通过网络攻击 |
| AC:H | 攻击复杂度高 |
| AT:P | 存在额外攻击条件 |
| PR:N | 评分体系下无需已有账户权限 |
| UI:N | 无需用户交互 |
| VC:H | 对受影响系统机密性的潜在影响高 |
| VI:H | 对受影响系统完整性的潜在影响高 |
| VA:H | 对受影响系统可用性的潜在影响高 |
这里的 PR:N 需要结合漏洞描述理解:攻击者仍需持有公开分享令牌,但该令牌并不必然代表一个已登录账户。
2. 公开 PoC
安全研究资料已经披露漏洞涉及的接口、路径穿越机制及后续 Python 模块导入条件。
公开的修复提交也为分析漏洞根因提供了直接证据。
截至 2026 年 11 月 16 日,本次核验尚未确认存在经过独立复现的完整公开利用程序。
因此,可以确认漏洞技术路径已经公开,完整攻击链的稳定复现情况仍需进一步证据。
3. 真实攻击情况
目前尚未发现足以确认 CVE-2026-129167 已被用于真实入侵的权威公开证据。
公开研究中存在针对相关请求的模拟测试,但模拟测试结果无法直接证明生产环境已经遭到攻击。
对管理员而言,优先修复仍然合理,因为漏洞能够影响服务器文件系统,并可能进一步触发代码执行。
六、如何自查?
1. 检查部署组件
如果通过 Docker 部署,可以执行:
docker ps --format \
'{{.Names}} {{.Image}}' \
| grep -Ei 'seadoc|seafile'
查看实际运行的容器。
对于 Docker Compose:
docker compose images
确认 SeaDoc Converter 对应的镜像和版本。
如果采用源码部署,可以检查 Git 仓库:
git remote -v
git log -1 --oneline
2. 检查是否包含修复提交
在源码目录执行:
git merge-base --is-ancestor \
cb43162e8bc2991a2900c8acf85090358a30e516 \
HEAD
echo $?
如果输出为 0,说明当前提交历史包含该修复提交。
如果输出其他值,需要进一步核实代码。某些发行版可能通过 cherry-pick 或其他方式回移补丁,提交历史检查无法覆盖全部情况。
还可以直接查看:
seadoc_converter/server/apis.py
确认 confluence_to_wiki() 是否包含对路径分隔符、空字节和特殊目录名称的检查。
3. 检查接口暴露情况
在授权的管理主机上,可以检查服务入口:
curl -I --connect-timeout 5 \
https://seadoc.example.com/
并检查反向代理配置中是否转发相关接口:
grep -Rni \
'confluence-to-wiki' \
/etc/nginx/ 2>/dev/null
具体代理配置可能采用统一路径转发,因此还需要结合实际部署文件检查。
对于 Nginx 访问日志:
grep 'confluence-to-wiki' \
/var/log/nginx/access.log
这可以帮助识别历史访问记录。
需要注意,普通访问日志通常不会保存完整请求体。仅靠接口访问记录,难以确认请求中是否包含恶意文件名。
七、修复方案
1. 升级至修复版本
根据公开 CVE 记录,建议使用以下版本或更新版本:
- SeaDoc Converter 2.0.x:2.0.11。
- SeaDoc Converter 3.0.x:3.0.8。
实际部署时,应优先使用 Seafile 官方维护的兼容发行包或容器镜像。
如果使用源码部署,可以检查修复提交:
https://github.com/haiwen/seadoc-converter/commit/cb43162e8bc2991a2900c8acf85090358a30e516
对于自定义版本,建议确认补丁是否已合并,并执行文档导入功能的回归测试。
2. 临时缓解措施
如果短期内无法升级,可以优先限制 Confluence 文档导入接口的访问范围。
如果业务暂时不需要该功能,可以在应用网关或反向代理层禁用相关路由。
还应限制转换服务的文件系统权限,避免服务账户写入 Python 运行环境的库目录。
对于容器化部署,可以考虑使用只读根文件系统,并将必要的临时工作目录单独挂载为可写目录。
这些措施需要结合实际运行依赖验证,避免影响正常文档转换。
3. 排查历史异常
建议重点检查:
- 文档导入接口是否出现异常请求。
- 转换服务是否写入了预期工作目录之外的文件。
- Python 库目录是否出现来源不明的模块。
- 转换服务是否启动异常子进程。
- 是否出现异常外联连接。
对于发现明显入侵迹象的服务器,应保留日志和文件证据,检查运行环境完整性,并考虑使用可信镜像重新部署。
八、总结
CVE-2026-129167 的根因是文件名校验不足,使攻击者可以利用绝对路径影响文档解压位置。
当恶意文件进入 Python 模块搜索路径,并被后续转换操作加载时,文件写入漏洞就可能发展成远程代码执行。
此次漏洞值得开发者关注的地方在于:一个看似普通的文件名参数,经过路径拼接、压缩包解压和动态模块导入,最终可能影响服务器代码执行。
对于使用 SeaDoc Converter 的管理员,应优先检查版本和修复提交,并限制不必要的文档导入接口暴露。
对于开发者,最关键的经验是:文件名、解压路径和动态代码加载必须分别实施安全检查,避免不可信输入跨越多个处理环节后获得执行能力。
- 点赞
- 收藏
- 关注作者
评论(0)