Cookie域名须动态提取并白名单校验:从c.Request().Host获取后,用正则匹配example.com等可信域,开发环境(localhost等)设Domain为空;禁用Referer/X-Forwarded-Host等不可信源,防止恶意Domain注入。

Cookie域名不能硬编码,得从请求里动态提取
直接写死 Domain: "example.com" 会导致子域名(如 api.example.com)或开发环境(localhost、127.0.0.1)下 Cookie 不被携带。浏览器按精确匹配规则拒绝发送,结果是登录态丢失、反复跳转登录页。
正确做法是根据 c.Request().Host 或 c.Request().URL.Hostname() 动态构造域名值,再传给 c.SetCookie()。
怎么安全地从 Host 提取根域名
不能直接把 c.Request().Host 当作 Domain 值——攻击者可伪造 Host 头,导致 Set-Cookie 写出 Domain=evil.com,造成信息泄露。
必须做白名单校验或结构化提取:
- 若只服务
example.com及其子域,用正则^([^.]+\.)*example\.com$匹配 Host,匹配成功后取example.com作为 Domain - 若需支持多租户(如
tenant1.app.com,tenant2.app.com),可截取最后两段:先strings.Split(host, "."),再取parts[len(parts)-2:]拼接,但要确保长度 ≥ 2 且不落入co.uk类例外 - 开发环境强制设为空字符串:
if strings.HasSuffix(host, ":3000") || host == "localhost" { domain = "" },避免浏览器拒绝
SetCookie 时 Domain 字段的坑
http.Cookie.Domain 是字符串字段,但它的语义很特殊:
使用 Cookiecutter CLI 和 Jinja2 模板生成项目脚手架。支持自定义模板注册表、通过 Python 脚本的生成后钩子,以及与 GitHub 模板仓库 API 的集成。
- 设为空字符串
""→ 浏览器按当前 Host 精确匹配(等效于不设 Domain) - 设为
"example.com"→ 允许www.example.com、api.example.com共享该 Cookie - 设为
".example.com"→ 旧写法,现代浏览器已不推荐,部分会忽略 - 设为
"localhost"→ 无效,浏览器不接受带点的 localhost 域名;必须留空 - 设为 IP 地址(如
"192.168.1.100")→ 完全无效,Domain 字段不支持 IP
示例代码片段:
host := c.Request().Host
domain := ""
if strings.Contains(host, ".") && !strings.HasPrefix(host, "127.0.0.") && host != "localhost" {
if matched, _ := regexp.MatchString(`^([^.]+\.)+example\.com$`, host); matched {
domain = "example.com"
}
}
cookie := &http.Cookie{
Name: "session_id",
Value: "abc123",
Domain: domain,
Path: "/",
MaxAge: 3600,
HttpOnly: true,
Secure: c.Request().TLS != nil,
}
c.SetCookie(cookie)
为什么不能依赖 Referer 或 X-Forwarded-Host
Referer 可被客户端篡改或缺失;X-Forwarded-Host 在没有反向代理信任链时极易伪造——一旦用它生成 Domain,就等于开放了跨域 Cookie 注入面。
唯一可信来源只有 c.Request().Host,且必须配合白名单或结构化提取逻辑。如果用了 Nginx / ALB,确保已配置 proxy_set_header Host $host;,否则 Go 读到的 Host 可能是上游地址而非原始域名。
最常被忽略的一点:本地调试时用 curl -H "Host: test.example.com" http://localhost:8080/login 模拟请求,Host 头会被 Go 正确解析,但浏览器不会发这种 Host,所以务必在真实浏览器中验证 Cookie 是否实际携带。

















