드롭박스가 멈췄다 — 범인은 파일 2만 개, node_modules였습니다

어느 날 드롭박스 동기화가 멈춰버렸습니다. 원인은 제가 만들던 AI 비서 앱의 node_modules 폴더 — 파일 2만여 개였습니다. 드롭박스와 GitHub의 역할을 나눠서 문제를 해결한 기록입니다. 개발 프로젝트를 드롭박스에 넣어두신 분이라면, 언젠가 반드시 겪을 일입니다.

잘 돌아가던 드롭박스가 멈춘 날

저는 회사의 모든 업무 파일을 드롭박스로 관리합니다. 사무실 PC에서 작업하던 파일을 집 PC에서 그대로 이어서 열 수 있다는 것, 이게 1인 기업 대표에게 얼마나 큰 무기인지는 써본 사람만 압니다.
그런데 어제부터 뭔가 이상했습니다. 파일을 저장해도 초록색 체크 표시가 뜨지 않고, 드롭박스 아이콘은 하루 종일 "인덱싱 중"에서 움직이지 않았습니다. 처음엔 네트워크 문제인 줄 알았습니다. 재시작을 해도, 재로그인을 해도 그대로였습니다.
동기화 도구가 멈추는 순간, 두 대의 PC로 일하는 사람의 업무는 통째로 멈춥니다.

범인은 node_modules — 파일 2만 개

원인을 추적해 보니 범인은 의외의 곳에 있었습니다. 최근에 만들기 시작한 일정관리 AI 비서 앱이었습니다.
이 앱은 npm 기반 프로젝트인데, npm 프로젝트는 설치 시 node_modules라는 폴더에 의존성 라이브러리를 전부 내려받습니다. 그 안에 든 파일 수가 2만 개가 넘습니다.
드롭박스는 파일 하나하나를 개별로 추적합니다. 코드 몇 줄 고치고 패키지 하나 설치할 때마다 수천 개 파일이 바뀌니, 드롭박스 입장에서는 감당이 안 되는 겁니다. 인덱싱 큐가 밀리면서 정작 중요한 업무 파일들의 동기화까지 전부 멈춰버린 것이었습니다.

node_modules는 애초에 동기화할 필요가 없는 폴더입니다. npm install 한 줄이면 어느 PC에서든 다시 만들어지는, 재생성 가능한 산출물이기 때문입니다.

해결: 동기화는 드롭박스, 버전 관리는 GitHub

해결의 핵심은 "무엇을 어디에 둘 것인가"를 다시 정하는 것이었습니다.
npm 기반 프로젝트는 드롭박스 밖으로 뺐습니다. 소스코드는 별도 개발 폴더에 두고, GitHub 비공개 저장소를 만들어 git push/pull로 두 PC를 동기화합니다. node_modules는 .gitignore에 등록해서 git도 추적하지 않게 합니다. 어차피 각 PC에서 npm install로 다시 만들면 되니까요.

.gitignore — 재생성 가능한 것들은 동기화하지 않는다

node_modules/
.env.local
정리하면 역할 분담은 이렇게 됩니다.

• 드롭박스 — 문서, 산출물, 순수 HTML 도구. "파일 자체가 원본"인 것들
• GitHub — npm 프로젝트 소스코드. "명령어로 재생성 가능한 것"이 딸린 프로젝트
• 어디에도 안 두는 것 — node_modules(재설치), API 비밀키(.env.local — 유실 시 발급처에서 재발급)

이렇게 옮기고 나니 드롭박스 인덱싱은 몇 분 만에 정상으로 돌아왔습니다.

이 사건이 남긴 원칙 하나

이번 일로 배운 것을 한 문장으로 남기면 이렇습니다.
동기화 도구에는 원본만 넣고, 재생성 가능한 것은 만드는 방법만 관리한다.
드롭박스가 느려졌다면, 탐색기에서 폴더별 파일 개수부터 확인해 보세요. 개발 폴더 하나가 수만 개 파일을 물고 있는 경우가 생각보다 많습니다. 특히 node_modules, 파이썬의 venv, 빌드 산출물 폴더(dist, build)가 단골 범인입니다.

자주 묻는 질문

드롭박스가 '인덱싱 중'에서 멈추면 무엇을 확인하나요?

탐색기에서 폴더별 파일 개수부터 확인합니다. node_modules, 파이썬의 venv, 빌드 산출물 폴더(dist, build)가 수만 개 파일을 물고 있는 경우가 가장 흔합니다.

node_modules는 동기화하지 않아도 되나요?

됩니다. npm install 한 줄이면 어느 PC에서든 다시 만들어지는 재생성 가능한 산출물이라서, .gitignore에 등록하고 각 PC에서 새로 설치합니다.

두 대의 PC로 일하는 업무 환경을 정리하고 싶다면

파일은 무엇에, 코드는 어디에 둘지 정하는 일은 1인 기업과 작은 조직에서 특히 자주 미뤄집니다.

AI 도구를 업무에 붙이는 조직의 업무 구조는 20분 무료 상담에서 함께 짚어봅니다.

👉 AX조직화컨설팅 자세히 보기: lifebell.kr/ax-consulting · 무료로 시작하기: lifebell.kr/start
💬 한 줄 문의: 카카오톡 채널 '라이프벨'