Java Web应用在Ubuntu上如何部署

在 Ubuntu 上部署 Java Web 应用的标准流程

一准备与安装

更新系统并安装 JDK（推荐 OpenJDK 17；如需 OpenJDK 11 亦可）：
- sudo apt update
- sudo apt install openjdk-17-jdk -y
- java -version、javac -version 验证
如需使用 Tomcat 9（传统 WAR 部署）：
- sudo apt install tomcat9 -y
- sudo systemctl start tomcat9
- 浏览器访问 http://服务器IP:8080 出现欢迎页即成功
如需使用 Nginx 反向代理（域名/80端口访问）：
- sudo apt install nginx -y
- 后续在 /etc/nginx/sites-available/ 配置反向代理并启用站点

二部署方式一 Spring Boot 可执行 JAR

本地打包（Maven/Gradle）：
- Maven：mvn clean package -DskipTests
- Gradle：gradle bootJar
- 产物路径：target/ 或 build/libs/
上传至服务器（示例目录 /opt/myapp）：
- 使用 SFTP 工具上传 your-app.jar
- sudo mkdir -p /opt/myapp && sudo chown $USER:$USER /opt/myapp
运行方式
- 快速临时运行：
  - cd /opt/myapp
  - nohup java -jar your-app.jar > app.log 2>&1 &
- 生产推荐 systemd 托管：
  - 新建服务文件：sudo nano /etc/systemd/system/myapp.service
    - [Unit]
      - Description=My Java App
      - After=network.target
    - [Service]
      - User=your_ssh_user
      - WorkingDirectory=/opt/myapp
      - ExecStart=/usr/bin/java -jar your-app.jar
      - SuccessExitStatus=143
      - Restart=on-failure
      - RestartSec=5
    - [Install]
      - WantedBy=multi-user.target
  - 启用与常用命令：
    - sudo systemctl daemon-reload
    - sudo systemctl start myapp
    - sudo systemctl enable myapp
    - sudo systemctl status myapp
    - sudo journalctl -u myapp -f
验证与端口
- tail -f app.log
- pgrep -f “java -jar your-app.jar”
- ss -tulnp | grep 8080（或 netstat -tulnp | grep 8080）

三部署方式二 WAR 包部署到 Tomcat

安装 Tomcat（若未安装）：sudo apt install tomcat9 -y
部署 WAR：
- 将 WAR 复制到 Tomcat webapps：
  - sudo cp your-web-project.war /var/lib/tomcat9/webapps/
- Tomcat 会自动解压部署，访问 http://服务器IP:8080/your-web-project
- 如已启动 Tomcat，可重启使其加载新应用：sudo systemctl restart tomcat9
日志与排错：
- 查看日志：/var/log/tomcat9/catalina.out 及 /var/log/tomcat9/ 下相关日志

四域名与端口开放

Nginx 反向代理示例（将 80 端口转发到应用 8080 端口）：
- sudo nano /etc/nginx/sites-available/myapp.conf
  - server {
    - listen 80;
    - server_name your_domain_or_ip;
    - location / {
      - proxy_pass http://127.0.0.1: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;
      - proxy_set_header X-Forwarded-Proto $scheme;
    - }
  - }
- 启用站点与生效：
  - sudo ln -s /etc/nginx/sites-available/myapp.conf /etc/nginx/sites-enabled/
  - sudo nginx -t && sudo systemctl reload nginx
防火墙（如使用 UFW）：
- 放行 80（HTTP）与 22（SSH）：sudo ufw allow 80,22/tcp
- 如需直连 8080 测试：sudo ufw allow 8080/tcp

五常见问题与排查

端口占用：ss -tulnp | grep 8080；必要时 kill 占用进程或更换应用端口
查看应用日志：
- JAR（systemd）：journalctl -u myapp -f
- JAR（nohup）：tail -f app.log
- Tomcat：tail -f /var/log/tomcat9/catalina.out
数据库连接失败：核对 application.yml/properties 中的 URL、用户名、密码、驱动；确保数据库允许远程或应用与数据库网络互通
外部访问不通：检查云服务器安全组/本机防火墙、Nginx 配置是否正确、应用是否监听 0.0.0.0 而非 127.0.0.1

最新问答