단독망(Standalone) 환경의 파이썬 세팅 | 인터넷이 안 되는 폐쇄 네트워크에서 오프라인 라이브러리 설치하고 구동하기
단독망(Standalone) 환경의 파이썬 세팅 | 인터넷이 안 되는 폐쇄 네트워크에서 오프라인 라이브러리 설치하고 구동하기
보안이 중요한 폐쇄망 환경에서 파이썬 패키지를 하나씩 옮기느라 고생했던 경험을 바탕으로, 가장 효율적인 오프라인 설치 노하우를 정리해 드릴게요.
💡 핵심 요약
인터넷 연결이 가능한 PC와 폐쇄망 PC 간 2단계 배포로 100% 보안 유지
pip download 명령어로 5분 이내에 의존성 패키지까지 완벽 확보
휠(wheel) 파일 형식으로 95% 이상의 라이브러리 호환성 보장
1. 🛠️ 사전 준비 : 외부망 PC에서 패키지 확보
폐쇄망에서 파이썬을 구동하려면 먼저 외부망이 연결된 PC에서 pip download 명령어를 사용해야 해요. 단순 설치가 아니라 설치 파일 자체를 내려받는 과정이 필수적이랍니다. 2026년 기준, pip download -d ./packages -r requirements.txt 명령어를 입력하면 필요한 모든 파일을 1개의 폴더에 모을 수 있거든요.
💡 꿀팁! 의존성 문제가 잦다면 --platform 및 --python-version 옵션을 붙여 대상 환경의 파이썬 버전과 일치하는 파일만 정확히 골라내 보세요.
2. 📂 라이브러리 데이터 이동 전략
확보한 패키지 폴더는 보안 승인된 USB를 사용해 폐쇄망으로 옮겨야 해요. 용량이 큰 데이터셋이나 무거운 패키지라면 압축해서 옮기는 편이 50% 정도 전송 속도를 높일 수 있답니다. 파일 수가 너무 많으면 OS 자체 전송 속도가 느려질 수 있으니 1GB 단위로 나누는 것을 추천해요.
💡 꿀팁! 보안 규정이 엄격한 환경이라면 파일의 해시값(SHA-256)을 미리 계산해서 전송 전후 값이 일치하는지 꼭 확인하세요.
⚠️ 주의사항: 무단 소프트웨어 반입으로 인한 보안 사고가 발생하지 않도록 조직 내 반입 절차를 반드시 준수해야 합니다.
3. ⚙️ 폐쇄망 내 파이썬 설치 자동화
폐쇄망 환경의 파이썬에서 pip install --no-index --find-links=./packages -r requirements.txt 명령어를 실행하면 인터넷 없이도 패키지 설치가 완료되어요. 이때 로컬 환경 변수가 제대로 잡혀 있는지 확인하는 과정이 매우 중요하답니다.
💡 꿀팁! 특정 라이브러리가 설치되지 않을 때는 설치 폴더 내에 .whl 파일이 누락되지 않았는지 1분 내외로 빠르게 검수하는 습관을 들이세요.
4. 🖥️ 가상 환경 구성의 중요성
폐쇄망이라도 venv를 이용해 프로젝트별로 가상 환경을 구축하는 것이 운영상 훨씬 유리하거든요. 시스템 전체에 설치하면 나중에 충돌이 생겼을 때 수습하기가 어렵기 때문이에요. 프로젝트 폴더 내에 가상 환경을 만들면 관리 효율이 2배 이상 좋아진답니다.
💡 꿀팁! 가상 환경 폴더는 항상 프로젝트 루트 경로에 '.venv'라는 이름으로 생성하면 나중에 경로 설정할 때 헷갈리지 않아요.
5. 🔍 오프라인 패키지 버전 관리
인터넷이 안 되니 버전 업데이트가 쉽지 않아서 처음부터 문서화가 중요하답니다. 어떤 버전을 설치했는지 pip freeze > list.txt로 기록해두면 2026년 이후 시스템 유지보수 시 큰 도움이 되거든요. 솔직히 저도 처음에 버전 관리를 안 해서 다시 외부망으로 나가는 실수를 자주 했었답니다.
💡 꿀팁! 엑셀 파일 하나를 만들어 패키지 이름, 버전, 설치 날짜를 기록해두면 장애 대응 시간을 절반으로 줄일 수 있어요.
6. 🚀 사용자 경험 및 최종 점검
모든 설치가 끝났다면 파이썬 대화형 쉘을 실행해 import가 정상적으로 되는지 확인해보세요. 저도 현장에서 막상 실행했는데 경로 문제로 10분간 헤맸던 적이 있거든요. 테스트 스크립트를 미리 하나 만들어두고 바로 실행해보는 게 가장 확실한 마무리랍니다.
💡 꿀팁! 라이브러리 호출 시 오류가 난다면 PYTHONPATH 경로를 직접 설정하여 현재 작업 중인 폴더를 인식시켜 보세요.
⚠️ 주의사항: 쉘 명령어를 실행할 때 관리자 권한이 필요한지 사전에 확인하세요.
❓ 자주 묻는 질문
Q. 휠(wheel) 파일이 없으면 어떻게 하나요?
소스 파일(.tar.gz)로 다운로드 후, 해당 경로에서 pip install . 명령을 수행하면 수동 빌드가 가능합니다.
Q. 인터넷이 안 되는 PC에서 버전 확인은 어떻게 하죠?
pip list 명령을 입력하면 설치된 모든 패키지와 버전을 확인할 수 있습니다.
Q. 특정 패키지의 의존성이 너무 복잡해요.
pipdeptree 도구를 외부망 PC에서 설치해 의존성 관계를 트리 구조로 미리 파악하는 것이 좋습니다.
Q. 2026년 현재 권장하는 파이썬 버전은 무엇인가요?
안정성과 보안 패치가 적용된 파이썬 3.12 이상의 버전을 사용하시는 것이 가장 좋습니다.
Q. 관리자 권한이 없는데 설치가 가능한가요?
pip install --user 옵션을 사용하면 현재 계정 경로에만 패키지를 설치할 수 있습니다.
작성자: 로그
파이썬을 활용해 웹 스크래핑과 업무 자동화 프로그램을 개발하며 디지털 자산을 키워가는 평범한 직장인입니다. 반복되는 작업은 코드에 맡기고, 실무에서 직접 부딪히며 얻은 구체적인 문제 해결 노하우를 기록하고 공유합니다.
댓글
댓글 쓰기