GitHub
Dashboard
← 返回博客

把 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 的时候不会有人提醒你。

小结

部署这件事,做完一次之后再看文档就顺手了。下一个目标是把日志和监控也接上,至少要知道服务是什么时候挂的。