Miniconda 설치 · 5 min read · Sep 12, 2025

Debian 12에 Miniconda 설치하는 방법

Miniconda는 Anaconda 배포판의 미니 버전으로, 패키지는 적지만 Python/R 및 데이터 과학 프로젝트를 설정하기에 충분히 강력합니다. Miniconda는 ‘conda’, Python 및 몇 가지 유용한 추가 패키지와 같은 도구만 포함합니다. 이는 더 작은 크기의 경량 Anaconda 버전으로, Anaconda의 공용 저장소 또는 conda-forge 및 bioconda와 같은 타사 저장소를 통해 추가 패키지를 설치할 수 있습니다.

이 가이드는 Linux Debian 12 서버에 Miniconda를 설치하는 방법을 알려줍니다. ‘conda’ 명령줄을 사용하여 가상 환경과 패키지를 생성하고 관리하는 방법을 배우게 됩니다. 궁극적으로 Flask 개발을 위한 Miniconda 사용 방법도 보여드릴 것입니다. 이는 가상 환경과 격리되어 있습니다.

필수 조건

이 가이드를 시작하기 전에 다음 사항을 확인하세요:

  • Linux 서버/데스크탑 - 이 예제는 Debian 12를 사용합니다.
  • 관리자 권한이 있는 비루트 사용자

Miniconda 설치하기

Debian에 Miniconda를 설치하려면 ‘curl’을 사용하여 설치 프로그램을 쉽게 다운로드하고 터미널에서 실행할 수 있습니다. Debian 머신에 Miniconda를 설치하는 방법은 다음과 같습니다.

아래 ‘curl’ 명령으로 Linux용 Miniconda 설치 프로그램을 다운로드하세요.

curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

다운로드가 완료되면 다음과 같이 ‘Miniconda3-latest-Linux-x86_64’ 설치 스크립트를 실행하세요:

bash ~/Miniconda3-latest-Linux-x86_64.sh

이제 다음을 수행하세요:

  • ENTER 키를 눌러 라이선스 계약을 검토합니다.
  • 라이선스 계약에 동의하려면 ‘yes’를 입력합니다.
  • 기본 설치 경로를 ‘ /home/USER/miniconda3 ‘로 구성하려면 ENTER 키를 누릅니다.
  • 초기화 프로세스에 대해 ‘yes’를 선택하여 Miniconda 초기화를 자동화합니다.
  • 프로세스가 완료되면 ‘ Miniconda3 설치에 감사드립니다 ‘와 같은 메시지가 표시됩니다.

install miniconda

install miniconda 설치가 완료되면 아래 명령으로 현재 셸 환경을 다시 로드하세요. 아래에서 Bash 사용자는 ‘~/.bashrc’를, ZSH 사용자는 ‘~/.zshrc’를 사용할 수 있습니다.

source ~/.bashrc  
source ~/.zshrc

셸이 다시 로드되면 ‘ (base) ‘ 환경에 자동으로 들어가게 됩니다. 이는 Miniconda 전용입니다.

애플리케이션이나 프로젝트를 위해 나만의 환경을 생성하세요. 이는 나중에 배우게 됩니다.

아래 명령으로 ‘conda’ 버전을 확인하세요. 이 시점에서 우리는 conda ‘ 24.11.1 ‘이 설치되어 있습니다.

conda --version

check conda versionb

마지막으로, 다음 명령으로 Miniconda 설치에 대한 자세한 정보를 확인할 수 있습니다:

conda info

여기에서 활성 환경, 데이터 디렉토리, 캐시 디렉토리, ‘ conda ‘ 버전, 환경 디렉토리 및 채널 URL(저장소)을 확인할 수 있습니다.

check conda info

conda로 환경 만들기

Miniconda를 설치한 후, 이제 Miniconda를 사용하여 가상 환경을 생성하고 관리하는 방법을 배워봅시다.

Miniconda는 가상 환경, 패키지 및 애플리케이션을 관리하고 배포하기 위한 명령줄 도구 ‘conda’를 제공합니다. 이 단계에서는 ‘conda’를 사용하여 가상 환경을 생성하고 활성화하는 방법과 가상 환경에 패키지를 설치하는 방법을 배웁니다.

새로운 개발 환경을 Conda로 만들려면 아래 ‘ conda ‘ 명령을 실행하세요. 이 예제에서는 ‘ cenv ‘라는 새 환경을 생성합니다.

conda create -n cenv

프롬프트가 표시되면 ‘ y ‘를 입력하여 진행합니다.

create virtual environment

cenv ‘ 환경이 생성되면 아래 ‘ conda activate ‘ 명령을 실행하여 새 환경을 활성화합니다.

conda activate cenv

이제 셸이 ‘ (base) ‘에서 ‘ (cenv) ‘로 변경되어야 합니다.

다음으로, 아래 ‘conda install’ 명령을 실행하여 패키지를 설치합니다. 예를 들어, 여기서는 Python 3.12, Beautifulsoup4 및 docutils 패키지를 설치합니다.

conda install python=3.12 beautifulsoup4 docutils

activate and install packages

마지막으로, 아래 명령으로 현재 환경을 비활성화할 수 있습니다.

conda deactivate

또한, 다음과 같이 단일 명령 ‘conda create’를 사용하여 새 환경을 만들고 패키지를 설치할 수 있습니다.

conda create cent python=3.12 beautifulsoup4 docutils

YAML 파일로 환경 만들기

Miniconda는 YAML 파일을 통해 환경을 생성하는 방법도 제공합니다. 이를 통해 YAML 파일을 친구들과 쉽게 공유할 수 있으며 모두 동일한 환경을 가질 수 있습니다. 이제 YAML 파일을 통해 ‘conda’로 가상 환경을 만드는 방법을 배워봅시다.

