PlatformUpdated 2025-04-01
Getting Started
CtrlPlus 로컬 개발 환경 세팅 및 첫 실행 가이드.
Next.jsSpring BootDockerPostgreSQLMariaDB
개요
CtrlPlus 플랫폼을 로컬에서 실행하기 위한 환경 세팅 가이드입니다. Next.js 프론트엔드, Spring Boot 백엔드, DB를 순서대로 구성합니다.
전체 실행 흐름
사전 요구사항
| 항목 | 버전 | 확인 명령 |
|---|---|---|
| Node.js | 20+ | node -v |
| Java | 17+ | java -version |
| Docker | 최신 | docker -v |
| Git | 최신 | git --version |
1. 레포지토리 클론
Bash
2. DB 실행 (Docker)
Bash
YAML
3. Spring Boot 실행
Bash
YAML
4. Next.js 실행
Bash
Bash
Bash
5. 브라우저 확인
| 서비스 | URL |
|---|---|
| Next.js 프론트엔드 | http://localhost:3000 |
| Spring Boot API | http://localhost:8080 |
| API Health Check | http://localhost:8080/actuator/health |
실행 순서 다이어그램
자주 발생하는 오류
| 오류 | 원인 | 해결 |
|---|---|---|
Connection refused 3306 | MariaDB 미실행 | docker compose up -d |
403 Forbidden | Spring Security 설정 | /auth/** permitAll 확인 |
ECONNREFUSED 8080 | Spring Boot 미실행 | ./gradlew bootRun |
Module not found | npm install 누락 | npm install 재실행 |
JWT signature error | secret 불일치 | .env.local secret 확인 |