在Express中获取当前请求的域名信息,最直接的方式是通过req.headers.host属性,它能同时拿到域名和端口号,是处理绝大多数场景的首选方案。
Express获取当前请求域名的方法对比
很多刚接触Node.js开发的同学,在做登录回调、生成分享链接、拼接绝对路径时,总会卡在“怎么拿到当前访问的域名”这一步,Express框架本身没有提供一个名为“获取域名”的专门API,但这恰恰是它在设计上灵活性的体现,我们需要从请求对象req的多个属性中挑选合适的方案。
使用req.headers.host获取域名和端口
req.headers.host返回的是浏览器发送请求时HTTP头中Host字段的内容,这个字段通常包含域名和端口号,是获取当前请求域名的最原始、最可靠的来源。
app.get('/api/profile', (req, res) => {
const host = req.headers.host;
// 输出示例:www.example.com 或 localhost:3000
res.json({ host });
});
这里有个细节值得注意:req.headers.host获取到的端口号是浏览器实际请求的端口,如果你的服务跑在80端口,这个值就不会包含端口号,直接返回干净的域名,如果跑在3000端口,返回的就是localhost:3000这种格式。
使用req.hostname获取纯域名
如果你只需要纯粹的域名,不想要端口号,Express在4.x版本之后提供了req.hostname属性,它会自动剥离端口号,只返回域名部分。
app.get('/api/profile', (req, res) => {
const hostname = req.hostname;
// 输出示例:www.example.com 或 localhost
res.json({ hostname });
});
业内专家指出,req.hostname在Express框架内部是基于Host头解析出来的,因此它对于窃取Host头注入攻击存在潜在风险,在安全敏感场景下需要校验,不过对于常规的业务开发来说,它足够简洁高效。
通过req.get方法读取请求头
req.get()是Express提供的一个请求头读取方法,与直接访问req.headers效果等价,但写法更语义化。
const host = req.get('Host');
这三种方式获取到的数据基本一致,核心区别在于是否包含端口号,下面的表格帮你快速决策:
| 方法 | 典型场景 | |
|---|---|---|
req.headers.host |
域名+端口(端口为80时省略) | 需要完整URL拼接、日志记录 |
req.hostname |
仅域名(端口被剥离) | 域名判断、白名单校验 |
req.get('Host') |
同req.headers.host |
语义化代码、团队规范 |
Express在代理服务器后面如何获取真实域名
单机直连场景相对简单,但实际生产环境大多会使用Nginx或CDN做反向代理,这时候直接读req.headers.host,拿到的极有可能是内网地址或者代理服务器的域名,而不是用户浏览器地址栏里的那个域名。
解析X-Forwarded-Proto头判断协议类型
产生上述问题的根本原因在于,代理服务器转发请求时默认不会传递原始Host头,常见解决办法是让Nginx配置中添加:
proxy_set_header Host $host; proxy_set_header X-Forwarded-Proto $scheme;
当Nginx做了这个配置,Express应用就需要配合解析X-Forwarded-Proto头来判断真实协议(HTTP还是HTTPS),再结合req.hostname拼出完整的域名和协议。
const protocol = req.get('X-Forwarded-Proto') || req.protocol;
const fullDomain = `${protocol}://${req.hostname}`;
配置trust proxy参数让Express信任代理
Express应用默认不会信任代理服务器的转发头,需要显式开启信任开关,在应用的入口文件设置trust proxy参数:
const express = require('express');
const app = express();
// 信任第一层代理
app.set('trust proxy', 1);
// 或者信任所有代理(内网环境可使用)
app.set('trust proxy', true);
配置完成之后,req.protocol和req.hostname就会自动回退到用户实际请求的值,省去手动解析的麻烦,这个配置在处理HTTPS重定向和分页链接生成时特别有用。
Express获取域名和端口后如何正确拼接URL
拿到域名只是第一步,拼接完整的URL时,协议类型和端口匹配问题经常让开发人员头疼,很多新手在这里踩坑,拼出来的地址在HTTP和HTTPS混合环境下行为不一致。
处理HTTP与HTTPS混合场景
在现代Web架构中,同一套后端代码可能需要同时服务HTTP和HTTPS请求,如果你在计算回调地址时写死了http://,用户通过HTTPS访问时就会遇到“页面明明开着,回调却跳到了http”的尴尬情况。
推荐的做法是动态判断协议:
function getBaseUrl(req) {
const protocol = req.get('X-Forwarded-Proto') || req.protocol;
const host = req.get('Host');
return `${protocol}://${host}`;
}
这样无论用户通过哪种协议访问,生成的URL都会自动匹配当前请求的协议。
拼接时注意端口是否重复
另一个高频坑是端口重复,当浏览器访问http://localhost:3000时,req.headers.host返回的值是localhost:3000,此时如果你再手动拼接一个':3000'尾部,就会得到localhost:3000:3000。
判断是否需要追加端口号的通用逻辑:
function getFullUrl(req) {
const host = req.headers.host;
const defaultPort = req.protocol === 'https' ? 443 : 80;
const hostWithoutPort = host.split(':')[0];
const portPart = host.includes(':') ? '' : `:${defaultPort}`;
return `${req.protocol}://${hostWithoutPort}${portPart}`;
}
多数情况下这个逻辑能兜住绝大多数场景,但如果你用了req.hostname则完全不需要关心端口问题,它已经帮你剥离干净了。
Express获取当前访问域名实现子域名判断
子域名判断是CMS系统和多租户SaaS应用中非常常见的需求,比如customer1.example.com和customer2.example.com需要分别渲染不同数据,这就依赖准确地从请求中解析出子域名。
动态解析子域名的实现思路
Express 4.x移除了内置的req.subdomains方法,但我们可以基于req.hostname手动解析:
app.use((req, res, next) => {
const hostname = req.hostname;
const parts = hostname.split('.');
// 适用于 example.com 或 www.example.com 这类二级域名结构
let subdomain = null;
if (parts.length > 2 && parts[0] !== 'www') {
subdomain = parts[0];
}
req.subdomain = subdomain;
next();
});
判断一级域名与二级域名的边界条件
需要注意的是,localhost环境下parts.length只有1,.local和.test这类内网测试域名也经常让子域名解析逻辑出错,行业共识认为,最稳妥的做法是维护一张“已知顶级域名”表,避免将co.uk这种多部分后缀的域名误判为普通子域名结构。
Express获取请求域名信息常见问题
Q1:为什么我的req.hostname返回的是undefined?
这通常是因为在调用req.hostname之前请求已经被中间件拦截或处理,又或者你使用的是Express 3.x的老版本,检查一下你的Express版本,并确认请求处理顺序中该属性是在响应阶段而非请求预处理阶段访问的,确认你是在请求处理函数内部访问而非在模块顶层。
Q2:能否直接使用req.headers.host来区分不同环境的请求?
可以,但不推荐。req.headers.host包含了端口信息,在开发环境(端口3000)和生产环境(端口80)之间切换时,端口号会导致逻辑判断不稳定,更推荐的做法是单独在环境变量里配置SITE_URL,结合req.hostname做兜底判断,这样既能在开发环境灵活运行,又不影响生产环境的域名解析。
Q3:Express获取请求域名时是否需要注意安全风险?
需要。Host头是HTTP请求中可人为篡改的字段,不应该把它直接用于权限校验或安全令牌生成,如果你需要生成签名URL或做防盗链处理,建议只取域名部分并配合白名单校验,切勿直接将完整主机头拼入加密逻辑中。