텍스트 편집기를 사용하여 새로운 ‘ environment.yml ‘ 파일을 만듭니다. 이 경우 ‘ nano ‘를 사용합니다.

nano environment.yml

아래 구성을 삽입하여 ‘ Python3.12 ‘, ‘ pip ‘, 및 ‘ flask ‘ 패키지가 포함된 새로운 환경 ‘ myproject ‘를 생성합니다. 해당 패키지는 자동으로 설치됩니다.

name: myproject  
dependencies:  
 - python=3.12  
 - pip  
 - flask

작업이 완료되면 파일을 저장하고 편집기를 종료합니다.

이제 아래 ‘ conda env create ‘ 명령을 실행하여 ‘ environment.yml ‘ 파일을 통해 새로운 가상 환경을 생성합니다.

conda env create -f environment.yml

완료되면 아래 명령으로 ‘ myproject ‘ 환경을 활성화합니다.

conda activate myproject

잘 진행되면 셸이 ‘ (myproject) user@host’와 같이 변경됩니다. 아래 스크린샷과 같습니다.

conda via command line

환경 및 패키지 나열하기

이 섹션에서는 생성한 환경을 확인하고 ‘conda’를 사용하여 설치한 패키지를 나열하는 방법을 배웁니다.

아래 ‘conda env’ 명령을 실행하여 시스템의 프로젝트/환경을 나열합니다. 이 경우 ‘ (base) ‘는 기본 Miniconda, ‘ cenv ‘, 및 ‘ myproject ‘의 세 가지 환경을 볼 수 있습니다.

conda env list

list environments

또한 아래 ‘ conda list ‘ 명령을 사용하여 환경 내의 패키지 목록을 확인할 수 있습니다.

conda list -n myproject  
conda list -n cenv

아래에서 ‘ myproject ‘ 내의 패키지 목록을 볼 수 있습니다.

list packages

패키지 및 환경 제거하기

이제 환경 및 패키지를 나열하는 방법을 배웠으므로, 다음 단계로 Miniconda 내에서 패키지 및 가상 환경을 제거하는 방법을 배워봅시다.

환경에서 특정 패키지를 제거하려면 ‘ conda remove ‘ 명령을 실행하고 ‘ -n env-name ‘ 및 패키지 이름을 뒤따릅니다.

conda remove -n myproject pip

remove packages

시스템에서 환경을 제거하려면 아래 ‘ conda remove ‘ 명령을 실행하고 환경 이름과 ‘ –all ‘ 옵션을 뒤따릅니다.

conda remove -n myproject --all

remove env

마지막으로 아래 명령으로 환경 목록을 다시 확인하세요. 환경이 삭제된 것을 볼 수 있습니다. 이 예제에서는 ‘ myproject ‘가 삭제되었습니다.

conda env list

list check env

Conda로 Flask 설치하기

마지막 단계로, Miniconda를 사용하여 Flask 개발을 시연하겠습니다. 이를 위해 우리가 생성한 ‘cenv’ 환경을 사용하고 Python, Pip 및 Flask 패키지를 설치합니다.

먼저, ‘ cenv ‘ 가상 환경을 활성화하고 ‘ flask ‘를 포함한 필요한 패키지를 설치합니다.

conda activate cenv  
conda install python=3.12 pip flask

install flask

이제 새로운 ‘ ~/flask ‘ 프로젝트 디렉토리를 만들고 그 안으로 들어갑니다. 그런 다음, 선호하는 텍스트 편집기를 사용하여 새로운 애플리케이션 ‘ myapp.py ‘를 만듭니다.

mkdir -p ~/flask; cd ~/flask  
vim myapp.py

다음 Python 스크립트를 삽입하여 ‘ Hello Flask ‘를 브라우저에 표시하는 새로운 애플리케이션 ‘ myapp ‘을 생성합니다.

#myapp  
from flask import Flask, render_template # render_template 함수 가져오기  
  
app = Flask(__name__)  
# 인덱스 페이지로의 경로  
@app.route("/")  
def hello():  
return render_template('index.html')  
  
if __name__ == ' __main__':  
app.run(debug=True)

이제 새로운 ‘templates’ 디렉토리를 만들고 그 안에 ‘index.html’ 파일을 생성합니다.

mkdir -p templates  
nano templates/index.html

render_template ‘ 함수에 의해 렌더링될 다음 HTML 스크립트를 삽입합니다.

  
   
 

Hello Flask within Miniconda!

다음으로, 아래 ‘flask’ 명령을 실행하여 애플리케이션을 시작합니다. 이는 기본 포트 ‘5000’에서 Flask를 실행합니다.

flask --app myapp run

실행 중에는 다음과 같은 출력이 표시됩니다:

run flask

마지막으로, 새 터미널 탭을 열고 서버에 연결한 다음, 아래 ‘curl’ 명령을 실행하여 Flask 애플리케이션에 접근합니다.

curl http://localhost:5000/

터미널에 ‘index.html’ 스크립트가 표시됩니다.

check flask app

결론

축하합니다! Miniconda를 설치하고 사용하는 방법을 배웠습니다. ‘conda’ 유틸리티를 사용하여 환경을 생성, 관리, 나열 및 삭제하는 방법을 배웠습니다. 또한 ‘conda’ 환경 내에서 Python 프로젝트 Flask를 설정하는 방법도 배웠습니다. 여기에서 프로젝트를 위해 여러 환경을 생성하거나 Miniconda 환경을 위한 YAML 스크립트를 생성하여 동료들과 배포할 수 있습니다. 이를 통해 팀을 위한 동일한 개발 환경을 가질 수 있습니다.

Share: X/Twitter LinkedIn

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

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