RuoYi Cloud是基于Spring Cloud、Spring Boot和Vue.js的開源微服務(wù)快速開發(fā)平臺，廣泛應(yīng)用于企業(yè)級后臺管理系統(tǒng)。本文將詳細(xì)介紹如何本地部署RuoYi Cloud v3.6.4，并快速構(gòu)建一個拖車管理后臺。
一、環(huán)境準(zhǔn)備
- JDK 1.8+：確保已安裝Java開發(fā)環(huán)境，推薦JDK 8或11。
- Maven 3.0+：用于項目依賴管理和構(gòu)建。
- MySQL 5.7+：數(shù)據(jù)庫存儲，建議使用MySQL 8.0。
- Redis 5.0+：緩存服務(wù)。
- Node.js 12+：前端環(huán)境，用于運行Vue.js項目。
- Git：用于從GitHub克隆項目源碼。
二、下載與配置
1. 獲取源碼：從RuoYi Cloud官方GitHub倉庫下載v3.6.4版本或使用Git命令克隆。
`bash
git clone https://github.com/ruoyi-cloud/ruoyi-cloud.git
`
- 導(dǎo)入數(shù)據(jù)庫：
- 創(chuàng)建數(shù)據(jù)庫（如
ry-cloud）。
- 執(zhí)行
sql目錄下的腳本：ry<em>2023xxxx.sql（基礎(chǔ)表）和ry</em>config_2023xxxx.sql（配置表）。
- 修改配置文件：
- 在
ruoyi-auth、ruoyi-gateway、ruoyi-modules等模塊的application.yml中，更新MySQL和Redis的連接信息（如數(shù)據(jù)庫URL、用戶名、密碼、Redis主機(jī)和端口）。
三、后端啟動
- 啟動順序：
- 先啟動注冊中心（
ruoyi-nacos），默認(rèn)端口8848。
- 再依次啟動
ruoyi-gateway（網(wǎng)關(guān)，端口8080）、ruoyi-auth（認(rèn)證服務(wù)，端口9200）、ruoyi-modules/system（系統(tǒng)模塊，端口9201）等核心服務(wù)。
- 驗證后端：訪問Nacos控制臺（http://localhost:8848/nacos），確認(rèn)所有服務(wù)已注冊。
四、前端部署
1. 安裝依賴：進(jìn)入ruoyi-ui目錄，運行以下命令安裝Node.js依賴。
`bash
npm install
`
2. 修改配置：在ruoyi-ui的.env.development文件中，將VUE<em>APP</em>BASE_API設(shè)置為后端網(wǎng)關(guān)地址（如http://localhost:8080）。
3. 啟動前端：運行開發(fā)服務(wù)器。
`bash
npm run dev
`
- 訪問系統(tǒng)：打開瀏覽器訪問http://localhost:80，使用默認(rèn)賬號admin和密碼admin123登錄。
五、構(gòu)建拖車管理后臺
- 添加拖車管理模塊：
- 在
ruoyi-modules下創(chuàng)建新模塊（如ruoyi-modules/trailer），參考現(xiàn)有模塊結(jié)構(gòu)，包含controller、service、mapper和實體類。
- 定義拖車實體，包括車牌號、型號、狀態(tài)、所屬公司等字段。
- 數(shù)據(jù)庫擴(kuò)展：在MySQL中創(chuàng)建拖車表（如
trailer_info），并同步更新MyBatis映射文件。 - 前端頁面開發(fā)：
- 在
ruoyi-ui的views目錄下新建拖車管理頁面，使用Vue.js和Element UI實現(xiàn)增刪改查功能。
- 通過API調(diào)用后端服務(wù)，接口路徑為
/trailer/**，由網(wǎng)關(guān)路由到拖車模塊。
- 權(quán)限配置：在RuoYi Cloud后臺的“系統(tǒng)管理”中，添加拖車管理的菜單和角色權(quán)限。
六、測試與優(yōu)化
- 功能測試：驗證拖車管理的CRUD操作、搜索和分頁功能。
- 性能監(jiān)控：集成Spring Boot Actuator或SkyWalking，監(jiān)控服務(wù)性能。
- 部署優(yōu)化：本地調(diào)試完成后，可打包為Docker鏡像或JAR文件，便于生產(chǎn)環(huán)境部署。
七、常見問題
- 端口沖突：確保各服務(wù)端口未被占用，可在
application.yml中調(diào)整。 - 依賴下載失敗：檢查Maven鏡像配置，或使用阿里云鏡像加速。
- 前端跨域問題：通過網(wǎng)關(guān)配置CORS或Nginx代理解決。
通過以上步驟，您可以在本地成功部署RuoYi Cloud v3.6.4，并快速擴(kuò)展為拖車管理后臺。該平臺提供了豐富的微服務(wù)組件和代碼生成器，可進(jìn)一步加速開發(fā)流程，滿足企業(yè)級應(yīng)用需求。
