如何配置Ubuntu上的Tomcat虚拟主机 - 问答

如何在Ubuntu上配置Tomcat虚拟主机

配置Tomcat虚拟主机需完成环境准备、配置文件修改、目录创建及验证等步骤，以下是详细操作指南：

1. 环境准备：安装Java与Tomcat

Tomcat依赖Java环境，需先安装OpenJDK（推荐11及以上版本），再安装Tomcat（以Tomcat 10为例）：

# 更新软件包列表
sudo apt update

# 安装OpenJDK 11
sudo apt install openjdk-11-jdk -y

# 验证Java安装
java -version  # 应输出Java版本信息

# 下载并解压Tomcat 10（以官方镜像为例）
wget https://dlcdn.apache.org/tomcat/tomcat-10/v10.1.15/bin/apache-tomcat-10.1.15.tar.gz -P /tmp
sudo mkdir -p /opt/tomcat
sudo tar -xf /tmp/apache-tomcat-10.1.15.tar.gz -C /opt/tomcat --strip-components=1

# 创建Tomcat专用用户（提升安全性）
sudo useradd -r -m -U -d /opt/tomcat -s /bin/false tomcat
sudo chown -R tomcat:tomcat /opt/tomcat

2. 配置Tomcat服务（系统级管理）

为方便管理，将Tomcat注册为系统服务：

# 创建系统服务文件
sudo nano /etc/systemd/system/tomcat.service

写入以下内容（替换/opt/tomcat为实际路径）：

[Unit]
Description=Apache Tomcat Web Application Container
After=network.target

[Service]
Type=forking
Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
Environment=CATALINA_HOME=/opt/tomcat
Environment=CATALINA_BASE=/opt/tomcat
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
User=tomcat
Group=tomcat
Restart=on-failure

[Install]
WantedBy=multi-user.target

加载服务配置并启动Tomcat：

sudo systemctl daemon-reload
sudo systemctl start tomcat
sudo systemctl enable tomcat  # 开机自启

3. 修改server.xml配置虚拟主机

虚拟主机核心配置在server.xml的<Engine>节点内，添加<Host>元素（以配置两个虚拟主机为例）：

sudo nano /opt/tomcat/conf/server.xml

在<Engine name="Catalina" defaultHost="localhost">内添加：

<!-- 第一个虚拟主机 -->
<Host name="site1.example.com" appBase="/opt/tomcat/webapps/site1" unpackWARs="true" autoDeploy="true">
    <Context path="" docBase="ROOT" reloadable="true"/>
    <Valve className="org.apache.catalina.valves.AccessLogValve"
           directory="logs" prefix="site1_access_log" suffix=".txt"
           pattern="%h %l %u %t "%r" %s %b"/>
</Host>

<!-- 第二个虚拟主机 -->
<Host name="site2.example.com" appBase="/opt/tomcat/webapps/site2" unpackWARs="true" autoDeploy="true">
    <Alias>www.site2.example.com</Alias>  <!-- 别名配置 -->
    <Context docBase="/var/www/site2/webapps/ROOT" reloadable="true"/>
</Host>

参数说明：

name：虚拟主机域名（需与DNS解析一致）；
appBase：应用部署目录（存放WAR包或Web应用的根目录）；
Context：指定默认应用的路径（path=""表示根路径，docBase为应用实际目录）；
Alias：可选，配置域名的别名（如www前缀）。

4. 创建虚拟主机应用目录

为每个虚拟主机创建对应的应用目录，并设置正确的权限：

# 创建site1应用目录
sudo mkdir -p /opt/tomcat/webapps/site1/ROOT
sudo chown -R tomcat:tomcat /opt/tomcat/webapps/site1

# 创建site2应用目录（自定义路径）
sudo mkdir -p /var/www/site2/webapps/ROOT
sudo chown -R tomcat:tomcat /var/www/site2/webapps

添加测试页面（以site1为例）：

echo '<html><body><h1>Welcome to Site1!</h1></body></html>' | sudo tee /opt/tomcat/webapps/site1/ROOT/index.html

5. 配置本地DNS解析（测试用）

若未绑定公网域名，需修改本地hosts文件将域名指向服务器IP：

sudo nano /etc/hosts

添加以下内容（替换your_server_ip为服务器实际IP）：

your_server_ip site1.example.com
your_server_ip site2.example.com

6. 重启Tomcat并验证配置

sudo systemctl restart tomcat

验证虚拟主机是否生效：

打开浏览器访问http://site1.example.com:8080，应显示site1的测试页面；
访问http://site2.example.com:8080，应显示site2的测试页面（若未创建应用则显示Tomcat默认页面）。

注意事项

权限问题：确保Tomcat用户（tomcat）对appBase和docBase目录有读写权限；
端口冲突：若修改Tomcat默认端口（8080），需同步更新server.xml中的<Connector>配置；
HTTPS配置：如需启用HTTPS，需在server.xml中添加SSL连接器，并配置证书（参考Tomcat官方文档）；
防火墙设置：允许HTTP（80）和HTTPS（443）流量通过（若使用云服务器，需配置安全组规则）：
```
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
```

0 赞

0 踩