FAQ · 트러블슈팅

사용자(개발자) 입장에서 자주 묻는 질문과 증상별 빠른 해결 매뉴얼입니다. 상품·정책 관련 일반 문의 + 운영 중 마주치는 트러블슈팅을 한 페이지에 정리했습니다.

💡 요약 정리

개발언어 VPS 호스팅은 프레임워크 + DB 선택 시 약 10분 안에 nginx · 런타임 · DB · 무료 SSL까지 자동 구성되는 단독 서버 호스팅입니다.
8개 프레임워크 x 2개 DB = 16개 조합 지원 (FastAPI, Django, NestJS, Express, Next.js, React, Spring Boot, Gin)
root SSH 권한 제공으로 서버 내 자유로운 변경·확장이 가능합니다.
요금제는 상위 변경만 가능하며, 자동 백업은 제공되지 않으므로 별도 백업이 필요합니다.
트러블슈팅 시 Python · Java · Go는 systemd, Node.js(React 포함)는 PM2 기반으로 관리합니다.

섹션	내용
A	상품 · 정책 FAQ
B	신청 · 결제 · 변경 FAQ
C	도메인 · SSL FAQ
D	운영 · 보안 FAQ
E	트러블슈팅 - 증상별 빠른 해결

A. 상품 · 정책 FAQ

A-1. 개발언어 VPS 호스팅이 뭔가요?

프레임워크와 DB를 고르시면 약 10분 안에 nginx · 런타임 · DB · 무료 SSL까지 자동 구성되어 도착하는 단독 서버 호스팅입니다. 일반 PaaS와 달리 root SSH 권한이 함께 제공되어 서버 안에서 자유롭게 변경·확장하실 수 있습니다.

한 줄: "자동 구성은 PaaS처럼, 서버 권한은 VPS답게."

A-2. 어떤 프레임워크/DB를 지원하나요?

8개 프레임워크 x 2개 DB = 16개 조합입니다.

카테고리	프레임워크
Python 3.12	FastAPI, Django
Node.js 24	NestJS, Express, Next.js, React
OpenJDK 21	Spring Boot
Go 1.27	Gin
DB	PostgreSQL 17, MariaDB 11.4 (택1)

A-3. 신청 후 얼마나 빨리 쓸 수 있나요?

결제 후 약 10분 후 SSH 접속이 가능합니다. 그 이전에는 자동 구성 진행 중 - [나의 서비스 관리 → 서버호스팅 관리]에서 활성화 시점을 확인하시면 됩니다.

A-4. 서버 위치는 어디인가요?

일본 오사카 IDC입니다.

A-5. OS는 무엇인가요?

Ubuntu 24.04 LTS입니다.

A-6. 자동으로 설치되는 것은 무엇이고, 설치되지 않는 것은 무엇인가요?

구분	내용
자동 설치	OS, nginx, 런타임(Python/Node/JDK/Go), 프레임워크, DB, fail2ban, 보안 헤더 3종, 무료 도메인 SSL 자동
자동 미설치	고객 코드, Redis/RabbitMQ 등 추가 미들웨어, CI/CD, 모니터링 도구, 외부 SaaS 연동

추가 패키지는 root SSH로 apt install ... 자유롭게 설치하실 수 있습니다.

B. 신청 · 결제 · 변경 FAQ

B-1. 요금제는 어떻게 구성되어 있나요?

요금제	월정액	RAM	SSD	트래픽	추천
DEV A	33,000원	2GB	50GB	1.0TB	사이드 프로젝트
DEV B (권장)	66,000원	4GB	100GB	2.0TB	스타트업 첫 배포
DEV C	132,000원	8GB	200GB	4.0TB	운영 서비스
DEV D	220,000원	16GB	400GB	6.0TB	본격 운영

설치비 0원, 약정 없음, 월정액.

B-2. 어떤 요금제를 선택해야 하나요?

DEV A: 사이드 프로젝트, 학습용 (단, Spring Boot · Next.js는 DEV B 권장)
DEV B (권장): 스타트업 첫 배포 (메모리 큰 스택 안정 운영)
DEV C: 운영 서비스 (사용자 수백~수천)
DEV D: 본격 운영, 트래픽 4TB+

B-3. 요금제를 변경할 수 있나요?

상위 변경만 가능합니다 (DEV A → B → C → D).

변경	가능 여부
A → B, B → C, C → D, A → C 직행 등	O 가능
B → A, C → B 등 (하위)	x 불가

다운그레이드가 필요하시면 만료 후 새로 낮은 요금제로 신청하셔야 하며, 데이터는 별도 백업 필수입니다.

B-4. 프레임워크 / DB를 변경할 수 있나요?

