tomcat如何配置域名？tomcat域名绑定访问教程

把 Tomcat 从 IP:8080 变成用户记住的域名来访问，核心思路就一条：修改 conf/server.xml 里的 Host 配置，再处理安全组、端口和重定向。 很多新手在这一步卡住，往往不是 Tomcat 本身的问题，而是域名解析、云厂商安全规则和配置文件里的细节没对齐，下面按实际部署顺序,把该踩的坑提前指出来。

tomcat 配置域名前，先确认这三件事

别急着打开 server.xml，先花五分钟确认环境，多数情况下，域名配不上要么是 80 端口被占，要么是云服务器安全组没放行，要么是 Host 名写错，这三个问题占了 tomcat 配置域名失败原因的绝大部分。

• Java 与 Tomcat 版本：Tomcat 8.5 及以上版本对 Host 和 Connector 的写法更宽松，老版本在配置 HTTPS 跳转时容易出怪问题，建议用 JDK 8 以上的环境。
• 端口策略：国内云服务器默认只开放 22 和 3389，8080 端口通常需要自己在安全组里手动添加，如果你打算直接用 80 端口让用户免输入端口号访问，还要确认 80 没有被 Nginx 或 Apache 占用。
• 解析状态检查：在本地终端执行 ping www.yourdomain.com，看返回的 IP 是不是你的服务器公网 IP，如果域名解析还没生效，Tomcat 配置得再对也白搭。

80 端口被 Nginx 占用时怎么办

服务器上如果已经装了 Nginx，直接用 80 端口配置 Tomcat 会冲突，行业共识是让 Nginx 继续占 80，然后通过反向代理把请求转发给 Tomcat 的 8080 端口，这种做法在后期配置 HTTPS 证书时反而更省事，因为 Nginx 处理证书比 Tomcat 更灵活，在 Nginx 的 server 块里加一行 proxy_pass http://127.0.0.1:8080;,其余不用动。

本地测试用 hosts 文件代替域名解析

如果域名还在备案或者解析未生效，可以通过修改本地 hosts 文件来模拟域名访问，Windows 系统修改 C:WindowsSystem32driversetchosts，Linux 和 macOS 修改 /etc/hosts，添加一行 服务器公网IP 你的域名，这一步能让你提前验证 Tomcat 配置是否正确，不用等 DNS 生效。

tomcat 绑定域名的 server.xml 标准写法

tomcat 绑定域名最核心的操作就是编辑 ${CATALINA_HOME}/conf/server.xml，所谓 CATALINA_HOME 就是你的 Tomcat 安装目录，/opt/apache-tomcat-9.0.85，打开这个文件，主要处理两个部分：Connector 和 Host。

修改 Connector 节点

找到默认的 8080 Connector 配置，如果你希望用户直接通过域名访问而不输入端口号，需要把它改成 80 端口,并添加三个重要属性：

<Connector port="80" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           proxyName="www.yourdomain.com"
           proxyPort="80"
           scheme="http" />

这里的 proxyName 和 proxyPort 很关键，当 Tomcat 生成重定向链接或拼接 URL 时，它会依据这两个值来决定使用哪个域名和端口，如果不写，Tomcat 默认返回服务器 IP 和端口号，用户访问时就会在地址栏看到

http://服务器IP:80 这种不友好的链接,影响观感。

配置 Host 节点指向你的应用

Host 节点定义的是 Tomcat 要响应的域名以及对应应用目录，默认配置里有一个 localhost 的 Host,你需要新建一个：

<Host name="www.yourdomain.com" appBase="webapps"
      unpackWARs="true" autoDeploy="true">
    <Context path="" docBase="/data/www/yourproject" reloadable="true" />
</Host>

name 属性必须与用户访问的域名完全一致，包括 www 前缀。docBase 指向你的项目实际存放路径，可以是绝对路径，也可以放在 webapps 目录下，如果应用打包成 WAR 包放在 webapps 下，不写 docBase 也能正常运行,但用外层目录挂载的方式更便于后期备份和维护。

