在阿里云 Ubuntu 服务器上部署 Java Web 项目,上传 JAR 包只是其中一步。还要确认 Java 版本与项目匹配、配置安全组和系统服务,并安排好日志与外部访问入口。本文以 Ubuntu 22.04、Spring Boot 项目和内嵌 Tomcat 为例,介绍一套常见部署流程。不同 Ubuntu 版本、项目构建方式可能有差异,操作前先核对自己的环境。
一、准备服务器和项目
在阿里云创建 ECS 实例,选择 Ubuntu 镜像,并根据预计访问量配置 CPU、内存和磁盘。创建完成后记下公网 IP,通过 SSH 登录:
ssh root@你的公网IP
初次登录后更新软件包,并创建有 sudo 权限的普通运维账户。日常操作尽量不要一直使用 root:
sudo apt update && sudo apt upgrade -y
在本地完成项目打包。Maven 项目可以执行 mvn clean package -DskipTests,生成的可执行包通常在 target 目录。这个命令会跳过测试,适合已经完成测试、需要快速构建的场景;正式发布前仍应按项目要求跑完测试,并检查数据库地址、账号密码等配置是否已切换为生产环境。
二、安装 Java 并上传 JAR 包
先查看项目使用的 Java 版本,再安装匹配的运行环境。以下以 Ubuntu 软件源提供的 OpenJDK 17 为例:
sudo apt install -y openjdk-17-jre-headless
运行 java -version 确认安装结果。服务器上能执行 Java,不代表版本一定合适;如果项目要求其他版本,应安装对应版本,避免启动时报版本不兼容错误。
创建应用目录,再从本地上传 JAR 包:
sudo mkdir -p /opt/myapp
scp target/myapp.jar 用户名@你的公网IP:/tmp/myapp.jar
sudo mv /tmp/myapp.jar /opt/myapp/app.jar
建议让应用以普通系统账户运行,并给应用目录设置合适权限。数据库密码、云服务密钥等敏感信息不要提交到公开代码仓库,也不要放进能被网站直接访问的目录。
三、手动启动,先排查常见问题
第一次部署时,可以先在终端手动启动应用,这样报错会直接显示出来:
cd /opt/myapp && java -jar app.jar --server.port=8080
另开一个终端,在服务器本机检查响应:
curl http://127.0.0.1:8080
如果启动失败,先看终端输出,再检查 Java 版本、应用配置、数据库连接和端口占用。确认应用能够正常响应后,按 Ctrl+C 停止进程,再配置 systemd。否则程序会跟着当前终端会话退出,SSH 断开后也可能停止运行。
四、用 systemd 管理应用
创建 systemd 服务文件:
sudo nano /etc/systemd/system/myapp.service
写入以下内容,并将 ubuntu 替换为实际运行账户:
[Unit]
After=network.target
[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/myapp
ExecStart=/usr/bin/java -jar /opt/myapp/app.jar --server.port=8080
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
保存后加载配置、启动服务,并设置开机启动:
sudo systemctl daemon-reload
sudo systemctl enable --now myapp
sudo systemctl status myapp
查看实时日志可运行 sudo journalctl -u myapp -f。修改服务文件后,要重新执行 sudo systemctl daemon-reload,再重启服务。还要留意日志占用的磁盘空间,长期运行的应用需要规划日志保留方式,避免磁盘被日志写满。
五、设置安全组和 Nginx
阿里云 ECS 安全组控制云服务器的网络入口。只开放实际需要的端口:SSH 管理端口的来源最好限制为办公网络或固定 IP,Web 服务按需开放 80 和 443。不要为了排查方便把所有端口都开放到公网。
使用 Nginx 反向代理时,外部请求通过 80 或 443 进入,Java 应用继续监听本机的 8080 端口,通常不需要将 8080 直接暴露到公网。先安装 Nginx:
sudo apt install -y nginx
创建站点配置,将请求转发到本机 Java 服务。下面的配置可以作为起点:
server {
listen 80;
server_name example.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;
}
}
将 example.com 换成自己的域名,并确认 DNS 已解析到 ECS 公网 IP。配置完成后测试并重载 Nginx。暂时没有域名时,可以先通过公网 IP 检查服务;正式对外提供服务应配置 HTTPS,同时确认应用能正确处理代理请求头和客户端真实 IP。
六、部署场景:预约管理系统上线
假设团队要发布一个 Spring Boot 预约管理系统,构建产物为 booking.jar,数据库已准备好。团队将程序放到 /opt/booking,填写数据库连接信息,再通过 systemd 让应用监听 8080。Nginx 对外提供 80 和 443 端口,并把请求转发到 127.0.0.1:8080;阿里云安全组只开放 SSH、HTTP 和 HTTPS,数据库端口不对公网开放。
上线后,团队用 systemctl status 检查服务状态,通过 journalctl 排查一次数据库连接失败,再从域名访问页面确认 Nginx 转发正常。这样的部署方式把公网入口、代理和应用端口分开,后续重启或排错时也有明确的检查位置。
七、上线前检查
- 核对 Java 版本、JAR 包和生产环境配置,尤其是数据库连接信息。
- 确认 systemd 服务能正常启动,失败后按预期重启,日志可以查看。
- 检查安全组规则,只保留必要端口;不要把数据库端口或应用管理端口随意暴露到公网。
- 确认域名解析指向 ECS 公网 IP,Nginx 配置有效,HTTPS 证书可用。
- 准备数据库备份、应用回滚包和基本监控;升级前先确认备份能够使用。
阿里云 Ubuntu Java Web 部署完成后,还要验证服务能否持续运行、日志是否可查、外部访问是否经过预期入口。小规模上线时,可以先按这套流程完成验证,再根据访问量和业务要求增加监控、自动发布或高可用配置。先把版本、权限、端口和回滚方案检查清楚,往往比一开始引入更多组件更省事。