部署项目之systemd部署

system后端项目部署操作手册（systemd 版 ）

一、项目目录说明

/opt/project/
├── project-backend.jar    # 后端 jar 包
├── application-prod.yml  # 生产环境配置文件
└── （日志由系统 journalctl 管理）

二、systemd 服务配置文件

文件路径

/etc/systemd/system/project.service

完整配置内容

[Unit]
Description=project Backend Service
After=network.target

[Service]
User=root
Group=root
Type=simple
WorkingDirectory=/opt/project
ExecStart=/usr/local/linux-aarch64/bin/java -jar /opt/project/project-backend.jar --spring.config.location=/opt/project/application-prod.yml --logging.level.com.zaxxer.hikari=DEBUG
SuccessExitStatus=143
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

三、常用操作命令

1. 重载配置（修改 service 后必须执行）

systemctl daemon-reload

2. 启动服务

systemctl start project

3. 停止服务

systemctl stop project

4. 重启服务

systemctl restart project

5. 查看服务状态

systemctl status project

6. 设置开机自启

systemctl enable project

7. 关闭开机自启

systemctl disable project

四、日志查看命令

1. 实时查看日志（推荐）

journalctl -u project -f

2. 查看最近 100 行日志

journalctl -u project -n 100

3. 查看今天所有日志

journalctl -u project --since today

五、进程管理

1. 查看是否有 Java 进程运行

ps -ef | grep java

2. 强制杀死所有 Java 进程（应急用）

pkill -f java

3. 仅杀死当前项目进程

pkill -f 'project-backend.jar'

六、重新部署流程（更新 jar 包）

上传新的 project-backend.jar 到 /opt/project/

停止服务：systemctl stop project

启动服务：systemctl start project

查看状态确认启动成功：systemctl status project

七、启动成功标志

Active: active (running)

出现绿色 running 即为正常运行。

八、常见问题排查

启动失败 → 看日志：journalctl -u project -e

端口占用 → 杀进程：pkill -f java

数据库连不上 → 检查 application-prod.yml 配置

服务启动后自动退出 → 多为配置文件语法错误或库连接异常