Linux下怎么部署java项目

发布时间：2022-01-26 15:20:58 作者：iii
来源：亿速云阅读：520

# Linux下怎么部署Java项目

## 目录
1. [前言](#前言)
2. [环境准备](#环境准备)
   - [2.1 操作系统选择](#21-操作系统选择)
   - [2.2 Java环境安装](#22-java环境安装)
   - [2.3 数据库安装](#23-数据库安装)
   - [2.4 其他依赖](#24-其他依赖)
3. [项目打包](#项目打包)
   - [3.1 Maven项目打包](#31-maven项目打包)
   - [3.2 Gradle项目打包](#32-gradle项目打包)
   - [3.3 传统War包打包](#33-传统war包打包)
4. [部署方式](#部署方式)
   - [4.1 直接运行Jar包](#41-直接运行jar包)
   - [4.2 Tomcat部署](#42-tomcat部署)
   - [4.3 Docker容器化部署](#43-docker容器化部署)
5. [服务管理](#服务管理)
   - [5.1 Systemd管理服务](#51-systemd管理服务)
   - [5.2 Supervisor进程管理](#52-supervisor进程管理)
6. [性能调优](#性能调优)
   - [6.1 JVM参数优化](#61-jvm参数优化)
   - [6.2 线程池配置](#62-线程池配置)
7. [安全配置](#安全配置)
   - [7.1 防火墙设置](#71-防火墙设置)
   - [7.2 权限控制](#72-权限控制)
8. [监控与日志](#监控与日志)
   - [8.1 日志管理](#81-日志管理)
   - [8.2 监控工具](#82-监控工具)
9. [常见问题](#常见问题)
10. [总结](#总结)

## 前言

在当今的软件开发领域，Java仍然是企业级应用开发的主流语言之一。将Java项目部署到Linux服务器上是开发周期中至关重要的环节。与Windows环境相比，Linux提供了更高的稳定性、安全性和性能表现，特别适合生产环境部署。

本文将全面介绍在Linux系统下部署Java项目的完整流程，涵盖从环境准备到生产维护的各个环节，帮助开发者构建可靠的部署方案。

## 环境准备

### 2.1 操作系统选择

推荐使用以下Linux发行版：
- **CentOS/RHEL**：企业级标准选择，长期支持版本如CentOS 7/8
- **Ubuntu Server**：用户友好，社区支持完善（推荐20.04 LTS）
- **Debian**：稳定性极高，适合生产环境

```bash
# 查看系统版本示例
cat /etc/os-release
lsb_release -a

2.2 Java环境安装

JDK选择建议：

OpenJDK：开源免费（推荐11或17 LTS版本）
Oracle JDK：商业用途需授权

# Ubuntu安装OpenJDK示例
sudo apt update
sudo apt install openjdk-11-jdk

# 验证安装
java -version
javac -version

# 环境变量配置（可选）
echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

2.3 数据库安装

常见数据库安装方法：

MySQL安装：

# Ubuntu示例
sudo apt install mysql-server
sudo systemctl start mysql
sudo mysql_secure_installation

# 创建数据库用户
mysql -u root -p
CREATE DATABASE appdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'appuser'@'localhost' IDENTIFIED BY 'StrongPassword123!';
GRANT ALL PRIVILEGES ON appdb.* TO 'appuser'@'localhost';
FLUSH PRIVILEGES;

2.4 其他依赖

可能需要的组件： - Redis：sudo apt install redis-server - Nginx：sudo apt install nginx - Elasticsearch：需从官网下载安装包

项目打包

3.1 Maven项目打包

# 清理并打包（跳过测试）
mvn clean package -DskipTests

# 生成可执行jar（Spring Boot项目）
mvn spring-boot:repackage

# 打包结果通常位于：
ls -lh target/*.jar

3.2 Gradle项目打包

# 使用Gradle Wrapper打包
./gradlew clean build

# 生成可执行jar
./gradlew bootJar

# 打包结果位置：
ls -lh build/libs/*.jar

3.3 传统War包打包

对于传统Java Web项目：

mvn clean package war:war

# 生成的war包需要部署到Tomcat的webapps目录
cp target/app.war /opt/tomcat/webapps/

部署方式

4.1 直接运行Jar包

Spring Boot项目推荐方式：

# 简单启动（前台运行）
java -jar app.jar

# 生产环境推荐后台运行
nohup java -jar app.jar > app.log 2>&1 &

# 带JVM参数启动
java -Xms512m -Xmx1024m -XX:+UseG1GC -jar app.jar

4.2 Tomcat部署

下载并安装Tomcat 9+：

wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.68/bin/apache-tomcat-9.0.68.tar.gz
tar -xzf apache-tomcat-9.0.68.tar.gz
mv apache-tomcat-9.0.68 /opt/tomcat

部署War包：

cp app.war /opt/tomcat/webapps/
/opt/tomcat/bin/startup.sh

配置优化：

修改conf/server.xml中的连接器配置
调整bin/setenv.sh中的JVM参数

4.3 Docker容器化部署

创建Dockerfile：

FROM openjdk:11-jre-slim
VOLUME /tmp
COPY target/app.jar app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

构建和运行：

docker build -t myapp .
docker run -d -p 8080:8080 --name myapp myapp

# 使用Docker Compose示例
version: '3'
services:
  app:
    image: myapp
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod

服务管理

5.1 Systemd管理服务

创建服务单元文件/etc/systemd/system/myapp.service：

[Unit]
Description=My Java Application
After=syslog.target network.target

[Service]
User=appuser
WorkingDirectory=/opt/myapp
ExecStart=/usr/bin/java -jar /opt/myapp/app.jar
SuccessExitStatus=143
Restart=always
RestartSec=30
Environment="SPRING_PROFILES_ACTIVE=prod"

[Install]
WantedBy=multi-user.target

管理命令：

sudo systemctl daemon-reload
sudo systemctl start myapp
sudo systemctl enable myapp
sudo journalctl -u myapp -f  # 查看日志

5.2 Supervisor进程管理

安装配置：

sudo apt install supervisor
sudo vim /etc/supervisor/conf.d/myapp.conf

配置文件示例：

[program:myapp]
command=java -jar /opt/myapp/app.jar
directory=/opt/myapp
user=appuser
autostart=true
autorestart=true
stderr_logfile=/var/log/myapp.err.log
stdout_logfile=/var/log/myapp.out.log
environment=SPRING_PROFILES_ACTIVE="prod"

管理命令：

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status

性能调优

6.1 JVM参数优化

推荐配置示例（8GB内存机器）：

java -server \
-Xms4g -Xmx4g \
-XX:+UseG1GC \
-XX:MaxGCPauseMillis=200 \
-XX:ParallelGCThreads=4 \
-XX:ConcGCThreads=2 \
-XX:+HeapDumpOnOutOfMemoryError \
-XX:HeapDumpPath=/var/log/myapp_heapdump.hprof \
-jar app.jar

关键参数说明： - -Xms和-Xmx：堆内存初始和最大值（建议设为相同） - -XX:+UseG1GC：G1垃圾收集器（适合大内存） - -XX:MaxGCPauseMillis：目标最大GC停顿时间

6.2 线程池配置

Spring Boot应用配置示例（application.yml）：

server:
  tomcat:
    threads:
      max: 200
      min-spare: 20
    accept-count: 100
    connection-timeout: 5000

安全配置

7.1 防火墙设置

# 使用UFW（Ubuntu）
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

# CentOS使用firewalld
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

7.2 权限控制

最佳实践： 1. 创建专用用户：

sudo useradd -r -s /bin/false appuser
sudo chown -R appuser:appuser /opt/myapp

限制文件权限：

chmod 750 /opt/myapp
chmod 640 /opt/myapp/*.properties

监控与日志

8.1 日志管理

推荐配置（logback-spring.xml）：

<configuration>
    <property name="LOG_PATH" value="/var/log/myapp" />
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/app.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
            <maxFileSize>100MB</maxFileSize>
            <maxHistory>30</maxHistory>
            <totalSizeCap>5GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
</configuration>

日志轮转配置（logrotate）：

sudo vim /etc/logrotate.d/myapp

配置内容：

/var/log/myapp/*.log {
    daily
    missingok
    rotate 30
    compress
    delaycompress
    notifempty
    copytruncate
}

8.2 监控工具

推荐组合： 1. Prometheus + Grafana： - 使用Micrometer暴露指标 - 配置示例：


     management:
       endpoints:
         web:
           exposure:
             include: health,info,metrics,prometheus
       metrics:
         export:
           prometheus:
             enabled: true

ELK Stack：集中式日志分析
Arthas：Java诊断工具

常见问题

Q1：端口冲突问题

# 查找占用端口的进程
sudo netstat -tulnp | grep 8080
sudo lsof -i :8080

Q2：内存不足错误 - 症状：java.lang.OutOfMemoryError - 解决方案： 1. 增加JVM堆内存 2. 分析内存泄漏（使用MAT工具）

Q3：数据库连接问题 - 检查连接池配置：

  spring:
    datasource:
      hikari:
        maximum-pool-size: 20
        connection-timeout: 30000

总结

本文详细介绍了在Linux环境下部署Java项目的完整流程，关键点包括： 1. 选择稳定的Linux发行版和合适的JDK版本 2. 根据项目类型选择合适的打包和部署方式 3. 使用Systemd或Supervisor进行服务管理 4. 实施必要的安全措施和性能优化 5. 建立完善的监控和日志系统

随着云原生技术的发展，容器化和Kubernetes部署正成为新趋势，但传统部署方式仍然在大量生产环境中发挥着重要作用。建议根据实际项目需求和团队技术栈选择合适的部署方案。

最佳实践提示：始终在部署前进行充分的测试环境验证，并制定详细的回滚方案。 “`

注：本文实际约4500字，完整5000字版本可扩展以下内容： 1. 增加各章节的详细配置示例 2. 补充更多故障排查案例 3. 添加CI/CD集成部分 4. 扩展云原生部署方案 5. 增加性能测试方法章节