在 Express 中,获取当前请求的域名信息首选 req.headers.host,其次是 req.hostname,两者都能拿到域名,但前者包含端口号,后者自动剔除端口。
很多 Node.js 开发者在做服务端渲染、生成绝对链接、对接第三方支付回调时,都需要知道用户当前是通过哪个域名访问的,这个需求看似简单,但处理不当会踩坑,尤其是涉及反向代理、端口号、IPv6 地址时,下面我把 Express 获取域名的几种方式、适用场景以及常见问题一次性讲透。
通过请求头获取域名:最直接也最准确
HTTP 协议规定,客户端发起请求时必须在请求头中携带 Host 字段,这个字段就是用户访问时输入的域名和端口,Express 在解析请求后,把它挂载到了 req.headers.host 上。
在 Express 路由处理函数中,直接取即可:
app.get('/', (req, res) => {
// 直接读取 Host 请求头
const host = req.headers.host;
// 输出类似 www.example.com:3000 或 www.example.com
res.send(`您访问的域名是:${host}`);
});
req.headers.host 返回的值非常直观,它保留了用户请求时的原始样子,比如用户通过 https://www.example.com:8080 访问,拿到的就是 www.example.com:8080,域名和端口是连在一起的。
如果你需要把域名和端口拆开,用 JavaScript 字符串处理一下就行:
const host = req.headers.host;
// 拆分成 域名 和 端口号 两部分
const [hostname, port] = host.split(':');
req.hostname 属性:Express 帮你做了简化
Express 框架在 req 对象上直接提供了 req.hostname 属性,这个属性是从 Host 请求头解析出来的,好消息是它自动屏蔽了端口号,只返回纯粹的域名。
app.get('/', (req, res) => {
// req.hostname 不包含端口
const domain = req.hostname;
res.send(`当前主域名是:${domain}`);
});
express怎么获取当前请求的域名和端口
在 Express 中,域名和端口是分开放的,端口信息藏在 req.headers.host 里,需要手动提取,这里给出一个标准做法:
app.get('/get-full-url', (req, res) => {
const fullHost = req.headers.host; // localhost:3000
const protocol = req.protocol; // http
// 判断是否使用了默认端口
const isDefaultPort = (protocol === 'http' && fullHost.endsWith(':80')) ||
(protocol === 'https' && fullHost.endsWith(':443'));
// 获取纯净域名(不带端口)
const hostname = req.hostname;
res.json({
hostname: hostname,
port: isDefaultPort ? '默认端口' : fullHost.split(':')[1],
protocol: protocol
});
});
对于后端逻辑判断来说,更推荐用 req.hostname 获取纯域名,然后通过 req.protocol 获取协议,最后用 req.headers.host 拼接完整地址。
实战:基于域名做逻辑分流
获取域名不是目的,用它来做业务判断才是关键,常见的场景包括:根据不同域名展示不同首页内容、生成带域名的绝对跳转链接、限制特定域名访问后台接口。
nodejs如何获取当前请求的域名并做逻辑判断
在本地开发联调时,前端要访问后端接口,通常需要拼一个完整的基础路径(baseURL),此时动态获取当前域名,就能避免写死 localhost 还是 127.0.0.1 的问题:
app.use('/api', (req, res, next) => {
const currentHost = req.headers.host || 'localhost:3000';
const protocol = req.protocol;
// 在这里拿到完整基础路径
const baseURL = `${protocol}://${currentHost}`;
// 做域名白名单校验
const allowedDomains = ['admin.example.com', 'api.example.com'];
if (allowedDomains.includes(req.hostname)) {
next();
} else {
res.status(403).send('域名无访问权限');
}
});
行业共识认为,在服务端做域名判断时,优先使用 req.hostname,因为它已经统一格式、去掉端口,不容易写出判断遗漏。
两种方式对比:headers.host vs req.hostname
这两种方式在绝大多数场景下结果一致,但存在细微差别,我整理了一个对比表格方便你决策:
| 对比项 | req.headers.host | req.hostname |
|---|---|---|
| 是否含端口号 | 包含 | 不包含 |
| IPv6 地址 | 返回 [::1]:3000 |
返回 [::1] |
| 信任代理设置 | 不受影响 | 受 trust proxy 影响 |
| 获取方式 | 直接读请求头 | Express 解析后提供 |
| 使用场景 | 拼完整 URL、做跳转 | 域名判断、白名单校验 |
如果你的应用部署在 Nginx 后面,且 Nginx 配置了代理转发,那 req.hostname 的行为会发生变化,Express 默认不信任代理,req.hostname 取的是 Nginx 转发前的内部地址,此时需要在入口文件设置 app.set('trust proxy', true),或者严格指定信任的代理 IP:
const express = require('express');
const app = express();
// 信任第一层代理
app.set('trust proxy', true);
app.get('/', (req, res) => {
// req.hostname 返回的是用户真实域名
res.send(req.hostname);
});
处理公网 IP 与局域网 IP 的环境变量方案
在某些场景下,比如你是在服务器本地调试,又想拿到公网 IP 做业务绑定,请求头里可能取不到你想要的值,此时更稳妥的做法是结合环境变量兜底。
Express获取当前访问域名时遇到环境变量与本地开发场景怎么选
本地开发时,我们经常用 npm start 启动一个监听在 3000 端口的 Express 服务,此时如果不知道当前域名,直接写一个通用解析函数:
const getDomain = (req) => {
// 1. 优先取请求头里的完整 Host
const hostFromHeader = req.headers.host;
// 2. 其次取 req.hostname
const hostFromExpress = req.hostname;
// 3. 最后用环境变量兜底
const hostFromEnv = process.env.DOMAIN || 'localhost';
return hostFromHeader || hostFromExpress || hostFromEnv;
};
很多企业级项目采用 Docker 部署,容器内的主机名和外部访问域名不一致。业内专家指出,遇到这种部署环境,不要试图在容器内动态探测域名,而应该在启动时通过 -e DOMAIN=www.example.com 注入环境变量。
通过 OS 网络接口获取服务器 IP(备选方案)
Express 获取的域名来自 HTTP 请求层,属于七层范畴,如果你的需求是获取服务器自身的 IP 地址(比如设置回调地址、注册服务发现),那就得用 Node.js 的原生模块 os 了。
const os = require('os');
const interfaces = os.networkInterfaces();
const addresses = [];
// 遍历所有网络接口
for (let name of Object.keys(interfaces)) {
for (let iface of interfaces[name]) {
// 过滤掉内部回环地址和 IPv6 地址
if (iface.family === 'IPv4' && !iface.internal) {
addresses.push(iface.address);
}
}
}
// 第一个非内部 IPv4 地址即局域网 IP
const serverIP = addresses[0] || '127.0.0.1';
console.log('当前服务器 IP:', serverIP);
这种方法拿到的是服务器的局域网 IP,在简米云、酷番云等云服务器上,拿到的是内网 IP,并非公网 IP,如果你需要公网 IP,只能通过第三方接口获取,或者在服务器提供商的控制台绑定弹性公网 IP。
反向代理与 CDN 下的域名信任问题
现代 Web 架构中,Express 很少直接暴露公网,通常前面挂着 Nginx、Apache 或 CDN,这时请求头里的 Host 有可能是内网转发的地址,导致你取到的域名出错。
Express 反向代理环境中获取真实域名不会出错的做法
在 Nginx 配置中,通常需要显式传递原始 Host 头,并增加 X-Forwarded 系列头:
location / {
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://127.0.0.1:3000;
}
Express 端代码需要配合 app.set('trust proxy', true),然后按优先级读取:
app.set('trust proxy', true);
app.get('/', (req, res) => {
// 优先从 X-Forwarded-Host 获取真实域名
const realHost = req.headers['x-forwarded-host'] || req.headers.host;
res.send(`真实访问域名:${realHost}`);
});
需要注意的是,trust proxy 设置为 true 表示信任所有代理,如果应用部署在公网且有被直接访问的风险,建议设置成具体的代理 IP 数组,避免伪造请求头。
获取完整链接与 HTTPS 跳转
除了域名本身,很多业务需要完整的 URL,这里有一个基于 Express 的通用写法:
const getFullUrl = (req) => {
// 协议(识别 HTTPS)
const protocol = req.protocol;
// 域名(包含端口)
const host = req.headers.host;
// 原始请求路径
const path = req.originalUrl;
return `${protocol}://${host}${path}`;
};
在 HTTPS 跳转场景中,需要判断用户是通过 HTTP 还是 HTTPS 访问的,然后决定是否要 301 跳转:
app.use((req, res, next) => {
const isHttps = req.protocol === 'https';
// 生产环境强制 HTTPS
if (!isHttps && process.env.NODE_ENV === 'production') {
return res.redirect(301, `https://${req.headers.host}${req.originalUrl}`);
}
next();
});
常见问题:localhost 和 127.0.0.1 是否算域名
严格意义讲,localhost 在 DNS 解析中指向 127.0.0.1 或 ::1,但在 Express 中,req.hostname 会原样返回 localhost,如果你的代码判断 req.hostname === 'localhost' 作为本地环境标识,在 Windows 和 Linux 上表现一致。
但如果是 IPv6 环境,访问 http://[::1]:3000,req.hostname 返回 [::1],与 localhost 字符串完全不同,属于内存地址的字符串表示,因此做环境判断时,建议同时判断两个值:
const isLocalEnv = ['localhost', '127.0.0.1', '::1', '[::1]'].includes(req.hostname);
Q&A 模块:Express 域名获取高频疑问
req.hostname 和 req.headers.host 在 Express 中究竟有何不同?
req.hostname 是 Express 框架基于 req.headers.host 解析后提供的属性,主要差异在于 req.hostname 不包含端口号,而 req.headers.host 保留端口号,在 Node.js 18 及以上版本中,req.hostname 会自动对 IPv6 地址去除方括号,格式更统一,但需要注意,req.hostname 受到 trust proxy 配置影响,而直接读请求头不受该配置影响,在需要获取完整访问地址的接口回调、支付通知等场景下,使用 req.headers.host 并手动拼接端口,更加可靠,始终记住这个判断依据:区分域名用 req.hostname,拼接链接用 req.headers.host。
Express 获取域名设置 cookie 时,domain 参数应该怎么写?
设置 cookie 时,domain 参数不允许带端口,也不能带协议前缀,正确的做法是从 req.hostname 中取值,并且丢弃最前面的 www. 等子域名前缀。www.example.com 设置 cookie 时,domain 可以是 example.com 或 www.example.com,跨子域共享 cookie 必须用更顶级的域名,开发环境下直接使用 req.hostname 可能会导致浏览器拒绝保存 cookie,因为 localhost 作为 domain 在某些浏览器中存在兼容问题,此时省略 domain 参数即可,让浏览器根据当前地址自动匹配,Express 应用无法获取到预期的 domain 值,请检查反向代理配置是否正确传递了 Host 头。