WSL Ubuntu 开发环境

仓库应放在 WSL 的 Linux 文件系统中，例如 /home/ubuntu/projects/xiedao，不要放在 /mnt/c 下进行 Maven 或前端构建。

工具版本

Java 21（仓库根目录 .java-version）
Maven 3.9 或更高版本
Node.js 22.22.1（仓库根目录 .nvmrc）
npm 10

服务器依赖

MySQL、Redis 和 OpenIM 均运行在服务器上，本地通过 SSH 隧道访问，不开放服务公网端口。

先在一个终端保持隧道运行：

bash

./Api/dev-tunnels.sh

默认使用 ~/.ssh/XieDao.pem。如需覆盖：

bash

XIEDAO_SSH_KEY=/path/to/key ./Api/dev-tunnels.sh

隧道占用本地端口 3306、6379 和 10002。若端口已被本地服务占用，应先停止本地服务。

后端

bash

cd Api
mvn clean package

export DB_PASSWORD='开发库密码'
export RUOYI_PROFILE="$HOME/.local/share/xiedao/uploadPath"
SPRING_PROFILES_ACTIVE=druid,dev \
  java -Dfile.encoding=UTF-8 -jar ruoyi-admin/target/ruoyi-admin.jar

本地 API 和 Swagger UI：

http://127.0.0.1:8082/
http://127.0.0.1:8082/swagger-ui.html

数据库、Redis 或 OpenIM 使用非默认地址时，可覆盖 DB_HOST、DB_PORT、DB_NAME、DB_USERNAME、REDIS_HOST、REDIS_PORT 和 OPENIM_SERVER_API_ADDRESS。

Web 管理端

bash

cd AdminWeb
npm ci
npm run dev

bash

cd MerchantWeb
npm ci
npm run dev

默认开发端口分别为 8081 和 8083。如需联调本地后端，在对应项目创建 .env.development.local：

dotenv

VITE_DEV_PROXY_TARGET=http://127.0.0.1:8082

该本地配置文件已被 Git 忽略。

部署

开发环境已迁移到独立 Docker Compose 服务器。发布入口如下：

bash

./deploy-dev.sh
./deploy-prod.sh prepare blue <开发版本号>
./deploy-prod.sh release blue <开发版本号>

正式槽位根据当前 Nginx upstream 选择。完整流程、密钥配置、单组件更新、版本晋级守卫及回滚说明见开发与正式发布。旧 repair-flyway 参数已移除，迁移校验失败时先查明原因。

本文前面的本地隧道部分沿用旧服务器配置；迁移后的容器数据库和 IM 端口见 Deploy/docker-dev/README.md，不要把旧开发库视为新 Compose 开发环境的数据源。

WSL Ubuntu 开发环境 ​

工具版本 ​

服务器依赖 ​

后端 ​

Web 管理端 ​

部署 ​

WSL Ubuntu 开发环境

工具版本

服务器依赖

后端

Web 管理端

部署