服务器与大带宽专家 · 持牌IDC/CDN/ISP服务商
简米科技官网JIANMI TECH
资讯 2026-11-17 简米科技 7,198 字 17 分钟阅读

Express如何获取当前请求的域名信息?Node.js后端获取请求域名方法详解

导读在 Express 中,获取当前请求的域名信息首选 req.headers.host,其次是 req.hostname,两者都能拿到域名,但前者包含端口号,后者自动剔除端口,很多 Node.js 开发者在做服务端渲染、生成绝对链接、对接第三方支付回调时,都需要知道用户当前是通过哪个域名访问的,这个需求看似简单……

在 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 头。

分享本文
本文为 简米科技官网 原创,已由运维技术专家审核。转载请注明来源:原文链接
售前咨询 服务热线 售后 邮箱