tomcat绑定域名

Tomcat绑定域名本质上是修改server.xml中的Host配置，把默认的localhost替换成你的真实域名，再配合正确的端口设置和DNS解析，重启服务即可生效，整个过程不复杂，但端口占用和Host匹配这两个环节最容易让人卡壳。

很多自己租服务器部署Java项目的朋友，都遇到过这样一个场景：项目明明在服务器上跑得好好的，Tomcat默认页面通过IP加8080端口也能打开，可一旦把访问地址换成自己的域名，浏览器就提示无法访问，其实这不是Tomcat坏了，也不是域名买错了,而是它压根还不知道你已经换了门牌号。

绑定域名前需要准备好的三样东西

动手改配置之前，先把前提条件理清楚，没有这些基础,后面做再多操作都是白忙活。

一个已经解析到服务器IP的域名，这一步可以在简米云、酷番云、华为云等任何一家域名服务商的控制台完成，解析记录选A记录，记录值填你的服务器公网IP，TTL保持默认即可，解析生效需要一点时间,本地可以通过ping命令验证域名是否已经指向目标IP。

服务器的访问权限，这里的权限包括两类：一是能SSH登录服务器的终端权限，比如使用Xshell、Putty等工具；二是操作系统层面的文件读写权限，后面要修改的server.xml文件在Tomcat目录的conf子文件夹下,修改和保存都需要相应的账户权限。

知道你的Tomcat是怎么安装的，不同的安装方式，目录结构和配置文件的默认路径会有差异，比如使用Windows安装包安装的，配置路径通常是D:apache-tomcat-9.0confserver.xml；使用Linux压缩包解压部署的，默认路径一般是/usr/local/tomcat/conf/server.xml，如果你是通过deb或rpm包安装的,路径可能会有所不同。

tomcat绑定域名的完整配置步骤

这是整篇文章的核心操作区域，下面会分步骤拆解一遍，每一步都说清楚原理和实际作用,避免照着抄完还不明白为什么要这么做。

第一步：找到server.xml里的Host节点

用文本编辑器打开conf目录下的server.xml文件，找到<Engine>标签下的<Host>节点，默认情况下,这个节点的配置大概长这样：

<Engine name="Catalina" defaultHost="localhost">
  <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
  </Host>
</Engine>

这里面的name属性就是Tomcat识别访问入口的关键标识，用户访问域名时，Tomcat会拿请求的Host头信息去和所有<Host>节点的name属性值做匹配,匹配上了才把请求交给对应的应用。

第二步：把默认Host节点改成你的域名

将Host节点的name改成你的完整域名，同时建议顺手把Engine级别的defaultHost也同步改为域名指向,改完后的效果：

<Engine name="Catalina" defaultHost="www.example.com">
  <Host name="www.example.com" appBase="webapps" unpackWARs="true" autoDeploy="true">
  </Host>
</Engine>

这里有个细节需要注意：如果改完后没有同时调整Engine的defaultHost，别人通过IP访问时依然会落到旧的Host节点上，表现可能是404或空白页。

第三步：处理Context和应用的部署路径

Host节点内部的appBase属性决定了应用默认存放的位置，如果你的war包放在webapps目录下，解压后生成的目录名就叫应用上下文路径，一个名为myapp.war的文件被解压后，直接访问路径是http://www.example.com/myapp/。

如果你希望访问域名就直接打开应用首页，不出现后面的/myapp/,有两种常用做法：

• 把war包重命名成ROOT.war再放入webapps目录,这样它会被识别为根应用；



• 在Host节点里手动添加一个Context节点，把docBase指向你的应用实际解压目录,并让path为空：

<Host name="www.example.com" appBase="webapps" unpackWARs="true" autoDeploy="true">
  <Context path="" docBase="/usr/local/tomcat/webapps/myapp" reloadable="true" />
</Host>

第一种方式最简单直接，第二种方式更灵活,适合应用部署路径和Tomcat解压路径不一致的场景。

第四步：保存配置并重启Tomcat服务

保存server.xml后，重启Tomcat让配置生效,在Linux环境下一般是执行：

/usr/local/tomcat/bin/shutdown.sh
/usr/local/tomcat/bin/startup.sh

