Revel 框架无原生域名路由分发机制,必须依赖 Nginx/Apache 反向代理按 Host 头分流,或在应用层通过 BEFORE filter 解析 $host 提取子域名并绑定租户上下文,同时确保 DNS、Nginx(proxy_set_header Host $host)与 Revel 三层 Host 透传完整。

Revel 框架本身不内置域名路由分发机制,所有多域名或二级域名逻辑必须由 Web 服务器(Nginx/Apache)或应用层手动解析 Host 头完成。直接在 Revel 路由里写“按域名跳转”不可行——它没有类似 Laravel 的 Route::domain() 或 Webman 的 webman/domain 插件。
Nginx 反向代理层做 Host 分流最可靠
这是生产环境首选方案:让 Nginx 根据 Host 头将请求转发到不同 Revel 实例端口,或注入路径前缀后统一打给同一实例。Revel 应用只需专注业务,不感知域名差异。
- 每个域名配独立
server块,server_name明确写死(如admin.example.com),避免泛匹配引发的 SSL 或 Cookie 作用域问题 - 若共用同一 Revel 进程,可用
proxy_set_header X-Host $host透传原始 Host,并在 Revel 中读取该 header(而非Request.Host,因反代后可能被覆盖) - 务必关闭 Revel 的开发模式(
REVEL_RUNMODE=prod),并确保-addr 127.0.0.1,禁止监听0.0.0.0 - SSL 终止建议放在 Nginx 层,不要让 Revel 直接处理 HTTPS;证书需覆盖所有绑定域名(通配符证书
*.example.com或 SAN 多域名证书)
Revel 应用内用 filter 解析 Host 实现动态租户识别
当所有子域名都指向同一个 Revel 实例(如 SaaS 场景下 client1.example.com、client2.example.com),需在代码中提取子域名并绑定上下文。不能依赖路由定义,而应使用 Revel 的 Filter 在请求早期介入。
- 在
app/init.go的init()函数中注册BEFOREfilter,例如:revel.InterceptFunc(tenantFilter, revel.BEFORE) - filter 函数内用
req.Request.Host获取原始 Host(注意:若 Nginx 未透传,此处拿到的是127.0.0.1:8089) - 用
strings.Split(req.Request.Host, ".")提取子域名部分,再查数据库或配置映射租户 ID - 把租户信息存入
req.Context或revel.Controller.Tenant字段,后续 action 可直接使用 - 避免在 controller 构造函数里解析 Host——此时
req尚未完全初始化,Host可能为空或错误
泛解析(Wildcard DNS)+ Nginx server_name *.example.com 要慎用
虽然配置简单,但 Revel 无法自动区分 user1.example.com 和 user2.example.com,必须靠应用层手动解析 Host。且 Nginx 的 server_name *.example.com 不匹配根域名 example.com,需额外加一条 server_name example.com 块。
- DNS 泛解析(A 记录
*→ IP)只解决“流量进来”,不解决“怎么路由” - Nginx 的
server_name *.example.com是字面匹配,不是正则;它匹配a.example.com、b.example.com,但不匹配www.example.com(因www是二级域,*只匹配一级子域) - 若要同时支持
www、api、client1等,推荐显式列出:server_name www.example.com api.example.com ~^[a-zA-Z0-9\-]+\.example\.com$(用正则需启用 PCRE) - 泛解析 + 正则匹配对 Nginx 性能影响极小,但调试困难;上线前务必用
curl -H "Host: test.example.com" http://127.0.0.1验证是否命中正确 server 块
真正容易被忽略的点是 Host 头透传链路完整性:DNS → Nginx(proxy_set_header Host $host)→ Revel(req.Request.Host)。任一环断裂,Host 就会变成 127.0.0.1:8089 或空字符串,导致租户识别失败。别假设“域名能打开就等于 Host 可用”。











