Java项目在Ubuntu如何部署

在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命令，安全又高效。举个例子：

记得把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 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等密钥，这样才能安全地连接服务器。