多个应用如何映射不同路径

如果你的 Tomcat 上跑了多个项目，想分别通过 www.yourdomain.com/app1 和 www.yourdomain.com/app2 访问，最简单的方式是保持默认 Host 配置，直接把 WAR 包或项目文件夹丢进 webapps 目录，Tomcat 会自动根据文件夹名生成访问路径，但如果你希望某个应用直接对应根路径 www.yourdomain.com，就必须用上面 <Context path="" ...> 的写法,让它接管根请求。

改完必须重启验证

这个步骤不能跳过，修改 server.xml 后，Tomcat 不会自动热加载配置文件，必须在 Tomcat 的 bin 目录下执行：

./shutdown.sh
./startup.sh

重启后通过 tail -f ../logs/catalina.out 查看启动日志，如果出现 Host name 'www.yourdomain.com' is not valid 这类报错，八成是域名格式写错了，比如带了 http:// 前缀或者多了一个空格。

简米云服务器 tomcat 域名配置的差异化步骤

在简米云服务器上做 tomcat 域名配置，多了一个本地环境没有的环节：安全组规则，这是云服务器实例层面的网络防火墙，和系统内部的 iptables/firewalld 是两套机制，系统内放行了端口，云控制台没放行,外部依然访问不了。

安全组放行 80 和 443 端口

登录简米云控制台，进入 ECS 实例详情页，在「安全组」标签里点击「配置规则」，添加入方向规则，协议选择 HTTP(80) 和 HTTPS(443)，授权对象填 0.0.0/0，表示允许所有 IP 访问，这一步完成了，Tomcat 配置才不会被云平台挡在门外。

如果你用的是酷番云或华为云，操作路径类似，只是入口名称改叫「防火墙」或「安全组策略」，多数情况下，用户反馈 tomcat 配置域名后本机 curl localhost 能通、手机流量访问不通,基本就是安全组没放行。

国内服务器域名解析必须备案

简米云上的 ECS 如果部署在中国大陆地域，域名解析到这台服务器后，浏览器访问 80 端口会直接被拦截到备案提示页，这是机房层面的硬性要求，绕不过去，如果网站应用还没准备好备案材料，可以先使用 IP + 8080 端口访问，或者把服务器切到中国香港地域,但访问速度会有一定损耗。

用 curl 验证解析是否真的到了 Tomcat

配置完成后,建议在服务器本机执行一条命令验证链路是否完整：

curl -I http://www.yourdomain.com

如果返回 HTTP/1.1 200 或 302，说明域名、Tomcat、端口链路是通的，如果返回其他服务的响应头，Nginx 的 Server: nginx，说明 80 端口流量被 Nginx 接管了，Tomcat 根本没收到请求。

tomcat 多个域名配置如何与 HTTPS 共存

同一个 Tomcat 实例上挂多个域名是常见需求，比如你的主站用 www.a.com，另一个业务用 www.b.com，很多教程里说在一个 Host 的 name 属性里用逗号分隔多个域名，这种做法在旧版本里确实支持，但新版本中容易导致证书匹配异常,不推荐。

标准做法：每个域名一个独立 Host

为每个域名单独写一个 Host 是更稳妥的方案，不同域名的应用彼此隔离,日志也分得更清楚：

<Host name="www.a.com" appBase="webapps_a" autoDeploy="true">
    <Context path="" docBase="/data/www/a_project" />
</Host>
<Host name="www.b.com" appBase="webapps_b" autoDeploy="true">
    <Context path="" docBase="/data/www/b_project" />
</Host>

记得把两个域名都解析到同一个服务器 IP，Tomcat 收到请求后会用请求头中的 Host 字段匹配对应的 Host 节点，匹配不到时会落到默认 Host，即 server.xml 中 Engine 节点里 defaultHost 指定的那个。

HTTPS 证书配置与强制跳转

