--- title: "Django 문서" version: 5.0 locale: ko source: https://docs.djangoproject.com/ko/5.0/ canonical: https://djangodocs.dev/ko/5.0/ --- # Django 문서 **장고에 대해 알아야 할 모든 것** ## 첫걸음 Django 또는 프로그래밍이 처음이신가요? 이곳에서 시작하세요! - **바닥부터 시작하기:** [개요](/ko/5.0/intro/overview/) | [설치](/ko/5.0/intro/install/) - **튜토리얼:** [Part 1: 요청과 응답](/ko/5.0/intro/tutorial01/) | [Part 2: 모델과 관리자 사이트](/ko/5.0/intro/tutorial02/) | [Part 3: 뷰와 템플릿](/ko/5.0/intro/tutorial03/) | [Part 4: 폼과 제네릭 뷰](/ko/5.0/intro/tutorial04/) | [Part 5: 테스팅](/ko/5.0/intro/tutorial05/) | [Part 6: 정적 파일](/ko/5.0/intro/tutorial06/) | [Part 7: 관리자 사이트 커스터마이징](/ko/5.0/intro/tutorial07/) | [Part 8: 서드 파티 패키지 추가하기](/ko/5.0/intro/tutorial08/) - **Advanced Tutorials:** [How to write reusable apps](/ko/5.0/intro/reusable-apps/) | [Writing your first contribution to Django](/ko/5.0/intro/contributing/) ## 도움말 문제가 있나요? 도와드리고 싶어요! - [FAQ](/ko/5.0/faq/)를 참고하세요 – 흔한 질문에 대한 답변을 얻을 수 있습니다. - 특정 정보를 찾으시나요? [색인](/ko/5.0/genindex/), [모듈 목록](/ko/5.0/py-modindex/) 또는 [상세한 목차](/ko/5.0/contents/) 를 이용하세요. - 해결법을 못 찾으셨나요? [자주 묻는 질문: 도움을 받는법](/ko/5.0/faq/help/) 에서 도움을 받는 방법과 커뮤니티에 질문하는 법을 확인하세요. - [ticket tracker](https://code.djangoproject.com/) 를 통해 장고로 버그를 레포트 하세요 ## 이 문서의 구조 Django는 문서가 아주 많습니다. 높은 수준에서의 개요를 알면 원하는 정보를 어떤 문서에서 찾을지 알 수 있습니다. - [자습서](/ko/5.0/intro/)는 웹 애플리케이션을 만드는 모든 과정을 자세히 설명합니다. Django 또는 웹 애플리케이션 개발이 처음이라면 여기에서 시작하세요. 또한 “[첫걸음](#index-first-steps)” 도 살펴보세요. - [주제 안내](/ko/5.0/topics/) 주요 주제와 개념을 높은 수준에서 논의하고 유용한 배경 지식과 설명을 제공합니다. - [레퍼런스 가이드](/ko/5.0/ref/) API와 Django의 여러 기능들에 대한 기술적 레퍼런스를 담고 있습니다. 이 가이드는 독자가 기본적인 주요 개념에 대해 이해하고 있다고 가정하고, 어떻게 동작하고 사용하는지 설명합니다. - [How-to 가이드](/ko/5.0/howto/)는 레시피입니다. 주요 문제와 사용 사례들의 해결 방법들을 단계별로 안내해 줍니다. 여기서는 Django가 어떻가 동작하는지 알고 있다고 가정하고 튜토리얼보다 심화된 내용을 다룹니다. ## 모델 계층 Django는 웹 애플리케이션의 데이터를 구조화하고 조작하기 위한 추상적 계층(모델)을 제공합니다. 아래에서 자세히 알아보세요. - **모델:** [모델 소개](/ko/5.0/topics/db/models/) | [필드 타입](/ko/5.0/ref/models/fields/) | [인덱스](/ko/5.0/ref/models/indexes/) | [메타 옵션](/ko/5.0/ref/models/options/) | [모델 클래스](/ko/5.0/ref/models/class/) - **쿼리셋:** [쿼리 실행하기](/ko/5.0/topics/db/queries/) | [쿼리셋 메소드 레퍼런스](/ko/5.0/ref/models/querysets/) | [룩업 표현식](/ko/5.0/ref/models/lookups/) - **모델 인스턴스:** [인스턴스 메소드](/ko/5.0/ref/models/instances/) | [관련 객체에 접근하기](/ko/5.0/ref/models/relations/) - **마이그레이션:** [마이그레이션 소개](/ko/5.0/topics/migrations/) | [연산자 레퍼런스](/ko/5.0/ref/migration-operations/) | [스키마에디터](/ko/5.0/ref/schema-editor/) | [마이그레션 작성하기](/ko/5.0/howto/writing-migrations/) - **심화:** [매니저](/ko/5.0/topics/db/managers/) | [Raw SQL](/ko/5.0/topics/db/sql/) | [트랜잭션](/ko/5.0/topics/db/transactions/) | [집계](/ko/5.0/topics/db/aggregation/) | [검색](/ko/5.0/topics/db/search/) | [맞춤 필드](/ko/5.0/howto/custom-model-fields/) | [다중 데이터베이스](/ko/5.0/topics/db/multi-db/) | [맞춤 룩업](/ko/5.0/howto/custom-lookups/) | [쿼리 표현식](/ko/5.0/ref/models/expressions/) | [조건식](/ko/5.0/ref/models/conditional-expressions/) | [데이터베이스 함수](/ko/5.0/ref/models/database-functions/) - **그 외:** [지원되는 데이터베이스](/ko/5.0/ref/databases/) | [레거시 데이터베이스](/ko/5.0/howto/legacy-databases/) | [초기 데이터 제공](/ko/5.0/howto/initial-data/) | [데이터베이스 접근 최적화](/ko/5.0/topics/db/optimization/) | [PostgreSQL만의 기능](/ko/5.0/ref/contrib/postgres/) ## 뷰 계층 Django는 사용자의 요청을 처리하고 결과를 반환하기 위한 로직을 캡슐화한 “뷰”의 개념을 갖고 있습니다. 뷰에 대하여 알아야할 모든 것을 아래 링크에서 찾아보세요. - **기본 사항:**[URL 구성](/ko/5.0/topics/http/urls/) [View 함수](/ko/5.0/topics/http/views/) | [Shortcuts 패키지](/ko/5.0/topics/http/shortcuts/) | [데코레이터](/ko/5.0/topics/http/decorators/) | [비동기 지원](/ko/5.0/topics/async/) - **레퍼런스** [내장된 뷰](/ko/5.0/ref/views/) | [Request/response 객체](/ko/5.0/ref/request-response/) | [TemplateResponse 객체](/ko/5.0/ref/template-response/) - **파일 업로드** [개요](/ko/5.0/topics/http/file-uploads/) | [File 객체](/ko/5.0/ref/files/file/) | [스토리지 API](/ko/5.0/ref/files/storage/) | [파일 다루기](/ko/5.0/topics/files/) | [커스텀 스토리지](/ko/5.0/howto/custom-file-storage/) - **클래스 기반 뷰:** [개요](/ko/5.0/topics/class-based-views/) | [내장된 디스플레이 뷰](/ko/5.0/topics/class-based-views/generic-display/) | [내장된 편집 뷰](/ko/5.0/topics/class-based-views/generic-editing/) | [믹스인 사용하기](/ko/5.0/topics/class-based-views/mixins/) | [API 레퍼런스](/ko/5.0/ref/class-based-views/) | [납작한 인덱스](/ko/5.0/ref/class-based-views/flattened-index/) - **심화:** [CSV 생성](/ko/5.0/howto/outputting-csv/) | [PDF 생성](/ko/5.0/howto/outputting-pdf/) - **미들웨어:** [개요](/ko/5.0/topics/http/middleware/) | [내장된 미들웨어 클래스](/ko/5.0/ref/middleware/) ## 템플릿 계층 템플릿 계층은 사용자에게 표시할 정보를 표현하기 위해 디자이너에게 친숙한 문법을 제공합니다. 디자이너들이 이 문법을 사용하는 방법과 프로그래머들이 확장하기 위한 방법을 알아보세요. - **기초:** [개요](/ko/5.0/topics/templates/) - **디자이너:** [언어 개요](/ko/5.0/ref/templates/language/) | [빌트인 태그와 필터](/ko/5.0/ref/templates/builtins/) | [휴머나이제이션](/ko/5.0/ref/contrib/humanize/) - **프로그래머:** [템플릿 API](/ko/5.0/ref/templates/api/) | [커스텀 태그와 필터](/ko/5.0/howto/custom-template-tags/) | [커스텀 템플릿 백엔드](/ko/5.0/howto/custom-template-backend/) ## 폼 Django는 쉽게 폼을 만들고 폼 데이터를 다루기 위한 풍부한 프레임워크를 제공합니다. - **기초:** [개요](/ko/5.0/topics/forms/) | [폼 API](/ko/5.0/ref/forms/api/) | [내장된 필드](/ko/5.0/ref/forms/fields/) | [내장된 위젯](/ko/5.0/ref/forms/widgets/) - **고급:** [모델을 위한 폼](/ko/5.0/topics/forms/modelforms/) | [미디어 통합](/ko/5.0/topics/forms/media/) | [폼셋](/ko/5.0/topics/forms/formsets/) | [맞춤 유효성 검증](/ko/5.0/ref/forms/validation/) ## 개발 프로세스 여러 구성 요소들과 Django 애플리케이션의 개발과 테스트를 도와줄 다양한 도구들을 알아보세요. - **설정:** [개요](/ko/5.0/topics/settings/) | [전체 설정 목록](/ko/5.0/ref/settings/) - **애플리케이션.** [개요](/ko/5.0/ref/applications/) - **예외:** [개요](/ko/5.0/ref/exceptions/) - **django-admin과 manage.py:** [개요](/ko/5.0/ref/django-admin/) | [맞춤 명령 추가하기](/ko/5.0/howto/custom-management-commands/) - **테스팅:** [소개](/ko/5.0/topics/testing/) | [테스트를 작성하고 실행하기](/ko/5.0/topics/testing/overview/) | [내장된 테스팅 도구](/ko/5.0/topics/testing/tools/) | [심화 주제](/ko/5.0/topics/testing/advanced/) - **배포:** [Django 배포 개요](/ko/5.0/howto/deployment/) | [WSGI 서버](/ko/5.0/howto/deployment/wsgi/) | ASGI 서버 | [이메일로 에러 코드 추적하기](/ko/5.0/howto/error-reporting/) | [배포 전 체크리스트](/ko/5.0/howto/deployment/checklist/) ## 관리자 Django의 가장 인기 있는 기능 중 하나인 자동적 관리 인터페이스를 이해하기 위한 모든 것들을 찾아보세요: - [Admin 사이트](/ko/5.0/ref/contrib/admin/) - [Admin 액션](/ko/5.0/ref/contrib/admin/actions/) - [Admin 문서 생성기](/ko/5.0/ref/contrib/admin/admindocs/) ## 보안 보안은 웹 애플리케이션 개발에서 가장 중요한 주제이며 Django는 여러 보호 도구와 메커니즘을 제공합니다. - [보안 개요](/ko/5.0/topics/security/) - [Django에서 알려진 보안 문제](/ko/5.0/releases/security/) - [클릭재킹 방어](/ko/5.0/ref/clickjacking/) - [사이트 간 요청 위조](/ko/5.0/ref/csrf/) - [암호화 서명](/ko/5.0/topics/signing/) - [보안 미들웨어](/ko/5.0/ref/middleware/#security-middleware) ## 국제화와 지역화 Django는 강력한 국제화와 지역화 프레임워크를 제공하여, 여러 언어와 세계 여러 지역을 위한 어플리케이션 개발을 지원합니다: - [개요](/ko/5.0/topics/i18n/) | [국제화](/ko/5.0/topics/i18n/translation/) | [지역화](/ko/5.0/topics/i18n/translation/#how-to-create-language-files) | [지역화 된 웹 UI 형식과 폼 입력](/ko/5.0/topics/i18n/formatting/) - [표준 시간대](/ko/5.0/topics/i18n/timezones/) ## 성능과 최적화 코드를 더욱 빠르고 더 적은 시스템 자원을 사용하여 효율적으로 실행 할 수 있는 다양한 기법과 도구들이 있습니다. - [성능과 최적화 개요](/ko/5.0/topics/performance/) ## 지리 프레임워크 [GeoDjango](/ko/5.0/ref/contrib/gis/)는 세계적 수준의 지리 웹 프레임워크가 되려고 합니다. 가능한 GIS 웹 애플리케이션을 쉽게 만들고, 공간 데이터의 성능을 충분히 활용하는 것이 목표입니다. ## 일반적인 웹 애플리케이션 도구 Django는 웹 애플리케이션들의 개발에 보편적으로 필요한 여러가지 기능들을 제공합니다. - **인증:** [개요](/ko/5.0/topics/auth/) | [인증 시스템 사용하기](/ko/5.0/topics/auth/default/) | [비밀번호 관리](/ko/5.0/topics/auth/passwords/) | [맞춤 인증](/ko/5.0/topics/auth/customizing/) | [API 참조](/ko/5.0/ref/contrib/auth/) - [캐싱](/ko/5.0/topics/cache/) - [로깅](/ko/5.0/topics/logging/) - [이메일 보내기](/ko/5.0/topics/email/) - [신디케이션 피드 (RSS/Atom)](/ko/5.0/ref/contrib/syndication/) - [페이지네이션](/ko/5.0/topics/pagination/) - [메세지 프레임워크](/ko/5.0/ref/contrib/messages/) - [직렬화](/ko/5.0/topics/serialization/) - [세션](/ko/5.0/topics/http/sessions/) - [사이트맵](/ko/5.0/ref/contrib/sitemaps/) - [정적 파일 관리](/ko/5.0/ref/contrib/staticfiles/) - [데이터 유효성 검증](/ko/5.0/ref/validators/) ## 다른 핵심 기능들 Django 프레임워크의 다른 핵심 기능들에 대해 좀 더 배우기: - [조건부 콘텐츠 처리](/ko/5.0/topics/conditional-view-processing/) - [콘텐츠 타입과 제네릭 릴레이션](/ko/5.0/ref/contrib/contenttypes/) - [플랫페이지](/ko/5.0/ref/contrib/flatpages/) - [리다이렉션](/ko/5.0/ref/contrib/redirects/) - [시그널](/ko/5.0/topics/signals/) - [시스템 점검 프레임워크](/ko/5.0/topics/checks/) - [sites 프레임워크](/ko/5.0/ref/contrib/sites/) - [Django의 유니코드](/ko/5.0/ref/unicode/) ## Django 오픈 소스 프로젝트 Django의 개발과정을 알아보고 어떻게 기여할 수 있는지 알아보세요. - **커뮤니티:** [참여 방법](/ko/5.0/internals/contributing/) | [릴리스 과정](/ko/5.0/internals/release-process/) | [팀 구성](/ko/5.0/internals/organization/) | [Django 소스 코드 저장소](/ko/5.0/internals/git/) | [보안 정책](/ko/5.0/internals/security/) | [메일링 리스트와 포럼](/ko/5.0/internals/mailing-lists/) - **디자인 철학:** [개요](/ko/5.0/misc/design-philosophies/) - **문서:** [이 문서에 대하여](/ko/5.0/internals/contributing/writing-documentation/) - **써드파티 분포:** [개요](/ko/5.0/misc/distributions/) - **Django의 장기 계획:** [API 안정성](/ko/5.0/misc/api-stability/) | [릴리스 노트와 업그레이드 지침](/ko/5.0/releases/) | [디프리케이션 타임라인](/ko/5.0/internals/deprecation/)