software

Part 2: 첫 번째 Django 프로젝트 설정

발행: (2025년 12월 10일 오전 03:55 GMT+9)
8 min read
원문: Dev.to

Source: Dev.to

이 시리즈 “소셜 미디어 앱을 만들며 백엔드 개발 배우기”의 파트 2입니다.

다시 오신 것을 환영합니다! 이전 파트에서는 백엔드가 무엇인지, 그리고 현대 앱 안에서 거의 모든 것을 조용히 어떻게 구동하는지 배웠습니다. 이제 실제 첫 걸음, 즉 여러분의 컴퓨터에서 백엔드 프로젝트를 만드는 단계로 넘어갑니다.

이 장이 끝날 때쯤이면 여러분의 머신에서 실행 중인 Django 프로젝트가 준비되어 있을 것입니다. 브라우저 창이 처음으로 열리고 백엔드가 응답하는 모습을 보면 여정이 실감 나게 시작됩니다.

설치하려는 도구들 이해하기

Python

Python은 Django가 실행되는 언어입니다. 레시피의 기본 재료와 같으며, 이것 없이는 아무것도 동작하지 않습니다.

Django

Django는 웹사이트와 백엔드를 빠르게 만들 수 있게 해 주는 프레임워크입니다. 구조, 도구, 그리고 많은 내장 기능을 제공합니다.

Django REST Framework (DRF)

DRF는 Django에 추가되는 플러그인으로, API를 구축해 앱(Android, iOS, Web)이 백엔드와 쉽게 통신하도록 도와줍니다.
오늘은 DRF를 설치하지 않고, 먼저 Django를 시작한 뒤 나중에 추가할 예정입니다.

Django를 설치하면 어떤 일이 일어나나요?

Django를 설치하면 여러분의 컴퓨터에 다음과 같은 도구들이 들어있는 도구함이 생깁니다:

  • 데이터베이스와 통신하는 도구
  • 사용자 관리를 위한 도구
  • URL을 구축하는 도구
  • 모델을 만드는 도구
  • 데이터를 렌더링하는 도구
  • 정보를 검증하는 도구
  • 전체 프로젝트를 구조화하는 도구

Django는 잘 정돈된 주방과 같습니다. 모든 것이 목적을 가지고 있으며, 무작위로 배치되지 않습니다.

1단계: Python 설치

Python 3.10 이상이 이미 설치되어 있다면 바로 진행하면 됩니다. 없으면 python.org에서 다운로드하세요.

Windows: 설치 중 Add Python to PATH 옵션을 반드시 체크하세요.

설치가 끝나면 터미널(명령 프롬프트, PowerShell, macOS/Linux 터미널 등)을 열고 다음을 실행합니다:

python --version

Python 3.10 혹은 Python 3.11과 같은 버전이 출력되면 준비가 된 것입니다.

2단계: 프로젝트 폴더 만들기

백엔드 프로젝트를 저장할 위치를 정하고 폴더를 생성합니다. 예시:

mkdir social_media_backend
cd social_media_backend

VS Code 혹은 선호하는 편집기로 이 폴더를 엽니다.

3단계: 가상 환경 만들기

가상 환경은 다른 프로젝트와 격리된 독립적인 Python 환경입니다.

다음 명령으로 생성합니다:

python -m venv venv

활성화 방법:

  • Windows

    venv\Scripts\activate

  • macOS/Linux

    source venv/bin/activate

터미널 프롬프트 앞에 (venv)가 표시되면 정상적으로 활성화된 것입니다.

4단계: Django 설치

가상 환경이 활성화된 상태에서 Django를 설치합니다:

pip install django

설치가 제대로 되었는지 확인합니다:

django-admin --version

버전 번호가 출력되면 성공적인 설치입니다.

5단계: Django 프로젝트 만들기

social_media_backend 디렉터리 안에서 다음 명령을 실행합니다:

django-admin startproject core .
  • django-admin – Django의 명령줄 도구
  • startproject – 새 프로젝트를 생성
  • core – 프로젝트 패키지 이름
  • . – 현재 디렉터리에 파일을 생성 (새 하위 폴더 대신)

프로젝트 구조

명령 실행 후 디렉터리는 다음과 같이 구성됩니다:

social_media_backend/
│
├── core/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   ├── asgi.py
│   └── wsgi.py
│
└── manage.py

Django 프로젝트 구조 이해하기

manage.py

프로젝트를 제어하는 원격 조종기입니다. 서버 시작, 마이그레이션 적용, 앱 생성, 커스텀 명령 실행 등에 사용합니다.

settings.py

Django가 수행하는 모든 설정을 담당합니다: 데이터베이스 설정, 설치된 앱, 보안, 인증 등.

urls.py

URL을 해당 코드를 처리하도록 매핑합니다.

asgi.py와 wsgi.py

프로젝트를 웹 서버와 연결합니다. 아직 수정할 필요는 없지만, 배포 시 중요해집니다.

6단계: 백엔드 처음 실행하기

개발 서버를 시작합니다:

python manage.py runserver

다음과 비슷한 출력이 보일 것입니다:

Starting development server at http://127.0.0.1:8000/

브라우저를 열고 http://127.0.0.1:8000/에 접속하세요. Django 환영 페이지가 나타날 것입니다.

Django 환영 페이지

이 순간은 백엔드가 살아났다는 신호이며, 백엔드 개발자로서의 여정이 공식적으로 시작된 것입니다.

현재 프로젝트를 한눈에 보는 간단한 다이어그램

시스템 흐름도

앞으로 만들 로그인, 게시물, 알림, 스토리 등 모든 기능은 이 간단한 실행 서버에서 시작됩니다.

파트 3에서 다룰 내용

프로젝트가 생성되고 실행되었으니 이제 사용자를 이해할 차례입니다. 파트 3에서는 다음을 다룰 예정입니다:

  • 데이터베이스 작동 원리
  • 모델이란 무엇인가
  • Django가 데이터를 저장하는 방식
  • 커스텀 사용자 모델 설계
  • 사용자 등록

많은 기대 부탁드립니다!

Back to Blog

관련 글

더 보기 »