在Ubuntu上部署Java项目,其实是个很成熟的流程,从环境准备到生产配置,每一步都有标准做法,下面就来一步步拆解,确保你拿到手就能用。
1. 安装Java运行环境(JDK)
先把Java运行环境搞定。在Ubuntu上部署Java项目,第一步就是安装JDK——也就是Java开发工具包。这里推荐用OpenJDK,开源又稳定,以OpenJDK 11为例,操作很简单:

- 先更新系统软件包列表:
sudo apt update - 然后安装OpenJDK 11:
sudo apt install openjdk-11-jdk - 最后验证一下安装结果:
java -version,如果输出Java版本信息,那就说明安装成功了。
2. 准备Java项目
确保项目已经完成开发并通过了测试,接下来需要把它打包成可执行文件。这一步因构建工具而异:
- 如果用的是Maven,在项目根目录执行
mvn clean package,生成的JAR文件会出现在target/目录下,比如myapp-1.0.0.jar。 - 如果用的是Gradle,执行
gradle build,JAR文件则在build/libs/目录下。
3. 上传项目文件到服务器
把本地打包好的JAR文件传到Ubuntu服务器上,这一步推荐用scp命令,安全又高效。举个例子:
scp target/myapp-1.0.0.jar username@your_server_ip:/path/to/deploy
记得把username换成你的服务器用户名,your_server_ip换成服务器IP地址,/path/to/deploy换成你希望存放的目标路径。
4. 部署运行Java项目
上传搞定后,就到了部署的关键环节。根据使用场景,有三种运行方式可选:
方式一:前台运行(临时测试)
直接在终端里执行以下命令,项目会在当前终端窗口运行,关闭终端就停止:java -jar /path/to/deploy/myapp-1.0.0.jar。这种方式适合快速验证,但不适合长期跑。
方式二:后台运行(nohup)
用nohup命令可以让项目在后台持续运行,即使终端关闭也不受影响。日志会输出到指定的app.log文件:nohup java -jar /path/to/deploy/myapp-1.0.0.jar > /path/to/deploy/app.log 2>&1 &。简单粗暴,但管理起来不够灵活。
方式三:systemd服务(生产环境推荐)
生产环境里,最推荐的做法是把项目注册成系统服务。好处是:开机自启、崩溃后自动重启,省心又靠谱。具体操作如下:
- 创建服务文件:
sudo vim /etc/systemd/system/myapp.service - 添加以下内容,记得根据实际路径修改:
[Unit] Description=My Java Application After=network.target [Service] User=your_username WorkingDirectory=/path/to/deploy ExecStart=/usr/bin/java -Xms512m -Xmx1024m -jar /path/to/deploy/myapp-1.0.0.jar Restart=always RestartSec=3 Environment="JAVA_OPTS=-Xms512m -Xmx1024m" [Install] WantedBy=multi-user.target - 加载服务配置:
sudo systemctl daemon-reload - 启动服务:
sudo systemctl start myapp - 设置开机自启:
sudo systemctl enable myapp - 最后查看服务状态:
sudo systemctl status myapp,如果显示“active (running)”,那就说明启动成功了。
5. 配置防火墙(允许外部访问)
需要留意的是,如果项目需要对外提供服务(比如Web应用),记得开放对应的端口,例如8080。以Ubuntu默认的防火墙ufw为例:
sudo ufw allow 8080/tcp
验证一下端口是否开放:sudo ufw status,如果看到“8080/tcp ALLOW”,那就说明配置成功了。
6. 可选:配置反向代理(如Nginx)
如果你需要通过域名访问项目,或者想启用HTTPS,Nginx是个好选择。操作步骤如下:
- 先安装Nginx:
sudo apt install nginx - 然后编辑配置文件:
/etc/nginx/conf.d/myapp.conf,添加以下内容,把your_domain.com换成你的域名,8080换成项目端口:server { listen 80; server_name your_domain.com; location / { proxy_pass http://localhost: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; } } - 最后重启Nginx:
sudo systemctl restart nginx。
7. 可选:自动化部署(如GitHub Actions)
如果是团队协作,或者追求效率,可以引入CI/CD工具,实现代码推送后自动构建、部署。以GitHub Actions为例,操作也不复杂:
- 在项目根目录创建
.github/workflows/deploy.yml文件,内容如下(记得把your_username、your_server_ip、your_deploy_path等换成实际值):name: Deploy Java App on: push: branches: - main jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Set up JDK 11 uses: actions/setup-java@v3 with: java-version: '11' distribution: 'adopt' - name: Build with Maven run: mvn -B package --file pom.xml - name: Upload to Server run: | sshpass -p ${{ secrets.SERVER_PASSWORD }} scp -o StrictHostKeyChecking=no target/*.jar ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }}:${{ secrets.DEPLOY_PATH }} sshpass -p ${{ secrets.SERVER_PASSWORD }} ssh -o StrictHostKeyChecking=no ${{ secrets.SERVER_USER }}@${{ secrets.SERVER_IP }} "systemctl restart myapp"
另外,需要在GitHub仓库的“Settings > Secrets and variables > Actions”中配置SERVER_USER、SERVER_PASSWORD、SERVER_IP、DEPLOY_PATH等密钥,这样才能安全地连接服务器。