把 Spring Boot 部署到香港服务器:Docker + Nginx + Certbot 全记录
GrandBlue 的后端写完很久了,一直跑在本地。这次终于狠下心把它部署到了那台 2C2G 的香港服务器上。记录一下整个过程,以及踩到的坑。
整体结构
最终的结构很简单:
用户请求
│
▼
Nginx (443, HTTPS)
│ proxy_pass
▼
Docker 容器里的 Spring Boot (8080)
│
▼
MySQL (宿主机 / 容器网络内)
Nginx 负责 TLS 和静态资源,Spring Boot 只安心处理 API。
步骤一:容器化
Dockerfile 用的是多阶段构建,先编译再拷贝 jar,镜像能小很多:
FROM maven:3.9-eclipse-temurin-17 AS build
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn package -DskipTests
FROM eclipse-temurin:17-jre
WORKDIR /app
COPY --from=build /app/target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]
启动的时候记得把端口映射到 127.0.0.1,不要让 8080 暴露到公网:
docker run -d --name grandblue \
-p 127.0.0.1:8080:8080 \
--env-file .env \
grandblue-api
步骤二:Nginx 反向代理
server {
listen 80;
server_name api.mav1.top;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
proxy_set_header 这几行别省,不然日志里全是 127.0.0.1,排查问题会很痛苦。
步骤三:签发证书
certbot --nginx -d api.mav1.top
Certbot 会自动改写配置加上 443 的监听,证书到期前也会自动续期,基本不用管。
踩过的坑
| 坑 | 表现 | 解决 |
|---|---|---|
| 内存不够 | 容器启动到一半被 OOM 杀掉 | 加 -Xmx512m,关掉没用的服务 |
| 时区不对 | 订单时间差 8 小时 | 容器里设置 TZ=Asia/Shanghai |
| 数据库连不上 | Communications link failure |
检查容器网络和 bind-address |
| 证书没生效 | 浏览器仍提示不安全 | 清缓存,确认 443 块已生成 |
最想说的是内存那一条。2G 内存的机器上,JVM 默认的堆大小会乐观得多,一定要手动限制,不然半夜被邻居 OOM 的时候不会有人提醒你。
小结
部署这件事,做完一次之后再看文档就顺手了。下一个目标是把日志和监控也接上,至少要知道服务是什么时候挂的。