자동 구성되는 프레임워크 · DB는 신청 시 선택하신 1가지입니다. 다른 프레임워크 · DB나 다른 버전이 필요하시면 root 권한으로 서버에 직접 설치하거나 업데이트하실 수 있습니다. 처음부터 다른 조합으로 자동 구성하려면 나의 서비스 관리의 OS 재설치에서 새로 선택하시면 됩니다. OS 재설치는 데이터를 모두 초기화하므로 먼저 백업해 주세요.

B-5. 트래픽 초과 요금은 어떻게 계산되나요?

단가: 110원/GB (VAT 포함)
측정: 월 누적 (5분 단위 실시간 X)
정산: 월 단위 초기화, 초과분 익월 후불
초과해도 서비스는 차단되지 않으며, 미납 지속 시에만 서버 차단
트래픽 별도 증설 불가 → 더 많은 트래픽 필요 시 상위 요금제 변경
상위 요금제 변경 시 기존 발생한 초과 트래픽은 새 요금제 기준으로 자동 재계산

B-6. LLM API · 외부 SaaS 비용 포함인가요?

포함되지 않습니다. OpenAI · Anthropic · 외부 SaaS는 각 제공사에 별도 결제하셔야 합니다.

B-7. 결제·환불·해지는 어떻게 처리하나요?

본 상품은 나의서비스관리(나서관) 직접 취소 버튼이 미제공됩니다. 1:1 문의 게시판에 신청해주시면 어드민에서 처리됩니다.

케이스	기준
신규 취소	사용 7일 이내 → 1:1 문의 접수 후 결제방법에 따라 전액 취소 또는 환불
서비스 해지	사용 7일 경과 ~ 30일 미만 (또는 장기결제 잔여 개월) → 1:1 문의 접수, 잔여 기간 환불
연장 취소	결제 후 사용 전 → 1:1 문의 접수

서버 회수는 자동 처리됩니다 (별도 회수 요청 불필요). 환불 계좌는 카드결제의 경우 명의자와 일치해야 하며, 불일치 시 마이캐쉬로 환불됩니다.

B-8. 만료 / 연장 / 데이터 삭제는?

만료 시 서버 차단
만료 후 7일 경과 시 데이터 삭제 가능 (복구 불가)
만료 안내 메일 수신 즉시 백업 권장

B-9. 약정이나 할인 이벤트가 있나요?

본 상품은 약정 없는 월정액이며, 약정 할인은 별도 제공되지 않습니다. 프로모션 진행 시 [이벤트 페이지]에서 별도 안내드립니다.

C. 도메인 · SSL FAQ

C-1. 무료 도메인이 제공되나요?

네. 아이디.mycafe24.com 무료 도메인이 자동 제공되며, SSL이 자동 적용됩니다.

C-2. 보유 도메인을 연결할 수 있나요?

가능합니다. 최대 20개까지.

STEP	작업
1	도메인 DNS의 A 레코드를 본인 공인 IP로 설정
2	nginx에 도메인 추가 (`server_name`)
3	SSL 별도 구매 필요 - 카페24 SSL 인증서 구매 후 나의 서비스 관리에서 설치

C-3. 무료 도메인이랑 보유 도메인 SSL 차이가 뭔가요?

유형	SSL 처리
무료 도메인 (`아이디.mycafe24.com`)	SSL 자동 발급·갱신 (별도 작업 불필요)
보유 도메인	SSL 별도 구매 필요. 카페24 SSL 인증서 구매 후 나의 서비스 관리에서 설치

D. 운영 · 보안 FAQ

D-1. 공인 IP는 몇 개 제공되나요?

공인 IP 1개가 기본 제공됩니다.

D-2. 방화벽은 어떻게 설정하나요?

카페24 [나의 서비스 관리 → 방화벽관리] 메뉴에서 직접 설정하시면 됩니다. 기본 인바운드 허용: 22(SSH), 80(HTTP), 443(HTTPS).

서버 내부에서 iptables/ufw 직접 변경 금지. 카페24 방화벽과 충돌하여 SSH 끊김이 발생할 수 있습니다.

D-3. 서버 ON/OFF 가능한가요?

네. 나의 서비스 관리 → 서버호스팅 관리에서 서버 원격 관리(ON/OFF/재시작)가 가능합니다.

D-4. 백업은 자동으로 되나요?

자동 백업은 제공되지 않습니다. 백업 책임은 고객에게 있습니다. 권장:

DB: pg_dump / mariadb-dump 일일 cron
코드: Git 원격 저장소
중요 파일: 외부 스토리지(S3 등)

D-5. root 권한으로 무엇까지 할 수 있나요?

일반 VPS와 동일하게 거의 모든 작업이 가능합니다.

