把Java项目部署到服务器上,核心就四步:买服务器、装环境、打包上传、启动守护。 下面按这套流程拆开讲,每一步都给你能直接照做的命令和操作路径,尤其适合第一次独立部署的开发者。
部署前该准备什么服务器
选服务器是第一步,不建议一开始就上物理机,国内主流选择是简米云、酷番云,预算敏感就选轻量应用服务器,需要灵活配置就选ECS或CVM,地域上,面向国内用户就选华北或华东节点,访问速度快;有出海业务再考虑香港或海外节点。
系统镜像优先选 CentOS 7.9 或 Ubuntu 22.04 LTS,CentOS 7虽然停止维护了,但存量资料最多,遇到问题搜得到答案;Ubuntu 22.04是长期支持版,apt安装软件更省心,新手我更推荐Ubuntu,坑少一些。
服务器规格以2核4G为起点,多数中小项目跑得动。如果是Spring Boot单体应用加MySQL加Redis,2核4G足够应付初期流量,带宽选3M到5M,主要是上传jar包时快一些。
服务器基础环境怎么配置
拿到服务器IP和密码后,用Xshell或FinalShell登录。第一步先创建普通用户,别用root裸奔生产环境,命令很简单:
adduser deploy usermod -aG sudo deploy
切换用户后,开始装Java环境。JDK选1.8还是17取决于你的项目老项目Spring Boot 2.x用JDK 8,新项目Spring Boot 3.x用JDK 17,用包管理器装最省事:
sudo apt update sudo apt install openjdk-8-jdk
装完用 java -version 验证一下,出现版本号就算成功。环境变量不用手动配,apt装完会自动写好,这也是推荐包管理器的原因。
把本地的Java项目打包并上传
本地项目先跑一遍测试,确认没问题再打包。Maven项目在IDEA右侧Maven面板执行 package 命令,或者在项目根目录执行:
mvn clean package -DskipTests
打包产物在 target 目录下,就是一个 xxx.jar 文件。上传工具用FileZilla或WinSCP,拖拽上传到服务器的 /home/deploy/apps/ 目录下。
上传完先手动启动一次,看依赖是否完整:
cd /home/deploy/apps java -jar xxx.jar
看到 Started Application in X.XXX seconds 字样说明启动成功。按 Ctrl+C 停掉,接下来配置后台运行。
jar包部署到服务器上如何让它一直运行
手动启动最大的问题是:关掉终端进程就没了。用systemd创建服务,让它开机自启、崩溃自动重启,在 /etc/systemd/system/ 下新建 myapp.service 文件:
[Unit] Description=My Java App After=network.target [Service] User=deploy ExecStart=/usr/bin/java -jar /home/deploy/apps/xxx.jar Restart=always RestartSec=10 [Install] WantedBy=multi-user.target
保存后执行:
sudo systemctl daemon-reload sudo systemctl enable myapp sudo systemctl start myapp
查看运行状态用 systemctl status myapp,查看实时日志用 journalctl -u myapp -f。这套方案比nohup更可靠,进程意外退出会10秒后自动拉起。
部署后访问不了是怎么回事
java项目部署到服务器后访问不了,90%是端口没开放,安全组规则和服务器防火墙都要放行端口,简米云在控制台的安全组里入方向添加规则,放行8080端口;服务器内部执行:
sudo ufw allow 8080
访问地址是 http://服务器IP:8080 。如果输入IP加端口打不开,依次排查这三个点:安全组是否放行、防火墙是否放行、服务是否在监听(ss -tlnp | grep 8080)。
数据库和Redis怎么一并部署
项目里用到了MySQL和Redis,生产环境也需要在服务器上装好。
MySQL装完后要建库建用户,千万别直接用root连项目:
sudo apt install mysql-server sudo mysql CREATE DATABASE myapp CHARACTER SET utf8mb4; CREATE USER 'myapp'@'localhost' IDENTIFIED BY '你的强密码'; GRANT ALL PRIVILEGES ON myapp. TO 'myapp'@'localhost'; FLUSH PRIVILEGES;
项目里的 application-prod.yml 配置文件改成生产库的连接地址和密码,打包前确认好。
Redis装完默认只监听本机,项目在服务器本地连Redis不需要改配置:
sudo apt install redis-server sudo systemctl enable redis-server
使用Nginx做反向代理部署前端和后端
如果你的项目有前端页面,建议用Nginx把静态资源和后端API分离开,前端构建产物上传到 /var/www/myapp 目录,Nginx配置如下:
server {
listen 80;
server_name 你的域名或IP;
location / {
root /var/www/myapp;
index index.html;
try_files $uri $uri/ /index.html;
}
location /api/ {
proxy_pass http://127.0.0.1:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
这样一来用户访问80端口就是你的项目,后端API走 /api/ 前缀转发到8080端口的Java服务,实测下来这种架构比直接暴露8080端口正规得多。
Docker部署Java项目有什么不同
Docker的部署方式和上述直接运行jar包有本质区别,适合需要保证环境一致性或者要编排多个组件的场景,先写一个Dockerfile:
FROM openjdk:8-jre-alpine WORKDIR /app COPY target/xxx.jar /app/app.jar EXPOSE 8080 CMD ["java", "-jar", "app.jar"]
用Docker Compose一键编排Java服务、MySQL、Redis,这是目前相当一部分中小企业采用的方案:
version: '3'
services:
mysql:
image: mysql:5.7
environment:
MYSQL_ROOT_PASSWORD: rootpass
MYSQL_DATABASE: myapp
redis:
image: redis:6-alpine
app:
build: .
ports:
- "8080:8080"
depends_on:
- mysql
- redis
Java项目部署到服务器用Docker和传统jar包方式的对比:
| 对比项 | systemd直接运行 | Docker运行 |
|---|---|---|
| 环境隔离 | 依赖宿主机环境 | 完全隔离 |
| 镜像迁移 | 需重新配置 | 一条命令部署 |
| 多组件编排 | 手动管理 | Compose一键搞定 |
| 磁盘占用 | 较小 | 较大 |
| 学习成本 | 低 | 中等 |
用宝塔面板能否降低部署难度
jekyll写命令有畏惧感的,可以选宝塔面板把上述所有操作图形化,在服务器上执行安装脚本,然后网页端操作。宝塔里点”网站”菜单,添加Java项目,选择jar包,设置端口和运行用户,系统自动生成systemd服务,日志也能在面板里直接看。
宝塔适合个人开发者或小团队快速上线,但大型团队一般不会用面板管理生产环境。如果你用宝塔部署,一个重点:安装完立刻修改默认端口和面板密码,默认端口是8899,几乎每台机器都被扫过。
项目更新迭代时怎么平滑发布
部署不是一锤子买卖,后续迭代发布要形成固定动作,我用一条命令搞定:
#!/bin/bash cd /home/deploy/apps sudo systemctl stop myapp cp 新jar包/myapp.jar ./app.jar sudo systemctl start myapp echo "发布完成,请检查日志"
发布窗口选在流量低谷,像凌晨两点,更严谨的做法是先备份旧jar包,出问题立刻回滚。
常见问题问答
部署Java项目需要哪些成本投入?
云服务器成本占大头,2核4G5M带宽的配置年付通常几百元,新用户首年有折扣,域名一年几十元,如果直接用IP访问连域名都不用买,总体预算可以按一年不超过一千元来规划,注意的是,地域选国内服务器就必须要备案域名才能用80端口对外服务,只走IP加端口则不受影响。
服务器上的配置文件怎么防止泄露数据库密码?
行业共识认为生产环境的敏感配置必须与代码仓库分离,把 application-prod.yml 放进 .gitignore,只保留 application-prod.yml.example 模板让大家照着填,更稳妥的做法是用Jasypt对配置内容加密,但前提是,部署时确认一定用的是生产配置而不是开发配置,否则连的是本地数据库,服务起自动失败。
日志文件越积越大,需要定期清理吗?
Spring Boot默认生成的 logs 目录会持续增长,部署之后没有日志轮转机制,时间长了磁盘会撑爆炸,在systemd服务文件里加两行配置:
StandardOutput=append:/home/deploy/apps/logs/out.log StandardError=append:/home/deploy/apps/logs/err.log
然后借助Linux的 logrotate 工具按天切分日志,保留最近30天,统统计过,不处理日志的服务器半年后磁盘使用率会上升一截,到时候处理起来更麻烦。
部署完最后要做的两件事
关掉SSH的root密码登录,改密钥认证;对服务器做完这步安全加固,你的Java项目部署才算真正落地。整套流程走通后,后续所有项目都是同一套打法。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/799304.html


