1. 시스템 요구 사양 및 라이브러리

RuoYi-Vue(전후방 분리 버전)를 구동하기 위해 다음 구성 요소들이 필요합니다.

• JDK: 1.8 버전 이상
• Database: MySQL (5.7 버전 권장)
• NoSQL: Redis (5.0 이상 권장)
• Build Tool: Maven 3.x 이상
• Frontend: Node.js (버전에 따라 추가 설정 필요)

2. Redis 서버 구성 및 최적화

Redis 구동 시 RDB 스냅샷 저장 문제로 인해 MISCONF Redis is configured to save RDB snapshots 오류가 발생할 수 있습니다. 이를 방지하기 위해 설정 파일(redis.windows.conf 등)을 수정해야 합니다.

먼저 데이터가 저장될 디렉터리를 지정합니다.

# redis.windows.conf 파일 수정
# 데이터를 저장할 물리적 경로를 지정합니다.
dir "C:/dev/redis_data"

설정 적용 후 서버를 실행합니다.

# Redis 서버 실행
redis-server.exe redis.windows.conf

만약 서버가 정상적으로 종료되지 않아 포트 충돌이 발생한다면 클라이언트를 통해 강제 종료 후 재시작합니다.

redis-cli.exe
127.0.0.1:6379> shutdown
exit

3. 데이터베이스 연동 및 테이블 생성

MySQL에 접속하여 시스템 운영에 필요한 스키마를 생성하고 초기 데이터를 임포트합니다.

1. ry-vue라는 이름의 데이터베이스를 생성합니다.
2. 제공되는 SQL 스크립트(ry_YYYYMMDD.sql, quartz.sql)를 순서대로 실행하여 테이블을 구성합니다.
3. 백엔드 설정 파일에서 접속 정보를 수정합니다.

설정 경로: ruoyi-admin/src/main/resources/application-druid.yml

spring:
  datasource:
    druid:
      master:
        url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=Asia/Seoul
        username: your_username
        password: your_password

4. 백엔드(Spring Boot) 애플리케이션 실행

IDE(IntelliJ IDEA 또는 Eclipse)를 통해 Maven 의존성을 로드한 후 아래의 메인 클래스를 실행합니다.

실행 파일 위치: ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java

정상적으로 구동되면 브라우저에서 http://localhost:8080 접속 시 시스템 가동 여부를 확인할 수 있습니다.

5. 프론트엔드(Vue.js) 개발 환경 구축

프론트엔드 코드는 ruoyi-ui 디렉터리에 위치하며, Node.js 환경에서 의존성을 설치하고 실행해야 합니다.

# 프로젝트 디렉터리 이동
cd ruoyi-ui

# 패키지 설치 (미러 사이트 활용 권장)
npm install --registry=https://registry.npmmirror.com

# 로컬 개발 서버 실행
npm run dev

참고: Node.js v17 이상의 버전을 사용하는 경우 OpenSSL 관련 보안 정책 이슈로 인해 실행 오류가 발생할 수 있습니다. 이 경우 환경 변수를 설정하여 해결합니다.

# Windows PowerShell 환경
$env:NODE_OPTIONS="--openssl-legacy-provider"

# 명령 프롬프트(cmd) 환경
set NODE_OPTIONS=--openssl-legacy-provider

프론트엔드가 성공적으로 실행되면 http://localhost:80으로 자동 접속됩니다. 로그인 화면에서 보안 문자가 정상적으로 출력된다면 백엔드와의 통신이 원활하게 이루어지고 있는 것입니다.