在腾讯云轻量应用服务器(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 开销的场景。
-
下载 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 -
权限设置
sudo chown -R deployer:deployer /opt/tomcat sudo chmod +x /opt/tomcat/bin/*.sh -
配置 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 垃圾回收器,适合中等堆大小,停顿时间短。
-
启动服务
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 日志切割。
五、 总结:最佳实践清单
- 系统:Ubuntu 20.04/22.04 LTS。
- JDK:OpenJDK 17(平衡性能与兼容性)。
- 部署方式:
- 单体应用/简单项目:Systemd 托管的二进制 Tomcat 或 Spring Boot Jar。
- 复杂/多应用/Docker 熟练者:Docker Compose 管理。
- 内存调优:JVM 堆内存控制在物理内存的 50%-75% 之间,务必开启 G1 GC。
- 网络架构:Nginx (80/443) -> Tomcat (127.0.0.1:8080),严禁公网直连 8080。
- 安全:腾讯云控制台防火墙严格限制入站 IP,SSH 改端口,禁用 Root 远程登录。
- 备份:定期备份
webapps下的 WAR 包和数据库。轻量服务器没有自动快照(付费功能),要养成手动导出重要数据的习惯。
这套方案在腾讯云轻量 C2/C3 系列实例上运行稳定,资源利用率最高,且维护成本最低。
云技术博客