인터넷도, npm도, pip도 안 되는 폐쇄망 환경.
내가 AI와 만든 도구를 회사 안으로 안전하고 완벽하게 반입하는 실전 전략입니다.
"도구는 잘 만들었는데, 왜 회사 컴퓨터로 옮기면 에러가 날까요?"
우리가 바이브 코딩으로 만드는 도구는 크게 두 가지 목적 중 하나입니다. 내 목적에 맞춰 도구를 선택하지만, 외부 인터넷이 차단된 사내망(폐쇄망)에 들어가는 순간 완전히 다른 규칙이 적용됩니다.
pip install 불가, 실행파일(.exe) 반입 금지.
"집에서 잘 돌던 node_modules 폴더나 파이썬 코드를 USB나 망연계로 복사해서 사내 PC에서 켜면 100% 터집니다."
사내망 컴퓨터는 외부 패키지 저장소(npm, PyPI)와 통신할 수 없기 때문입니다.
사내망에서는 임의로 서버를 띄울 수 없습니다. 그렇다면 어디에 배포해야 할까요?
바깥에서는 Vercel이나 Cloudflare에 클릭 한 번으로 배포하지만, 사내망에서는 보안 방화벽, 포트 개방 승인, 24시간 서버 유지보수 책임 등 넘어야 할 산이 너무나 높습니다. 비전공자가 혼자 감당하기에는 사실상 불가능합니다.
내가 사내에 새로운 건물(서버)을 직접 지으려 하지 말고, 회사가 이미 공인해 둔 빌딩(SharePoint 포털) 안에 팝업스토어(웹 부품, WebPart)로 쏙 들어가는 방식입니다.
실제로 사내에서 널리 쓰이는 AX Hub와 Agent Store 또한 이 SharePoint 기반 SPFx 방식을 채택했습니다.
복잡한 사내 보안 심의를 거치지 않고도 사내 전 임직원에게 웹 도구를 안전하게 서비스할 수 있는 가장 검증된 모범 패턴입니다.
외부 식당(npm/pip)이 없는 산골(사내망)에 갈 때는 필요한 재료를 모두 담은 도시락이 필요합니다.
집에서는 배달의민족(npm/pip)으로 그때그때 재료를 시켜 요리했습니다.
하지만 사내망은 배달 라이더가 못 들어오는 격리된 산골입니다. 따라서 출발하기 전, 내가 쓸 모든 소스와 도구를
하나의 도시락 통(단일 HTML 파일 or 의존성 없는 단일 .py/.pyz 파일)에 완전히 조리해서 담아가야 합니다.
Vite 같은 도구로 프로젝트를 만들었다면, node_modules를 가져가는 것이 아니라
Vite Singlefile 플러그인을 통해 HTML 안에 CSS와 JS 코드를 하나로 싹 밀어 넣습니다.
vite-plugin-singlefile 설정을 적용하고 빌드 명령어를 알려줘."
사내 보안 솔루션(DLP, EDR, 백신)은 서명되지 않은 .exe 파일을 잠재적 악성코드로 간주해 자동 격리/삭제하거나, 사내 규정상 실행 파일 반입 자체를 금지합니다.
따라서 파이썬은 .exe가 아닌 순수 파이썬 형태(.py / .pyz / .whl)로 번들링해야 안전하게 반입할 수 있습니다.
csv, json, sqlite3, urllib, re, tkinter)만으로 작성합니다..pyz 파일로 만듭니다.python app.pyz로 바로 실행됩니다.
.whl)들을 통째로 다운로드받아 사내망으로 들여옵니다.pip install --no-index --find-links=./wheels ... 로 인터넷 없이 설치!
"복잡한 번들링 없이 라이브러리를 쓸 수 있는 사내망의 숨은 통로가 있다고요?"
사내망에서 일반 외부 웹사이트는 다 막혀 있지만, 전 세계적으로 널리 쓰이는 공인 CDN(jsDelivr, cdnjs 등)은
사내 방화벽 화이트리스트에 허용되어 있는 경우가 많습니다.
즉, 복잡하게 요리해서 싸오지 않아도 정문 배달 트럭(CDN)을 통해 브라우저가 라이브러리를 즉석에서 받아옵니다.
설치 명령어(npm install) 대신, HTML 상단에 링크 한 줄만 넣으면 차트나 스타일이 바로 동작합니다:
반입 심의를 신청하기 전, 직접 클릭하며 6가지 통과 기준을 점검해 보세요!
.exe)나 임의 배치 파일 대신, 순수 텍스트/표준 형식(.py, .pyz, .html)으로 산출물을 준비했나요?node_modules 없이 단일 dist/index.html로 번들링되었나요? 파이썬은 표준 라이브러리 기반 단일 .py 또는 zipapp .pyz로 묶였나요?<script src="..."> CDN 링크 방식을 썼다면, 사내 PC 브라우저에서 해당 CDN 주소(jsdelivr/cdnjs)가 사내 방화벽에 차단되지 않고 열리는지 미리 확인했나요?기초 개념부터 실습, 사내 반입까지 바이브 코딩으로 나만의 업무 도구를 완성해보세요.