努力
加油

腾讯云轻量服务器安装Tomcat并部署Java项目的最佳实践?

在腾讯云轻量应用服务器(Lighthouse)上部署 Java 项目,核心逻辑其实和通用 Linux 服务器没区别,但考虑到轻量服务器的资源限制(通常内存较小,如 1G-2G)以及“开箱即用”的特性,最佳实践需要围绕性能优化、环境隔离和安全加固来展开。

以下是经过实战验证的部署流程,去除了那些虚头巴脑的理论,直接上干货。

一、 前置准备:系统选型与环境初始化

轻量服务器默认镜像通常是 CentOS 7/8 或 Ubuntu 18.04/20.04。对于 Java 开发,强烈建议首选 Ubuntu LTS 版本。原因很简单:包管理工具 apt 比 yum/dnf 更现代,依赖冲突少,且社区对 JDK/Tomcat 的最新支持更好。

1. 基础环境配置

登录服务器后,先做几件必须的事:

# 更新系统源
sudo apt update && sudo apt upgrade -y

# 安装必要的基础工具
sudo apt install curl wget git vim net-tools -y

# 创建非 root 用户(严禁直接使用 root 运行 Tomcat)
sudo adduser deployer
sudo usermod -aG sudo deployer

2. JDK 的安装与选择

不要手动下载 .tar.gz 解压配环境变量,除非你有特殊需求。使用官方 PPA 或 SDKMAN 是最稳的。

这里推荐 OpenJDK 17(Java 17 是目前的长期支持版本,性能优于 8,且兼容性好)。

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

# 验证安装
java -version
javac -version

注意:如果你的项目依赖特定的旧版本(如 Java 8),请替换为 openjdk-8-jdk。但在轻量服务器上,Java 17 的资源占用控制得更好。


二、 Tomcat 的安装策略

有两种主流方式:二进制包安装 和 Docker 容器化安装。

方案 A:二进制包安装(传统、轻量、可控)