구분	내용
O 가능	apt 패키지, 시스템 서비스 추가, nginx 설정, cron, 추가 도메인
x 불가	불법 콘텐츠, 해외 VPN, 약관 위반

D-6. 자동 구성된 nginx · systemd · env 파일을 다 손대도 되나요?

권장: 외부 설정 분리.

DB 접속 정보 등은 /etc/[프로젝트]/env 환경변수만 수정
코드는 자유롭게 (단, 다음 3개는 절대 덮어쓰지 마세요)
- /etc/systemd/system/[프로젝트].service
- /opt/[프로젝트]/ecosystem.config.js
- /etc/[프로젝트]/env

가장 흔한 사고: 자체 코드 통째 업로드 → systemd unit / env 같이 덮어씀 → 환경변수 주입 끊김 → DB 연결 실패

D-7. SSH가 끊겼는데 어떻게 하나요?

한 번 끊긴 SSH는 사용자가 직접 복구 사실상 불가합니다.

카페24 [방화벽관리]에서 22번 포트 허용 IP 확인
안 되면 [서버호스팅 관리 → 서버 재시작]
안 되면 → 고객센터 문의 / 재설치 안내 (데이터 손실 위험)

예방: "변경 작업 시 별도 SSH 세션 동시 유지, 변경 후 새 세션으로 재접속 확인 후 기존 세션 종료" 3원칙 미리 안내

D-8. fail2ban으로 IP가 차단됐어요

SSH 5회 실패 시 30분 자동 차단됩니다. 30분 후 재시도하시거나, 다른 IP에서 SSH 접속 후 sudo fail2ban-client set sshd unbanip [IP]로 해제하시면 됩니다.

D-9. 서버 안에서 iptables 만져도 되나요?

권장하지 않습니다. 카페24 방화벽관리와 충돌 가능. 외부 노출 포트 조정은 카페24 방화벽관리 메뉴, 서버 내부 라우팅 미세 조정만 nginx allow/deny로 권장드립니다.

E. 트러블슈팅 - 증상별 빠른 해결

E-1. 접속 안 됨

증상	원인	해결
SSH timeout	방화벽에서 22번에 본인 IP 미등록	[방화벽관리]에서 22번 포트 허용 IP에 현재 IP 추가
SSH 인증 실패	비밀번호 오타 / 키 미등록	신청 시 본인이 설정한 root 비밀번호 재확인 (카페24 미보관). 키 인증 시 키 등록 여부
결제 직후 접속 안 됨	자동 구성 진행 중	약 10분 후 다시 시도
작업 중 SSH 끊김	iptables 직접 변경 / sshd 잘못 / IP 변경	D-7 절차
외부에서 :8000/:3000/:8080 접속 안 됨	의도된 동작	nginx :80/:443만 외부 노출 (정상)

E-2. HTTP 에러

증상	원인	해결
HTTP 502 Bad Gateway	앱 다운 / 포트 미스매치	systemd: `systemctl is-active [프로젝트]` · PM2: `pm2 status`
HTTP 403 / 404	nginx 권한 / path	`tail /var/log/nginx/[프로젝트]_error.log`
HTTP 400 Bad Request (Django)	`ALLOWED_HOSTS` 미등록	env에 도메인 추가 후 restart
HTTP 404 (전체)	DNS 미반영 / A 레코드 오류	`nslookup [도메인]`
사이트 느림	트래픽 / DB 슬로우 / 메모리 부족	`top`, `free -h` 확인 → 지속되면 상위 요금제

E-3. SSL / HTTPS

증상	원인	해결
무료 도메인 HTTPS 안 됨	자동 적용 직후	약 10분 안에 자동 적용
보유 도메인 HTTPS 안 됨	SSL 별도 구매 후 적용 필요	카페24 SSL 인증서 구매 후 나의 서비스 관리에서 설치

E-4. DB

증상	원인	해결
Connection refused	DB 미기동	PG: `systemctl status postgresql@17-main` / Maria: `systemctl status mariadb`
Auth failed	env DB_PASSWORD 불일치	`sudo cat /etc/[프로젝트]/env` 확인
HTTP 200인데 DB 쿼리 다 실패	환경변수 참조 깨짐 (코드 통째 업로드 사고)	위험 5종 매트릭스 참조, env 파일 확인
외부에서 :5432/:3306 접속 안 됨	의도된 동작	DB는 보안상 외부 미노출. SSH 터널로 접속
MariaDB 한글 깨짐	charset 미지정	`?charset=utf8mb4` 또는 `OPTIONS` charset 명시

E-5. 자동 구성 / 초기

