1. 项目概述从本地开发到云端服务的跨越“SpringVue工程部署在Linux”这个标题对于任何一个正在或即将从单体应用向现代化前后端分离架构转型的开发者来说都是一个绕不开的实战课题。它描述的不仅仅是一个简单的部署动作而是一套从开发环境到生产环境的完整工程化实践。我见过太多团队在本地联调时一切顺风顺水Spring Boot后端API响应迅速Vue前端页面交互流畅可一旦要部署到那台远在数据中心的Linux服务器上各种“水土不服”的问题就接踵而至端口冲突、静态资源404、跨域请求失败、环境变量丢失、服务进程莫名挂掉……这背后的核心是将两个技术栈、两种构建产物、两套运行环境在同一个操作系统上整合成一个对外提供统一服务的应用。Spring Boot作为后端承载着业务逻辑、数据处理和API供给Vue作为前端负责用户界面渲染和交互。部署的本质就是让它们在生产环境的Linux服务器上像在本地开发时那样协同工作并且要更稳定、更高效、更安全。这个过程涉及了Linux系统操作、网络配置、服务管理、持续集成等多个维度的知识是检验一个项目是否具备生产可用性的关键一步。无论你是独立开发者、运维工程师还是项目负责人掌握这套部署流程都意味着你拥有了将创意和代码转化为真正可服务用户的产品的能力。2. 部署架构设计与核心思路拆解2.1 前后端分离部署的两种主流模式在动手之前我们必须先厘清部署的架构。对于SpringVue项目生产环境部署主要有两种模式选择哪种直接决定了后续的技术选型和配置复杂度。第一种是完全分离部署。在这种模式下前端Vue应用和后端Spring Boot应用是彻底独立的两个服务。Vue经过npm run build后生成纯粹的HTML、CSS、JavaScript静态文件。这些文件会被部署到一个专门的HTTP服务器上例如Nginx或Apache。这个HTTP服务器只负责提供前端页面和静态资源。而后端的Spring Boot应用则被打包成可执行的JAR文件作为一个独立的Java进程运行在服务器上通常使用java -jar命令启动并监听某个后端端口如8080。前端页面通过JavaScript发起的API请求例如使用Axios库会指向这个后端服务的地址。这种模式的优点是职责清晰前后端可以独立扩容、独立更新。例如前端静态资源可以放到CDN上加速后端服务可以集群化部署。但它的一个核心挑战是跨域问题CORS。因为前端页面假设由www.yourdomain.com提供请求的后端API假设在api.yourdomain.com:8080属于不同的“源”浏览器出于安全考虑会阻止这类请求。解决它需要在Spring Boot后端显式配置CORS策略。第二种是整合式部署。这种模式更适合小型项目或希望简化运维的场景。Vue同样被构建成静态文件但这些文件不是由独立的Web服务器托管而是被直接放到Spring Boot项目的src/main/resources/static/目录下。当我们打包Spring Boot应用时这些前端文件会被打包进最终的JAR包。启动这个JAR后Spring Boot内嵌的Tomcat或Undertow服务器将同时承担两个角色既提供前端静态文件服务通过根路径或特定路径也提供后端API服务。用户访问服务器IP和端口看到的就是完整的前端页面页面内的API请求自然指向同一个域名和端口从而完美避开了跨域问题。这种模式部署简单“一个JAR包走天下”但前后端耦合较紧任何一方的更新都需要重新构建和部署整个应用。注意对于大多数中大型项目或团队协作项目我强烈推荐完全分离部署。它不仅更符合微服务和云原生的思想也为未来的技术演进如引入API网关、服务网格留足了空间。本文后续的详细实操也将以这种模式为主线进行展开。2.2 技术栈选型与工具准备确定了分离部署的架构接下来就需要为Linux服务器挑选合适的“武器”。这不仅仅是安装软件更是为整个应用的稳定性、性能和可维护性打下基础。1. 服务器环境Linux发行版CentOS/RHEL系列如CentOS 7/8, AlmaLinux和Ubuntu/Debian系列是两大主流。CentOS以稳定著称常见于传统企业环境Ubuntu则拥有更活跃的社区和更新的软件包对新手更友好。我个人近年来更倾向于Ubuntu Server LTS版本如20.04 LTS, 22.04 LTS其apt包管理器用起来顺手遇到问题网上解决方案也更多。无论选择哪个请务必使用LTS长期支持版本以获得稳定的安全更新。2. Web服务器用于托管前端Nginx几乎是当今的不二之选。相较于ApacheNginx在处理高并发静态资源请求时性能更优配置语法也更简洁清晰。我们不仅用它来托管Vue的dist目录还会利用其反向代理功能将API请求转发给后端的Spring Boot应用这样对外只需要暴露一个端口通常是80或443简化了网络配置并提升了安全性。3. 应用服务器用于运行后端Spring Boot应用自带内嵌的Servlet容器Tomcat, Jetty, Undertow因此我们不需要额外安装像Tomcat这样的独立应用服务器。只需要安装合适版本的Java运行环境JRE或开发工具包JDK。对于生产环境建议安装JDK而非仅JRE因为一些监控和诊断工具可能需要JDK中的工具。4. 版本管理工具虽然可以直接上传文件但使用Git进行版本拉取是更专业和可持续的做法。在服务器上安装Git从代码仓库如GitHub, Gitee, GitLab拉取指定版本的前后端代码便于回滚和持续部署。5. 进程管理工具不能让Spring Boot的JAR进程仅仅在SSH会话中通过java -jar前台运行一旦SSH断开进程就终止了。我们需要一个进程守护工具。systemd是现代Linux发行版的标准服务管理器功能强大可以设置开机自启、自动重启、日志管理。它是管理Spring Boot服务的最佳选择。6. 构建工具服务器上需要安装Node.js和npm或yarn/pnpm来构建Vue项目安装Maven或Gradle来构建Spring Boot项目。一种更优的做法是将构建过程放在CI/CD流水线中如Jenkins, GitLab CI, GitHub Actions服务器只负责运行构建好的产物。这能保持服务器环境纯净。但为了演示完整流程我们会在服务器上完成构建。总结一下我们的工具清单一台安装好Ubuntu 22.04 LTS的服务器、Nginx、OpenJDK 17或与你的Spring Boot版本匹配的JDK、Git、Node.js 18、Maven 3.6。接下来我们就进入具体的实操环节。3. Linux服务器基础环境配置3.1 系统更新与安全加固拿到一台全新的云服务器第一件事不是急着安装软件而是进行系统更新和安全基础设置这是一个好习惯。通过SSH登录服务器后首先更新软件包列表并升级现有软件sudo apt update sudo apt upgrade -y-y参数用于自动确认避免中途需要手动输入。接着创建一个用于部署的专用用户而不是一直使用root。这能提高安全性避免误操作。sudo adduser deployer按照提示设置密码并填写一些无关紧要的信息。然后将新用户添加到sudo组使其拥有管理权限sudo usermod -aG sudo deployer后续的操作我们都可以切换到deployer用户进行使用su - deployer或重新以deployer用户SSH登录。防火墙是必须开启的。Ubuntu默认使用ufwUncomplicated Firewall。我们先放行SSH端口默认为22否则启用防火墙后可能会把自己关在外面。sudo ufw allow OpenSSH sudo ufw enable在部署阶段我们还需要临时放行后端Spring Boot的端口如8080和前端Nginx的端口80/443。但生产环境中通常只对外暴露80HTTP和443HTTPS后端端口不对外网开放仅允许本机或内部网络访问。我们可以先放行后续再调整sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw allow 8080/tcp使用sudo ufw status numbered可以查看当前规则。3.2 核心依赖安装JDK, Node.js, Maven, Git, Nginx现在以deployer用户身份安装我们所需的所有软件。安装OpenJDK 17Spring Boot 2.7 和 3.0 版本通常推荐JDK 17或更高版本。sudo apt install openjdk-17-jdk -y安装后验证版本java -version。如果需要管理多个JDK版本可以考虑安装sdkman但生产环境建议固定一个稳定版本。安装Node.js 18 LTS直接从NodeSource仓库安装比Ubuntu默认仓库的版本更新。curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs验证安装node --version和npm --version。安装Mavensudo apt install maven -y验证安装mvn -v。安装Gitsudo apt install git -y安装Nginxsudo apt install nginx -y安装完成后Nginx会自动启动。你可以通过sudo systemctl status nginx查看状态并在浏览器访问服务器IP应该能看到Nginx的欢迎页面。3.3 项目目录结构规划清晰的目录结构是高效运维的基础。我建议在deployer用户的家目录下/home/deployer创建如下结构/home/deployer/ ├── apps/ # 存放所有应用 │ ├── backend/ # Spring Boot后端项目目录 │ │ ├── source/ # 从Git拉取的源代码 │ │ ├── app.jar # 构建好的可执行JAR包 │ │ └── config/ # 外部配置文件如application-prod.yml │ └── frontend/ # Vue前端项目目录 │ ├── source/ # 从Git拉取的源代码 │ └── dist/ # npm build后生成的静态文件目录 ├── logs/ # 统一存放应用日志 │ ├── backend/ │ └── nginx/ └── scripts/ # 存放部署、重启等维护脚本创建这个结构mkdir -p ~/apps/backend/{source,config} mkdir -p ~/apps/frontend/{source,dist} mkdir -p ~/logs/{backend,nginx} mkdir -p ~/scripts这个结构将源代码、构建产物、配置文件、日志分离非常清晰。config目录尤其重要它允许我们将Spring Boot的配置文件如application-prod.yml放在JAR包外部这样修改配置时无需重新构建和部署JAR包只需重启服务即可符合12-Factor应用的原则。4. 后端Spring Boot应用部署详解4.1 项目构建与生产环境配置首先进入后端源代码目录从版本控制系统拉取代码。假设你的代码在GitHub上cd ~/apps/backend/source git clone 你的后端仓库地址 . # 注意最后的‘.’表示克隆到当前目录而非创建子目录拉取特定分支或标签git checkout release/v1.0Spring Boot项目通常使用Maven或Gradle管理。我们以Maven为例。在构建之前最关键的一步是准备生产环境配置文件。在src/main/resources/下你可能有application.yml和application-dev.yml。我们需要创建一个application-prod.yml用于覆盖生产环境特有的配置。一个典型的application-prod.yml可能包含server: port: 8080 # 生产环境建议关闭详细错误信息避免信息泄露 error: include-stacktrace: never include-message: never # 设置合适的连接器属性 tomcat: max-threads: 200 min-spare-threads: 10 spring: datasource: url: jdbc:mysql://localhost:3306/your_prod_db?useSSLfalseserverTimezoneUTCcharacterEncodingutf8 username: prod_user password: ${DB_PASSWORD:} # 强烈建议使用环境变量传递密码 hikari: maximum-pool-size: 20 connection-timeout: 30000 # 生产环境关闭开发工具和热部署 devtools: add-properties: false # JPA配置示例 jpa: hibernate: ddl-auto: validate # 生产环境绝对不要用‘create’或‘update’ show-sql: false properties: hibernate.format_sql: false # 日志配置输出到文件 logging: file: name: /home/deployer/logs/backend/spring-boot.log level: com.yourcompany: INFO org.springframework: WARN实操心得数据库密码、API密钥等敏感信息绝对不要硬编码在配置文件中。应该使用环境变量如${DB_PASSWORD}或专门的密钥管理服务如HashiCorp Vault。在服务器上可以通过export DB_PASSWORDyour_secure_password设置环境变量或者在systemd服务文件中定义。现在开始构建项目。在源代码根目录执行mvn clean package -DskipTests -Pprodclean package清理并打包。-DskipTests跳过测试生产构建可跳过但确保你的CI流程中已运行过测试。-Pprod激活Maven的prodprofile。你需要在pom.xml中定义这个profile并指定使用application-prod.yml作为激活时的配置文件。例如在pom.xml的profiles部分profile idprod/id properties activatedPropertiesprod/activatedProperties /properties /profile并在build的resources部分配置资源过滤。构建成功后在target/目录下会生成一个可执行的JAR文件名称通常为your-app-name-0.0.1-SNAPSHOT.jar。将其复制到我们规划好的位置cp target/*.jar ~/apps/backend/app.jar同时将生产配置文件也复制到外部配置目录cp src/main/resources/application-prod.yml ~/apps/backend/config/4.2 使用Systemd托管Spring Boot服务这是保证服务稳定运行的核心步骤。我们将创建一个systemd服务单元文件来管理Spring Boot应用。使用sudo权限创建服务文件sudo vim /etc/systemd/system/springboot-backend.service写入以下内容[Unit] DescriptionSpring Boot Backend Application Aftersyslog.target network.target [Service] Typesimple # 指定运行用户和组不要用root Userdeployer Groupdeployer # 指定工作目录这里指向JAR包所在目录 WorkingDirectory/home/deployer/apps/backend # 启动命令 # 关键通过‘--spring.config.location’指定外部配置文件路径 # 通过‘-D’设置JVM参数如内存、GC等 ExecStart/usr/bin/java -Xms512m -Xmx1024m -jar /home/deployer/apps/backend/app.jar --spring.config.locationfile:/home/deployer/apps/backend/config/application-prod.yml # 指定环境变量文件用于存放数据库密码等敏感信息 EnvironmentFile/home/deployer/apps/backend/config/backend.env # 失败时自动重启 Restarton-failure # 重启间隔 RestartSec10s # 标准输出和错误输出重定向到系统日志同时我们也输出到自定义文件 StandardOutputjournal StandardErrorjournal SyslogIdentifierspringboot-backend [Install] WantedBymulti-user.target关键参数解析User/Group使用非root用户运行是基本的安全准则。-Xms512m -Xmx1024m设置JVM堆内存初始值和最大值。根据你的应用实际内存占用调整设置太小会导致频繁GC设置太大可能浪费资源。生产环境建议通过监控工具观察后设定。--spring.config.location这是最重要的参数之一。它告诉Spring Boot从外部文件加载配置优先级高于JAR包内的配置文件。这样我们就可以在不重新打包的情况下修改配置。EnvironmentFile指向一个环境变量文件如backend.env里面可以定义DB_PASSWORDxxx。在application-prod.yml中就可以用${DB_PASSWORD}引用。记得给这个env文件设置严格的权限chmod 600 backend.env。创建环境变量文件cd ~/apps/backend/config vim backend.env # 内容示例DB_PASSWORDYourSuperSecretPassword123! chmod 600 backend.env现在重新加载systemd配置启动服务并设置开机自启sudo systemctl daemon-reload sudo systemctl start springboot-backend sudo systemctl enable springboot-backend检查服务状态和日志sudo systemctl status springboot-backend # 查看实时日志 sudo journalctl -u springboot-backend -f如果状态是active (running)并且日志中没有报错说明后端服务已经成功启动并在监听8080端口。你可以用curl localhost:8080/api/health假设你有健康检查端点来测试。5. 前端Vue应用构建与Nginx配置5.1 Vue项目生产环境构建优化切换到前端项目目录拉取代码cd ~/apps/frontend/source git clone 你的前端仓库地址 . git checkout release/v1.0在构建之前同样需要处理生产环境配置。Vue项目特别是Vue CLI或Vite创建的项目通常使用.env文件管理环境变量。在项目根目录创建.env.production文件NODE_ENVproduction VUE_APP_API_BASE_URL/api # 注意这里我们设置API基础路径为‘/api’意味着前端请求会发向同域名下的‘/api’路径。 # Nginx将负责将这个路径的请求代理到后端的Spring Boot服务localhost:8080。VUE_APP_API_BASE_URL这个变量在你的Vue代码中可以通过process.env.VUE_APP_API_BASE_URL访问。你需要在发起API请求的地方如Axios的全局配置使用它// axios配置示例 (src/utils/request.js) import axios from axios; const service axios.create({ baseURL: process.env.VUE_APP_API_BASE_URL, timeout: 10000 });安装依赖并构建npm install --registryhttps://registry.npmmirror.com # 使用国内镜像加速 npm run buildnpm run build命令会执行Vue项目的生产环境构建代码会被压缩、混淆并生成一个dist目录。构建过程可能会比较耗时取决于项目大小。构建完成后将dist目录下的所有内容复制到我们规划好的前端部署目录rm -rf ~/apps/frontend/dist/* # 清理旧构建 cp -r dist/* ~/apps/frontend/dist/5.2 Nginx配置静态服务与反向代理现在配置Nginx让它做两件事1. 托管Vue的静态文件2. 将API请求反向代理到Spring Boot后端。首先备份默认配置然后创建我们自己的站点配置sudo mv /etc/nginx/sites-available/default /etc/nginx/sites-available/default.backup sudo vim /etc/nginx/sites-available/spring-vue-app写入以下配置内容。这是一个兼顾了性能和安全的基础配置server { listen 80; # 将 your-server-ip-or-domain 替换为你的服务器IP或域名 server_name your-server-ip-or-domain; # 前端静态文件服务 # 根目录指向我们放置Vue构建产物的目录 root /home/deployer/apps/frontend/dist; index index.html index.htm; # Gzip压缩提升传输效率 gzip on; gzip_vary on; gzip_min_length 1024; gzip_types text/plain text/css text/xml text/javascript application/javascript application/xmlrss application/json; # 处理Vue Router的history模式 # 当用户直接访问一个前端路由如 /dashboard时Nginx会尝试找对应的文件找不到则返回index.html location / { try_files $uri $uri/ /index.html; } # 反向代理所有以 /api 开头的请求到后端Spring Boot应用 location /api/ { # 移除请求路径中的 /api 前缀可选取决于后端路由设计 # 如果后端API路径本身就以/api开头则不需要重写。 # rewrite ^/api/(.*)$ /$1 break; # 代理到的后端地址和端口 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; # 超时设置 proxy_connect_timeout 60s; proxy_send_timeout 60s; proxy_read_timeout 60s; } # 禁止访问隐藏文件如.git location ~ /\. { deny all; } # 静态资源缓存设置减轻服务器压力 location ~* \.(jpg|jpeg|png|gif|ico|css|js|svg|woff|woff2|ttf|eot)$ { expires 1y; add_header Cache-Control public, immutable; # 确保浏览器在资源未过期时不会发送请求验证 add_header Pragma public; add_header Cache-Control public, max-age31536000, immutable; } }配置要点解析try_files $uri $uri/ /index.html;这是支持Vue Router的history模式的关键。它让Nginx在找不到对应静态文件时返回index.html由前端路由接管。location /api/将所有/api路径的请求转发给本机8080端口运行的Spring Boot服务。这样前端代码中请求/api/users实际上会被Nginx转发到http://127.0.0.1:8080/api/users。proxy_set_header这些头部信息很重要它们将客户端的真实IP、协议等信息传递给后端应用否则Spring Boot日志里看到的客户端IP可能都是127.0.0.1。静态资源缓存对图片、CSS、JS等文件设置长期缓存1年并添加immutable属性告诉浏览器在缓存有效期内无需再向服务器验证极大提升重复访问速度。创建符号链接启用该站点配置并测试Nginx配置语法sudo ln -s /etc/nginx/sites-available/spring-vue-app /etc/nginx/sites-enabled/ sudo nginx -t # 测试配置看到‘syntax is ok’和‘test is successful’则成功如果测试成功重新加载Nginx使配置生效sudo systemctl reload nginx现在打开浏览器访问你的服务器IP地址HTTP端口80。你应该能看到Vue前端页面正常加载。尝试进行一些需要调用后端API的操作检查网络请求是否成功应该发向/api/xxx并返回正确数据。6. 部署后的运维、监控与问题排查6.1 服务状态管理与常用命令部署完成不是终点日常的运维监控同样重要。以下是一些必备的命令查看服务状态# 查看Spring Boot后端服务状态 sudo systemctl status springboot-backend # 查看Nginx服务状态 sudo systemctl status nginx查看服务日志# 查看Spring Boot后端最新日志 sudo journalctl -u springboot-backend -n 100 -f # -f 实时跟踪 # 查看我们指定的日志文件在application-prod.yml中配置的 tail -f ~/logs/backend/spring-boot.log # 查看Nginx访问日志和错误日志 tail -f /var/log/nginx/access.log tail -f /var/log/nginx/error.log重启、停止、启动服务sudo systemctl restart springboot-backend # 重启常用 sudo systemctl stop springboot-backend sudo systemctl start springboot-backend在更新代码后一个完整的更新流程可能是# 1. 拉取最新后端代码并构建 cd ~/apps/backend/source git pull origin main mvn clean package -DskipTests -Pprod cp target/*.jar ~/apps/backend/app.jar # 2. 重启后端服务 sudo systemctl restart springboot-backend # 3. 拉取最新前端代码并构建 cd ~/apps/frontend/source git pull origin main npm install npm run build rm -rf ~/apps/frontend/dist/* cp -r dist/* ~/apps/frontend/dist/ # 4. 通常前端静态文件更新Nginx无需重启但为了确保缓存刷新可以reload sudo systemctl reload nginx6.2 常见问题与排查技巧实录即使按照步骤操作部署过程中也难免会遇到问题。这里记录几个我踩过的坑和排查思路。问题1前端页面能打开但所有API请求都报404或500错误。排查思路检查Nginx代理配置确认location /api/的proxy_pass地址和端口是否正确后端服务是否运行在8080。可以用curl http://127.0.0.1:8080/api/health直接在服务器上测试后端API是否存活。检查后端服务日志sudo journalctl -u springboot-backend -n 50查看是否有启动异常比如数据库连接失败、端口被占用等。检查CORS配置如果你在Spring Boot后端没有配置允许前端域名的CORS在分离部署模式下浏览器会因跨域而阻塞请求。你需要在Spring Boot的配置类中添加CORS配置。一个简单的全局配置如下生产环境建议细化允许的源Configuration public class WebConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/api/**) // 匹配的API路径 .allowedOrigins(http://你的服务器IP或域名) // 允许的前端地址 .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowCredentials(true); // 如果需要传递Cookie等凭证 } }检查网络和防火墙确保服务器的防火墙ufw没有阻止8080端口的本地访问。sudo ufw status查看。对于生产环境后端端口8080通常不应对外网开放只允许本机127.0.0.1访问这由Nginx在内部转发。问题2Vue页面刷新后出现404。原因与解决这是Vue Router使用history模式时的典型问题。确保Nginx配置中包含了try_files $uri $uri/ /index.html;这一行并且它位于处理根路径location /的块中。如果配置正确Nginx会在找不到对应文件时返回index.html由Vue应用处理路由。问题3静态资源JS、CSS、图片加载失败404。排查思路检查~/apps/frontend/dist/目录下是否存在这些资源文件。可能是构建过程有问题或者复制文件时路径错误。检查Nginx配置中的root指令路径是否正确指向了dist目录。检查文件权限。确保Nginx进程用户通常是www-data有权限读取/home/deployer/apps/frontend/dist/目录下的文件。可以尝试sudo chmod -R 755 /home/deployer/apps/frontend/dist。查看Nginx错误日志/var/log/nginx/error.log里面通常会有更详细的错误信息。问题4应用运行一段时间后内存占用过高或崩溃。排查思路检查JVM参数回顾springboot-backend.service文件中的-Xmx参数。是否设置过小使用top或htop命令查看Java进程的内存占用。可以适当调大-Xmx如-Xmx2048m但不要超过服务器物理内存的70%-80%。检查应用内存泄漏使用jcmd PID GC.heap_info或更专业的工具如jvisualvm需要图形界面或配合JMX连接进行分析。Spring Boot Actuator的/actuator/heapdump端点需安全配置也可以生成堆转储文件用于分析。查看GC日志在JVM启动参数中添加-Xlog:gc*:file/home/deployer/logs/backend/gc.log来记录GC日志分析是否存在频繁Full GC。问题5如何实现HTTPS访问解决方案使用Let‘s Encrypt的免费证书通过Certbot工具自动化配置。这是生产环境的标配。# 安装Certbot和Nginx插件 sudo apt install certbot python3-certbot-nginx -y # 运行Certbot它会自动修改你的Nginx配置 sudo certbot --nginx -d your-domain.com执行后按照提示操作即可。Certbot会自动将HTTP重定向到HTTPS并配置好SSL证书。证书每90天会自动续期。6.3 进阶考量备份、监控与持续部署对于正式的生产环境除了基础部署还需要考虑更多。1. 日志聚合与监控将spring-boot.log和Nginx日志接入ELKElasticsearch, Logstash, Kibana或LokiGrafana等日志系统方便查询和分析。为Spring Boot应用集成Micrometer将JVM指标、应用指标暴露给Prometheus再通过Grafana展示监控QPS、延迟、错误率、内存使用等。2. 备份策略定期备份数据库。备份关键的配置文件Nginx配置、systemd service文件、环境变量文件。可以考虑将构建产物JAR包、dist目录也纳入备份便于快速回滚。3. 持续集成/持续部署CI/CD将上述手动更新流程自动化。例如使用GitLab CI在代码仓库中编写.gitlab-ci.yml。当代码推送到main分支时自动触发流水线。流水线在独立的Runner中完成测试、构建生成JAR和dist。通过SCP或Rsync将构建产物传输到生产服务器。通过SSH在服务器上执行重启服务的命令。4. 使用Docker容器化部署这是更现代、更一致的方式。将Spring Boot应用和Vue应用或Nginx分别制作成Docker镜像使用docker-compose.yml定义服务。部署时只需docker-compose up -d。这能完美解决环境依赖问题并简化部署流程。不过这需要学习Docker相关知识并妥善处理容器间的网络通信、数据持久化等问题。部署SpringVue应用到Linux是一个将开发成果交付给用户的临门一脚。这个过程串联了开发、运维、网络、安全多个领域的知识。从最基础的软件安装、服务配置到中级的反向代理、进程守护再到高级的HTTPS、监控、自动化每一步都关乎线上服务的稳定与安全。希望这份超详细的指南能帮你避开我当年踩过的那些坑顺利地将你的应用发布上线。记住部署完成后持续观察日志和监控指标才是运维工作的真正开始。
Spring Boot+Vue前后端分离项目Linux部署实战：从架构设计到生产运维
发布时间：2026/5/16 15:29:26
1. 项目概述从本地开发到云端服务的跨越“SpringVue工程部署在Linux”这个标题对于任何一个正在或即将从单体应用向现代化前后端分离架构转型的开发者来说都是一个绕不开的实战课题。它描述的不仅仅是一个简单的部署动作而是一套从开发环境到生产环境的完整工程化实践。我见过太多团队在本地联调时一切顺风顺水Spring Boot后端API响应迅速Vue前端页面交互流畅可一旦要部署到那台远在数据中心的Linux服务器上各种“水土不服”的问题就接踵而至端口冲突、静态资源404、跨域请求失败、环境变量丢失、服务进程莫名挂掉……这背后的核心是将两个技术栈、两种构建产物、两套运行环境在同一个操作系统上整合成一个对外提供统一服务的应用。Spring Boot作为后端承载着业务逻辑、数据处理和API供给Vue作为前端负责用户界面渲染和交互。部署的本质就是让它们在生产环境的Linux服务器上像在本地开发时那样协同工作并且要更稳定、更高效、更安全。这个过程涉及了Linux系统操作、网络配置、服务管理、持续集成等多个维度的知识是检验一个项目是否具备生产可用性的关键一步。无论你是独立开发者、运维工程师还是项目负责人掌握这套部署流程都意味着你拥有了将创意和代码转化为真正可服务用户的产品的能力。2. 部署架构设计与核心思路拆解2.1 前后端分离部署的两种主流模式在动手之前我们必须先厘清部署的架构。对于SpringVue项目生产环境部署主要有两种模式选择哪种直接决定了后续的技术选型和配置复杂度。第一种是完全分离部署。在这种模式下前端Vue应用和后端Spring Boot应用是彻底独立的两个服务。Vue经过npm run build后生成纯粹的HTML、CSS、JavaScript静态文件。这些文件会被部署到一个专门的HTTP服务器上例如Nginx或Apache。这个HTTP服务器只负责提供前端页面和静态资源。而后端的Spring Boot应用则被打包成可执行的JAR文件作为一个独立的Java进程运行在服务器上通常使用java -jar命令启动并监听某个后端端口如8080。前端页面通过JavaScript发起的API请求例如使用Axios库会指向这个后端服务的地址。这种模式的优点是职责清晰前后端可以独立扩容、独立更新。例如前端静态资源可以放到CDN上加速后端服务可以集群化部署。但它的一个核心挑战是跨域问题CORS。因为前端页面假设由www.yourdomain.com提供请求的后端API假设在api.yourdomain.com:8080属于不同的“源”浏览器出于安全考虑会阻止这类请求。解决它需要在Spring Boot后端显式配置CORS策略。第二种是整合式部署。这种模式更适合小型项目或希望简化运维的场景。Vue同样被构建成静态文件但这些文件不是由独立的Web服务器托管而是被直接放到Spring Boot项目的src/main/resources/static/目录下。当我们打包Spring Boot应用时这些前端文件会被打包进最终的JAR包。启动这个JAR后Spring Boot内嵌的Tomcat或Undertow服务器将同时承担两个角色既提供前端静态文件服务通过根路径或特定路径也提供后端API服务。用户访问服务器IP和端口看到的就是完整的前端页面页面内的API请求自然指向同一个域名和端口从而完美避开了跨域问题。这种模式部署简单“一个JAR包走天下”但前后端耦合较紧任何一方的更新都需要重新构建和部署整个应用。注意对于大多数中大型项目或团队协作项目我强烈推荐完全分离部署。它不仅更符合微服务和云原生的思想也为未来的技术演进如引入API网关、服务网格留足了空间。本文后续的详细实操也将以这种模式为主线进行展开。2.2 技术栈选型与工具准备确定了分离部署的架构接下来就需要为Linux服务器挑选合适的“武器”。这不仅仅是安装软件更是为整个应用的稳定性、性能和可维护性打下基础。1. 服务器环境Linux发行版CentOS/RHEL系列如CentOS 7/8, AlmaLinux和Ubuntu/Debian系列是两大主流。CentOS以稳定著称常见于传统企业环境Ubuntu则拥有更活跃的社区和更新的软件包对新手更友好。我个人近年来更倾向于Ubuntu Server LTS版本如20.04 LTS, 22.04 LTS其apt包管理器用起来顺手遇到问题网上解决方案也更多。无论选择哪个请务必使用LTS长期支持版本以获得稳定的安全更新。2. Web服务器用于托管前端Nginx几乎是当今的不二之选。相较于ApacheNginx在处理高并发静态资源请求时性能更优配置语法也更简洁清晰。我们不仅用它来托管Vue的dist目录还会利用其反向代理功能将API请求转发给后端的Spring Boot应用这样对外只需要暴露一个端口通常是80或443简化了网络配置并提升了安全性。3. 应用服务器用于运行后端Spring Boot应用自带内嵌的Servlet容器Tomcat, Jetty, Undertow因此我们不需要额外安装像Tomcat这样的独立应用服务器。只需要安装合适版本的Java运行环境JRE或开发工具包JDK。对于生产环境建议安装JDK而非仅JRE因为一些监控和诊断工具可能需要JDK中的工具。4. 版本管理工具虽然可以直接上传文件但使用Git进行版本拉取是更专业和可持续的做法。在服务器上安装Git从代码仓库如GitHub, Gitee, GitLab拉取指定版本的前后端代码便于回滚和持续部署。5. 进程管理工具不能让Spring Boot的JAR进程仅仅在SSH会话中通过java -jar前台运行一旦SSH断开进程就终止了。我们需要一个进程守护工具。systemd是现代Linux发行版的标准服务管理器功能强大可以设置开机自启、自动重启、日志管理。它是管理Spring Boot服务的最佳选择。6. 构建工具服务器上需要安装Node.js和npm或yarn/pnpm来构建Vue项目安装Maven或Gradle来构建Spring Boot项目。一种更优的做法是将构建过程放在CI/CD流水线中如Jenkins, GitLab CI, GitHub Actions服务器只负责运行构建好的产物。这能保持服务器环境纯净。但为了演示完整流程我们会在服务器上完成构建。总结一下我们的工具清单一台安装好Ubuntu 22.04 LTS的服务器、Nginx、OpenJDK 17或与你的Spring Boot版本匹配的JDK、Git、Node.js 18、Maven 3.6。接下来我们就进入具体的实操环节。3. Linux服务器基础环境配置3.1 系统更新与安全加固拿到一台全新的云服务器第一件事不是急着安装软件而是进行系统更新和安全基础设置这是一个好习惯。通过SSH登录服务器后首先更新软件包列表并升级现有软件sudo apt update sudo apt upgrade -y-y参数用于自动确认避免中途需要手动输入。接着创建一个用于部署的专用用户而不是一直使用root。这能提高安全性避免误操作。sudo adduser deployer按照提示设置密码并填写一些无关紧要的信息。然后将新用户添加到sudo组使其拥有管理权限sudo usermod -aG sudo deployer后续的操作我们都可以切换到deployer用户进行使用su - deployer或重新以deployer用户SSH登录。防火墙是必须开启的。Ubuntu默认使用ufwUncomplicated Firewall。我们先放行SSH端口默认为22否则启用防火墙后可能会把自己关在外面。sudo ufw allow OpenSSH sudo ufw enable在部署阶段我们还需要临时放行后端Spring Boot的端口如8080和前端Nginx的端口80/443。但生产环境中通常只对外暴露80HTTP和443HTTPS后端端口不对外网开放仅允许本机或内部网络访问。我们可以先放行后续再调整sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw allow 8080/tcp使用sudo ufw status numbered可以查看当前规则。3.2 核心依赖安装JDK, Node.js, Maven, Git, Nginx现在以deployer用户身份安装我们所需的所有软件。安装OpenJDK 17Spring Boot 2.7 和 3.0 版本通常推荐JDK 17或更高版本。sudo apt install openjdk-17-jdk -y安装后验证版本java -version。如果需要管理多个JDK版本可以考虑安装sdkman但生产环境建议固定一个稳定版本。安装Node.js 18 LTS直接从NodeSource仓库安装比Ubuntu默认仓库的版本更新。curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs验证安装node --version和npm --version。安装Mavensudo apt install maven -y验证安装mvn -v。安装Gitsudo apt install git -y安装Nginxsudo apt install nginx -y安装完成后Nginx会自动启动。你可以通过sudo systemctl status nginx查看状态并在浏览器访问服务器IP应该能看到Nginx的欢迎页面。3.3 项目目录结构规划清晰的目录结构是高效运维的基础。我建议在deployer用户的家目录下/home/deployer创建如下结构/home/deployer/ ├── apps/ # 存放所有应用 │ ├── backend/ # Spring Boot后端项目目录 │ │ ├── source/ # 从Git拉取的源代码 │ │ ├── app.jar # 构建好的可执行JAR包 │ │ └── config/ # 外部配置文件如application-prod.yml │ └── frontend/ # Vue前端项目目录 │ ├── source/ # 从Git拉取的源代码 │ └── dist/ # npm build后生成的静态文件目录 ├── logs/ # 统一存放应用日志 │ ├── backend/ │ └── nginx/ └── scripts/ # 存放部署、重启等维护脚本创建这个结构mkdir -p ~/apps/backend/{source,config} mkdir -p ~/apps/frontend/{source,dist} mkdir -p ~/logs/{backend,nginx} mkdir -p ~/scripts这个结构将源代码、构建产物、配置文件、日志分离非常清晰。config目录尤其重要它允许我们将Spring Boot的配置文件如application-prod.yml放在JAR包外部这样修改配置时无需重新构建和部署JAR包只需重启服务即可符合12-Factor应用的原则。4. 后端Spring Boot应用部署详解4.1 项目构建与生产环境配置首先进入后端源代码目录从版本控制系统拉取代码。假设你的代码在GitHub上cd ~/apps/backend/source git clone 你的后端仓库地址 . # 注意最后的‘.’表示克隆到当前目录而非创建子目录拉取特定分支或标签git checkout release/v1.0Spring Boot项目通常使用Maven或Gradle管理。我们以Maven为例。在构建之前最关键的一步是准备生产环境配置文件。在src/main/resources/下你可能有application.yml和application-dev.yml。我们需要创建一个application-prod.yml用于覆盖生产环境特有的配置。一个典型的application-prod.yml可能包含server: port: 8080 # 生产环境建议关闭详细错误信息避免信息泄露 error: include-stacktrace: never include-message: never # 设置合适的连接器属性 tomcat: max-threads: 200 min-spare-threads: 10 spring: datasource: url: jdbc:mysql://localhost:3306/your_prod_db?useSSLfalseserverTimezoneUTCcharacterEncodingutf8 username: prod_user password: ${DB_PASSWORD:} # 强烈建议使用环境变量传递密码 hikari: maximum-pool-size: 20 connection-timeout: 30000 # 生产环境关闭开发工具和热部署 devtools: add-properties: false # JPA配置示例 jpa: hibernate: ddl-auto: validate # 生产环境绝对不要用‘create’或‘update’ show-sql: false properties: hibernate.format_sql: false # 日志配置输出到文件 logging: file: name: /home/deployer/logs/backend/spring-boot.log level: com.yourcompany: INFO org.springframework: WARN实操心得数据库密码、API密钥等敏感信息绝对不要硬编码在配置文件中。应该使用环境变量如${DB_PASSWORD}或专门的密钥管理服务如HashiCorp Vault。在服务器上可以通过export DB_PASSWORDyour_secure_password设置环境变量或者在systemd服务文件中定义。现在开始构建项目。在源代码根目录执行mvn clean package -DskipTests -Pprodclean package清理并打包。-DskipTests跳过测试生产构建可跳过但确保你的CI流程中已运行过测试。-Pprod激活Maven的prodprofile。你需要在pom.xml中定义这个profile并指定使用application-prod.yml作为激活时的配置文件。例如在pom.xml的profiles部分profile idprod/id properties activatedPropertiesprod/activatedProperties /properties /profile并在build的resources部分配置资源过滤。构建成功后在target/目录下会生成一个可执行的JAR文件名称通常为your-app-name-0.0.1-SNAPSHOT.jar。将其复制到我们规划好的位置cp target/*.jar ~/apps/backend/app.jar同时将生产配置文件也复制到外部配置目录cp src/main/resources/application-prod.yml ~/apps/backend/config/4.2 使用Systemd托管Spring Boot服务这是保证服务稳定运行的核心步骤。我们将创建一个systemd服务单元文件来管理Spring Boot应用。使用sudo权限创建服务文件sudo vim /etc/systemd/system/springboot-backend.service写入以下内容[Unit] DescriptionSpring Boot Backend Application Aftersyslog.target network.target [Service] Typesimple # 指定运行用户和组不要用root Userdeployer Groupdeployer # 指定工作目录这里指向JAR包所在目录 WorkingDirectory/home/deployer/apps/backend # 启动命令 # 关键通过‘--spring.config.location’指定外部配置文件路径 # 通过‘-D’设置JVM参数如内存、GC等 ExecStart/usr/bin/java -Xms512m -Xmx1024m -jar /home/deployer/apps/backend/app.jar --spring.config.locationfile:/home/deployer/apps/backend/config/application-prod.yml # 指定环境变量文件用于存放数据库密码等敏感信息 EnvironmentFile/home/deployer/apps/backend/config/backend.env # 失败时自动重启 Restarton-failure # 重启间隔 RestartSec10s # 标准输出和错误输出重定向到系统日志同时我们也输出到自定义文件 StandardOutputjournal StandardErrorjournal SyslogIdentifierspringboot-backend [Install] WantedBymulti-user.target关键参数解析User/Group使用非root用户运行是基本的安全准则。-Xms512m -Xmx1024m设置JVM堆内存初始值和最大值。根据你的应用实际内存占用调整设置太小会导致频繁GC设置太大可能浪费资源。生产环境建议通过监控工具观察后设定。--spring.config.location这是最重要的参数之一。它告诉Spring Boot从外部文件加载配置优先级高于JAR包内的配置文件。这样我们就可以在不重新打包的情况下修改配置。EnvironmentFile指向一个环境变量文件如backend.env里面可以定义DB_PASSWORDxxx。在application-prod.yml中就可以用${DB_PASSWORD}引用。记得给这个env文件设置严格的权限chmod 600 backend.env。创建环境变量文件cd ~/apps/backend/config vim backend.env # 内容示例DB_PASSWORDYourSuperSecretPassword123! chmod 600 backend.env现在重新加载systemd配置启动服务并设置开机自启sudo systemctl daemon-reload sudo systemctl start springboot-backend sudo systemctl enable springboot-backend检查服务状态和日志sudo systemctl status springboot-backend # 查看实时日志 sudo journalctl -u springboot-backend -f如果状态是active (running)并且日志中没有报错说明后端服务已经成功启动并在监听8080端口。你可以用curl localhost:8080/api/health假设你有健康检查端点来测试。5. 前端Vue应用构建与Nginx配置5.1 Vue项目生产环境构建优化切换到前端项目目录拉取代码cd ~/apps/frontend/source git clone 你的前端仓库地址 . git checkout release/v1.0在构建之前同样需要处理生产环境配置。Vue项目特别是Vue CLI或Vite创建的项目通常使用.env文件管理环境变量。在项目根目录创建.env.production文件NODE_ENVproduction VUE_APP_API_BASE_URL/api # 注意这里我们设置API基础路径为‘/api’意味着前端请求会发向同域名下的‘/api’路径。 # Nginx将负责将这个路径的请求代理到后端的Spring Boot服务localhost:8080。VUE_APP_API_BASE_URL这个变量在你的Vue代码中可以通过process.env.VUE_APP_API_BASE_URL访问。你需要在发起API请求的地方如Axios的全局配置使用它// axios配置示例 (src/utils/request.js) import axios from axios; const service axios.create({ baseURL: process.env.VUE_APP_API_BASE_URL, timeout: 10000 });安装依赖并构建npm install --registryhttps://registry.npmmirror.com # 使用国内镜像加速 npm run buildnpm run build命令会执行Vue项目的生产环境构建代码会被压缩、混淆并生成一个dist目录。构建过程可能会比较耗时取决于项目大小。构建完成后将dist目录下的所有内容复制到我们规划好的前端部署目录rm -rf ~/apps/frontend/dist/* # 清理旧构建 cp -r dist/* ~/apps/frontend/dist/5.2 Nginx配置静态服务与反向代理现在配置Nginx让它做两件事1. 托管Vue的静态文件2. 将API请求反向代理到Spring Boot后端。首先备份默认配置然后创建我们自己的站点配置sudo mv /etc/nginx/sites-available/default /etc/nginx/sites-available/default.backup sudo vim /etc/nginx/sites-available/spring-vue-app写入以下配置内容。这是一个兼顾了性能和安全的基础配置server { listen 80; # 将 your-server-ip-or-domain 替换为你的服务器IP或域名 server_name your-server-ip-or-domain; # 前端静态文件服务 # 根目录指向我们放置Vue构建产物的目录 root /home/deployer/apps/frontend/dist; index index.html index.htm; # Gzip压缩提升传输效率 gzip on; gzip_vary on; gzip_min_length 1024; gzip_types text/plain text/css text/xml text/javascript application/javascript application/xmlrss application/json; # 处理Vue Router的history模式 # 当用户直接访问一个前端路由如 /dashboard时Nginx会尝试找对应的文件找不到则返回index.html location / { try_files $uri $uri/ /index.html; } # 反向代理所有以 /api 开头的请求到后端Spring Boot应用 location /api/ { # 移除请求路径中的 /api 前缀可选取决于后端路由设计 # 如果后端API路径本身就以/api开头则不需要重写。 # rewrite ^/api/(.*)$ /$1 break; # 代理到的后端地址和端口 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; # 超时设置 proxy_connect_timeout 60s; proxy_send_timeout 60s; proxy_read_timeout 60s; } # 禁止访问隐藏文件如.git location ~ /\. { deny all; } # 静态资源缓存设置减轻服务器压力 location ~* \.(jpg|jpeg|png|gif|ico|css|js|svg|woff|woff2|ttf|eot)$ { expires 1y; add_header Cache-Control public, immutable; # 确保浏览器在资源未过期时不会发送请求验证 add_header Pragma public; add_header Cache-Control public, max-age31536000, immutable; } }配置要点解析try_files $uri $uri/ /index.html;这是支持Vue Router的history模式的关键。它让Nginx在找不到对应静态文件时返回index.html由前端路由接管。location /api/将所有/api路径的请求转发给本机8080端口运行的Spring Boot服务。这样前端代码中请求/api/users实际上会被Nginx转发到http://127.0.0.1:8080/api/users。proxy_set_header这些头部信息很重要它们将客户端的真实IP、协议等信息传递给后端应用否则Spring Boot日志里看到的客户端IP可能都是127.0.0.1。静态资源缓存对图片、CSS、JS等文件设置长期缓存1年并添加immutable属性告诉浏览器在缓存有效期内无需再向服务器验证极大提升重复访问速度。创建符号链接启用该站点配置并测试Nginx配置语法sudo ln -s /etc/nginx/sites-available/spring-vue-app /etc/nginx/sites-enabled/ sudo nginx -t # 测试配置看到‘syntax is ok’和‘test is successful’则成功如果测试成功重新加载Nginx使配置生效sudo systemctl reload nginx现在打开浏览器访问你的服务器IP地址HTTP端口80。你应该能看到Vue前端页面正常加载。尝试进行一些需要调用后端API的操作检查网络请求是否成功应该发向/api/xxx并返回正确数据。6. 部署后的运维、监控与问题排查6.1 服务状态管理与常用命令部署完成不是终点日常的运维监控同样重要。以下是一些必备的命令查看服务状态# 查看Spring Boot后端服务状态 sudo systemctl status springboot-backend # 查看Nginx服务状态 sudo systemctl status nginx查看服务日志# 查看Spring Boot后端最新日志 sudo journalctl -u springboot-backend -n 100 -f # -f 实时跟踪 # 查看我们指定的日志文件在application-prod.yml中配置的 tail -f ~/logs/backend/spring-boot.log # 查看Nginx访问日志和错误日志 tail -f /var/log/nginx/access.log tail -f /var/log/nginx/error.log重启、停止、启动服务sudo systemctl restart springboot-backend # 重启常用 sudo systemctl stop springboot-backend sudo systemctl start springboot-backend在更新代码后一个完整的更新流程可能是# 1. 拉取最新后端代码并构建 cd ~/apps/backend/source git pull origin main mvn clean package -DskipTests -Pprod cp target/*.jar ~/apps/backend/app.jar # 2. 重启后端服务 sudo systemctl restart springboot-backend # 3. 拉取最新前端代码并构建 cd ~/apps/frontend/source git pull origin main npm install npm run build rm -rf ~/apps/frontend/dist/* cp -r dist/* ~/apps/frontend/dist/ # 4. 通常前端静态文件更新Nginx无需重启但为了确保缓存刷新可以reload sudo systemctl reload nginx6.2 常见问题与排查技巧实录即使按照步骤操作部署过程中也难免会遇到问题。这里记录几个我踩过的坑和排查思路。问题1前端页面能打开但所有API请求都报404或500错误。排查思路检查Nginx代理配置确认location /api/的proxy_pass地址和端口是否正确后端服务是否运行在8080。可以用curl http://127.0.0.1:8080/api/health直接在服务器上测试后端API是否存活。检查后端服务日志sudo journalctl -u springboot-backend -n 50查看是否有启动异常比如数据库连接失败、端口被占用等。检查CORS配置如果你在Spring Boot后端没有配置允许前端域名的CORS在分离部署模式下浏览器会因跨域而阻塞请求。你需要在Spring Boot的配置类中添加CORS配置。一个简单的全局配置如下生产环境建议细化允许的源Configuration public class WebConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/api/**) // 匹配的API路径 .allowedOrigins(http://你的服务器IP或域名) // 允许的前端地址 .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowCredentials(true); // 如果需要传递Cookie等凭证 } }检查网络和防火墙确保服务器的防火墙ufw没有阻止8080端口的本地访问。sudo ufw status查看。对于生产环境后端端口8080通常不应对外网开放只允许本机127.0.0.1访问这由Nginx在内部转发。问题2Vue页面刷新后出现404。原因与解决这是Vue Router使用history模式时的典型问题。确保Nginx配置中包含了try_files $uri $uri/ /index.html;这一行并且它位于处理根路径location /的块中。如果配置正确Nginx会在找不到对应文件时返回index.html由Vue应用处理路由。问题3静态资源JS、CSS、图片加载失败404。排查思路检查~/apps/frontend/dist/目录下是否存在这些资源文件。可能是构建过程有问题或者复制文件时路径错误。检查Nginx配置中的root指令路径是否正确指向了dist目录。检查文件权限。确保Nginx进程用户通常是www-data有权限读取/home/deployer/apps/frontend/dist/目录下的文件。可以尝试sudo chmod -R 755 /home/deployer/apps/frontend/dist。查看Nginx错误日志/var/log/nginx/error.log里面通常会有更详细的错误信息。问题4应用运行一段时间后内存占用过高或崩溃。排查思路检查JVM参数回顾springboot-backend.service文件中的-Xmx参数。是否设置过小使用top或htop命令查看Java进程的内存占用。可以适当调大-Xmx如-Xmx2048m但不要超过服务器物理内存的70%-80%。检查应用内存泄漏使用jcmd PID GC.heap_info或更专业的工具如jvisualvm需要图形界面或配合JMX连接进行分析。Spring Boot Actuator的/actuator/heapdump端点需安全配置也可以生成堆转储文件用于分析。查看GC日志在JVM启动参数中添加-Xlog:gc*:file/home/deployer/logs/backend/gc.log来记录GC日志分析是否存在频繁Full GC。问题5如何实现HTTPS访问解决方案使用Let‘s Encrypt的免费证书通过Certbot工具自动化配置。这是生产环境的标配。# 安装Certbot和Nginx插件 sudo apt install certbot python3-certbot-nginx -y # 运行Certbot它会自动修改你的Nginx配置 sudo certbot --nginx -d your-domain.com执行后按照提示操作即可。Certbot会自动将HTTP重定向到HTTPS并配置好SSL证书。证书每90天会自动续期。6.3 进阶考量备份、监控与持续部署对于正式的生产环境除了基础部署还需要考虑更多。1. 日志聚合与监控将spring-boot.log和Nginx日志接入ELKElasticsearch, Logstash, Kibana或LokiGrafana等日志系统方便查询和分析。为Spring Boot应用集成Micrometer将JVM指标、应用指标暴露给Prometheus再通过Grafana展示监控QPS、延迟、错误率、内存使用等。2. 备份策略定期备份数据库。备份关键的配置文件Nginx配置、systemd service文件、环境变量文件。可以考虑将构建产物JAR包、dist目录也纳入备份便于快速回滚。3. 持续集成/持续部署CI/CD将上述手动更新流程自动化。例如使用GitLab CI在代码仓库中编写.gitlab-ci.yml。当代码推送到main分支时自动触发流水线。流水线在独立的Runner中完成测试、构建生成JAR和dist。通过SCP或Rsync将构建产物传输到生产服务器。通过SSH在服务器上执行重启服务的命令。4. 使用Docker容器化部署这是更现代、更一致的方式。将Spring Boot应用和Vue应用或Nginx分别制作成Docker镜像使用docker-compose.yml定义服务。部署时只需docker-compose up -d。这能完美解决环境依赖问题并简化部署流程。不过这需要学习Docker相关知识并妥善处理容器间的网络通信、数据持久化等问题。部署SpringVue应用到Linux是一个将开发成果交付给用户的临门一脚。这个过程串联了开发、运维、网络、安全多个领域的知识。从最基础的软件安装、服务配置到中级的反向代理、进程守护再到高级的HTTPS、监控、自动化每一步都关乎线上服务的稳定与安全。希望这份超详细的指南能帮你避开我当年踩过的那些坑顺利地将你的应用发布上线。记住部署完成后持续观察日志和监控指标才是运维工作的真正开始。
相关文章
SystemVerilog联合(Union)详解：硬件工程师的打包与解包实战指南
1. 联合（Union）是什么？从硬件工程师的视角重新理解如果你是从Verilog转战SystemVerilog的硬件工程师，第一次看到union这个关键字，可能会有点懵。这玩意儿看起来有点像struct，但又不太一样。教科书或者语言手…
窗口尺寸革命：如何用WindowResizer打破Windows应用程序的尺寸枷锁
窗口尺寸革命：如何用WindowResizer打破Windows应用程序的尺寸枷锁 【免费下载链接】WindowResizer 一个可以强制调整应用程序窗口大小的工具 项目地址: https://gitcode.com/gh_mirrors/wi/WindowResizer 你是否曾遇到过这样的情况：一个重要的应用…
Unity GLTF模型导入终极教程：5分钟掌握GLTFUtility完整指南
Unity GLTF模型导入终极教程：5分钟掌握GLTFUtility完整指南 【免费下载链接】GLTFUtility Simple GLTF importer for Unity 项目地址: https://gitcode.com/gh_mirrors/gl/GLTFUtility GLTFUtility是Unity开发者必备的GLTF模型导入工具，能够让你在…
深入理解C语言section属性：从链接脚本到自动初始化框架
1. 从链接脚本到自动启动：深入理解C语言的section属性在嵌入式开发，尤其是RTOS（实时操作系统）的SDK设计中，我们常常会看到一种“神奇”的现象：开发者只需在某个初始化函数前加上一个特定的宏，比…
Eplan块属性 - 连接定义点
1.简介EPLAN “块属性格式字符串”[20025,1,1<20201<20058,0,0,0,0,0,0,0,0,zh_CN,0,0,0,0,0,0,0>>]/[20211,2,1<20201<20058,0,0,0,0,0,0,0,0,zh_CN,0,0,0,0,0,0,0>>]2.操作步骤①新建一个块属性格式；②选择一个格式：“关于连接…
独家解密：ElevenLabs匈牙利语模型训练数据源（含布达佩斯大学语料库授权细节与音系学标注规范）
更多请点击： https://intelliparadigm.com 第一章：ElevenLabs匈牙利语语音模型的技术定位与战略意义 ElevenLabs 匈牙利语语音模型并非简单的地方语言适配，而是其多语言零样本语音合成（Zero-Shot Voice Cloning）架构在…
Cocos游戏开发中的Vibe Coding零代码实战与痛点，很详细！
引言 哈喽大家好，我是亿元程序员，一位有着8年游戏行业经验的主程。 随着AI的快速发展，虽然它已经很强了，但是想要完完全全取代咱们游戏开发者，还是没那么简单的。 我用CocosAI从0到1实战了一款词图归类游戏࿰…
【ElevenLabs泰文语音生成权威测评】：对比Watson、Azure、Amazon Polly的MOS评分与本地化适配率
更多请点击： https://intelliparadigm.com 第一章：ElevenLabs泰文语音生成技术概览 ElevenLabs 自 2023 年起逐步扩展其多语言支持能力，泰文（Thai）作为东南亚关键语种，于 v2.5 API 版本中正式加入语音合成…
基于Feather RP2040 Scorpio与NeoPixel打造动态LED节日树全流程解析
1. 项目概述：打造你的专属动态LED节日树如果你和我一样，对闪烁的LED和嵌入式编程充满热情，那么用微控制器驱动一整个灯光装置，看着它按照你的指令翩翩起舞，绝对是件充满成就感的事。今天要分享的这个项目，就…
SD-PPP：在Photoshop中开启智能设计革命的终极AI插件
SD-PPP：在Photoshop中开启智能设计革命的终极AI插件 【免费下载链接】sd-ppp A Photoshop AI plugin 项目地址: https://gitcode.com/gh_mirrors/sd/sd-ppp 你是否厌倦了在Photoshop和AI工具之间频繁切换，打断了创意的流畅性？SD-PPP正…
NomNom存档编辑器：解放你的《无人深空》游戏体验终极指南
NomNom存档编辑器：解放你的《无人深空》游戏体验终极指南 【免费下载链接】NomNom NomNom is the most complete savegame editor for NMS but also shows additional information around the data youre about to change. You can also easily look up each item i…
5个专业策略：构建企业级本地漏洞情报分析平台
5个专业策略：构建企业级本地漏洞情报分析平台 【免费下载链接】cve-search cve-search - a tool to perform local searches for known vulnerabilities 项目地址: https://gitcode.com/gh_mirrors/cv/cve-search 在当今复杂的网络安全环境中，快速…
贾子理论与AI时代文明竞争：从暴力计算到本质贯通的范式重构
贾子理论与AI时代文明竞争：从暴力计算到本质贯通的范式重构摘要本文基于贾子理论的文明竞争视角，揭示中美AI战略差异的本质并非技术参数较量，而是“暴力计算”与“本质贯通”两种文明范式的根本对立。美国依赖算力堆叠与资本逻辑追求技术霸权…
2026年AI大模型API中转平台排名揭晓，诗云API(ShiyunApi)脱颖而出成省心之选
在AI开发领域，如何接入模型厂商的官方API是一个绕不开的现实问题。对于海外开发者来说，注册、绑卡、调用，三步即可轻松搞定。然而，国内开发者却面临着跨境网络波动、外币支付门槛、发票合规需求以及多厂商Key碎片化管理等诸多“非…
基于飞书与OpenAI构建企业级AI助手：架构、部署与深度优化指南
1. 项目概述：当飞书遇上AI，一个企业级智能助手的诞生 最近在折腾一个挺有意思的项目，叫“ConnectAI-E/feishu-openai”。简单来说，它就是一个桥梁，把飞书这个强大的企业协作平台，和以ChatGPT为代表的OpenA…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…