Python Django 강좌 : 제 2강 - 프로젝트 생성

Django Project

장고(Django)를 원활하게 사용하기 위해선 기본 프로젝트 구성을 사용합니다.

기본 프로젝트를 사용할 폴더로 이동합니다.

django-admin startproject daehee .

django-admin startproject [프로젝트 이름]을 통해 장고 기본 프로젝트 생성이 가능합니다.

만약, django-admin startproject [프로젝트 이름] .의 형태로 온점(.)을 추가한다면 현재 디렉토리에서 생성합니다.

온점(.)을 생략한다면 [프로젝트 이름] 폴더가 하나 더 생성되고, 그 안에 아래의 구조가 만들어집니다.

정상적으로 프로젝트가 생성된다면 아래의 디렉토리 구조로 폴더와 파일이 생성됩니다.

[현재 프로젝트]/
  ⬇ 📁 [장고 프로젝트 이름]
    🖹 __init__.py
    🖹 asgi.py
    🖹 settings.py
    🖹 urls.py
    🖹 wsgi.py
  🖹 manage.py

[장고 프로젝트 이름] : django-admin startproject로 생성한 프로젝트 이름입니다. 프로젝트 실행을 위한 Python 패키지가 저장됩니다.

__init__.py : 해당 폴더를 패키지로 인식합니다.

asgi.py : 현재 프로젝트를 서비스하기 위한 ASGI(Asynchronous Server Gateway Interface) 호환 웹 서버의 진입점입니다.

settings.py : 현재 Django 프로젝트의 환경 및 구성을 설정합니다.

urls.py : 현재 Django 프로젝트의 URL을 설정합니다.

wsgi.py : 현재 프로젝트를 서비스하기 위한 WSGI(Web Server Gateway Interface) 호환 웹 서버의 진입점입니다.

manage.py : 현재 Django 프로젝트를 관리하고 실행하기 위한 커맨드라인 유틸리티입니다.

현재 프로젝트의 파일에서 가장 중요한 요소는 settings.py, urls.py, manage.py 입니다.

위 세 가지 파일 중, manage.py를 제외하고 직접 수정해 변경합니다.

• Tip : 일반적으로 manage.py는 수정하지 않습니다.

• Tip : 프로젝트 이름으로 django, test처럼 Python 내장 모듈이나 장고 패키지와 같은 이름은 사용할 수 없습니다.

Django Test RunServer

먼저 간단하게 manage.py를 활용해 Django 서버를 구동해보겠습니다.

manage.py가 존재하는 디렉토리로 이동합니다.

디렉토리 이동은 cd [장고 프로젝트 이름] 등으로 이동할 수 있습니다.

python manage.py runserver

결과

Watching for file changes with StatReloader
Performing system checks…

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run ‘python manage.py migrate’ to apply them.
November 01, 2026 - 21:37:44
Django version 6.1.2, using settings ‘daehee.settings’
Starting WSGI development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.

WARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.
For more information on production servers see: https://docs.djangoproject.com/en/6.1/howto/deployment/
[01/Nov/2026 21:37:48] “GET / HTTP/1.1” 200 12149

서버를 구동하게 되면 파일 변경 사항 감시, 시스템 점검, 마이그레이션 점검, 설정 반영 등을 통해 프로젝트를 실행시킵니다.

테스트 프로젝트는 http://127.0.0.1:8000/에서 확인할 수 있습니다.

해당 url로 이동해 서버가 정상적으로 구동되는지 확인합니다.

서버를 종료하려면, Ctrl + C키를 눌러 서버를 종료할 수 있습니다.

runserver는 개발용 서버이므로, 실제 서비스에는 Gunicorn, uWSGI(WSGI)나 Uvicorn, Daphne(ASGI) 같은 운영용 서버를 사용해야 합니다.

• Tip : 마이그레이션 경고는 장고 기본 앱의 테이블이 아직 데이터베이스에 생성되지 않아 나타나는 경고입니다. 4강에서 migrate 명령어로 적용합니다.

• Tip : 개발 서버는 코드가 변경되면 자동으로 재시작됩니다. 단, 새 파일을 추가하는 등 일부 상황에서는 직접 재시작해야 합니다.

현재 포트는 8000에 연결되어 있습니다. 만약 포트를 변경하거나 외부접속을 허용한다면 다음과 같이 명령어를 작성합니다.

python manage.py runserver 8080
python manage.py runserver 0:8080

python manage.py runserver 뒤에 8080을 추가해 포트를 8080으로 변경할 수 있습니다.

python manage.py runserver 뒤에 0:8080을 추가해 외부 접속을 허용하고 포트를 8080으로 변경합니다.

• Tip : 기본 포트는 8000번입니다.

• Tip : 0은 0.0.0.0의 축약으로, 모든 네트워크 인터페이스에서 접속을 허용합니다.

• Tip : 외부에서 접속하려면 settings.py의 ALLOWED_HOSTS에 접속할 호스트(IP 또는 도메인)를 등록해야 합니다. 등록하지 않은 호스트로 접속하면 Bad Request (400)가 반환됩니다.