질문 제목 : MongoDB 설치방법을 처음부터 끝까지 쉽게 정리해 주세요 (윈도우 기준, 권한/계정 포함)
질문 내용 : 윈도우에서 MongoDB를 설치하고 서비스로 실행한 뒤, mongosh로 접속해서 복제셋 초기화와 관리자 계정 생성, 인증(authorization) 설정까지 한 번에 정리된 설치 가이드가 필요합니다. 중간에 막히기 쉬운 포인트(서비스 재시작, 설정파일 위치, 접속 확인 방법, 로컬 접속/원격 접속 구분)도 함께 설명해 주세요.
질문한 닉네임: 설치막힘초보
태그: mongodb,윈도우설치,mongosh,복제셋,authorization
답변 : 현장 설치 가이드처럼 처음부터 끝까지 흐름을 잡아드리겠습니다. 목표는 단순 설치가 아니라, 실제 운영에 필요한 3단계까지 마무리하는 것입니다.
1단계 설치 및 서비스 실행 MongoDB는 윈도우에서 보통 서비스 형태로 구동됩니다. 설치가 끝나면 백그라운드에서 MongoDB 서비스가 실행되고, 우리는 클라이언트 셸(mongosh)로 접속해 상태를 확인합니다.
- MongoDB Community Server 설치 설치 중 선택 화면에서 다음을 체크하는 것이 일반적으로 안전합니다. MongoDB를 Windows Service로 설치 서비스 이름은 보통 MongoDB로 설정 데이터 경로와 로그 경로는 기본값을 사용해도 무방하지만, 나중에 운영할 계획이면 D 드라이브 같은 별도 디스크로 빼는 것도 좋습니다
- 설치 경로 확인 설치 후 주요 경로는 보통 아래와 같습니다. MongoDB 실행 파일: C:\Program Files\MongoDB\Server\7.0\bin 설정 파일: C:\Program Files\MongoDB\Server\7.0\bin\mongod.cfg
- 서비스 동작 확인 서비스가 정상 실행 중인지 확인합니다. 작업 관리자 또는 서비스(services.msc)에서 MongoDB 상태 확인 명령줄에서 net start MongoDB로도 확인 가능
여기까지가 설치와 실행의 기본입니다. 이제 중요한 설정을 붙여서 실사용 가능한 상태로 만듭니다.
2단계 복제셋(Replica Set) 설정 및 초기화 단일 서버로만 쓸 생각이라도 복제셋을 켜는 경우가 많습니다. 이유는 트랜잭션, 특정 기능, 향후 확장성에서 복제셋 모드가 유리한 경우가 있기 때문입니다. 단, 이 단계는 설정 파일 수정과 서비스 재시작이 동반됩니다.
- mongod.cfg에 replication 설정 추가 mongod.cfg 파일을 관리자 권한으로 열고 아래를 추가합니다. 이미 비슷한 섹션이 있으면 그 아래에 정리해 넣으세요.
replication: replSetName: myReplSet
replSetName은 임의로 지을 수 있지만, 이후에도 계속 쓰는 이름이므로 간단하게 유지하는 편이 좋습니다.
- MongoDB 서비스 재시작 설정 변경은 서비스 재시작 후 반영됩니다.
net stop MongoDB net start MongoDB
여기서 자주 발생하는 문제는 권한 문제 또는 mongod.cfg 문법 오류입니다. 들여쓰기(스페이스)와 콜론(:) 위치가 틀리면 MongoDB가 기동에 실패합니다 재시작이 안 되면 이벤트 뷰어 또는 로그 파일에서 오류 메시지를 확인해야 합니다
- mongosh 설치 및 접속 MongoDB 서버 설치만으로 셸이 항상 함께 설치되는 건 아닙니다. 별도로 mongosh를 설치하는 경우가 많습니다.
mongosh를 설치한 뒤, 터미널에서 mongosh를 실행합니다. 기본 로컬 접속이 되면 이제 복제셋을 초기화합니다.
- 복제셋 초기화 mongosh에서 아래를 실행합니다.
rs.initiate()
성공하면 프롬프트가 primary로 바뀌거나, rs.status()에서 상태가 확인됩니다. 이 단계가 끝나면 서버는 복제셋 모드로 동작합니다.
3단계 관리자 계정 생성 및 인증(Authorization) 활성화 이제부터가 실무에서 가장 중요한 부분입니다. 계정 없이 열어두는 MongoDB는 내부망이라도 위험합니다. 단, 인증을 켜기 전에 반드시 관리자 계정을 먼저 만들어야 합니다.
- admin DB로 이동 후 관리자 계정 생성 mongosh에서 다음 순서로 진행합니다.
use admin
db.createUser({ user: “myAdmin”, pwd: “adminPass”, roles: [ { role: “userAdminAnyDatabase”, db: “admin” } ] })
여기서 팁을 드리면 운영에서는 adminPass는 더 강력한 비밀번호로 변경해야 합니다 역할(role)은 목적에 맞게 최소 권한으로 설계하는 것이 좋습니다 다만 초기 세팅에서는 관리자 권한이 필요하니 userAdminAnyDatabase 같은 관리자 역할을 부여하는 흐름이 일반적입니다
- mongod.cfg에 인증 설정 추가 계정 생성이 끝났다면 이제 mongod.cfg에 아래를 추가합니다.
security: authorization: enabled
- 서비스 재시작 인증도 마찬가지로 서비스 재시작이 필요합니다.
net stop MongoDB net start MongoDB
- 인증이 켜진 후 접속 방법 이제는 그냥 mongosh만 치면 접속이 실패할 수 있습니다. 계정 정보를 함께 넣어야 합니다.
mongosh –username myAdmin –password adminPass –authenticationDatabase admin
또는 접속한 뒤 인증이 필요하다고 나오면, 위와 같은 방식으로 재접속하세요.
4단계 설치 후 점검 체크리스트 설치가 되었는지, 실제로 안전한지, 운영 가능한지 빠르게 점검하는 체크리스트입니다.
- 서버 실행 여부 서비스가 실행 중인지 확인 mongosh 접속이 되는지 확인
- 복제셋 상태 mongosh에서 rs.status()로 primary 상태 확인 초기화가 안 됐다면 rs.initiate() 재확인
- 인증 상태 authorization enabled 이후 익명 접속이 막히는지 확인 계정으로 정상 접속되는지 확인
- 포트 및 네트워크 기본 포트는 27017입니다 로컬 개발만이면 방화벽/외부접속 설정은 굳이 열지 않는 것이 안전합니다 원격 접속이 필요하다면 bindIp 설정과 방화벽 규칙, 계정 권한을 함께 설계해야 합니다
5단계 자주 막히는 문제와 해결 방향 재시작이 안 됨 대부분 mongod.cfg YAML 문법 오류(들여쓰기) 또는 권한 문제입니다. 로그 확인이 가장 빠릅니다.
rs.initiate()가 안 됨 replication 설정이 반영되지 않았거나 서비스 재시작이 누락된 경우가 많습니다. mongod.cfg 저장 후 net stop/start가 되었는지 확인하세요.
인증 켰더니 접속이 안 됨 인증을 켜기 전에 계정을 만들지 않았거나, authenticationDatabase를 잘못 지정한 경우가 흔합니다. admin DB에 만든 계정이면 authenticationDatabase는 admin이 맞습니다.
마무리 정리하면 흐름은 설치 → 서비스 실행 확인 → mongod.cfg에 replSet 설정 → 서비스 재시작 → mongosh에서 rs.initiate → admin 계정 생성 → mongod.cfg에 authorization enabled → 서비스 재시작 순서입니다. 이 순서만 지키면 윈도우에서도 MongoDB를 운영 가능한 형태로 안정적으로 세팅할 수 있습니다.