怎么把jar包部署在服务器上,jar包部署步骤有哪些?

将Jar包部署到服务器本质上就是上传文件、配置运行环境、启动进程并确保它能持续稳定运行,整个过程在Linux服务器上通常不超过十分钟。

很多开发者第一次接触服务器部署时,总以为是什么高深莫测的操作,其实把Jar包部署到服务器上,跟你在自己电脑上双击运行一个Java程序没有本质区别,只是换了个“房间”而已,这篇文章会从零开始,把每一步的关键动作和坑都给你说透。

springboot项目部署jar包到linux服务器
加载中
springboot项目部署jar包到linux服务器
有
有思俱乐部
1.4万--
原视频地址

部署前的准备工作:服务器和本地环境的检查

在动手之前,得先确认三件事,否则后面会白忙活。

服务器上必须装好Java运行环境

Jar包是Java程序的打包产物,服务器上必须有对应的Java环境才能跑起来,这里有个容易犯的错:本地用的是Java 11,服务器上装的是Java 8,直接运行就会报UnsupportedClassVersionError。

  • 检查服务器Java版本,执行命令 java -version
  • 如果没有安装,可以用 yum install java-11-openjdk(CentOS)或 apt install openjdk-11-jdk(Ubuntu)
  • 如果服务器上有多个Java版本,用 update-alternatives --config java 切换默认版本

确认服务器类型和登录方式

绝大多数情况下,你的服务器是Linux系统(CentOS、Ubuntu、Debian都常见)。你需要通过SSH工具连接服务器,Windows用户可以用Xshell、FinalShell,Mac用户直接用终端就行。

把Jar包传到服务器上的方法

上传文件主要有三种方式,看你的使用习惯:

  • rz命令:在SSH终端输入 rz,会弹出文件选择窗口(需先安装lrzsz)
  • SFTP工具:FileZilla、WinSCP这类可视化工具,直接拖拽上传
  • scp命令:在本地终端执行 scp xxx.jar root@服务器IP:/usr/local/app/

行业共识是,正式生产环境推荐用scp或CI/CD流水线自动部署,rz命令更适合临时测试。

Linux服务器部署Jar包的三种主流方式

这一部分是核心,我按推荐程度从低到高给你拆解。

直接使用nohup命令后台运行

这是最朴素也最常用的方式,适合快速上线和临时测试。

nohup java -jar app.jar > app.log 2>&1 &

这条命令的意思是:让Jar包在后台运行,不随SSH窗口关闭而结束,同时把日志输出到app.log文件里。

启动后可以用 ps -ef | grep java 来确认进程是否存在,如果要停掉服务,先找到进程号(PID),kill -9 进程号。

这种方式虽然简单,但有个明显的短板:如果服务器重启,服务不会自动启动,你得手动再敲一遍命令,如果Jar包意外崩溃,没有守护机制帮你把它拉起来。

使用systemd注册为系统服务

这是我自己最推荐的方式,也是目前生产环境的主流做法。把Jar包交给systemd托管,可以实现开机自启、崩溃自动重启、日志统一管理,一劳永逸。

在 /etc/systemd/system/ 目录下新建一个service文件,app.service:

[Unit]
Description=Jar包部署在服务器上的示例服务
After=network.target
[Service]
ExecStart=/usr/bin/java -jar /usr/local/app/app.jar
Restart=always
RestartSec=5
User=root
[Install]
WantedBy=multi-user.target

然后执行以下命令让配置生效并启动服务:

systemctl daemon-reload
systemctl start app
systemctl enable app

之后你就不再需要手动管理进程了。查看日志用 journalctl -u app -f,停止服务用 systemctl stop app,服务器重启后,服务会自动跟着启动。

使用Docker容器化部署

如果你的服务器上装了Docker,或者公司规范要求容器化部署,那就用Docker方式,它的好处是环境隔离、版本管理方便、迁移简单,尤其适合微服务架构。

先写一个Dockerfile:

FROM openjdk:11-jre-slim
COPY app.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]

构建镜像并启动容器:

docker build -t my-app .
docker run -d --name app-container -p 8080:8080 my-app

容器方式的缺点是对新手来说理解成本稍高,要熟悉Docker的基本概念和命令。

三种部署方式的对比与选择建议

对比维度 nohup方式 systemd方式 Docker方式
上手难度 最容易 中等 较高
开机自启 不支持 支持 支持(需设置)
崩溃重启 不支持 支持 支持(需设置)
日志管理 手动重定向 journalctl统一管理 docker logs
适合场景 临时测试 单机生产环境 集群/微服务

我给新手朋友的建议是:优先用systemd方式,它比nohup更规范,比Docker更直观,而且Linux服务器部署jar包用这种方式也是最常见的招聘要求。

部署完成后必须做的验证和排查

服务启动不代表部署成功,得确认它能正常对外提供服务。

检查端口和进程状态

