VPS에 Dokploy 설치하기 초보자 가이드
소개
서버 관리가 처음이지만 웹 애플리케이션을 호스팅하고 싶으신가요? 걱정하지 마세요! 이 단계별 가이드는 VPS에 Dokploy를 가장 간단한 방법으로 설치하는 과정을 안내해 드립니다. 마지막에는 Dokploy가 미리 설치된 VPS 서버를 제공하는 LightNode에 대해서도 배울 수 있어 더욱 편리하게 이용할 수 있습니다.
준비물
- 최소 2GB RAM과 30GB 저장 공간을 갖춘 VPS (가상 사설 서버)
- 기본적인 명령어 사용법 (걱정 마세요, 쉽게 설명해 드립니다!)
- 약 15~20분의 시간
1단계: VPS 접속하기
먼저 VPS에 연결해야 합니다:
- 제공업체에서 VPS IP 주소와 비밀번호를 확인하세요
- 윈도우: PuTTY 또는 Windows Terminal 사용
- 맥/리눅스: 터미널 열기
SSH로 접속하는 명령어는 다음과 같습니다:
ssh root@your-vps-ip
"your-vps-ip"를 실제 VPS IP 주소로 바꾸세요. 비밀번호 입력을 요청하면 입력합니다.
축하합니다! 이제 서버에 연결되었습니다.
2단계: Dokploy 설치하기
Dokploy는 웹 애플리케이션 배포를 위한 강력하면서도 사용자 친화적인 플랫폼입니다. 설치해 봅시다:
- 다음 한 줄 명령어로 Dokploy를 설치하세요 (Docker도 함께 설치됩니다):
curl -sSL https://dokploy.com/install.sh | sh
-
설치가 자동으로 진행되니 잠시 기다리세요. 서버 속도에 따라 5~10분 정도 걸릴 수 있습니다.
-
"Dokploy has been successfully installed" 메시지가 보이면 설치가 완료된 것입니다!
3단계: Dokploy 설정하기
이제 Dokploy가 설치되었으니 설정을 진행합니다:
- 웹 브라우저를 열고 다음 주소로 접속하세요:
http://your-vps-ip:3000
-
Dokploy 설정 페이지가 나타납니다. 관리자 계정을 만드세요:
- 사용자 이름 선택 (예: "admin")
- 강력한 비밀번호 설정 (잊지 마세요!)
- "Save" 클릭
-
이제 Dokploy 대시보드에 접속했습니다! 여기서 모든 애플리케이션을 관리할 수 있습니다.
4단계: 첫 번째 애플리케이션 배포하기
샘플 애플리케이션을 배포해 보며 테스트해 봅시다:
-
Dokploy 대시보드에서 "New Project" 클릭
-
세부 정보 입력:
- 프로젝트 이름: "test-app"
- Git 제공자: GitHub, GitLab 또는 직접 URL 선택
- 저장소 URL: 코드 저장소 URL 입력
- 브랜치: "main" (또는 배포할 브랜치)
-
빌드 설정 선택:
- 대부분 웹 애플리케이션은 "Railpack" 선택
- 빌드 명령어: 애플리케이션에 따라 다름 (예: "npm run build")
- 시작 명령어: 앱 실행 방법 (예: "npm start")
-
"Create Project" 클릭
-
"Deploy" 클릭하여 배포 시작
배포 진행 상황을 실시간으로 확인할 수 있습니다. 완료되면 Dokploy가 애플리케이션에 접속할 수 있는 URL을 제공합니다!
5단계: 애플리케이션 관리하기
배포 후에는 다음을 할 수 있습니다:
- "Logs" 탭에서 로그 확인
- "Domains" 섹션에서 커스텀 도메인 설정
- "Environment" 탭에서 환경 변수 추가
- 필요 시 애플리케이션 재시작 또는 재배포
LightNode 소개: 더 쉬운 방법
이 모든 설정이 부담스럽다면, 더 간단한 방법이 있습니다: LightNode!
LightNode란?
LightNode는 Dokploy가 미리 설치된 VPS 서버를 제공하여 시간과 노력을 절약해 줍니다. 초보자에게 완벽한 이유는 다음과 같습니다:
- 즉시 사용 가능: Dokploy가 이미 설치 및 구성되어 있음
- 사용자 친화적: 바로 애플리케이션 배포 시작 가능
- 최적화된 성능: 웹 애플리케이션에 최적화된 서버
LightNode 시작 방법
- LightNode 웹사이트 방문
- 필요에 맞는 서버 플랜 선택
- 회원가입 절차 완료
- 로그인 정보 즉시 수신
- 미리 구성된 Dokploy 인스턴스에 로그인
- 바로 애플리케이션 배포 시작!
LightNode를 이용하면 이 가이드의 1단계와 2단계를 건너뛰고 바로 애플리케이션 배포로 넘어갈 수 있습니다.
자주 발생하는 문제 해결 팁
- Dokploy에 연결할 수 없나요? 방화벽에서 포트 3000이 열려 있는지 확인하세요
- 배포 실패? 애플리케이션 로그에서 구체적인 오류 확인
- 웹사이트가 로드되지 않나요? 시작 명령어가 올바른지 점검
- 메모리 부족? VPS 플랜 업그레이드 고려
축하합니다! VPS에 Dokploy를 성공적으로 설치했고, LightNode라는 대안도 알게 되셨습니다. 직접 설정하든 미리 설치된 솔루션을 이용하든, 이제 전문가처럼 웹 애플리케이션을 배포하고 관리할 준비가 되셨습니다.

