VPS에 Dokploy 설치하기 초보자 가이드

LightNode
작성자 LightNode ·

소개

서버 관리가 처음이지만 웹 애플리케이션을 호스팅하고 싶으신가요? 걱정하지 마세요! 이 단계별 가이드는 VPS에 Dokploy를 가장 간단한 방법으로 설치하는 과정을 안내해 드립니다. 마지막에는 Dokploy가 미리 설치된 VPS 서버를 제공하는 LightNode에 대해서도 배울 수 있어 더욱 편리하게 이용할 수 있습니다.

준비물

  • 최소 2GB RAM과 30GB 저장 공간을 갖춘 VPS (가상 사설 서버)
  • 기본적인 명령어 사용법 (걱정 마세요, 쉽게 설명해 드립니다!)
  • 약 15~20분의 시간

1단계: VPS 접속하기

먼저 VPS에 연결해야 합니다:

  1. 제공업체에서 VPS IP 주소와 비밀번호를 확인하세요
  2. 윈도우: PuTTY 또는 Windows Terminal 사용
  3. 맥/리눅스: 터미널 열기

SSH로 접속하는 명령어는 다음과 같습니다:

ssh root@your-vps-ip

"your-vps-ip"를 실제 VPS IP 주소로 바꾸세요. 비밀번호 입력을 요청하면 입력합니다.

축하합니다! 이제 서버에 연결되었습니다.

2단계: Dokploy 설치하기

Dokploy는 웹 애플리케이션 배포를 위한 강력하면서도 사용자 친화적인 플랫폼입니다. 설치해 봅시다:

  1. 다음 한 줄 명령어로 Dokploy를 설치하세요 (Docker도 함께 설치됩니다):
curl -sSL https://dokploy.com/install.sh | sh
  1. 설치가 자동으로 진행되니 잠시 기다리세요. 서버 속도에 따라 5~10분 정도 걸릴 수 있습니다.

  2. "Dokploy has been successfully installed" 메시지가 보이면 설치가 완료된 것입니다!

3단계: Dokploy 설정하기

이제 Dokploy가 설치되었으니 설정을 진행합니다:

  1. 웹 브라우저를 열고 다음 주소로 접속하세요:
http://your-vps-ip:3000
  1. Dokploy 설정 페이지가 나타납니다. 관리자 계정을 만드세요:

    • 사용자 이름 선택 (예: "admin")
    • 강력한 비밀번호 설정 (잊지 마세요!)
    • "Save" 클릭
  2. 이제 Dokploy 대시보드에 접속했습니다! 여기서 모든 애플리케이션을 관리할 수 있습니다.

4단계: 첫 번째 애플리케이션 배포하기

샘플 애플리케이션을 배포해 보며 테스트해 봅시다:

  1. Dokploy 대시보드에서 "New Project" 클릭

  2. 세부 정보 입력:

    • 프로젝트 이름: "test-app"
    • Git 제공자: GitHub, GitLab 또는 직접 URL 선택
    • 저장소 URL: 코드 저장소 URL 입력
    • 브랜치: "main" (또는 배포할 브랜치)
  3. 빌드 설정 선택:

    • 대부분 웹 애플리케이션은 "Railpack" 선택
    • 빌드 명령어: 애플리케이션에 따라 다름 (예: "npm run build")
    • 시작 명령어: 앱 실행 방법 (예: "npm start")
  4. "Create Project" 클릭

  5. "Deploy" 클릭하여 배포 시작

배포 진행 상황을 실시간으로 확인할 수 있습니다. 완료되면 Dokploy가 애플리케이션에 접속할 수 있는 URL을 제공합니다!

5단계: 애플리케이션 관리하기

배포 후에는 다음을 할 수 있습니다:

  1. "Logs" 탭에서 로그 확인
  2. "Domains" 섹션에서 커스텀 도메인 설정
  3. "Environment" 탭에서 환경 변수 추가
  4. 필요 시 애플리케이션 재시작 또는 재배포

LightNode 소개: 더 쉬운 방법

이 모든 설정이 부담스럽다면, 더 간단한 방법이 있습니다: LightNode!

LightNode란?

LightNode는 Dokploy가 미리 설치된 VPS 서버를 제공하여 시간과 노력을 절약해 줍니다. 초보자에게 완벽한 이유는 다음과 같습니다:

  • 즉시 사용 가능: Dokploy가 이미 설치 및 구성되어 있음
  • 사용자 친화적: 바로 애플리케이션 배포 시작 가능
  • 최적화된 성능: 웹 애플리케이션에 최적화된 서버

LightNode 시작 방법

  1. LightNode 웹사이트 방문
  2. 필요에 맞는 서버 플랜 선택
  3. 회원가입 절차 완료
  4. 로그인 정보 즉시 수신
  5. 미리 구성된 Dokploy 인스턴스에 로그인
  6. 바로 애플리케이션 배포 시작!

LightNode를 이용하면 이 가이드의 1단계와 2단계를 건너뛰고 바로 애플리케이션 배포로 넘어갈 수 있습니다.

LightNode에서 Dokploy VPS 구매하기

자주 발생하는 문제 해결 팁

  • Dokploy에 연결할 수 없나요? 방화벽에서 포트 3000이 열려 있는지 확인하세요
  • 배포 실패? 애플리케이션 로그에서 구체적인 오류 확인
  • 웹사이트가 로드되지 않나요? 시작 명령어가 올바른지 점검
  • 메모리 부족? VPS 플랜 업그레이드 고려

축하합니다! VPS에 Dokploy를 성공적으로 설치했고, LightNode라는 대안도 알게 되셨습니다. 직접 설정하든 미리 설치된 솔루션을 이용하든, 이제 전문가처럼 웹 애플리케이션을 배포하고 관리할 준비가 되셨습니다.

Dokploy VPS

자주 묻는 질문 (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 키, 데이터베이스 비밀번호 등 코드에 포함시키지 말아야 할 민감한 정보를 안전하게 저장할 수 있는 환경 변수 기능을 제공합니다.