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