在 tomcat 多个域名配置场景下，每个域名都要独立的证书，如果你通过 Nginx 做代理，证书放在 Nginx 层管理会更方便；如果是公网直接访问 Tomcat 的 443 端口，需要在 conf/server.xml 里添加一个 HTTPS Connector：

<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           maxThreads="150" SSLEnabled="true">
    <SSLHostConfig>
        <Certificate certificateKeystoreFile="/data/ssl/a.com.pfx"
                     certificateKeystorePassword="你的密码"
                     certificateKeystoreType="PKCS12" />
    </SSLHostConfig>
</Connector>

为了让所有 HTTP 请求都跳到 HTTPS，可以在 80 端口的 Connector 里加上一句：

<Connector port="80" protocol="HTTP/1.1" redirectPort="443" />

证书本身并不贵，简米云、酷番云都为域名提供一年期左右的免费证书，申请流程基本是验证域名所有权后就能签发,满足大部分中小网站的加密需求。

tomcat 配置域名后无法访问时按这几个方向排查

域名配好了却打不开，这是新手提问区里最常见的一句话，tomcat 配置域名后无法访问，先别怀疑配置，按下面顺序排查,绝大部分问题能定位出来。

• 第一步，ping 域名，ping 不通，说明解析还没生效或者域名被墙，和 Tomcat 无关。
• 第二步，公网 IP 访问测试，直接用 http://公网IP:8080 访问，如果这个能通，说明 Tomcat 在正常运行,问题出在端口或域名绑定上。
• 第三步，检查 Connector 的 address 属性，server.xml 里的 Connector 写了 address="127.0.0.1"，Tomcat 就只监听本机回环地址，外网永远无法访问，需要删除这行或改为 0.0.0。
• 第四步，看系统防火墙，CentOS 执行 firewall-cmd --list-ports 查看 80/8080 端口是否在放行列表里，Ubuntu 检查 ufw status。

本机能访问、手机用流量不能访问

这类现象几乎可以锁定是安全组或云平台防火墙的问题，本机 ping 和 curl 走的网络链路不经过云平台的外网入口，而手机流量访问必须经过服务器安全组，所以规则没放行时就会出现这种“内外有别”的情况。

浏览器提示“您访问的页面不安全”

出现这个提示说明 80 端口能访问 Tomcat，但浏览器默认尝试 HTTPS 连接，而服务器没有启用 443 端口的 HTTPS 服务，如果暂时没有证书，可以引导用户直接访问 http://域名 并在 URL 前手动加上 http://，不过从正式运营角度看，尽早配好 HTTPS 才是正路。

tomcat 配置域名的几个高频问题

tomcat 配置域名后，原来用 IP 地址还能访问吗

可以，只要 IP 能访问的端口还在监听，用户依然可以用 http://IP:8080 访问到应用，但需要注意，如果修改了 Connector 的端口或绑定了 address 属性，IP 访问的行为会随之改变，如果希望只允许域名访问，可以通过 Valve 过滤器限制指定 Host,或者在应用层面做重定向。

域名解析正常，但打开后显示 Nginx 默认页

说明 80 端口的流量被 Nginx 接管，请求根本没转发到 Tomcat，检查 Nginx 的配置文件，确认 server_name 是否包涵你的域名，以及 proxy_pass 是否指向了 Tomcat 的监听端口，改动 Nginx 配置后执行 nginx -s reload 生效。

多个域名共用一个 Tomcat 会影响性能吗

影响不大，Tomcat 处理多 Host 的机制只是根据请求头做字符串匹配，CPU 开销几乎可以忽略，真正影响性能的是连接数上限和线程池大小，据统计，大多数中小项目的并发量远未触及 Tomcat 默认线程池的上限，先安心把业务做好,后续再通过压测确定是否需要调参。

说到底，tomcat 配置域名就是一个把域名解析、端口监听、Host 映射三者对齐的过程，不存在特殊的技巧，按配置文件逐项核对，遇到访问不了就反过来查安全组和防火墙,问题总能水落石出。