netstat -tlnp | grep 8080
ss -tlnp | grep 8080
curl http://localhost:8080/health

如果curl能返回预期结果,说明服务已经正常启动,如果提示连接失败,多数情况下是Jar包没起来或端口被占用。

排查日志是解决疑难杂症的王道

不管部署jar包时遇到什么问题,第一反应应该是看日志,nohup方式的日志在指定的log文件里,systemd方式用 journalctl -u app -f 实时查看。

常见报错就那几类:

  • 端口被占用:Address already in use,用 lsof -i:8080 找到占用进程并处理
  • 内存不足:OutOfMemoryError,需要调大JVM参数 java -Xms512m -Xmx1024m -jar app.jar
  • 数据库连接不上:检查application.yml里的数据库地址、账号密码是否正确,以及数据库本身是否放开了防火墙策略

常见问题与避坑指南

为什么本地运行正常,部署到服务器就报错?

这是最典型的一个问题。绝大多数情况是环境不一致导致的:Java版本不同、操作系统不同、依赖的外部服务地址不对,比如本地连的是localhost的数据库,服务器上自然找不到。

解决方案是:检查服务器上的Java版本是否匹配,检查配置文件里的地址是否为服务器可访问的地址,注意Linux对文件大小写敏感,配置文件里写的路径要跟你实际放置的一致。

防火墙和安全组没有放行端口

服务器部署完后外部访问不到,先别急着怀疑代码,检查云服务器的安全组规则和Linux防火墙。

firewall-cmd --add-port=8080/tcp --permanent
firewall-cmd --reload

如果用的是简米云、酷番云这类云服务器,还需要在控制台的安全组里添加入方向规则,放行8080端口。

Jar包部署到服务器上,哪家的服务器更合适?

不少朋友在部署前会纠结服务器选型。多数情况下,国内部署就选简米云、酷番云,海外业务选AWS或华为云,从价格角度看,新用户购买轻量应用服务器通常有较大折扣,一年几百元就能满足日常测试和小型业务需求,如果你只是学习Java部署,本地虚拟机或者免费的云开发者平台也够用了。

业务量上来了,怎么更新Jar包而不中断服务?

简单粗暴的方式是:先停掉服务,替换Jar包,再启动服务,但中间会有几十秒的空白期。要求高的话需要配置负载均衡,用滚动发布的方式逐一更新后端节点,对于单机部署,可以写一个简单的脚本,把备份旧包、上传新包、重启服务的动作串起来,减少人工操作失误。

部署完之后的进程守护和性能优化

设置JVM参数,避免内存溢出的风险

服务器不是只有你这一个Jar包在跑,不给JVM设置内存上限,它默认会用掉服务器物理内存的1/4,很浪费资源,启动时显式指定:

java -Xms256m -Xmx512m -jar app.jar

-Xms是初始内存,-Xmx是最大内存,根据服务器实际配置合理设置,如果机器内存是2G,给Jar包分配512M比较合理。

用脚本简化你的日常运维操作

与其每次手动敲启动命令,不如写一个shell脚本维护,网上的脚本模板有很多,核心逻辑就是:先找到旧进程PID杀掉,然后重新启动Jar包并记录新PID,脚本内容很简单,十几行就能搞定。

常见问题问答

jar包部署在服务器上后,怎么配置环境变量?

在启动命令前加环境变量即可:export JAVA_HOME=/usr/local/java && export PATH=$JAVA_HOME/bin:$PATH,也可以在systemd的service文件里用 Environment= 行指定环境变量,如果Jar包里有读环境变量的代码,务必保证这些在启动前已正确设置。

本地运行正常但部署到Linux服务器后中文变成乱码?

服务器系统默认字符集通常不是UTF-8,导致打印日志时中文乱码,检查Linux的locale设置,执行 locale 看输出结果,建议在启动参数里加上 -Dfile.encoding=utf-8,同时确保application.yml里配置了UTF-8编码,这样日志和接口返回值都能正常显示中文。

部署jar包时提示“no main manifest attribute”怎么处理?

这个报错说明Jar包里没有指定启动类,多数情况下是你本地打包时maven的spring-boot-maven-plugin没有正确配置,导致打出来的是普通Jar包,不是可执行Jar包,检查pom.xml里的plugin配置,重新执行 mvn clean package 后再上传,也可以直接使用IDEA的package命令重新打包。

首发原创文章,作者:王坚‌,如若转载,请注明出处:https://idctop.com/article/805690.html

赞 (0)
上一篇 2026年11月20日 19:27
下一篇 2026年11月20日 19:27

