인터넷 없는 PC에 Python 패키지 설치하기: pip download와 –no-index 사용법

회사 내부망, 보안망, 폐쇄망처럼 인터넷 접속이 안 되는 PC에서도 Python 패키지를 설치할 수 있습니다. 핵심은 인터넷이 되는 PC에서 필요한 패키지와 의존성을 미리 다운로드한 뒤, 오프라인 PC에서 로컬 파일로 설치하는 것입니다.

전체 흐름

  1. 온라인 PC에서 필요한 패키지를 pip download로 다운로드합니다.
  2. 다운로드한 .whl, .tar.gz 파일을 USB나 내부 파일서버로 옮깁니다.
  3. 오프라인 PC에서 --no-index --find-links 옵션으로 설치합니다.
  4. 설치 후 Python에서 import 테스트를 실행합니다.

Step 1. 온라인 PC에서 패키지 다운로드

mkdir C:python-packages
pip download -d C:python-packages pandas numpy matplotlib seaborn requests

프로젝트에서 쓰는 패키지가 많다면 requirements.txt를 만들어 한 번에 다운로드하는 방식이 더 안정적입니다.

pip download -d C:python-packages -r requirements.txt

Step 2. 오프라인 PC에서 설치

pip install --no-index --find-links=C:python-packages pandas numpy matplotlib seaborn requests

Jupyter Notebook에서 실행한다면 Windows 경로를 슬래시 형태로 바꿔 쓰는 편이 안전합니다.

!pip install --no-index --find-links="C:/python-packages" pandas numpy matplotlib

설치 확인

python -c "import pandas, numpy, matplotlib; print('ok')"

자주 나는 오류

오류원인해결
No matching distribution foundPython 버전/OS와 wheel 파일이 맞지 않음온라인 PC와 오프라인 PC의 Python 버전과 OS를 맞춘 뒤 다시 다운로드
의존성 패키지 누락필요한 하위 패키지가 같이 다운로드되지 않음pip download -r requirements.txt로 전체 의존성 재다운로드
권한 오류관리자 권한 또는 가상환경 문제가상환경을 만들고 해당 환경 안에서 설치

FAQ

온라인 PC와 오프라인 PC의 Python 버전이 달라도 되나요?

권장하지 않습니다. 특히 wheel 파일은 Python 버전과 운영체제에 영향을 받기 때문에 가능하면 같은 버전으로 맞추는 것이 안전합니다.

pip 자체가 없는 PC에서는 어떻게 하나요?

Python 설치 파일에 pip가 포함되어 있는지 확인하고, 필요하다면 Python 설치 옵션에서 pip를 함께 설치해야 합니다.

Post Views: 4