Django 설치 · 5 min read · Dec 14, 2025

Debian 10에 Django 웹 애플리케이션 프레임워크 설치하는 방법

Django는 동적 웹사이트 및 애플리케이션 개발을 돕는 오픈 소스 웹 애플리케이션 프레임워크입니다. 안전하고 빠르며 안정적이어서 적은 코드로 복잡한 웹사이트를 만들 수 있습니다. 시스템에 Django를 설치하는 방법은 여러 가지가 있습니다. Debian 저장소, PIP 또는 Git 저장소를 사용하여 설치할 수 있습니다. 필요에 따라 어떤 방법이든 선택할 수 있습니다. Django는 Python 가상 환경에서 프로젝트를 생성할 수 있게 해줍니다. 이렇게 하면 단일 시스템에서 여러 Django 환경을 생성할 수 있습니다.

이 튜토리얼에서는 Debian 10에서 PIP를 사용하여 Django 웹 프레임워크를 설치하는 방법을 배웁니다. 또한 Django 애플리케이션을 생성하고 데이터베이스와 연결하는 방법도 배웁니다.

필수 조건

  • Debian 10이 실행되는 서버.
  • 서버에 루트 비밀번호가 설정되어 있어야 합니다.

시작하기

시작하기 전에 시스템을 최신 버전으로 업데이트하십시오. 다음 명령어를 실행하여 업데이트할 수 있습니다:

apt-get update -y  
apt-get upgrade -y

시스템이 업데이트되면 변경 사항을 적용하기 위해 재부팅하십시오.

Django 설치

Django는 Python 언어로 작성되었습니다. 따라서 Django를 설치하려면 시스템에 Python 종속성을 설치해야 합니다. 다음 명령어로 모든 종속성을 설치할 수 있습니다:

apt-get install python3 python3-pip tree -y

모든 패키지를 설치한 후, 다음 명령어로 설치된 PIP 버전을 확인할 수 있습니다:

pip3 -V

다음과 같은 출력이 표시되어야 합니다:

pip 18.1 from /usr/lib/python3/dist-packages/pip (python 3.7)

이제 아래와 같이 PIP 명령어를 사용하여 Django를 설치할 수 있습니다:

pip3 install Django

설치가 완료되면 다음 명령어로 Django 버전을 확인하십시오:

django-admin --version

다음과 같은 출력이 표시되어야 합니다:

3.0.2

이 시점에서 Django가 서버에 설치되었습니다. 이제 다음 단계로 진행할 수 있습니다.

Django 프로젝트 생성

이제 샘플 Django 프로젝트를 생성해 보겠습니다. 먼저 Django 프로젝트를 생성할 /opt 디렉토리로 변경합니다:

cd /opt

다음으로, Dproject라는 새로운 Django 프로젝트를 생성하기 위해 다음 명령어를 실행합니다:

django-admin startproject Dproject

프로젝트가 생성되면 다음 명령어로 이 프로젝트의 디렉토리 구조를 확인할 수 있습니다:

tree

다음과 같은 출력이 표시되어야 합니다:

.
??? Dproject
    ??? Dproject
    ?   ??? asgi.py
    ?   ??? __init__.py
    ?   ??? settings.py
    ?   ??? urls.py
    ?   ??? wsgi.py
    ??? manage.py

다음으로, Dproject 디렉토리로 변경하고 다음 명령어로 보류 중인 변경 사항을 마이그레이션합니다:

cd Dproject  
python3 manage.py migrate

마이그레이션이 성공적으로 완료되면 다음과 같은 출력이 표시되어야 합니다:

Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying sessions.0001_initial... OK

이 시점에서 /opt 디렉토리 내에 새로운 Django 프로젝트가 생성되었습니다.

Django용 슈퍼 사용자 생성

다음으로, Django 관리 인터페이스에 접근하기 위해 Django의 슈퍼 사용자를 생성해야 합니다. 다음 명령어로 생성할 수 있습니다:

python3 manage.py createsuperuser

원하는 사용자 이름, 이메일 주소 및 비밀번호를 다음과 같이 입력하십시오:

Username (leave blank to use 'root'): admin
Email address: [email protected]
Password: 
Password (again): 
Superuser created successfully.

Django 서버 시작

기본적으로 Django는 원격 시스템에서 접근할 수 없습니다. 따라서 Django를 구성하고 서버 IP를 정의해야 합니다. settings.py 파일을 편집하여 이를 수행할 수 있습니다.

nano /opt/Dproject/Dproject/settings.py

다음 줄을 변경하십시오:

ALLOWED_HOSTS = ['your-server-ip']

작업이 완료되면 파일을 저장하고 닫습니다. 다음으로, 다음 명령어로 Django 서버를 시작합니다:

cd /opt/Django  
python3 manage.py runserver 0.0.0.0:8000

서버가 성공적으로 시작되면 다음과 같은 출력이 표시되어야 합니다:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
January 07, 2020 - 13:01:23
Django version 3.0.2, using settings 'Dproject.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

