Debian上Java项目如何打包部署

首页

编程语言

Debian上Java项目如何打包部署

热心网友

转载

2026-04-24

在 Debian 上打包与部署 Ja va 项目的实用流程

Debian上Ja va项目如何打包部署

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

想把 Ja va 项目稳稳当当地跑在 Debian 服务器上？这事儿说简单也简单，说讲究也讲究。下面这份流程，从环境准备到打包部署，再到进程管理和高级分发，帮你把每个环节都理清楚。

万事开头先搭台。一个稳定、一致的环境是后续所有操作的基础。

安装 OpenJDK（示例选用 OpenJDK 11）：
- 第一步永远是更新索引，然后安装：sudo apt update && sudo apt install openjdk-11-jdk。
- 装完别忘了验证一下：ja va -version、ja vac -version，确保版本对得上。
安装构建工具（二选一或两者皆有）：
- Ma ven：sudo apt install ma ven
- Gradle：sudo apt install gradle
可选：设置 JA VA_HOME（便于统一环境）
- 写入环境变量：echo 'JA VA_HOME=/usr/lib/jvm/ja va-11-openjdk-amd64' | sudo tee -a /etc/environment
- 让它立即生效：source /etc/environment
核心建议：尤其是在 CI 流水线或生产环境，务必固定 JDK 版本。不同机器上版本不一致，往往是诡异问题的源头。

项目代码要变成可执行的 JAR 包，主流构建工具各有各的招。这里的关键是，你要一个“胖”JAR（包含所有依赖）还是一个“瘦”JAR。

使用 Ma ven
- 普通打包：一句 mvn clean package，产物就在 target/ 目录下等着你。
- 生成“fat/uber JAR”（含所有依赖）：
  - 方案一：使用 ma ven-assembly-plugin
    - 先在 pom.xml 里添加插件配置，指定好 mainClass 并选用 jar-with-dependencies 描述符。
    - 然后执行 mvn clean package 即可。
  - 方案二：使用 ma ven-shade-plugin（这个更灵活，能更好地处理依赖冲突和资源文件）。
使用 Gradle
- 普通打包：gradle build，产物在 build/libs/ 里。
- 生成“fat/uber JAR”：
  - 先应用插件：id 'com.github.johnrengelman.shadow' version '7.0.0'
  - 配置主类：shadowJar { manifest { attributes 'Main-Class': 'your.main.Class' } }
  - 执行：gradle shadowJar
命名约定：给可执行 JAR 起名时，建议带上版本号和标识，比如 app-1.0.0.jar 或 app-1.0.0-all.jar，一目了然，方便管理。

包打好了，怎么让它稳定、可靠地跑起来？直接运行只适合测试，生产环境得有更专业的法子。

直接运行（测试/简单场景）
- 命令很简单：ja va -jar app-1.0.0.jar。
- 这种方式建议在前台运行，方便观察日志。但生产环境千万别这么干，得用下面的进程管理工具。
使用 systemd 托管（强烈推荐）
- 创建服务文件：sudo nano /etc/systemd/system/myapp.service
- 写入以下示例内容（记得按实际情况修改路径、用户和JVM参数）：
```
[Unit]
Description=My Ja va Application
After=network.target

[Service]
Type=simple
User=appuser
ExecStart=/usr/bin/ja va -jar /opt/myapp/app-1.0.0.jar
Restart=on-failure
Environment="JA VA_OPTS=-Xms512m -Xmx1g"

[Install]
WantedBy=multi-user.target
```
- 常用管理命令：
  - 重载配置：sudo systemctl daemon-reload
  - 启动/停止/重启：sudo systemctl start|stop|restart myapp
  - 设置开机自启：sudo systemctl enable myapp
  - 查看实时日志：sudo journalctl -u myapp -f
远程发布与回滚（示例）
- 发布新版本：scp app-1.0.0.jar user@server:/opt/myapp/app.jar
- 快速回滚：scp app-0.9.0.jar user@server:/opt/myapp/app.jar && sudo systemctl restart myapp
端口与防火墙
- 如果你的应用监听 8080 端口，记得放行：sudo ufw allow 8080/tcp（具体命令取决于你使用的防火墙工具）。

如果需要把应用分发给多台 Debian/Ubuntu 机器，或者想更“原生”地管理，打成 DEB 包是个专业选择。

简易手工法（快速交付）
- 先创建标准目录结构：mkdir -p myapp_1.0-1/DEBIAN myapp_1.0-1/usr/local/bin
- 把 JAR 包复制进去：cp target/app-1.0.0.jar myapp_1.0-1/usr/local/bin/app.jar
- 创建核心的控制文件 myapp_1.0-1/DEBIAN/control：
```
Package: myapp
Version: 1.0-1
Section: ja va
Priority: optional
Architecture: all
Depends: default-jre
Maintainer: Your Name 
Description: A simple Ja va application
```
- 创建安装后脚本 myapp_1.0-1/DEBIAN/postinst（用于生成启动脚本）：
```
#!/bin/bash
cat >/usr/local/bin/myapp <<'EOF'
#!/bin/bash
exec ja va -jar /usr/local/bin/app.jar "$@"
EOF
chmod +x /usr/local/bin/myapp
```
- 最后赋权并打包：
  - chmod 755 myapp_1.0-1/DEBIAN/postinst
  - dpkg-deb --build myapp_1.0-1
规范 Debian 打包（推荐用于正式发布）
- 这种方法更专业，使用 debhelper 与 ja vahelper/dh_ja va 工作流。它会生成标准的 debian/ 目录（包含 control、rules、copyright 等文件），然后通过 dpkg-buildpackage 或 debuild 命令构建出符合仓库标准的 .deb 包，便于分发、升级和依赖管理。

对于传统的 Ja va Web 项目，打包成 WAR 部署到 Tomcat 依然是经典路径。

打包：在 Ma ven 项目根目录执行 mvn clean package，生成的 WAR 包位于 target/app.war。
部署到 Apache Tomcat
- 将 WAR 文件复制到 Tomcat 的 webapps 目录：$CATALINA_HOME/webapps/
- 启动 Tomcat：$CATALINA_HOME/bin/startup.sh
- 访问应用：https://localhost:8080/app（这里的 “app” 就是你的 WAR 文件名）。
一点说明：Tomcat 会自动解压 WAR 包并完成部署。如果需要热部署等高级功能，可以配置自动解压目录，或者使用 Tomcat 自带的 Manager 应用进行管理。