tomcat域名绑定

要让Tomcat直接用你的域名提供服务，最核心的一步就是修改conf/server.xml中的Host节点，把域名和项目路径绑定在一起。 这个操作不复杂，但牵涉端口、上下文路径、DNS解析等多个环节，任何一个地方出错，域名就访问不了，下面咱们从配置到排查，完整走一遍。

tomcat域名绑定怎么配置？从server.xml开始

Tomcat的域名绑定,本质上是让Tomcat识别你发来的请求，并根据域名把请求交给对应的应用，这个识别动作发生在server.xml的Host节点里，默认情况下，Tomcat只认识localhost，你需要把它改成自己的域名。

第一步：找到Host节点并修改域名

打开conf/server.xml，定位到Engine标签内部，你会看到类似这样的内容：

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

把name="localhost"改成你的完整域名，比如www.example.com，把Engine标签里的defaultHost也改成这个域名，这样当请求没有匹配到任何Host时，Tomcat会默认走这个域名。

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

一个Host节点就是一个虚拟主机,如果你有多个项目，不想用子域名区分，继续往下看。

第二步：把项目路径通过Context指过去

光改域名还不够,Tomcat还需要知道这个域名对应哪个应用，默认情况下，appBase指向webapps目录，Tomcat会把webapps下所有应用都部署到这个Host上，但很多时候，你的项目并不在webapps里，或者你想让域名直接访问项目根路径，而不是带上下文路径。

这时需要添加Context节点，你的项目放在/var/www/myapp，希望www.example.com直接访问这个应用，配置如下：

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

path=""

是关键，它让域名根路径直接命中应用，如果path设置为/myapp，那访问地址就变成了www.example.com/myapp，这通常不是我们想要的。

tomcat域名绑定端口怎么改？80和443的取舍

Tomcat默认监听8080端口,所以配置完域名后，你访问www.example.com:8080才能看到效果，但用户不会记住端口号，你需要让Tomcat直接监听80端口。

修改server.xml里的Connector节点，把port="8080"改成port="80"：

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

这里有几个坑要注意：

• Linux系统下,小于1024的端口需要root权限启动Tomcat，你可以用sudo启动，或者配置authbind，更推荐的做法是让Nginx监听80端口，再反向代理到Tomcat的8080。
• 如果域名已经配置了HTTPS,443端口也需要对应监听，你需要额外添加一个带有SSL证书配置的Connector，同时把80端口的redirectPort改成443。
• 修改端口后,记得检查防火墙和云服务器安全组，只放行需要的端口。

tomcat绑定多个域名的两种常见方式

一个Tomcat跑多个网站,很常见，做法有两种，根据你的场景选。

添加多个Host节点

在Engine内部，并列添加多个Host，每个Host有自己的域名、appBase和Context，这种方式适合多个完全独立的项目，各自使用不同的域名。

<Host name="www.example.com" appBase="webapps" ...>
    <Context path="" docBase="/var/www/site1" />
</Host>
<Host name="www.example.org" appBase="webapps2" ...>
    <Context path="" docBase="/var/www/site2" />
</Host>

注意,每个Host的name必须全局唯一，不能重复。

使用Alias别名

如果一个应用有多个域名入口,比如example.com和www.example.com，你不需要创建两个Host，只需要在Host节点里加Alias：

<Host name="www.example.com" appBase="webapps" ...>
    <Alias>example.com</Alias>
    <Context path="" docBase="/var/www/site1" />
</Host>

这样两个域名都能访问同一个应用,Tomcat会自动识别。

tomcat绑定域名访问不了？按这个顺序排查

配置写好了,重启Tomcat，结果浏览器一打开还是报错，别急，按下面这个顺序查，90%的问题出在这几个环节。

域名解析和hosts文件

先确认域名是否解析到了服务器IP上,在本地终端执行ping yourdomain.com，看返回的IP是不是你的服务器IP，如果解析不对，去DNS服务商那里改解析记录，如果只是本地测试，可以临时改本机hosts文件，把域名指向服务器IP，

0.113.10 www.example.com

注意,hosts文件的修改只对当前机器有效，而且记得把行首的注释去掉。

防火墙和服务器安全组

Tomcat监听了80端口,但外部访问不到，多半是防火墙挡了，Linux下检查firewalld或iptables，Windows下检查入站规则，云服务器还要检查安全组，在控制台把对应端口放行，行业共识认为，端口问题是导致“tomcat绑定域名访问不了”的头号原因。

端口占用和Tomcat日志

端口被其他进程占用了,Tomcat会启动失败，用netstat -tlnp | grep 80看看80端口是否被占用，如果被占用了，要么杀掉占用进程，要么给Tomcat换一个端口，Tomcat的日志文件在logs/catalina.out，启动失败时，错误原因会写在这里，重点看有没有Address already in use或Invalid Host name之类的报错。

上下文路径和项目状态

如果你配置了Context的path=""，但访问时仍然跳到了/example之类的路径，检查一下是不是server.xml里写错了，或者项目里有额外的web.xml配置，你也可以在Tomcat管理页面里查看应用是否处于running状态，如果状态是stopped，点启动看看有没有报错。

域名绑定后的性能与安全，要不要用Nginx？

直接让Tomcat监听80端口,虽然能用，但生产环境里，更常见的做法是让Tomcat继续跑8080，用Nginx做反向代理，这样有几个明显的好处：

• Nginx处理静态文件和高并发连接的能力比Tomcat更强,可以减轻Tomcat压力。
• 你可以在Nginx层配置HTTPS、负载均衡、缓存，而不需要动Tomcat的代码。
• 多个Tomcat实例共存时,Nginx可以统一做路由分发。

下面这张表,帮你快速对比两种方式：

如果你只是个人项目或内网测试,直接改Tomcat端口最省事，但如果是线上服务，建议把Nginx放在前面，配置Nginx反向代理时，核心配置类似这样：

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-Real-IP $remote_addr;
    }
}

这样,用户访问的是Nginx的80端口，Nginx再把请求转发给Tomcat的8080端口，Tomcat里依然保持默认的localhost配置，不需要对外暴露端口，安全性更高。

tomcat域名绑定常见问题解答

tomcat域名绑定失败是什么原因？

最常见的失败原因是域名没有解析到服务器IP,或者解析后没有生效，其次是server.xml里Host节点的name写错了，比如多了一个空格，或者大小写不一致，再次是端口冲突，Tomcat启动时发现80端口被别的程序占用，检查防火墙和安全组是否放行了对应端口，按照前面提到的排查顺序，逐项验证，基本都能定位到问题。

tomcat绑定域名后访问出现404怎么办？

404说明Tomcat已经收到了请求,但没有找到对应的应用资源，重点检查Context节点的path和docBase。path必须设置为空字符串，才能让域名根路径直接命中项目。docBase必须指向你的项目根目录，不能指向WEB-INF或者lib等子目录，如果你的项目是通过war包部署的，看看webapps下是否解压成功，修改配置后，记得重启Tomcat并清空work目录下的缓存。

tomcat域名绑定端口必须用80吗？

不一定,Tomcat可以监听任意端口，但只有80端口是HTTP协议的默认端口，如果你用其他端口，用户访问时必须在域名后加上端口号，比如www.example.com:8888，这样既不美观，也容易让用户觉得网站不安全，除非端口被占用或出于安全考虑故意隐藏端口，否则还是建议用80端口，如果同时需要HTTPS，就再配置443端口，并让80端口自动跳转到443。