Django 애플리케이션 접근

이 시점에서 Django 애플리케이션이 시작되었고 포트 8000에서 수신 대기하고 있습니다. 접근하려면 웹 브라우저를 열고 URL http://your-server-ip:8000을 입력하십시오. 다음 화면에서 Django 애플리케이션을 볼 수 있어야 합니다:

Django 프레임워크

Django 관리 인터페이스에 접근하려면 웹 브라우저를 열고 URL http://your-server-ip:8000/admin을 입력하십시오. Django 로그인 페이지로 리디렉션됩니다:

Django 로그인

Django 관리 사용자 이름, 비밀번호를 입력하고 Log in 버튼을 클릭하십시오. 다음 화면에서 Django 관리 인터페이스를 볼 수 있어야 합니다:

Django 관리 콘솔

MariaDB 데이터베이스 커넥터 설치

다음으로, Django와 MariaDB 데이터베이스를 연결하기 위해 MariaDB 데이터베이스 커넥터 및 기타 개발 패키지를 설치해야 합니다. 다음 명령어로 모두 설치할 수 있습니다:

apt-get install mariadb-server python3-dev libmariadb-dev libmariadbclient-dev -y

모든 패키지가 설치되면 다음과 같이 PIP 명령어를 사용하여 mysqlclient 라이브러리를 설치할 수 있습니다:

pip3 install mysqlclient

설치가 완료되면 다음 명령어로 MariaDB 셸에 로그인합니다:

mysql

다음으로, 다음 명령어로 MariaDB의 루트 비밀번호를 설정합니다.

MariaDB [(none)]> SET PASSWORD FOR 'root'@'localhost' = PASSWORD("newpassword");

다음으로, 다음 명령어로 Django용 데이터베이스를 생성합니다:

MariaDB [(none)]> create database testdb;

다음 명령어로 생성된 데이터베이스를 확인할 수 있습니다:

MariaDB [(none)]> show databases;

다음과 같은 출력이 표시되어야 합니다:

+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| testdb             |
+--------------------+

다음으로, 권한을 플러시하고 다음 명령어로 MariaDB 셸에서 종료합니다:

MariaDB [(none)]> flush privileges;  
MariaDB [(none)]> exit;

Django를 위한 MariaDB 연결 구성

다음으로, Django에서 MariaDB 데이터베이스 자격 증명을 정의해야 합니다. settings.py 파일을 편집하여 이를 정의할 수 있습니다:

nano /opt/Dproject/Dproject/settings.py

다음 줄을 찾습니다:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

그리고 다음 줄로 교체합니다:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'OPTIONS': {
        'read_default_file': '/etc/mysql/mariadb.conf.d/50-client.cnf',
        },
    }
}

작업이 완료되면 파일을 저장하고 닫습니다. 그런 다음 MariaDB 클라이언트 자격 증명 파일을 다음과 같이 편집합니다:

nano /etc/mysql/mariadb.conf.d/50-client.cnf

다음과 같이 MariaDB 데이터베이스 자격 증명을 정의합니다:

[client]
database = testdb 
user = root   
password = newpassword
default-character-set = utf8

파일을 저장하고 닫은 후, 다음 명령어로 MariaDB 서비스를 재시작하여 변경 사항을 적용합니다:

systemctl restart mariadb

다음으로, Django 프로젝트 디렉토리로 변경하고 다음 명령어로 새로운 변경 사항을 마이그레이션합니다:

cd /opt/Dproject  
python3 manage.py migrate

마이그레이션이 성공적으로 완료되면 다음 단계로 진행할 수 있습니다.

MariaDB 연결 테스트

이 시점에서 Django가 MariaDB 데이터베이스에 연결되도록 구성되었습니다. 이제 테스트할 시간입니다.

이를 위해 다음 명령어로 Django 서버를 시작합니다:

cd /opt/Django  
python3 manage.py runserver 0.0.0.0:8000

Django 서버가 성공적으로 시작되면 다음과 같은 출력이 표시되어야 합니다:

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
January 07, 2020 - 13:30:49
Django version 3.0.2, using settings 'Dproject.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

이제 URL http://your-server-ip:8000을 사용하여 Django 애플리케이션에 접근할 수 있습니다. 다음 화면에서 Django 애플리케이션을 볼 수 있어야 합니다:

Django 애플리케이션

테스트 후, 터미널에서 CTRL + C를 눌러 언제든지 Django 서버를 중지할 수 있습니다.

결론

축하합니다! Debian 10 서버에 Django를 성공적으로 설치하고 MariaDB 데이터베이스와 연결했습니다. 이제 웹 애플리케이션 개발을 시작하고 Django 애플리케이션에서 마이그레이션을 적용할 수 있습니다. 질문이 있으면 언제든지 문의하십시오.

Share: X/Twitter LinkedIn
#Django 설치

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.