Spring Boot 배포하기

Spring Boot 앱 Nginx로 배포하기

개요

Spring Boot 앱은 내장 톰캣에서 실행되며, Nginx는 리버스 프록시로서 앞단에서 요청을 받아 Spring Boot에 전달한다.

React는 정적 파일을 직접 서빙하면 됐지만, Spring Boot는 다릅니다! Spring Boot는 자기 자신이 웹 서버(내장 톰캣)를 가지고 있어서 스스로 HTTP 요청을 처리할 수 있어요.

그런데 왜 Nginx를 앞에 두냐고요? Nginx가 앞에서 SSL 처리, 로드 밸런싱, 정적 파일 캐싱, 보안을 담당해주면, Spring Boot는 비즈니스 로직에만 집중할 수 있거든요. 마치 식당에서 홀 직원(Nginx)이 손님 응대를 하고, 주방장(Spring Boot)은 요리에만 집중하는 것과 같아요!

배포 아키텍처

graph LR
    A[👤 사용자<br/>브라우저] -->|"<https://api.example.com><br/>포트 443"| B[🖥️ Nginx<br/>리버스 프록시]
    B -->|"<http://localhost:8080><br/>내부 통신"| C[🍃 Spring Boot<br/>내장 톰캣]
    C --> D[🗄️ Database<br/>MySQL/PostgreSQL]

    style B fill:#90EE90
    style C fill:#87CEEB
Mermaid
복사

flowchart TD
    A["💻 로컬 개발"] -->|"./gradlew build<br/>또는 mvn package"| B["📦 JAR 파일 생성<br/>app.jar"]
    B -->|"scp 또는 CI/CD"| C["🖥️ 서버에 업로드"]
    C --> D["🍃 java -jar app.jar<br/>Spring Boot 실행"]
    D --> E["⚙️ Nginx 리버스 프록시<br/>설정 + SSL"]
    E --> F["🌐 서비스 오픈!"]

    style B fill:#FFD700
    style E fill:#90EE90
Mermaid
복사

Step 1: Spring Boot 앱 빌드

# Gradle 프로젝트
./gradlew clean build -x test
# 결과: build/libs/myapp-0.0.1-SNAPSHOT.jar

# Maven 프로젝트
mvn clean package -DskipTests
# 결과: target/myapp-0.0.1-SNAPSHOT.jar
Bash
복사

Step 2: 서버에 업로드 및 실행

# JAR 파일 업로드
scp build/libs/myapp-0.0.1-SNAPSHOT.jar ubuntu@서버IP:/home/ubuntu/app/

# 서버에서 실행
cd /home/ubuntu/app
java -jar myapp-0.0.1-SNAPSHOT.jar
Bash
복사

Systemd 서비스로 등록 (권장!)

터미널에서 직접 java -jar로 실행하면, SSH 연결이 끊어지면 앱도 같이 죽어요. 그래서 systemd 서비스로 등록해야 해요!

sudo nano /etc/systemd/system/myapp.service
Bash
복사

[Unit]
Description=My Spring Boot Application
After=network.target

[Service]
User=ubuntu
ExecStart=/usr/bin/java -jar /home/ubuntu/app/myapp-0.0.1-SNAPSHOT.jar
SuccessExitStatus=143
Restart=always
RestartSec=5
StandardOutput=journal
StandardError=journal
Environment=SPRING_PROFILES_ACTIVE=prod
Environment=SERVER_PORT=8080

[Install]
WantedBy=multi-user.target
Plain Text
복사

# 서비스 등록 및 시작
sudo systemctl daemon-reload
sudo systemctl start myapp
sudo systemctl enable myapp

# 상태 확인
sudo systemctl status myapp

# 로그 확인
sudo journalctl -u myapp -f
Bash
복사

항목	설명
After=network.target	네트워크가 준비된 후 시작
Restart=always	앱이 죽으면 자동 재시작
RestartSec=5	재시작 전 5초 대기
Environment	환경 변수 설정 (프로파일, 포트 등)

Step 3: Nginx 리버스 프록시 설정

sudo nano /etc/nginx/sites-available/spring-app
Bash
복사