适合:对磁盘空间极度敏感,不想引入 Docker 开销的场景。

  1. 下载 Tomcat
    访问 Apache Tomcat 官网,下载最新的 Binary Distributions (Core) -> tar.gz 包。目前稳定版建议选 9.0.x 或 10.1.x。

    cd /opt
    sudo wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.83/bin/apache-tomcat-9.0.83.tar.gz
    sudo tar -xzf apache-tomcat-9.0.83.tar.gz
    sudo mv apache-tomcat-9.0.83 tomcat
  2. 权限设置

    sudo chown -R deployer:deployer /opt/tomcat
    sudo chmod +x /opt/tomcat/bin/*.sh
  3. 配置 systemd 服务(关键步骤)
    为了让 Tomcat 开机自启并方便管理,必须编写 service 文件。

    创建 /etc/systemd/system/tomcat.service:

    [Unit]
    Description=Apache Tomcat Web Application Container
    After=network.target
    
    [Service]
    Type=forking
    User=deployer
    Group=deployer
    
    Environment="JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64"
    Environment="CATALINA_PID=/opt/tomcat/temp/tomcat.pid"
    Environment="CATALINA_HOME=/opt/tomcat"
    Environment="CATALINA_BASE=/opt/tomcat"
    Environment="CATALINA_OPTS=-Xms512m -Xmx1024m -XX:+UseG1GC"
    
    ExecStart=/opt/tomcat/bin/startup.sh
    ExecStop=/opt/tomcat/bin/shutdown.sh
    
    [Install]
    WantedBy=multi-user.target

    重点解释 CATALINA_OPTS:

    • -Xms512m: 初始堆内存设为 512MB。
    • -Xmx1024m: 最大堆内存设为 1GB。这是轻量服务器的黄金分割点。如果给太大,Tomcat 会 OOM(内存溢出);给太小,并发稍高就卡死。
    • -XX:+UseG1GC: 启用 G1 垃圾回收器,适合中等堆大小,停顿时间短。
  4. 启动服务

    sudo systemctl daemon-reload
    sudo systemctl enable tomcat
    sudo systemctl start tomcat
    sudo systemctl status tomcat

方案 B:Docker 容器化(推荐用于微服务或多应用隔离)

适合:希望快速部署、便于迁移、或者同时跑多个不同版本 Java 项目的场景。

腾讯云轻量服务器完全支持 Docker。

# 安装 Docker
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# 启动 Docker
sudo systemctl enable docker
sudo systemctl start docker

# 拉取并运行 Tomcat (映射端口 8080 到 80,假设你买了域名解析到了 80)
docker run -d --name my-tomcat 
  -p 8080:8080 
  -v /home/deployer/webapps:/usr/local/tomcat/webapps 
  -e JAVA_OPTS="-Xms512m -Xmx1024m" 
  tomcat:9.0-jdk17-openjdk

优点:清理环境只需 docker rm -f my-tomcat,无需担心残留配置文件。


三、 Java 项目部署细节

无论用哪种方式,最终都是把 WAR 包放到 webapps 目录,或者通过 Spring Boot 打包成 Jar 直接运行。

1. 如果是传统的 WAR 包

将你的 .war 文件上传到 /opt/tomcat/webapps/ 或 Docker 挂载的目录。Tomcat 会自动解压。

常见问题排查:

  • 乱码问题:检查 conf/server.xml 中的 Connector 是否配置了 URIEncoding="UTF-8"。
  • Session 共享:轻量服务器单节点不存在 Session 共享问题,忽略即可。

2. 如果是 Spring Boot Jar 包(当前主流)

Spring Boot 内置了 Tomcat,不需要单独安装 Tomcat 软件。

创建脚本 start.sh:

#!/bin/bash
APP_NAME=myapp.jar
JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC -Dfile.encoding=UTF-8"

nohup java $JAVA_OPTS -jar $APP_NAME > app.log 2>&1 &
echo "Process ID: $!"

同样,建议将其封装为 systemd 服务,以实现优雅启停和崩溃重启。


四、 腾讯云轻量服务器特有优化与安全

这部分是区分“普通教程”和“大神实践”的关键。

1. 防火墙与安全组(重中之重)

腾讯云轻量服务器有独立的防火墙界面(不同于 ECS 的安全组,虽然功能类似,但入口不同)。

  • 操作路径:控制台 -> 轻量应用服务器 -> 防火墙 -> 添加规则。
  • 必须开放:
    • TCP 80 (HTTP)
    • TCP 443 (HTTPS, 如果有证书)
    • TCP 22 (SSH, 建议修改默认端口以防爆破)
  • 禁止暴露:绝对不要开放 8080、3306、6379 等内部端口到公网!只开 80/443,然后通过 Nginx 反向XX转发到 8080。

2. 反向XX Nginx

不要让用户直接访问 Tomcat 的 8080 端口。Nginx 能处理静态资源、SSL 终止、负载均衡。

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

3. 内存监控与 Swap

轻量服务器内存小,极易被 OOM Kill。

  • 开启 Swap:即使只有 1G 内存,也建议创建一个 1G-2G 的 Swap 文件作为缓冲,防止瞬时流量峰值导致进程被杀。
    sudo fallocate -l 2G /swapfile
    sudo chmod 600 /swapfile
    sudo mkswap /swapfile
    sudo swapon /swapfile
    # 写入 fstab 永久生效
    echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
  • 监控工具:安装 htop 或使用腾讯云的云监控插件,关注 MemAvailable 而非单纯的 Used。

4. 日志轮转

Tomcat 的 catalina.out 会无限增长,撑爆磁盘。

  • 如果使用 systemd 方式,确保 journald 配置合理。
  • 或者使用 logrotate 配置 Tomcat 日志切割。

五、 总结:最佳实践清单

  1. 系统:Ubuntu 20.04/22.04 LTS。
  2. JDK:OpenJDK 17(平衡性能与兼容性)。
  3. 部署方式:
    • 单体应用/简单项目:Systemd 托管的二进制 Tomcat 或 Spring Boot Jar。
    • 复杂/多应用/Docker 熟练者:Docker Compose 管理。
  4. 内存调优:JVM 堆内存控制在物理内存的 50%-75% 之间,务必开启 G1 GC。
  5. 网络架构:Nginx (80/443) -> Tomcat (127.0.0.1:8080),严禁公网直连 8080。
  6. 安全:腾讯云控制台防火墙严格限制入站 IP,SSH 改端口,禁用 Root 远程登录。
  7. 备份:定期备份 webapps 下的 WAR 包和数据库。轻量服务器没有自动快照(付费功能),要养成手动导出重要数据的习惯。

这套方案在腾讯云轻量 C2/C3 系列实例上运行稳定,资源利用率最高,且维护成本最低。