重启完成后，在浏览器里输入你的完整域名（不带端口号的情况下默认走80，但Tomcat默认监听8080，这又是一个需要处理的问题，下面展开讲），如果能看到你的应用页面,说明这一步已经顺利通过了。

端口问题：tomcat修改80端口与访问习惯

绝大多数情况下，默认端口是8080而不是80意味着访问域名时还得手动带上端口号，例如http://www.example.com:8080/，这种带端口的形式既不美观,也不利于用户记忆。

为什么端口不起眼却容易出问题

HTTP协议默认走80端口，HTTPS默认走443端口，用户输入域名时不会主动加端口，浏览器会替你默认补上80，所以如果Tomcat继续监听8080，域名访问自然就会失败，要让Tomcat直接响应80端口的请求,最直观的办法是修改Connector。

修改Connector监听80端口

在server.xml中找到默认的HTTP Connector节点,把port从8080改成80：

<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

改完后重启Tomcat，再直接输入你的域名不带任何端口号,正常情况下就能访问到Tomcat了。

Linux下绑定80端口的权限问题

Linux系统对非root用户有一个安全限制：1024以下的端口只有root账号有权限绑定，如果你用普通用户启动Tomcat，启动过程会报Permission denied的错误。

行业专家指出，最常见的解决办法是使用iptables做端口转发，让8080端口接收到的流量转发给80端口处理,具体命令如下：

iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 8080

这条规则执行后再启动Tomcat，用户访问80端口时流量会被内核自动转给8080来处理,Tomcat本身不需要改动。

另外还有一种特殊情况需要留意：如果服务器上已经装了Nginx或者Apache，80端口很可能已经被它们占用了，这时用ss -lntp（旧系统是netstat -lntp）查看监听情况即可确认，占用了就要二选一，要么停掉其中一个，要么让Nginx自带的反向代理功能来处理域名转发,这个方案在后面专门说明。

tomcat绑定多个域名的虚拟主机配置

有时候一台Tomcat服务器上要跑好几个项目，每个项目对应一个不同的域名,这种场景在部署多套独立业务系统的企业中相当常见。

配置方式一：多个Host节点

在server.xml的Engine节点内，每添加一个域名，就增加一个对应的Host节点，一个Host节点代表一台虚拟主机，各虚拟主机之间的应用目录相互隔离,互不干扰。

<Engine name="Catalina" defaultHost="www.example.com">
  <Host name="www.example.com" appBase="webapps_a" />
  <Host name="www.another.com" appBase="webapps_b" />
</Engine>

这样配置以后，www.example.com的请求会交给webapps_a目录下的应用处理，www.another.com的请求则交给webapps_b目录下的应用处理。

配置方式二：同一个Host对应多个域名

如果多个域名指向的是同一个应用，不需要分开配置多个Host，只需在同一个Host节点的name属性中写入多个域名,之间用英文逗号或竖线分隔：

<Host name="www.example.com,www.example.net" appBase="webapps" />

配置多域名时要避开的坑

• Engine的defaultHost建议保持为第一个Host的name，这个值决定了当请求的Host头匹配不到任何Host节点时，Tomcat会把请求默认交给哪个虚拟主机处理,留成第一个域名比较稳妥。
• 每个Host节点必须使用独立的appBase，如果不独立而共用同一个目录,实际运行时会因为部署冲突出现应用互相覆盖或无法加载的状况。
• 不要忘记检查DNS解析，新增域名必须在DNS服务商处把新的域名A记录解析到同一台服务器的IP上,否则配置再多Host节点也访问不了。

tomcat绑定域名后访问不了的排查思路

绑定域名这一步操作本身不难，可实际操作中就是会出现各种“绑好了但打不开”的情况，按照下面链条逐个排查,大多数问题十分钟内能定位。

ping不通域名

在本地电脑执行ping www.example.com，如果显示无法解析或请求超时，问题大概率出在DNS解析这一层，先用nslookup www.example.com确认解析记录是否已经生效，若解析没生效，去域名服务商控制台核对记录值填的IP是否准确，还有一种可能：服务器安全组（防火墙）没有放行ICMP协议，导致ping命令永远得不到回应,这种情况下建议改用浏览器直接访问来验证。

能ping通但访问超时或直接被拒绝

