nvm list

安装最新的长期支持版 (LTS):

nvm install lts

安装指定版本 (例如 18.20.2):

nvm install 18.20.2

切换到已安装的版本:

nvm use 18.20.2

删除不需要的版本

nvm uninstall 16.20.2

设置默认版本

nvm alias default 18.20.2

如果安装失败，就刷新nvm缓存再进行安装

nvm list available

wsl --install

安装完成后重启电脑，设置虚拟机账号密码

账号：xxxx
密码：xxxx

更新系统并配置国内镜像源

# 替换 Ubuntu 官方源为阿里云源
sudo sed -i 's/http:\/\/archive.ubuntu.com/https:\/\/mirrors.aliyun.com/g' /etc/apt/sources.list
sudo sed -i 's/http:\/\/security.ubuntu.com/https:\/\/mirrors.aliyun.com/g' /etc/apt/sources.list

# 更新系统软件列表
sudo apt update && sudo apt upgrade -y

第二步：安装基础开发工具与 Python 环境

# 安装 pip、python3-venv 等基础工具
sudo apt install -y python3-pip python3-venv build-essential git

第三步：创建并激活 Python 虚拟环境

# 在用户目录下创建一个名为 vllm-env 的虚拟环境
python3 -m venv ~/vllm-env

# 激活虚拟环境（激活后，命令行前面会出现 (vllm-env) 提示）
source ~/vllm-env/bin/activate

# 升级 pip 到最新版本
pip install --upgrade pip

第四步：配置 pip 国内镜像并安装 vLLM

# 配置 pip 使用阿里云镜像
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

# 安装 vLLM（推荐使用 uv 安装，速度更快，如果没有 uv 也可以直接用 pip install vllm）
pip install uv
uv pip install vllm

第五步：下载大模型文件

# 安装魔搭社区命令行工具
pip install modelscope

# 创建存放模型的目录（建议放在 /mnt/d/ 等 Windows 盘符下，方便管理且不易撑爆 C 盘）
mkdir -p /mnt/d/LLM_Models

# 下载 Qwen2.5-7B-Instruct 模型到 D 盘
modelscope download --model qwen/Qwen2.5-7B-Instruct --local_dir /mnt/d/LLM_Models/Qwen2.5-7B

modelscope download --model Qwen/Qwen3.6-35B-A3B-FP8 --local_dir /ai-models/qwen3-35b-fp8

第六步：启动 vLLM 推理服务

python -m vllm.entrypoints.openai.api_server \
    --model /mnt/d/LLM_Models/Qwen2.5-7B \
    --served-model-name qwen2.5-7b \
    --host 0.0.0.0 \
    --port 8000 \
    --gpu-memory-utilization 0.85 \
    --dtype float16 \
    --max-model-len 8192

第七步：验证服务是否成功

curl http://localhost:8000/v1/chat/completions \
    -H "Content-Type: application/json" \
    -d '{
        "model": "qwen2.5-7b",
        "messages": [
            {"role": "user", "content": "你好，请简单介绍一下你自己"}
        ]
    }'

当终端打印出 Uvicorn running on http://0.0.0.0:8000 时，说明服务已经启动

若依前后端分离版改造为单体部署指南

前言

本项目基于若依前后端分离版开发，现需将其改造为不分离版本，即将前端打包产物整合进后端 JAR 包中统一运行。以下是详细的改造步骤。

一、 修改前端项目配置

1. 修改生产环境配置

编辑 ruoyi-ui/.env.production 文件，配置 API 基础路径（二选一）：

# 方式一：本机地址访问（推荐）
VUE_APP_BASE_API = '/'

# 方式二：指定任意地址访问
# VUE_APP_BASE_API = 'http://xxx.xxx.xxx.xxx:8080'

2. 修改路由模式

编辑 ruoyi-ui/src/router/index.js，将路由模式设置为 hash：

export default new Router({
  mode: 'hash', // 必须改为 hash 模式
  scrollBehavior: () => ({ y: 0 }),
  routes: constantRoutes
})

3. 修改注销跳转逻辑

编辑 ruoyi-ui/src/layout/components/Navbar.vue 中的 logout 方法，防止重定向错误：

async logout() {
  this.$confirm('确定注销并退出系统吗？', '提示', {
    confirmButtonText: '确定',
    cancelButtonText: '取消',
    type: 'warning'
  }).then(() => {
    this.$store.dispatch('LogOut').then(() => {
      // 注意：跳转 index 前加 /#/ 防止定向错误
      location.href = '/#/index';
    })
  }).catch(() => {});
}

4. 执行前端打包

在前端项目根目录运行以下命令生成 dist 文件：

npm run build:prod

二、 修改后端项目配置

1. 添加 Thymeleaf 模板引擎配置

编辑 ruoyi-admin/src/main/resources/application.yml：

spring:
  # 模板引擎配置
  thymeleaf:
    mode: HTML
    encoding: utf-8
    cache: false

2. 添加 Thymeleaf 依赖

编辑 ruoyi-admin/pom.xml，引入模板引擎依赖：

<!-- spring-boot-thymeleaf -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

3. 配置静态资源映射

编辑 ruoyi-framework/src/main/java/com/ruoyi/framework/config/ResourcesConfig.java，在 addResourceHandlers 方法中添加：

/** 前端静态资源配置 */
registry.addResourceHandler("/static/**").addResourceLocations("classpath:/static/");

4. 放行静态资源访问权限

编辑 ruoyi-framework/src/main/java/com/ruoyi/framework/config/SecurityConfig.java，在 configure 方法中添加匿名访问规则：

// 静态资源可匿名访问，主要添加 "/static/**", "/index", "/*.ico"
.antMatchers(HttpMethod.GET, "/", "/*.html", "/**/*.html", "/**/*.css", "/**/*.js", "/profile/**", "/static/**", "/index", "/*.ico").permitAll()

5. 设置首页访问控制器

编辑 SysIndexController.java，配置根路径返回页面：

@RequestMapping("/")
public ModelAndView index() {
    return new ModelAndView("index.html");
}

6. 整合前端静态资源

将前端打包生成的 dist 目录内容复制到后端项目中：

• HTML 文件：放入 ruoyi-admin/src/main/resources/templates/ 目录
• JS/CSS/图片等静态文件：放入 ruoyi-admin/src/main/resources/static/ 目录

注意：如果 templates 或 static 目录不存在，请手动新建。

三、 启动验证

启动后端服务，访问测试地址（例如：http://192.168.164.134:8080/）。

✅ 成功标志：页面正常显示首页并加载出验证码，即表示改造完成。