server {
    listen 80;
    server_name api.example.com;

    # ⭐ 리버스 프록시 — Spring Boot로 전달
    location / {
        proxy_pass <http://localhost:8080>;

        # 원본 요청 정보 전달 (필수!)
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # 타임아웃 설정
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;

        # WebSocket 지원 (필요시)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # 큰 파일 업로드 허용
    client_max_body_size 10M;
}
Plain Text
복사

프록시 헤더가 왜 필요해?

sequenceDiagram
    participant 사용자 as 👤 사용자<br/>IP: 203.0.113.50
    participant Nginx as 🖥️ Nginx<br/>IP: 10.0.0.1
    participant Spring as 🍃 Spring Boot<br/>IP: 127.0.0.1

    사용자->>Nginx: 요청 (IP: 203.0.113.50)

    Note over Nginx: 헤더 없이 전달하면<br/>Spring은 Nginx IP만 보임

    Nginx->>Spring: 요청 전달
    Note over Nginx,Spring: X-Real-IP: 203.0.113.50<br/>X-Forwarded-For: 203.0.113.50<br/>X-Forwarded-Proto: https

    Note over Spring: 이제 진짜 사용자 IP를<br/>알 수 있어요!
Mermaid
복사

헤더	역할
Host	원래 요청된 도메인 이름
X-Real-IP	실제 클라이언트 IP
X-Forwarded-For	프록시 체인을 거친 IP 목록
X-Forwarded-Proto	원래 프로토콜 (http/https)

이 헤더가 없으면 Spring Boot는 모든 요청이 127.0.0.1(Nginx)에서 온 것으로 인식해요. 사용자의 진짜 IP를 알 수 없게 되는 거죠!

Step 4: 활성화 및 SSL 적용

# 사이트 활성화
sudo ln -s /etc/nginx/sites-available/spring-app /etc/nginx/sites-enabled/

# 테스트 및 적용
sudo nginx -t && sudo systemctl reload nginx

# SSL 적용
sudo certbot --nginx -d api.example.com
Bash
복사

최종 설정 (HTTPS 포함)

# 업스트림 정의 (로드 밸런싱 대비)
upstream spring_backend {
    server localhost:8080;
}

server {
    listen 443 ssl http2;
    server_name api.example.com;

    ssl_certificate /etc/letsencrypt/live/api.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/api.example.com/privkey.pem;

    # 리버스 프록시
    location / {
        proxy_pass http://spring_backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # Health Check 엔드포인트 (로깅 제외)
    location = /actuator/health {
        proxy_pass http://spring_backend;
        access_log off;
    }

    client_max_body_size 10M;
}

server {
    listen 80;
    server_name api.example.com;
    return 301 https://$host$request_uri;
}
Plain Text
복사

Spring Boot application.yml 설정

server:
  port: 8080
  forward-headers-strategy: framework  # ⭐ 프록시 헤더 인식 (필수!)

# Actuator (Health Check)
management:
  endpoints:
    web:
      exposure:
        include: health
YAML
복사

forward-headers-strategy: framework 설정을 꼭 해주세요! 이걸 안 하면 Spring Boot가 Nginx가 보내주는 X-Forwarded-* 헤더를 무시해요.

자주 발생하는 문제

문제	원인	해결
502 Bad Gateway	Spring Boot가 안 돌아가고 있음	systemctl status myapp으로 확인
504 Gateway Timeout	응답 시간 초과	proxy_read_timeout 늘리기
CORS 에러	프론트-백 도메인 다름	Spring Boot에 CORS 설정 or Nginx에서 처리
리다이렉트 무한 루프	X-Forwarded-Proto 미설정	프록시 헤더 설정 확인
파일 업로드 실패	크기 제한	client_max_body_size 늘리기

실습

실습 환경

항목	값
로컬 프로젝트	Spring Boot + Gradle
빌드 결과물	build/libs/APP.war
서버	alohaserver4.cafe24.com
WAR 배포 경로	/var/www/krules/backend/
제어 스크립트	start.sh / stop.sh / restart.sh
SSH 접속	Host alias alohaserver4 사용

Spring Boot는 파일 복사만으로 끝나지 않아요. APP.war 업로드 → restart.sh 원격 실행 순서로 배포해야 해요!

배포 파일 구조

📁 프로젝트 루트/
  ├── 📄 deploy.bat     ← 빌드 + 업로드 + 재시작 자동화
  ├── 📄 start.bat      ← 서버 앱 원격 시작
  ├── 📄 stop.bat       ← 서버 앱 원격 종료
  └── 📄 restart.bat    ← 서버 앱 원격 재시작

📁 서버 /var/www/krules/backend/
  ├── 💻 APP.war        ← 배포된 애플리케이션
  ├── 📜 start.sh       ← APP.war 백그라운드 실행 (로그 저장)
  ├── 📜 stop.sh        ← APP.war 프로세스 종료
  ├── 📜 restart.sh     ← stop.sh → start.sh 순서로 재시작

📁 서버 /var/www/krules/log/
  └── 📰 appwar_20260422_120000.log   ← 실행 로그 (start.sh 자동 생성)
Plain Text
복사

사전 준비: 서버 디렉토리 생성 (최초 1회)

# 서버 접속
ssh alohaserver4

# 배포 경로 생성
mkdir -p /var/www/krules/backend
mkdir -p /var/www/krules/log
Bash
복사

start.sh

#!/bin/bash

# 현재 스크립트가 위치한 경로로 이동
cd "$(dirname "$0")"

# 로그 디렉토리 생성
LOG_DIR="../log"
mkdir -p "$LOG_DIR"
LOG_FILE="$LOG_DIR/appwar_$(date +%Y%m%d_%H%M%S).log"

# JAVA_HOME이 설정되어 있지 않으면 java 명령어 사용
JAVA_CMD=${JAVA_HOME:-}/bin/java
if [ ! -x "$JAVA_CMD" ]; then
  JAVA_CMD=java
fi

# JVM 메모리 제한 (최소 128MB, 최대 256MB)
JAVA_OPTS="-Xms128m -Xmx256m"

# Spring 프로파일 명시 (server = 실서버 설정, local = 로컬 개발)
SPRING_OPTS="--spring.profiles.active=server"

# APP.war 파일을 백그라운드에서 실행하고 로그 저장
$JAVA_CMD $JAVA_OPTS -jar APP.war $SPRING_OPTS > "$LOG_FILE" 2>&1 &
JavaScript
복사

stop.sh

#!/bin/bash

# APP.war 프로세스 종료 스크립트
# 현재 경로의 APP.war 프로세스만 종료

cd "$(dirname "$0")"
APP_PATH="$(pwd)/APP.war"

PIDS=$(ps -ef | grep '[j]ava.*-jar' | grep "$APP_PATH" | awk '{print $2}')

if [ -z "$PIDS" ]; then
  echo "실행 중인 APP.war 프로세스가 없습니다."
  exit 0
fi

for PID in $PIDS; do
  echo "APP.war 프로세스 종료: $PID"
  kill $PID
  sleep 1
  if ps -p $PID > /dev/null; then
    echo "강제 종료: $PID"
    kill -9 $PID
  fi
  echo "종료 완료: $PID"
  sleep 1
  done

echo "모든 APP.war 프로세스가 종료되었습니다."
JavaScript
복사

restart.sh (프로젝트 루트에 저장)

start.sh와 stop.sh를 순서대로 호출하는 재시작 스크립트예요.

#!/bin/bash

# APP.war 재시작 스크립트 (stop.sh → start.sh 순서로 실행)
cd "$(dirname "$0")"

echo "=== APP.war 재시작 시작 ==="

# 기존 프로세스 종료
bash stop.sh

# 프로세스 완전 종료 대기
sleep 2

# 새 프로세스 시작
bash start.sh

echo "=== APP.war 재시작 완료 ==="
Bash
복사

1단계: 수동 배포

flowchart TB
    A["💻 로컬<br>gradlew clean bootWar"] -->|"APP.war 생성"| B["📦 APP.war"]
    B -->|"scp 업로드<br>WAR + sh 파일"| C["🖥️ 서버<br>/var/www/krules/backend/"]
    C -->|"plink restart.sh"| D["🍃 Spring Boot 재시작"]
    D --> E["🌐 브라우저 확인"]
Mermaid
복사

# 1. 로컬에서 WAR 빌드
./gradlew clean bootWar

# 빌드 결과 확인
ls build/libs/
# APP.war 파일 생성됨

# 2. 서버에 APP.war + sh 파일 업로드
scp build/libs/APP.war alohaserver4:/var/www/krules/backend/APP.war
scp start.sh stop.sh restart.sh alohaserver4:/var/www/krules/backend/

# 3. sh 파일 실행 권한 부여 (최초 1회)
ssh alohaserver4 "chmod +x /var/www/krules/backend/*.sh"

# 4. restart.sh 원격 실행
ssh alohaserver4 "cd /var/www/krules/backend && bash restart.sh"

# 5. 로그 확인
ssh alohaserver4 "tail -f /var/www/krules/log/appwar_*.log"
Bash
복사

2단계: 프론트엔드 .env 환경변수 설정

백엔드 API 주소를 환경에 따라 분리해서 관리해요. Vite 프로젝트는 VITE_ 접두사, CRA는 REACT_APP_ 접두사를 붙여야 인식해요.

# .env.local (로컬 개발용 — .gitignore에 추가 권장)
VITE_API_URL=http://localhost:8080/api
# VITE_API_URL=http://192.168.30.19:8080/api   # 같은 네트워크 다른 PC 테스트

# .env.production (배포용)
# 방식 A (서브도메인): api.국룰.com → Spring Boot
# VITE_API_URL=http://xn--3e0b91t.com/api      # HTTP 적용 전
# VITE_API_URL=https://api.xn--3e0b91t.com/api  # HTTPS 적용 후

# 방식 B (리버스 프록시): 국룰.com/api → Spring Boot
# VITE_API_URL=http://xn--3e0b91t.com/api      # HTTP 적용 전
# VITE_API_URL=https://xn--3e0b91t.com/api      # HTTPS 적용 후
Bash
복사

React 코드에서 이렇게 사용해요:

// 환경변수로 API 주소를 읽어옴
const res = await fetch(`${import.meta.env.VITE_API_URL}/products`);
JavaScript
복사

3단계: Nginx 리버스 프록시 설정 — 방식 선택

두 가지 방식이 있어요. 상황에 맞게 하나를 선택하세요!

graph TD
    A["🌐 사용자 요청"] --> B{방식 선택}
    B -->|"방식 A<br>서브도메인"| C["api.국룰.com<br>→ Spring Boot :8080"]
    B -->|"방식 B<br>리버스 프록시"| D["국룰.com/api/**<br>→ Spring Boot :8080"]
    C --> E["🍃 Spring Boot"]
    D --> E
Mermaid
복사

비교	방식 A — 서브도메인	방식 B — 경로 기반 리버스 프록시
API URL	api.국룰.com/api/...	국룰.com/api/...
DNS 설정	api 서브도메인 A레코드 추가 필요	추가 DNS 불필요
SSL 인증서	api 서브도메인 인증서 별도 발급	기존 도메인 인증서 공유
Nginx 파일 수	2개 (프론트 + 백엔드 각각)	1개 (하나의 server 블록에 통합)
추천 상황	API 서버를 독립적으로 관리할 때	도메인 하나로 풀스택을 단순하게 구성할 때

방식 A — 서브도메인 (api.국룰.com)

ssh alohaserver4
nano /etc/nginx/conf.d/krules-backend.conf
Bash
복사

# 백엔드 전용 서버 블록 (api 서브도메인)
server {
    listen 80;
    server_name api.xn--3e0b91t.com;

    location / {
        proxy_pass <http://localhost:8080>;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_connect_timeout 60s;
        proxy_read_timeout 60s;
    }

    client_max_body_size 10M;
}
Plain Text
복사

프론트엔드 .env.production:

VITE_API_URL=https://api.xn--3e0b91t.com/api
Bash
복사

방식 B — 경로 기반 리버스 프록시 (국룰.com/api)

프론트엔드와 백엔드를 하나의 Nginx 서버 블록에서 처리해요. 도메인 하나로 풀스택 구성할 때 편해요!

ssh alohaserver4
nano /etc/nginx/conf.d/krules.conf
Bash
복사

server {
    listen 80;
    server_name xn--3e0b91t.com www.xn--3e0b91t.com;

    # ── 프론트엔드 (React Vite 정적 파일) ──────────────────
    root /var/www/krules/frontend;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /assets/ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    # ── 백엔드 (Spring Boot 리버스 프록시) ─────────────────
    # /api/ 로 시작하는 요청은 Spring Boot로 전달
    location /api/ {
        proxy_pass <http://localhost:8080>;        # ← /api/ 경로 그대로 전달

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_connect_timeout 60s;
        proxy_read_timeout 60s;
        client_max_body_size 10M;
    }

    gzip on;
    gzip_types text/plain text/css application/json application/javascript text/xml;
}
Plain Text
복사

proxy_pass <http://localhost:8080>; — 끝에 / 를 붙이지 않으면 /api/ 경로가 그대로 Spring Boot에 전달돼요. Spring Boot의 RequestMapping도 /api/... 로 맞춰야 해요!

프론트엔드 .env.production:

VITE_API_URL=https://xn--3e0b91t.com/api
Bash
복사

nginx -t && systemctl reload nginx
Bash
복사

3단계: 개별 제어 bat 파일 (서버 관리용)

PuTTY의 plink.exe(원격 명령), pscp.exe(파일 복사)를 사용해요. 설치: https://www.putty.org/ → 다운로드 후 PATH에 추가하거나 bat 파일과 같은 폴더에 두세요.

start.bat

@echo off
chcp 65001 > nul
set REMOTE_USER=root
set REMOTE_HOST=alohaserver4.cafe24.com
set REMOTE_PATH=/var/www/krules/backend
:: 🔐 비밀번호 입력 (안 보이게)
for /f "delims=" %%p in ('powershell -Command "$p = Read-Host ''SSH Password'' -AsSecureString; $BSTR=[System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($p); [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($BSTR)"') do set REMOTE_PASS=%%p

echo [START] Spring Boot 앱 시작 중...
plink -pw %REMOTE_PASS% %REMOTE_USER%@%REMOTE_HOST% "cd %REMOTE_PATH% && bash start.sh"
echo 완료!
pause
Shell
복사

stop.bat

@echo off
chcp 65001 > nul
set REMOTE_USER=root
set REMOTE_HOST=alohaserver4.cafe24.com
set REMOTE_PATH=/var/www/krules/backend
:: 🔐 비밀번호 입력 (안 보이게)
for /f "delims=" %%p in ('powershell -Command "$p = Read-Host ''SSH Password'' -AsSecureString; $BSTR=[System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($p); [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($BSTR)"') do set REMOTE_PASS=%%p

echo [STOP] Spring Boot 앱 종료 중...
plink -pw %REMOTE_PASS% %REMOTE_USER%@%REMOTE_HOST% "cd %REMOTE_PATH% && bash stop.sh"
echo 완료!
pause
Shell
복사

restart.bat

@echo off
chcp 65001 > nul
set REMOTE_USER=root
set REMOTE_HOST=alohaserver4.cafe24.com
set REMOTE_PATH=/var/www/krules/backend
:: 🔐 비밀번호 입력 (안 보이게)
for /f "delims=" %%p in ('powershell -Command "$p = Read-Host ''SSH Password'' -AsSecureString; $BSTR=[System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($p); [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($BSTR)"') do set REMOTE_PASS=%%p

echo [RESTART] Spring Boot 앱 재시작 중...
plink -pw %REMOTE_PASS% %REMOTE_USER%@%REMOTE_HOST% "cd %REMOTE_PATH% && bash restart.sh"
echo 완료!
pause
Shell
복사

4단계: 통합 배포 자동화 (deploy.bat)

clean bootWar → APP.war + sh 파일 업로드 → restart.sh 원격 실행까지 한 번에!

deploy.bat

@echo off
chcp 65001 > nul
echo.
echo =============================================
echo   Spring Boot bootWar Build ^& Deploy
echo =============================================
echo.

:: ────────────────────────────────────────────
:: 설정값
:: ────────────────────────────────────────────
set PROJECT_DIR=%~dp0
set REMOTE_USER=root
set REMOTE_HOST=alohaserver4.cafe24.com
set REMOTE_PATH=/var/www/krules/backend

:: 🔐 비밀번호 입력 (안 보이게)
for /f "delims=" %%p in ('powershell -Command "$p = Read-Host ''SSH Password'' -AsSecureString; $BSTR=[System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($p); [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($BSTR)"') do set REMOTE_PASS=%%p

echo.

:: ────────────────────────────────────────────
:: [1] bootWar 빌드
:: ────────────────────────────────────────────
echo [1/3] bootWar 빌드 중...
cd /d %PROJECT_DIR%
call gradlew.bat clean bootWar

if errorlevel 1 (
    echo.
    echo [오류] 빌드 실패! 에러를 확인하세요.
    pause
    exit /b 1
)

echo 빌드 완료 - APP.war 생성됨
echo.

:: ────────────────────────────────────────────
:: [2] 파일 업로드
:: ────────────────────────────────────────────
echo [2/3] 파일 업로드 중...

pscp -pw %REMOTE_PASS% build\libs\APP.war %REMOTE_USER%@%REMOTE_HOST%:%REMOTE_PATH%/APP.war

if errorlevel 1 (
    echo.
    echo [오류] WAR 업로드 실패!
    pause
    exit /b 1
)

pscp -pw %REMOTE_PASS% start.sh stop.sh restart.sh %REMOTE_USER%@%REMOTE_HOST%:%REMOTE_PATH%/

echo 업로드 완료
echo.

:: ────────────────────────────────────────────
:: [3] 서버 재시작
:: ────────────────────────────────────────────
echo [3/3] 서버 재시작 중...

plink -pw %REMOTE_PASS% %REMOTE_USER%@%REMOTE_HOST% "chmod +x %REMOTE_PATH%/*.sh && cd %REMOTE_PATH% && bash restart.sh"

if errorlevel 1 (
    echo.
    echo [오류] 재시작 실패!
    pause
    exit /b 1
)

:: ────────────────────────────────────────────
:: [4] 완료
:: ────────────────────────────────────────────
echo.
echo =============================================
echo   배포 완료!
echo   로그 확인:
echo   ssh %REMOTE_USER%@%REMOTE_HOST%
echo   tail -f /var/www/krules/log/appwar_*.log
echo =============================================
echo.
pause
Shell
복사

실행 방법: deploy.bat 더블클릭 → bootWar 빌드 → WAR + sh 업로드 → restart.sh 실행까지 자동!

(선택) SSH 키 인증으로 비밀번호 없이 배포

# 1. SSH 키 생성 (이미 있으면 생략)
ssh-keygen -t ed25519 -C "deploy-key"

# 2. 공개키를 서버에 등록
ssh-copy-id alohaserver4
Bash
복사

키 등록 후 각 bat 파일에서 pscp -pw / plink -pw 대신 표준 명령으로 교체:

:: WAR 업로드 (pscp → scp)
scp build\\libs\\APP.war alohaserver4:%REMOTE_PATH%/APP.war
scp start.sh stop.sh restart.sh alohaserver4:%REMOTE_PATH%/

:: 원격 실행 (plink → ssh)
ssh alohaserver4 "chmod +x %REMOTE_PATH%/*.sh && cd %REMOTE_PATH% && bash restart.sh"
Shell
복사

체크리스트

~/.ssh/config 에 alohaserver4 Host 설정 완료?

서버에 /var/www/krules/backend/ 및 /var/www/krules/log/ 디렉토리 생성?

프로젝트 루트에 start.sh / stop.sh / restart.sh 파일 존재?

./gradlew clean bootWar → build/libs/APP.war 생성 확인?

scp APP.war + *.sh 업로드 성공?

서버에서 chmod +x /var/www/krules/backend/*.sh 완료?

ssh alohaserver4 "cd /var/www/krules/backend && bash restart.sh" 실행 확인?

tail -f /var/www/krules/log/appwar_*.log 로 정상 기동 로그 확인?

Nginx conf.d/krules-backend.conf 리버스 프록시 설정?

nginx -t 통과 및 systemctl reload nginx 완료?

start.bat / stop.bat / restart.bat 개별 동작 확인?

deploy.bat 통합 배포 테스트 완료?

핵심 정리

Spring Boot = 내장 톰캣으로 자체 실행 → Nginx는 리버스 프록시 역할

systemd 서비스 등록으로 앱 자동 시작/재시작 보장

프록시 헤더(X-Real-IP, X-Forwarded-For 등) 설정 필수

Spring Boot forward-headers-strategy: framework 설정 필수

Certbot으로 HTTPS 적용 + HTTP→HTTPS 리다이렉트