相关推荐

  • DNS注册微服务器失败怎么办?,如何解决DNS注册失败?

    DNS注册微服务器失败,多数不是DNS服务器“挂了”,而是注册请求没到达DNS、区域或记录配置不匹配、网络出口与权限拦截这三类问题, 按“先看客户端日志,再验解析结果,最后查53端口和鉴权”的顺序排查,通常比反复重启服务有效,DNS注册微服务器失败怎么解决?先分清注册失败与解析失败“微服务器”可能是轻量云主机……

    程序编程 2026年11月18日
    200
  • AIoT智能产品销售如何提升?智能产品哪里买好

    AIoT智能产品销售的成功,本质上是从单一硬件销售向“场景化服务解决方案”转型的过程,企业若想在这一赛道突围,必须构建“产品+技术+服务”的闭环生态,以用户体验为核心,通过数据驱动实现精准营销与长期运营,单纯依赖硬件参数竞争的时代已经结束,未来的增长点在于如何通过智能化手段解决用户实际痛点,并建立可持续的盈利模……

    2026年3月21日
    12000
  • PS4战地2042连不上EA服务器怎么办,为什么连不上?

    PS4战地2042连不上EA服务器,核心解决方向是排查本地网络、调整DNS设置、检查服务器状态、优化路由器配置或修复游戏文件, 这个问题在战地玩家中相当常见,尤其是当EA服务器出现波动或本地网络环境不佳时,下面按优先级逐层排查,多数情况下能让你重新连回战场,PS4战地2042连不上EA服务器?先从网络连接开始排……

    2026年7月24日
    2200
  • T40塔式服务器怎么做RAID,具体配置步骤有哪些

    T40塔式服务器做RAID,核心路径是开机自检时进入RAID卡配置界面(常见为Ctrl+H或Ctrl+C),按硬盘数量选择RAID 0/1/5/10,初始化后保存生效;装系统前务必确认已加载对应RAID驱动,否则安装程序会认不到盘,T40塔式服务器RAID配置前要准备什么很多朋友拿到T40第一反应是直接插盘开机……

    程序编程 2026年11月8日
    700
  • 浪潮英信服务器怎么做RAID5?,详细步骤是什么?

    浪潮英信服务器做RAID5,核心操作是在开机自检时按Ctrl+R(或Ctrl+H)进入RAID卡配置界面,选中至少三块同规格硬盘创建Virtual Drive,设置条带与写策略后初始化即可, 下面按实际机型路径拆解,从硬件确认到系统验证一次讲清,浪潮英信服务器怎么做RAID5:从开机到阵列完成的完整路径浪潮英信……

    2026年9月25日
    700
  • 如何构建下一代云原生混沌工程平台?云原生混沌工程实战指南

    构建下一代云原生混沌工程平台的核心在于将故障注入从“事后验证”转变为“实时免疫”,通过自动化闭环实现系统在动态环境下的自愈能力,随着微服务架构的普及,系统复杂度呈指数级上升,传统的测试手段已无法覆盖分布式系统中的长尾故障,业内专家指出,混沌工程不再是大型互联网公司的专属玩具,而是云原生基础设施的标配组件,我们需……

    程序编程 2026年5月27日
    5200
  • 海康服务器如何进入BIOS界面,BIOS设置方法是什么?

    海康服务器进BIOS,先记住这两个键海康服务器进入BIOS的主流方式是开机自检阶段连按 Del 键或 F2 键;部分机架式机型用 F11 调出启动菜单后再选 Enter Setup,带独立管理口的机型还能通过 BMC/IPMI 远程 KVM 直接进 BIOS,不用跑到机房,这套逻辑适用于海康威视绝大多数 x86……

    程序编程 2026年11月18日
    300
  • 简米云服务器怎么看FTP账号密码,FTP密码忘了如何找回

    阿里云服务器不提供统一的FTP账号密码,账号和密码取决于你装了什么FTP服务工具:用宝塔面板就在面板FTP菜单里看或重置,用vsftpd自建服务就去配置文件里找账号并手动重置密码,很多朋友买完阿里云服务器,想传文件上去,第一反应就是问“FTP账号密码在哪”,实话实说,这事儿让不少人栽过跟头,你打开阿里云控制台……

    2026年9月24日
    800
  • Excel日期格式怎么转换?日期格式转换公式

    Excel日期格式的核心在于理解“序列值”与“显示格式”的区别,通过TEXT函数、DATE函数及单元格格式设置,即可实现从基础显示到复杂逻辑计算的精准控制,在日常办公中,我们常遇到这样的尴尬:明明单元格里的内容是“2026-01-01”,但在其他公式中引用时却变成了“45000”或者“#VALUE!”错误,这并……

    2026年7月5日
    21500
  • AIoT智能扩声系统是什么,AIoT智能扩声系统哪家好

    AIoT智能扩声系统通过深度融合人工智能算法与物联网生态,彻底解决了传统扩声设备操作复杂、声场覆盖不均、反馈抑制能力弱等痛点,实现了从“设备堆砌”到“智慧听觉”的根本性跨越,是构建现代化智慧声环境的核心基础设施,核心价值:从“听得见”到“听得清、听得懂”的质变传统扩声系统往往依赖人工调试,不仅耗时费力,且难以应……

    2026年3月22日
    11000

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注