这种情况多见于服务器防火墙拦截或安全组规则未放行，国内主流的云服务商控制台都有“安全组”或“防火墙”设置页面，需要检查入方向规则中是否放行了TCP 80端口以及8080端口,Linux自带的firewalld或iptables服务也可能会拦截这些端口：

# 查看firewalld当前开放的端口
firewall-cmd --list-ports
# 开放80端口并重新加载规则
firewall-cmd --zone=public --add-port=80/tcp --permanent
firewall-cmd --reload

Tomcat日志报连接超时或Host匹配错误

这一步往往容易忽略，Tomcat的日志文件位于logs目录下，日常排查主要看两个文件：catalina.out是主日志，localhost_access_log记录每次HTTP访问请求，日志中出现Invalid Host header之类的提示，说明请求头里携带的域名不匹配任何Host节点，此时回去核对server.xml中的Host name属性是否与应用实际使用的域名完全一致,包括大小写和有没有多余的空格。

浏览器访问还能看到IP:8080的默认页

排查思路反过来想：能看到默认页，说明Tomcat服务进程本身正常，问题出在当前Host配置和访问地址没对上，将浏览器地址栏的URL再检查一遍，是否还带着端口号，如果带8080且没有显示应用，按前面的端口修改方法处理，如果端口已经改成80还是默认页，说明根路径下并没有部署对应的应用，需要回到第三步检查Context或ROOT.war的配置。

更省心的方案：用Nginx做反向代理而不是直接改Tomcat端口

在真实的生产环境中，直接把Tomcat修改为监听80端口并不是最常见的选择，行业共识认为，使用Nginx在前端接收80或443端口的请求，再由Nginx根据域名将请求转发给Tomcat监听的8080端口，是更成熟也更灵活的做法。

这种部署方式有几个直接的好处，Nginx处理静态资源的效率远高于Tomcat，图片、CSS、JS文件请求几乎不消耗Java进程的资源，Nginx可以非常方便地实现同一台服务器上多域名、多端口的复杂路由规则,处理负载均衡和HTTPS证书绑定也更为顺手。

以下是Nginx中一个针对Tomcat的完整server块配置示例：

server {
    listen 80;
    server_name www.example.com;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

这段配置配好后，运行nginx -t验证配置语法无误，再nginx -s reload重载配置，域名访问就直接落在Nginx上,由Nginx把对应请求转给Tomcat处理。

选择用Nginx代理的方案后，Tomcat里的server.xml基本不用动，仍然保持8080端口监听，Host节点也可以全部维持默认的localhost，FastCGI方案不存在二次排查的复杂度，而且Nginx的配置修改支持热加载,不用中断服务。

常见问题解答

tomcat绑定域名后为什么还需要重启？

Tomcat不像Nginx那样支持配置热加载，server.xml文件在Tomcat进程启动时被一次性读入内存，运行期间不会再次检测文件内容变化，修改完配置后不重启，Tomcat使用的仍然是旧的Host和端口信息，新域名自然无法生效，所以保存server.xml之后，必须通过shutdown和startup（或直接systemctl restart tomcat）完成完整重启。

绑定域名后，通过旧IP还能访问Tomcat吗？

取决于Engine节点中的defaultHost配置，如果defaultHost设置为新绑定的域名，用服务器IP访问时，Tomcat无法从请求头中匹配到域名，会按照defaultHost指定的默认虚拟主机处理，这种情况下，IP访问可能显示404，也可能落到某一个Host下部署的应用，具体行为与你的Host节点name属性值有关，若希望IP访问也正常，可在Host节点中同时配置IP地址和域名,两个身份指向同一个虚拟主机。

一个域名可以同时绑定到两台以上的Tomcat服务器吗？

可以，但这不是Tomcat单点能独立完成的任务，在DNS层面，同一个域名只能指向一个IP地址，若服务器有多个公网IP，可以通过DNS的A记录添加多条记录做简单的轮询负载均衡，更规范的做法是在多台Tomcat服务器前面部署一台负载均衡器（比如Nginx、HAProxy或云负载均衡服务），把这些服务器组成一个集群，由负载均衡器统一接收域名请求并转发给后端成员，对客户端而言,只看到负载均衡器这一个入口。