자주 묻는 질문 (FAQ)
Q: Dokploy가 정확히 무엇인가요?
A: Dokploy는 웹 애플리케이션 배포를 위한 가볍고 사용자 친화적인 플랫폼입니다. 코드 저장소에서 라이브 웹사이트로 쉽게 배포할 수 있도록 도와줍니다.
Q: Dokploy를 사용하려면 코딩 경험이 필요한가요?
A: 애플리케이션 코드에 대한 기본적인 이해가 도움이 되지만, Dokploy는 최소한의 기술 경험자도 쉽게 사용할 수 있도록 설계되었습니다. 인터페이스가 직관적이고 간단합니다.
Q: 한 Dokploy 인스턴스에서 여러 애플리케이션을 호스팅할 수 있나요?
A: 네! 서버 자원이 허용하는 한 여러 애플리케이션을 배포할 수 있습니다. 각 애플리케이션은 독립된 환경에서 실행됩니다.
설치 관련 질문
Q: Dokploy는 어떤 운영체제를 지원하나요?
A: Dokploy는 Ubuntu 20.04 이상에서 가장 잘 작동합니다. 다른 리눅스 배포판에서도 작동할 수 있으나, Windows나 macOS는 공식적으로 호스트 시스템으로 지원하지 않습니다.
Q: 설치는 보통 얼마나 걸리나요?
A: 적절한 VPS에서는 보통 5~10분 정도 소요됩니다. 서버의 인터넷 연결 속도와 처리 능력에 따라 다릅니다.
Q: Dokploy로 어떤 종류의 애플리케이션을 배포할 수 있나요?
A: Node.js, Python, Ruby, PHP, Go 등 거의 모든 웹 애플리케이션을 지원합니다. 특히 Next.js, React, Vue, Django 같은 최신 프레임워크에 적합합니다.
Q: 변경 사항을 적용하려면 어떻게 업데이트하나요?
A: 변경 사항을 Git 저장소에 푸시한 후 Dokploy 대시보드에서 "Deploy"를 클릭하세요. Dokploy가 최신 코드를 가져와 애플리케이션을 다시 빌드합니다.
Q: 민감한 정보를 위한 환경 변수를 사용할 수 있나요?
A: 물론입니다! Dokploy는 API 키, 데이터베이스 비밀번호 등 코드에 포함시키지 말아야 할 민감한 정보를 안전하게 저장할 수 있는 환경 변수 기능을 제공합니다.