使用阿里云轻量服务器 + Docker 部署 Spring Boot 项目实战指南

🎯 目标：使用阿里云轻量服务器部署一个完整的 Spring Boot 全栈项目（如 hmdp），包括 MySQL、Redis、Nginx 和 Spring Boot 应用。

💡 适合人群：有基础 Linux 操作能力、了解 Docker 的开发者，适用于课程设计、毕业设计或个人项目上线。

一、前置准备

1. 准备一台 Ubuntu 系统服务器

推荐使用 阿里云轻量应用服务器，大学生可以免费申请使用，配置为 2核1G，完全满足学习和小项目部署需求。

• 登录方式：使用 SSH 工具（如 XShell 或 Terminal）连接服务器
• 推荐使用 root 用户操作，或者在命令前加 sudo

2. 安装 Docker

# 更新系统软件包索引
apt update && apt upgrade -y

# 安装依赖包
apt install -y apt-transport-https ca-certificates curl software-properties-common

# 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg –dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 设置稳定仓库源
echo "deb [arch=$(dpkg –print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

# 再次更新并安装 Docker CE
apt update
apt install -y docker-ce

# 启动 Docker 并设置开机自启
systemctl enable docker && systemctl start docker

# 验证安装
docker –version

二、部署mysql

# 1.创建本地数据存储目录
mkdir -p ~/mysql/data ~/mysql/logs

# 2.拉取镜像（建议使用长期支持版本）
docker pull mysql:5.6

# 3.启动容器
docker run -d \\
–name mysql_1 \\
-p 3306:3306 \\
-v ~/mysql/data:/var/lib/mysql \\
-v ~/mysql/logs:/logs \\
-e MYSQL_ROOT_PASSWORD=123456 \\
mysql:5.6

✅ 可选操作：

• 使用客户端工具远程连接测试（如 Navicat、DBeaver）

• 修改密码、创建数据库等可通过 docker exec 进入容器操作

启动好可以用本地连接测试一下

三、部署redis

# 1.创建 Redis 数据与配置目录
mkdir -p ~/redis/data ~/redis/conf

# 2.下载官方配置文件并设置密码
cd ~/redis/conf
curl -O https://raw.githubusercontent.com/redis/redis/unstable/redis.conf

# 3.编辑配置文件，添加密码认证
vim redis.conf
# 找到 requirepass 行，取消注释并设置密码，例如：
# requirepass your_password_here

# 4.拉取镜像
docker pull redis:latest

# 5.启动容器
docker run -d \\
–name redis_custom \\
–restart always \\
-p 6379:6379 \\
-v ~/redis/data:/data \\
-v ~/redis/conf/redis.conf:/usr/local/etc/redis/redis.conf \\
redis:latest redis-server /usr/local/etc/redis/redis.conf

✅ 可选操作：

• 使用 redis-cli 测试连接和认证
• 设置持久化策略、限制最大内存等可在 redis.conf 中调整

启动好可以用本地连接测试一下

四、部署nginx

这个稍微麻烦一点，也就是多了一步上传压缩包到云端，解压这一步，因为你要挂自己的html和conf。

1.上传并解压 Nginx 资源包

将本地打包好的前端资源（含 HTML、CSS、JS、配置文件等）上传至服务器，例如 /root/dockerFiles/nginx-1.18.0_hmdp2.zip。

假设你已经有了 nginx-1.18.0_hmdp2.zip 并且位于 /root/dockerFiles/ 目录下： 

unzip nginx-1.18.0_hmdp2.zip -d nginx_hmdp

2.准备宿主机目录并复制文件

mkdir -p ~/nginx_conf
mkdir -p ~/nginx_html

 把自己项目的conf和html复制到容器准备挂载的目录（我这里的root下面两个文件夹了，你可以放在一个里面例如：nginx/nginx_conf、nginx/nginx_html）

