Sz-Admin | 基于SpringBoot3与Vue3的RBAC管理系统Docker化部署实战

1. 环境准备与脚本解读

大家好，我是老张，一个在后台系统开发领域摸爬滚打了十来年的老码农。今天咱们不聊高深的理论，就来手把手、一步一步地，把一个基于 SpringBoot3、JDK21 和 Vue3 的 RBAC 权限管理系统——Sz-Admin，用 Docker 给部署起来。这套系统功能挺全，前后端分离，权限管理也做得清晰，很适合拿来作为企业内部的管理后台模板。但很多朋友拿到开源项目后，最头疼的就是部署，尤其是涉及到 Docker、Nginx、前后端联调这些环节，容易踩坑。所以，我结合官方提供的部署脚本，把整个过程掰开揉碎了讲，保证你跟着做就能跑起来。

首先，咱们得把“战场”准备好。官方的部署仓库叫 sz-deploy，里面提供了一整套 Shell 脚本，可以说是非常贴心了。你第一步要做的，就是把代码拉下来。这里我建议直接用 Gitee 的地址，速度会快很多。打开你的 Linux 服务器（我用的 CentOS 7.9，其他发行版思路类似），找个顺眼的目录，比如 /home，执行克隆命令。

cd /home
git clone https://gitee.com/feiyuchuixue/sz-deploy.git

克隆完成后，你会看到一个 sz-deploy 目录，进去后重点看 shell 文件夹。这里面就是今天我们要用的所有“兵器”。先别急着运行，咱们得先让这些脚本有执行的权限。这就像给你买的工具开刃，不开刃没法用。执行下面这两条命令：

cd sz-deploy/shell
chmod +x *.sh

这里有个小细节，官方文档里还建议把脚本移动到 /home/deploy 目录下。这个看个人习惯，目的是为了集中管理。你可以 mkdir -p /home/deploy 然后 mv *.sh /home/deploy。我个人习惯是直接在原目录操作，只要记住当前路径就行。接下来，就是重头戏——环境初始化脚本 env-init.sh。这个脚本干了三件大事：第一，安装 Git 和 Docker；第二，提供了一个可选的 Docker 代理配置，这对国内某些网络环境特别有用；第三，设置 Docker 开机自启。运行它很简单：

bash env-init.sh

在运行之前，我强烈建议你用 cat 或者 vim 命令先看一眼这个脚本的内容，特别是开头部分。你会发现两个关键变量：USE_DOCKER_PROXY 和 DOCKER_PROXY。如果你的服务器拉取 Docker 镜像特别慢，可以考虑把 USE_DOCKER_PROXY 改成 "true"，并把后面的代理地址换成你自己可用的。这个功能很实用，我当初在公司内网部署时就靠它解决了镜像下载的难题。脚本执行过程中，它会自动安装 Docker 和 Docker Compose，并配置镜像加速器（默认用了阿里云和腾讯云的源），整个过程基本是全自动的，你只需要看着屏幕刷刷刷的日志就行。

2. 关键配置：读懂并修改 common.env

环境初始化好了，就像房子毛坯房装修完了，但还没通水电。common.env 这个文件，就是整个部署的“水电图纸”，所有核心路径、账号信息都在这定义。在运行任何具体部署脚本前，必须根据你的实际情况修改它。用编辑器打开它：

vim ../common.env
# 或者
cat ../common.env

文件内容看起来不少，但别慌，咱们挑关键的改。最上面几行是关于目录的，默认的 ENV_ROOT_DIR="/home" 意思就是所有东西都会放在 /home 目录下。如果你想把应用放到 /data 或者别的盘，就在这里改。我建议新手先别动，就用默认的，避免路径混乱。

接下来是 重中之重，也是最容易出错的地方：Git 配置。