증상	원인	해결
결제 후 10분 지나도 접속 안 됨	자동 구성 지연	30분까지 대기 후 고객센터 문의
선택과 다른 프레임워크가 깔림	결제 시 누락 / 시스템 오류	결제 내역 확인 후 고객센터 문의
언어 minor 버전이 다름	minor/patch 자연 상승	정상 동작. 시리즈(메이저) 고정

E-6. 트래픽 / 청구

문의	안내
이번 달 트래픽 사용량	[나의 서비스 관리 → 서버호스팅 관리 → 트래픽 사용량]
트래픽 초과 청구	110원/GB(VAT 포함) x 초과량 익월 후불
월 청구에 트래픽 포함?	기본 트래픽까지 포함, 초과만 별도
트래픽 측정 주기	월 누적 (5분 단위 실시간 X)
트래픽 별도 증설	불가. 더 많은 트래픽 필요 시 상위 요금제 변경
초과 시 서비스 차단?	차단 안 함. 미납 지속 시에만 서버 차단

E-7. 의존성 / 빌드

증상	원인	해결
ImportError (Python)	의존성 미동기화	`sudo -u appuser uv sync` + restart
Cannot find module (Node)	`node_modules/` 미설치	`sudo -u appuser pnpm install` + PM2 restart
ClassNotFoundException (Java)	의존성 미빌드	`./gradlew clean build` + restart
빌드 OOM (Spring Boot · Next.js)	DEV A 메모리 부족	swap 추가 또는 DEV B+ 또는 로컬 빌드 후 산출물만 업로드
`go: command not found` (Go)	로그인 셸이 아닌 방식으로 appuser 전환	`sudo -iu appuser`로 전환 후 빌드
`requires go >= 1.28` (Go)	라이브러리가 서버에 설치된 Go(1.27)보다 높은 버전 요구	라이브러리 버전을 낮추거나 서버 Go를 직접 올림 (Go 운영 가이드 FAQ)
`ERR_PNPM_IGNORED_BUILDS` (React)	`package.json`의 `packageManager`와 다른 pnpm 사용	`packageManager` 값을 실제로 쓰는 pnpm 버전과 맞춤 (기본 pnpm 10)
KeyError env 변수	systemd 외부에서 수동 실행	`set -a; source /etc/[프로젝트]/env; set +a` 후 실행

E-8. PM2 (Node.js (PM2))

증상	원인	해결
`pm2 list` 빈 결과 (root에서)	PM2는 사용자별 데몬	`sudo -u appuser pm2 list`
env 변경 미반영	--update-env 누락	`pm2 restart [프로젝트] --update-env`
재부팅 후 앱 사라짐	`pm2 save` 누락	`sudo -u appuser pm2 save`
메모리 누수	코드 영역	ecosystem `max_memory_restart: '500M'` 임시

E-9. 보안

증상	해결
비밀번호 잊음	카페24 미보관. [나의 서비스 관리 → 서버호스팅 관리 → OS 재설치]로 새 비밀번호 재설정 (데이터 모두 초기화 - 사전 백업 필수)
다른 사람 들어온 흔적	`last`, `/var/log/auth.log` 확인 + 즉시 비밀번호 변경 + SSH 키 인증 강제 + fail2ban 강화
iptables 만지지 말라는데 SSH 포트 변경하고 싶음	`sshd_config`에서 Port 22 외 추가 + 카페24 방화벽관리에서 해당 포트 허용

빠른 명령어 참고

프레임워크별 상태 확인 / 재시작 / 로그	명령
Python · Java (systemd) - 상태	`sudo systemctl is-active [프로젝트]` & `curl -sf 127.0.0.1:8000/`
Node.js (PM2) - 상태	`sudo -u appuser pm2 status` & `curl -sf 127.0.0.1:3000/`
Spring Boot - 상태	`sudo systemctl is-active [프로젝트]` & `curl -sf 127.0.0.1:8080/actuator/health`
Go - 상태	`sudo systemctl is-active [프로젝트]` & `curl -s 127.0.0.1:8080/health`
React - 상태	`sudo -iu appuser pm2 list` & `curl -s 127.0.0.1:3000/api/health`
Go - 코드 반영	appuser에서 `go build -o bin/server .` 후 `sudo systemctl restart [프로젝트]`
React - 코드 반영	appuser에서 화면은 `pnpm build`, API는 `pm2 reload [프로젝트]`
Python · Java (systemd) - 재시작	`sudo systemctl restart [프로젝트]`
Node.js (PM2) - 재시작	`sudo -u appuser pm2 restart [프로젝트] --update-env`
Python · Java (systemd) - 로그	`sudo journalctl -u [프로젝트] -f`
Node.js (PM2) - 로그	`sudo -u appuser pm2 logs [프로젝트] --lines 100`
DB 접속 (PG)	`sudo -u postgres psql`
DB 접속 (Maria)	`sudo mariadb`

목차