阿里云部署jar:Java 服务上线前要做好哪些准备?
把 Java 项目打包成 jar 后,上传到阿里云 ECS 并执行启动命令,服务不一定就能稳定运行。Java 版本、端口访问、进程管理和日志都要提前安排好。下面以运行 Alibaba Cloud Linux 或 CentOS 的 ECS 为例,介绍一套适用于小型 Spring Boot 应用的部署流程。
部署前先确认环境和文件
开始操作前,准备好 ECS 管理权限、服务器公网 IP 和已经构建完成的 jar 包。本文示例使用 Java 17,文件名为 demo.jar,应用监听 8080 端口。实际部署时,要把这些示例值换成项目自己的配置。
- 核对 Java 版本:先确认项目使用的 Java 版本,再检查服务器上的 JDK 是否兼容。
- 准备登录方式:可以用 SSH 客户端连接 Linux 服务器,也可以使用阿里云控制台的远程连接功能。
- 规划访问端口:测试时可以临时开放应用端口;正式环境通常由 Nginx 接收请求,再转发到应用端口。
使用 Maven 构建时,常见命令是 mvn clean package -DskipTests,生成的 jar 通常在项目的 target 目录。跳过测试适合已经确认测试结果、只做临时验证等情况。正式发布前,建议先完成必要的测试,避免把代码问题带到服务器上。
安装 Java 并检查版本
SSH 登录服务器后,先执行 java -version。如果系统提示找不到命令,再根据操作系统的软件源安装对应 JDK。以支持 dnf 的系统为例,可以先查询可用软件包,再安装 Java 17:
sudo dnf search openjdk
sudo dnf install java-17-openjdk -y
安装完成后再次运行 java -version,确认版本符合项目要求。不同操作系统的软件包名称和包管理器可能不同;服务器无法访问软件源时,也可以通过可信渠道获取 JDK 安装包。
不要因为 jar 在本机能运行,就默认服务器也能启动。开发环境和服务器的 Java 版本不一致时,可能出现类版本错误或启动失败。遇到这类问题,先核对版本,再检查应用配置。
上传 jar,先以前台方式验证
建议给应用单独建目录,别把程序文件随手放在系统目录或个人家目录里:
sudo mkdir -p /opt/demo
jar 包可以通过 SCP、SFTP 工具或控制台上传。假设本地文件位于项目的 target 目录,可在本地终端执行:
scp target/demo.jar 用户名@服务器公网IP:/tmp/demo.jar
登录服务器后,将文件移到应用目录:
sudo mv /tmp/demo.jar /opt/demo/demo.jar
第一次启动时,建议以前台方式运行,方便直接查看报错:
cd /opt/demo && java -jar demo.jar
看到 Spring Boot 启动完成的日志后,可以在另一个终端执行 curl http://127.0.0.1:8080,检查服务器本机是否能访问应用。启动失败时,先看控制台报错,并核对配置文件、数据库连接和端口占用;不要一上来就改安全组,因为安全组不会解决应用自身的启动问题。测试结束后按 Ctrl+C 停止进程,再配置长期运行方式。
用 systemd 管理服务
用 nohup 启动适合临时测试,但服务退出后的恢复、开机启动和状态查看不够方便。需要长期运行的应用,可以创建 systemd 单元文件:
sudo vi /etc/systemd/system/demo.service
写入以下配置,并按实际情况调整 Java 路径、启动参数和运行用户:
[Unit]
After=network.target
[Service]
User=root
WorkingDirectory=/opt/demo
ExecStart=/usr/bin/java -Xms256m -Xmx512m -jar /opt/demo/demo.jar
Restart=on-failure
RestartSec=5
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
示例使用 root 用户,是为了让初次配置更直观。长期运行更适合创建专用应用用户,并把应用目录权限授予该用户,再将 User=root 改为专用用户名。若 Java 不在 /usr/bin/java,执行 which java 查看实际路径,并更新 ExecStart。
保存后重新加载配置并启动服务:
sudo systemctl daemon-reloadsudo systemctl enable --now demo
查看运行状态和最近日志:
sudo systemctl status demosudo journalctl -u demo -n 100 --no-pager
更新 jar 时,可以先把新文件上传到临时位置,确认文件无误后再替换旧包,然后执行 sudo systemctl restart demo。服务没有启动时,先查看 journal 日志,确认错误原因后再处理,反复重启通常只会让排查更困难。
配置阿里云网络访问
本机能访问应用,不代表外部网络也能访问。若要从公网直连 8080 端口,需要在阿里云 ECS 安全组中允许相应的入站 TCP 流量。临时测试时,尽量把来源限制为自己的公网 IP,不要为了省事将所有端口开放给所有来源。
设置规则后,可以访问 http://服务器公网IP:8080。如果请求失败,按顺序检查:systemd 服务是否运行、应用监听端口是否正确、安全组是否放行、系统防火墙是否拦截,以及应用是否只绑定在 127.0.0.1。这些问题表现相似,逐项确认比同时改多处配置更容易定位。
面向正式用户时,通常让 Nginx 监听 80 或 443 端口,再把请求转发到本机的 8080。这样可以集中处理域名、HTTPS 证书和访问日志,也能避免把应用端口直接暴露在公网。域名解析完成后,再检查安全组,只开放实际需要的 HTTP、HTTPS 和管理端口。
小型订单后台的部署示例
假设团队要部署一个订单后台,jar 文件名为 order-api.jar,服务器是 2 核 4GB 的 ECS,应用监听 8080 端口。运维人员先安装项目要求的 Java 17,把文件放到 /opt/order-api,再创建名为 order-api 的 systemd 服务。
服务启动后,用本机 curl 确认接口可用,再配置 Nginx:域名请求先到 Nginx,由它转发到 127.0.0.1:8080。安全组只开放管理所需的 SSH 来源以及 HTTP、HTTPS 端口,不直接开放 8080。应用异常退出时,systemd 会按配置尝试重启;排查问题时,则分别查看服务日志和 Nginx 日志。
上线后要检查的几项内容
- 内存参数:
-Xms和-Xmx要结合 ECS 内存设置,并给操作系统和其他进程留出空间。示例中的数值不一定适合所有应用。 - 敏感配置:数据库密码和第三方密钥不要硬编码进代码仓库,也不要写进公开日志。
- 日志与磁盘:定期检查日志增长和磁盘剩余空间,避免日志占满磁盘后影响服务。
- 版本回滚:保留上一个可用版本和对应配置,更新失败时才能及时恢复。
- 业务验证:上线后检查关键接口、数据库连接和核心流程。进程存在不等于业务已经正常。
阿里云部署 jar,可以按“准备 Java 环境、上传程序、验证启动、交给 systemd 管理、配置网络入口”的顺序推进。先在服务器本机确认应用正常,再开放必要的外部访问;日志、备份和回滚也要一并考虑。这样部署出的 Java 服务,后续出现问题时才有明确的检查和处理路径。