cp ~/dockerFiles/nginx_hmdp/nginx-1.18.0_hmdp2/conf/nginx.conf ~/nginx_conf/nginx.conf
cp -r ~/dockerFiles/nginx_hmdp/nginx-1.18.0_hmdp2/html/* ~/nginx_html/

3. 拉取镜像并启动容器

docker pull nginx:alpine
docker run -d \\
–name nginx_hmdp1 \\
-p 80:80 \\
-v ~/nginx_html:/usr/share/nginx/html \\
-v ~/nginx_conf/nginx.conf:/etc/nginx/nginx.conf
nginx:alpine

4. 常见问题排查

如果遇到问题，请按照以下步骤进行排查：

(1) 检查挂载是否正确

确认挂载的路径是否正确，并且宿主机上的文件确实存在于指定路径：

ls -l ~/nginx_conf/nginx.conf
ls -l ~/nginx_html/

(2) 检查 Nginx 日志

进入容器查看 Nginx 错误日志：

docker exec -it nginx_hmdp1 /bin/sh
cat /var/log/nginx/error.log

(3) 检查 Nginx 配置语法

在容器内测试 Nginx 配置文件语法：

docker exec -it nginx_hmdp1 /bin/sh
nginx -t
docker run –rm -it \\
-v ~/nginx_conf/nginx.conf:/etc/nginx/conf.d/nginx.conf \\
nginx:alpine nginx -t

如果配置文件有错误，Nginx 会提示具体的错误信息。

五、部署 Spring Boot 项目（以 hmdp 为例）

实际开发中，我们常常需要将 Spring Boot 应用打包并部署到生产环境中。使用 Docker 可以实现应用的快速构建、分发与部署。本文将以名为 hmdp 的 Spring Boot 项目为例，介绍如何通过 Dockerfile 构建镜像，并运行容器化服务。

1.准备阶段：上传 JAR 包

在项目目录下创建一个 dockerfile，用于定义镜像的构建过程。这里我们选择基于 openjdk:8-jdk-alpine 镜像，它是一个轻量级的 JDK 环境

（1）打包 Spring Boot 应用

在本地开发环境中，使用 IntelliJ IDEA 或 Maven 命令对项目进行清理和打包：

用idea的maven先clean一下再package一下。

（2）上传 JAR 到服务器

使用工具如 XFTP 或 SCP 将生成的 JAR 包上传至服务器的目标目录，例如 /root/dockerFiles/。

确保 Dockerfile 和 JAR 包处于同一目录下，便于后续构建。

2.编写 Dockerfile 并构建镜像

（1）创建 Dockerfile 文件

在项目目录下创建一个 Dockerfile，用于定义镜像的构建过程。这里我们选择基于 openjdk:8-jdk-alpine 镜像，它是一个轻量级的 JDK 环境。

vim /root/dockerFiles/springboot_dockerfile
# 使用 openjdk:8-jdk-alpine 镜像（轻量化版本）
FROM openjdk:8-jdk-alpine

# 维护者信息（建议改用 LABEL 指令）
LABEL maintainer="lfq <lfq@lfq.cn>"
# 添加 Spring Boot 应用的 JAR 文件
ADD hm-dianping-0.0.1-SNAPSHOT.jar app.jar
# 启动命令
ENTRYPOINT ["java", "-jar", "/app.jar"]

（2）构建 Docker 镜像

执行如下命令构建镜像：

docker build -f ./springboot_dockerfile -t hmdp .

3.运行容器并挂载配置文件

为了便于维护和更新配置，推荐将 Spring Boot 应用的配置文件（如 application.yaml）从容器外部挂载进去。

（1）准备宿主机配置文件

在服务器上创建配置文件目录并放置你的 application.yaml，你可以自己写也可以上传都行。

mkdir -p /root/myapp/config
cp application.yaml /root/myapp/config/

（2）运行容器并挂载配置

执行以下命令启动容器：

docker run -d \\
–name hmdp_new \\
-v /root/myapp/config/application.yaml:/app/config/application.yaml \\
-p 8088:8088 \\
hmdp

参数说明：

• -d：后台运行容器

• –name：指定容器名称

• -v：将宿主机的配置文件挂载到容器内部路径

• -p：映射容器端口到宿主机（本例为 8088）

六、总结

本文详细讲解了如何在阿里云轻量服务器上使用 Docker 部署一个完整的 Spring Boot 项目（hmdp），包括：

• Docker 安装配置
• MySQL、Redis、Nginx、Spring Boot 应用的部署
• 常用参数说明与问题排查技巧
• 安全性与灵活性优化建议

📌 扩展阅读：

• Docker 官方文档
• Spring Boot with Docker
• Docker Compose 实战教程