学生项目本地能跑,一放云服务器就各种起不来——这话我年年都能听到好几遍。前阵子帮一个学弟部署他的毕设,他已经在阿里云上从下午折腾到半夜,最后发现只是安全组没放行8080端口。说实话,这类问题不算难,但每年总有一批人被卡住,因为云端和本地的环境差异、网络隔离、配置方式完全不是一个逻辑。这几年我先后在阿里云、腾讯云上给不同毕设项目做过部署,踩坑踩出了一套固定流程。这篇就把从本地到云端的完整链路上最常见的雷挨个拆一遍,不光给你能直接抄的命令,还会讲清楚每一步背后的判断依据,让不同基础的同学都能搞明白:下次部署到底该怎么做,出问题了该先去查哪儿。
1. 部署前的自检清单:本地能跑,不等于服务器上就能跑
1.1 先判断你的项目属于哪种"部署难度"
毕设项目落到云服务器上,我习惯先给它们做一次难度分级,不同级别对应的准备工作完全不同。
- 最简单的是纯静态站点:只有 HTML/CSS/JS,这类项目部署难度最低,把文件传上去、用 Nginx 指向目录就能跑,基本不需要考虑运行环境。
- 常见的是前后端分离项目:前端 Vue/React 打包成静态文件,后端 Spring Boot / Django / Flask 作为独立服务,这类项目要处理构建、反向代理、进程守护,是毕设里最常见的形态。
- 少数人做的是带桌面端或本地推理的项目,比如本地大模型、图像处理服务,这类除了常规部署还要考虑服务器的 CPU/内存、GPU 能不能扛住,很多时候1核2G的入门机型根本跑不动。
我建议一接到部署任务先做这个判断,因为很多人的第一反应是急着买服务器、装环境,结果跑了半天才意识到自己的项目需要 8G 内存才能启动。先搞清楚需求再动手,比什么都重要。
1.2 本地环境与云端环境的版本差异是头号暗坑
我见过的部署失败案例里,因为版本不一致引发的占比最高。学校机房或者个人电脑上,大家往往用的是比较新或比较旧的工具链,而云服务器上通过软件源装的版本,可能和你本地完全对不上。
- JDK 版本:本地用的 JDK 17,服务器上
yum install java可能装出一个很老的版本,然后启动 Spring Boot 直接报UnsupportedClassVersionError。这种报错看一眼 class 文件版本号就知道了,但很多人第一反应是怀疑代码有问题。 - Node 版本:前端项目本地用 Node 18 构建正常,服务器上用系统自带的 Node 10 跑
npm install,各种语法错误、依赖安装失败全冒出来了。 - Python 版本:Django 项目本地 3.10,服务器上 Python 3.6 甚至 3.5,很多语法和依赖直接不兼容。
- 数据库版本:本地 MySQL 8.0,云服务器上自带 5.7 或者反过来,编码集、排序规则、连接驱动都有可能出问题。
解决思路很简单:在云服务器上主动安装和你本地一致的版本。用版本管理器(比如 nvm 管理 Node,pyenv 管理 Python,或者直接通过官网下载 JDK 的 tar 包)比依赖系统默认源更可控。我在实际操作中给毕设项目统一推荐的组合是:后端 JDK 1.8 或 17(看项目具体情况),前端 Node 16 或 18(腾讯云和阿里云的镜像源都有 rpm 包),数据库用 MySQL 8.0,这样覆盖大多数毕设场景都没问题,而且网上踩坑案例最多,遇到问题容易搜到答案。
1.3 配置外置:别把本地地址写死在代码里
我刚带项目时经常遇到一种情况:代码本地跑得好好的,一部署才发现数据库连接地址写的是 localhost:3306,Redis 地址写的是 127.0.0.1。这类问题排查起来很费劲,因为编译时可能都不报错,启动时才连不上。
更合理的做法是把配置外置。Spring Boot 项目把数据库地址、Redis 地址、上传文件路径放到 application-prod.yml 或环境变量里;Python 项目可以用 .env 文件管理配置。部署时通过环境变量覆盖,而不是每次改代码重新打包。
这里有个非常典型的例子:有次一个学生把阿里云 OSS 的 AccessKey 直接写在代码里上传到 GitHub 仓库,后来拿服务器上部署时才发现密钥已经泄露了,别人在异地消费了好几百块。这个坑希望看到这篇文章的同学一定要记住:所有敏感配置,包括数据库密码、云服务密钥、回调地址,一律不进代码仓库,要么放在部署机上的配置文件里,要么用环境变量注入。
1.4 用 Git 管理部署版本,别用"最终版.zip"
每次部署前我都建议先把项目推到一个 Git 仓库(GitHub/Gitee/云效都行),然后在服务器上 git clone 或者 git pull。这么做有几个现实的好处:一是避免 U 盘拷贝代码时文件缺失或损坏;二是服务器上可以直接切换到任意提交记录,出问题能快速回滚到上一版;三是服务器的代码和本地同一个源,改起来有据可查。
有些同学习惯把项目打包成 zip 传上去,然后解压、配置、启动。等线上版本出问题,想回想上一版改了什么,完全没有记录。用 Git 管理部署版本,其实是成本最低、收益最高的习惯。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 服务器选购、登录与初始安全设置
2.1 学生机选型与地域选择
阿里云和腾讯云都有专门的学生优惠套餐,价格不高,但配置也有限。给毕设项目做部署,我的建议是最低 2核4G,能上 4G 内存就不要买 2G。为什么?你自己可以打开任务管理器,把 JDK、MySQL、Redis、Nginx 同时跑起来,看看内存占用多少。很多毕设项目后端是 Spring Boot,启动就占 500MB 到 1GB,加上 MySQL 默认吃内存,2G 的机器很容易在负载一上来时就 OOM。
地域选择的原则是离你的目标用户近。如果只是自己演示给答辩老师看,选哪个区域都无所谓;如果你担心答辩现场网络不好,可以把服务器区域选在和你同一城市附近,延迟会低一些。但如果你买的是境外区域,可能会遇到访问速度慢、备案等问题,所以毕设项目首选境内地域,稳妥。
2.2 系统镜像选择与版本需要注意的坑
新手阶段我会推荐用镜像市场里比较成熟的系统。目前阿里云和腾讯云主流的操作系统有两类:
- CentOS 风格:CentOS 7.6 以上、Alibaba Cloud Linux、TencentOS。这类系统和学校的 Linux 课程契合度高,网上资料最多。
- Ubuntu/Debian 风格:Ubuntu 20.04 / 22.04。命令是
apt,很多软件包更新更及时,适合 Python 项目。
不过有一点要清醒:CentOS 7 官方已经停止维护了,安全更新停了之后容易有漏洞。新购买服务器时建议直接用 CentOS 7 的替代品(Alibaba Cloud Linux、TencentOS,或者直接上 Ubuntu 22.04)。如果你已经买了 CentOS 7,也不是不能继续用,但要清楚它不再有安全补丁,尽量别开放不必要的外网端口,当演示服务器问题不大。操作系统版本尽量在同一代向上选,避免 MySQL、Nginx 等软件源里版本过老的问题。
2.3 初始登录:密码还是密钥?改端口要不要做?
云服务器购买成功后,控制台会给一个公网 IP 和初始密码。第一次登录我建议用 SSH 密钥方式,而不是密码。原因很简单:云服务器上默认开着 22 端口,用密码登录容易被人持续爆破,而密钥登录从机制上堵住了暴力破解这条路。
密钥对在控制台可以生成,生成后把私钥下载到本地,服务器上导入公钥。然后本地用终端执行:
bash复制ssh -i ~/.ssh/your_key.pem root@你的服务器公网IP
登录后第一件事是创建一个普通用户,同时给这个用户 sudo 权限:
bash复制# 添加用户,比如叫 deploy
adduser deploy
# 设置密码
passwd deploy
# 加入 wheel 组或 sudo 组
usermod -aG wheel deploy
以后日常操作都用 deploy 用户登录,需要管理员权限时加 sudo。我的习惯是直接禁用 root 的 SSH 登录,把 PermitRootLogin no 加进 /etc/ssh/sshd_config,然后重启 sshd 生效。这样就算有人拿到了密码,想直接以 root 进入也不行,多一层保险。
至于改 SSH 端口,有人把它当成必做的安全措施,我的建议是:如果只是为了毕设演示,不强制改;改了反而容易让自己忘了端口连不上。真要防爆破,密钥登录 + 改端口二选一就够了,两项都做当然更稳,但别因为过度安全配置把自己锁在门外。
2.4 服务器上的常用更新
不管用什么系统,登录之后第一件事是更新软件包:
bash复制# CentOS / 阿里云Linux
sudo yum update -y
# Ubuntu
sudo apt update && sudo apt upgrade -y
这步不是走形式。有些云厂商的镜像源里,软件包快照可能比较旧,不更新会导致后面装软件时下载失败或版本过旧。更新完顺手装几个基础工具:curl、wget、git、vim、lsof、netstat 或 ss、telnet,排错的时候都用得上。
3. 安全组、防火墙与快照:网络不通十有八九是这里
3.1 云平台安全组和服务器内部防火墙是两套机制
这是我在部署教学里反复强调的概念。很多同学以为买了服务器,端口就能通,然后本地浏览器访问不了就到处找原因。其实云服务器上能否访问一个端口,要过两道关卡:
- 第一道是云平台安全组。它在虚拟机外面,阿里云控制台叫"安全组",腾讯云也叫"安全组"。默认通常只放行了 22、3389、ICMP(ping),以及你购买时勾选的端口。其他端口即使服务器里跑着服务,外部也访问不了。
- 第二道是服务器内部的防火墙。CentOS 上是 firewalld,Ubuntu 上是 ufw,还有早期系统用的 iptables。如果服务器内部防火墙没有放行端口,连接会被拒掉。
绝大多数"端口不通"的情况,都是这两层里有一层没放行。更常见的错误是:学生只改了云平台安全组,没关服务器内部防火墙,或者反过来。我见过有人把 firewalld 直接停掉来解决问题——能通,但不推荐这么干,因为这样等于把所有端口都开放了,存在较大安全隐患。正确做法是明确哪些端口必须对外,然后精准放行。
3.2 毕设项目常用的端口放行清单
拿一套典型的前后端分离项目来说,需要放行的端口大概是这样:
| 服务 | 端口 | 访问范围 | 说明 |
|---|---|---|---|
| SSH | 22(或自定义) | 仅允许你自己的IP,或全部 | 最好限制来源,防爆破 |
| HTTP | 80 | 全部 | Nginx/后端 HTTP 服务 |
| HTTPS | 443 | 全部 | SSL 证书接入后使用 |
| 后端 API | 8080 或 8081 | 可以不放行,通过 Nginx 反代 | 如果直接给评委演示,可临时放行 |
| MySQL | 3306 | 建议仅允许你自己的本地IP | 不要对全世界开放 |
| Redis | 6379 | 建议保持内部访问,或仅限服务器本机 | 不对公网开放 |
如果你用前后端分离方式,后端端口完全不需要对公网开放。Nginx 在服务器内部用 proxy_pass 访问后端,外部用户只访问 80/443 端口。这样安全性和方便性都兼顾了——数据库端口在云平台安全组里也不要放行 0.0.0.0/0,否则你的数据库密码很容易被扫库爆破。"为什么我的 MySQL 被别人连上了"这类问题,多半就是 3306 端口对公网全放行导致的。
3.3 排查顺序:从外到内一层层剥
当你发现服务器上某个服务启动正常,但浏览器访问不了时,不要慌,按下面顺序排查:
- 先看本地是否能 ping 通服务器(ping 公网 IP),ping 不通且你在控制台买了带宽,那可能安全组禁止了 ICMP 或服务器关机。
- 在本地用
telnet 你的公网IP 端口,如果提示无法连接,说明外到内不通,问题出在安全组或内部防火墙。 - 在服务器上执行
ss -lntp或netstat -tlnp看服务是不是真的在监听对应端口。如果服务没起来,后面全是白查。 - 在服务器上执行
curl http://127.0.0.1:端口,能通说明服务正常,不通说明服务本身有问题。 - 检查云平台安全组入方向规则是否放行了对应端口。
- 检查服务器内部防火墙:
sudo firewall-cmd --list-all(CentOS)或sudo ufw status(Ubuntu)。如果开着且没放行,添加规则。
这套链路我写进每篇部署笔记里,因为按照这个顺序做,绝大多数问题十分钟内就能定位。
3.4 快照是你的后悔药
动任何系统配置之前,我强烈建议先在云控制台给服务器做一次快照。快照相当于给整个硬盘拍了个"定妆照",出任何问题可以一键回滚。价格很便宜,而且很多新手用户免费额度内就够用。
比如你要升级 MySQL 大版本,或者要给服务器配置 Nginx 反代,这些操作一旦搞错可能导致服务起不来。先做快照再操作,就算把系统搞挂了,也能在控制台点击回滚,不用从零重装系统再重新配置一遍。
4. JDK、MySQL、Redis 等基础环境的版本陷阱
4.1 安装 JDK:别只依赖 yum 默认版本
给 Spring Boot 项目装 JDK,我推荐两种方式,取决于你项目用哪个版本。
- 如果项目是 JDK 8,直接用
sudo yum install -y java-1.8.0-openjdk-devel最省事。装完用java -version确认。 - 如果项目是 JDK 17(现在不少新项目用这个),CentOS 7 的默认源里可能没有,需要额外配置源或者直接下载官方 tar 包。
用 tar 包方式安装的步骤也不复杂:
bash复制# 下载 JDK 17 的 tar 包,注意版本号以当时官方实际发布为准
wget https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.tar.gz
# 解压到 /usr/local/
sudo tar -zxvf jdk-17_linux-x64_bin.tar.gz -C /usr/local/
# 配置环境变量
sudo vim /etc/profile.d/java.sh
内容填入:
bash复制export JAVA_HOME=/usr/local/jdk-17.0.x
export PATH=$JAVA_HOME/bin:$PATH
保存后 source /etc/profile.d/java.sh 即可。为什么要单独创建 profile.d 下的文件?因为这样不用改全局的 /etc/profile,也更方便别人一眼看出环境变量是谁配置的。
有一点特别提醒:如果服务器上同时装了多个 JDK 版本,java -version 可能指向不是你期望的那个。检查一下 which java 和 echo $JAVA_HOME,确保服务启动脚本里用的是正确路径。这种"我明明装了 JDK 17,Java 命令还是 1.8"的情况非常常见,基本都是 PATH 顺序问题。
4.2 MySQL 8.0 与 5.7 的区别,以及 utf8mb4
毕设项目数据库选型,我统一建议用户装 MySQL 8.0,原因很简单:本地新装的 MySQL 基本也是 8.0,版本一致性高,连接驱动、SQL 语法不会有意外。CentOS 7 默认源里没有 MySQL,需要先装官方仓库:
bash复制# 安装 MySQL 官方 yum 仓库
sudo yum install -y https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
# 安装 MySQL 服务端
sudo yum install -y mysql-community-server
# 启动并设置开机自启
sudo systemctl start mysqld
sudo systemctl enable mysqld
装完 MySQL 8.0 后,初始化阶段会生成一个临时密码,在日志里:
bash复制sudo grep 'temporary password' /var/log/mysqld.log
拿到临时密码登录后,强制改密码:
bash复制mysql -uroot -p
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码';
改完密码后还要注意 MySQL 8.0 默认的认证插件是 caching_sha2_password,如果你用老版本的 Navicat 或 JDBC 驱动连接,可能会报 Authentication plugin 'caching_sha2_password' cannot be loaded。解决办法有两种:一是升级客户端驱动;二是把用户改成 mysql_native_password。从实用角度,毕设项目用较新版本的客户端工具基本都能直接连 MySQL 8.0,不用特意改认证方式,但这个问题提前知道,遇上了不至于一头雾水。
数据库字符集强烈建议统一成 utf8mb4,不要用 utf8。原因很实在:utf8 在 MySQL 里最多存 3 字节的字符,遇到 emoji 表情或者生僻字会报错或乱码。建库时要明确指定:
sql复制CREATE DATABASE 数据库名 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
如果项目里已有表且字符集不是 utf8mb4,后续造数据时一旦出现 emoji 就有可能出现乱码,所以提前把坑堵上。
4.3 Redis:默认只能本机访问,千万别图省事关掉保护
很多毕设项目会把 Session、验证码或缓存放到 Redis。Redis 装起来很简单,但有一点要注意:默认配置下 Redis 只绑定 127.0.0.1,也就是说只有服务器本机能访问,你在本地连它的公网 IP 去访问会失败。这是一个安全设计,不该轻易改。
如果你确实需要从另一台机器访问 Redis,正确做法是:
- 在云平台安全组里把 6379 端口限制为你的本地 IP,不要用
0.0.0.0/0。 - 在 Redis 配置文件中设置
bind 0.0.0.0,并设置一个复杂度足够的requirepass。 - 防火墙里也放行 6379,来源限定你的 IP。
不过毕设项目的常规做法并不是让本地方便连 Redis,而是让服务器上的应用连本机 Redis,所以保持默认绑定 127.0.0.1 就行,不需要对公网开放。如果你图方便,把 bind 127.0.0.1 改成 bind 0.0.0.0 且不设密码,那等于把你的缓存数据甚至可能包括验证码、Session 放到公网上裸奔,被扫描到基本几分钟就会被入侵。
4.4 用阿里云镜像站给 yum 和 Maven 加速
服务器在国内,访问国外软件源很慢,装一个依赖等半天。解决办法是换成阿里云镜像站。这个操作几乎是部署必做项:
- 阿里云 Linux 系统如果本身就是阿里云镜像,速度通常已经比较快;CentOS 7 需要把
/etc/yum.repos.d/CentOS-Base.repo里的 baseurl 换成阿里云镜像地址。 - Maven 项目把本地
~/.m2/settings.xml里的 mirror 改成阿里云 Maven 仓库。
settings.xml 里的核心片段:
xml复制<mirror>
<id>aliyun</id>
<name>aliyun maven mirror</name>
<url>https://maven.aliyun.com/repository/public</url>
<mirrorOf>central</mirrorOf>
</mirror>
很多同学在服务器上执行 mvn clean package 时卡在下载依赖,一卡就是几十分钟,换完镜像源基本一两分钟解决。
5. 代码上传与前后端构建:从开发机到服务器的最后一公里
5.1 上传代码的几种方式:Git 优先,SCP 兜底
把代码弄到服务器上,我首推使用 Git 仓库。你在本地 git push,在服务器上 git clone 或 git pull,这一个流程还能顺带解决版本管理问题。如果项目没有推仓库,退而求其次用 scp 把打包好的文件传上去:
bash复制# 把本地后端 jar 包传到服务器
scp target/demo.jar deploy@你的公网IP:/home/deploy/app/
# 把前端构建产物传上去
scp -r dist/ deploy@你的公网IP:/home/deploy/nginx/html/
如果文件很多,可以用 tar 先打包再传,效率更高。Windows 用户不想敲命令,用 WinSCP 或 FinalShell 拖拽上传也完全可以,本质一样。
5.2 后端打包:mvn clean package 的启动坑
对 Spring Boot 项目,在服务器上执行打包前建议先明确工作目录。我一般会在服务器上创建 /home/deploy/app 目录,把整个项目放进去。然后在项目根目录执行:
bash复制mvn clean package -DskipTests
-DskipTests 跳过测试,是为了避免单元测试运行时间太长或某些测试依赖本地环境失败。打包完成后,产物在 target/ 目录下,通常是一个可执行 jar。直接跑:
bash复制java -jar demo.jar --spring.profiles.active=prod &
用 & 放到后台。但这里要特别提醒:& 这种后台方式会在 SSH 断开时很容易被杀掉。所以这里不是最终落地方案,后面专门讲进程守护。
如果你是传统的 war 包项目,要放到 Tomcat 的 webapps 目录下,那还要额外处理 Tomcat 的安装和配置。现在大多数毕设都用 Spring Boot 内嵌 Tomcat,一把 jar 直接跑,这个环节少了很多事。
5.3 前端构建:node-sass 是重灾区
前端项目如果是 Vue,通常跑 npm install 再 npm run build。在服务器上执行这两步时,最常见的坑有两个:
npm install下载慢。解决办法是把 npm 源切到淘宝镜像:npm config set registry https://registry.npmmirror.com。设置完npm install速度会快非常多。node-sass安装失败。node-sass 依赖本机编译工具链,版本不匹配经常报错。我的建议:如果项目还没锁定依赖,尽量把 node-sass 换成sass或dart-sass;如果必须用 node-sass,确保 Node 版本和 node-sass 版本匹配。实在不行,在package.json里固定版本号,配合国内镜像源重新装。
前端构建产物通常是 dist/ 目录,里面全是静态文件。这些文件不需要后端 Java 来处理,直接交给 Nginx 托管,这样性能和安全性都更优。
5.4 日志是你最好的排查工具
不管后端还是前端,部署完之后不要只看"启动了吗",一定要看日志。Spring Boot 默认把日志打到控制台,你启动时如果用了 nohup,它会写到 nohup.out:
bash复制tail -f /home/deploy/app/nohup.out
如果服务没起来,日志里一定会有原因,最常见的几种:
Port 8080 was already in use:端口被占用,用lsof -i:8080找到进程杀掉。Unable to connect to MySQL:数据库连不上,去查数据库地址、账号、密码。ClassNotFoundException:依赖缺失,通常是打包不全或本地依赖没带进 jar。UnknownHostException:代码里配置的地址有问题,比如 Redis 地址写错。
我见过很多同学一看服务没起来,就反复重启、反复杀掉重跑,就是不看一眼日志。其实日志是程序给你的最好提示,稍微花点时间读一下,很多问题自己就能定位。
6. Nginx 反向代理与进程守护:让服务真正稳定对外开放
6.1 Nginx 安装与基本配置
Nginx 是反向代理服务,是多数前后端分离项目对外提供访问的入口。安装很简单:
bash复制sudo yum install -y nginx
配置文件在 /etc/nginx/nginx.conf,默认会 include /etc/nginx/conf.d/*.conf。我习惯给每个项目单独建一个配置文件:
bash复制sudo vim /etc/nginx/conf.d/student-project.conf
一个典型的前后端分离配置长这样:
nginx复制server {
listen 80;
server_name 你的公网IP或域名;
# 前端静态文件
location / {
root /home/deploy/nginx/html;
index index.html;
try_files $uri $uri/ /index.html;
}
# 后端 API 反向代理
location /api/ {
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;
}
}
保存后先测试语法:
bash复制sudo nginx -t
输出 syntax is ok 之后再重载:
bash复制sudo nginx -s reload
这里有个高频坑:很多前端项目里请求地址是 /api/xxx,后端 Spring Boot 的接口地址可能是 /api/xxx,也可能没有 /api 前缀。如果后端接口路径没带 /api,而前端请求带了 /api,你就要在 Nginx 里把路径去掉再转发。具体做法是 proxy_pass http://127.0.0.1:8080;(注意末尾不加斜杠),然后把 /api 原样传给后端;如果后端接口没有 /api 前缀,就用 proxy_pass http://127.0.0.1:8080/;(末尾加斜杠),这样 /api 会被去掉。这个细微差别我一开始也经常搞混,每次都是检查日志才发现。
6.2 用 systemd 把后端服务变成常驻进程
刚才说 java -jar demo.jar & 这种后台方式不够稳。SSH 连接断开时进程可能被挂掉,或者服务器重启后服务不会自动拉起。规范的落地方案是使用 systemd 来管理。
创建服务文件:
bash复制sudo vim /etc/systemd/system/demo.service
内容如下:
ini复制[Unit]
Description=Demo Spring Boot Application
After=network.target
[Service]
User=deploy
WorkingDirectory=/home/deploy/app
ExecStart=/usr/bin/java -jar /home/deploy/app/demo.jar --spring.profiles.active=prod
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
然后执行:
bash复制sudo systemctl daemon-reload
sudo systemctl start demo
sudo systemctl enable demo
之后可以用 sudo systemctl status demo 查看状态,sudo systemctl restart demo 重启服务,sudo systemctl stop demo 停止服务。注意 ExecStart 里要用绝对路径,User 指定运行用户,Restart=always 表示服务崩了会自动拉起。这些细节初看琐碎,但实际运行中特别省心——万一 Java 进程因为内存不足或代码 bug 崩溃,它能自己恢复,不用你半夜爬起来重启。
一个容易被忽略的点:WorkingDirectory 要指向项目目录,因为有些代码会从相对路径读取文件或写日志。如果工作目录不对,即使服务起来了,上传文件、输出日志也可能落到意想不到的位置。
6.3 nohup 与 systemd 怎么选
如果只是临时演示一两天,用 nohup 也没问题:
bash复制nohup java -jar demo.jar --spring.profiles.active=prod > app.log 2>&1 &
但如果是需要稳定运行到答辩、甚至给老师演示好几次的项目,我建议直接用 systemd。它的优势不仅是自动重启,还能统一管理启动顺序、记录标准输出、隔离运行环境。多花五分钟写个 service 文件,后面能省掉很多麻烦。
6.4 域名与 HTTPS 证书的基本姿势
答辩演示时可以拿公网 IP 直接访问,但如果有域名的话体验会好很多,也显得专业。购买域名后在云控制台添加解析,把域名 A 记录指向服务器公网 IP。然后需要等解析生效,通常在几分钟内。
HTTPS 证书现在阿里云、腾讯云都可以免费申请,类型是 DV(域名验证型)证书,申请流程一般是:在控制台选择证书服务,提交域名,然后按提示做 DNS 验证或文件验证。验证通过后下载证书文件,在 Nginx 配置里加上:
nginx复制listen 443 ssl;
ssl_certificate /etc/nginx/cert/你的域名.pem;
ssl_certificate_key /etc/nginx/cert/你的域名.key;
同时把 80 端口的请求重定向到 443:
nginx复制server {
listen 80;
server_name 你的域名;
return 301 https://$host$request_uri;
}
这里要提醒:免费证书有效期通常是三个月或一年,到期前记得续期。阿里云控制台有证书到期提醒,至少提前一周续期并替换证书文件。每年都会有人在答辩前发现 HTTPS 打不开,一查证书过期了,画面相当尴尬。
7. 远程数据库连接与自动化备份:别让数据成为唯一的遗憾
7.1 本地连服务器数据库被拒,最常见的两个原因
毕设项目开发过程中经常需要直接从本地数据库工具连接云服务器上的 MySQL,我猜你大概率遇到过连不上的问题。我的排查经验是重点看两个原因:
- 账号权限不对。MySQL 里用户是带 host 的,比如
root@localhost只能在服务器本机登录。你想从本地连,需要创建允许远程登录的用户:
sql复制CREATE USER 'deploy'@'%' IDENTIFIED BY '你的强密码';
GRANT ALL PRIVILEGES ON 数据库名.* TO 'deploy'@'%';
FLUSH PRIVILEGES;
'%' 表示任意主机都可以用这个账号登录。但注意,这是个相对宽泛的授权,配合安全组限定来源 IP 才够安全。
- 3306 端口没放行。云平台安全组和服务器防火墙都要放行,而且来源最好只写你本地网络出口的公网 IP,不要用
0.0.0.0/0。
如果这两步都做了还连不上,再检查 MySQL 是否监听在 0.0.0.0:3306。在服务器上执行 netstat -tlnp | grep 3306,如果看到 127.0.0.1:3306 而不是 0.0.0.0:3306,说明 MySQL 只绑定了本机,需要修改 /etc/my.cnf 里的 bind-address=0.0.0.0 并重启。
7.2 备份策略:mysqldump + crontab
答辩前一天系统崩溃、数据库数据全没了,这种事听起来很夸张,但我真的见过。部署完第一件事,请把自动备份配好,不然数据安全全凭运气。
最简单的备份方案是 mysqldump 加定时任务。先写一个备份脚本:
bash复制#!/bin/bash
BACKUP_DIR="/home/deploy/backup/mysql"
DATE=$(date +%Y%m%d%H%M)
DB_NAME="student_db"
DB_USER="backup_user"
DB_PASS="你的密码"
mkdir -p $BACKUP_DIR
mysqldump -u$DB_USER -p$DB_PASS --databases $DB_NAME | gzip > $BACKUP_DIR/${DB_NAME}_${DATE}.sql.gz
# 保留最近 7 天的备份,自动清理更早的
find $BACKUP_DIR -name "*.sql.gz" -type f -mtime +7 -exec rm {} \;
然后添加定时任务:
bash复制crontab -e
# 每天凌晨 2 点执行备份脚本
0 2 * * * /bin/bash /home/deploy/backup/mysql_backup.sh
注意脚本里不要明文写密码,这是为了安全。实际使用中建议用 MySQL 的 .my.cnf 配置或者环境变量来传密码。作为毕设项目,先保证备份文件能生成、能恢复,比追求多完美的方案更重要。备份完最好自己试一次恢复,别等真出事才发现备份文件是坏的。
7.3 备份文件要不要传到云存储
如果项目数据量不大,备份文件留在服务器本地也是可以的。但服务器一旦被入侵、磁盘损坏,本地备份也跟着没。有条件的话,把备份文件同步到阿里云 OSS 或腾讯云 COS 是最稳的。具体实现不复杂:装官方命令行工具(ossutil / coscmd),在备份脚本里加一行上传命令,按日期路径归档。
对于毕设项目,我的建议是先把本地备份跑起来,如果时间充裕再配云存储同步。答辩前手动打一个压缩包下载到本地保存,也是简单有效的方式。
8. 端口不通、内存被杀、证书过期:几个高频排错实战
8.1 端口不通的完整排查链路
前面在第 3.3 节给过一个排查顺序,这里用一个具体场景再走一遍。假设你部署了一个 Spring Boot 项目,端口 8080,本地浏览器访问 http://公网IP:8080 却打不开。
第一步,在服务器上执行 ss -lntp | grep 8080,看服务是否在监听。没输出说明服务没起来,去查日志。有输出说明服务正常,继续往下。
第二步,在服务器上执行 curl http://127.0.0.1:8080,能返回页面说明服务真的正常,接下来怀疑网络层。
第三步,用本地 telnet 测试:telnet 公网IP 8080。如果连接失败或超时,大概率是安全组或防火墙拦截。
第四步,检查云平台安全组入方向规则,确认 8080 已放行。没放行就添加入方向规则:协议 TCP,端口 8080,来源 0.0.0.0/0 或你本地 IP。
第五步,检查服务器内部防火墙。CentOS 7 执行:
bash复制sudo firewall-cmd --list-all
如果看到 8080 不在 list 里,添加:
bash复制sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload
Ubuntu 的话:
bash复制sudo ufw status
sudo ufw allow 8080/tcp
走完这五步基本能定位所有端口不通的问题。
8.2 服务器内存不足,Java 进程被系统杀掉
1核2G 的小机器跑 Spring Boot + MySQL + Redis 经常会内存吃紧,表现形式是 Java 进程运行一段时间后消失,或者直接报 Killed。其实这是 Linux 的 OOM Killer 在起作用,当系统内存不够时,内核会选一个进程把它杀了来释放内存。
排查方法:
bash复制free -h
看 total / used / available。如果没有 swap 且内存长期接近用完,Java 进程就是风险最高的那个。
解决办法有几个:
- 给 JVM 设置最大堆内存,不要让 JVM 默认占用过多内存。启动命令加参数:
bash复制java -Xms256m -Xmx512m -jar demo.jar
- 给服务器加 swap(交换分区),用少量磁盘换内存容量:
bash复制sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
- 如果项目确实需要大量内存,最实际的办法是升级服务器规格。2G 升 4G,阿里云和腾讯云通常都可以直接控制台升配,数据不丢。
谈到这点我印象很深:有次帮一个学生部署一个基于深度学习的毕设项目,他把模型加载到内存里,2G 机器直接扛不住,后来换了 4G 加了 2G swap 才能稳定跑起来。买机器的时候一定要评估运行负载,别只看价格。
8.3 部署完成后的验收清单
我每次帮人完成部署都会按一套清单做最终检查,建议你也养成这个习惯:
- 服务访问正常:公网 IP 或域名能打开页面,刷新无异常。
- 后端接口正常:前端页面里涉及的数据能加载出来,说明前后端联通。
- 数据库备份已配置:
crontab -l能看到备份任务,且手动执行过备份脚本能生成文件。 - 服务自动重启:重启服务器后,用 systemd 管理的服务能自动拉起,页面无需人工干预。
- 安全风险项已检查:SSH 非默认端口或密钥登录已配置,数据库端口没有对全网开放,证书没有过期。
- 控制台绑定费用:确认云服务器后续续费提醒,避免中途停机导致演示时连不上。
这一套检查下来,基本可以放心去准备答辩了。
最后再分享一个实践细节
部署这件事,做得多了你会发现大部分问题都是环境、权限、网络这三类原因,很少真的是代码 bug。所以每次遇到问题,先按"环境差异 -> 端口网络 -> 日志提示"的顺序查一遍,大多数坑都能快速绕过去。
另外,学生优惠服务器到期后,记得提前把数据库做一次完整备份并下载到本地。云服务商的数据在欠费或到期后不会立即删除,但一旦回收就真的找不回来了。毕业答辩结束之后,把项目数据带回本地存档,也算给自己的毕设画上一个完整句号。希望这篇指南能帮你少熬几个夜,把精力花在真正重要的功能打磨上,而不是在部署环境里反复碰壁。
