Localtonet으로 MongoDB 서버에 접속하기
이 페이지의 내용 섹션 9개
다른 네트워크에서 mongosh, MongoDB Compass 또는 드라이버로 내 컴퓨터의 MongoDB 서버에 연결하세요. TCP 터널이 27017번 포트에 공개 호스트 이름과 포트를 부여합니다.
작동 방식 #
Localtonet 클라이언트는 MongoDB를 호스팅하는 컴퓨터 또는 같은 네트워크의 다른 기기에서 실행됩니다. TCP 터널은 MongoDB 포트인 27017을 가리키며, Localtonet은 터널에 호스트 이름과 포트로 이루어진 공개 주소를 부여합니다. 이 주소로 연결하는 MongoDB 클라이언트는 내 서버에 접속하게 됩니다. TCP 터널의 자세한 내용은 TCP 페이지에 있습니다.
먼저 인증을 켜세요. 직접 관리하는 MongoDB 서버는 액세스 제어를 활성화하기 전까지 사용자 이름이나 비밀번호 없이 모든 연결을 받아들입니다. 시작된 터널은 주소를 아는 누구나 접근할 수 있으므로, 이런 서버로 터널을 열면 낯선 사람에게 내 데이터에 대한 모든 권한을 주게 됩니다.
시작하기 전에 #
- Localtonet 계정과 내 AuthToken으로 연결된 Localtonet 클라이언트. 빠른 시작을 참고하세요.
- 액세스 제어가 활성화된 상태로 기기에서 실행 중인 MongoDB. 아래의 MongoDB 설정을 참고하세요.
- 원격 사용을 위한 MongoDB 사용자. 강력한 비밀번호를 사용하고 필요한 역할만 부여하세요.
터널 만들기 #
-
TCP - UDP 페이지 열기 #
내 터널 › TCP - UDP를 열고 TCP - UDP 터널 만들기를 펼치세요.
-
양식 작성하기 #
필드 입력할 내용 프로토콜 TCP 기기 토큰 기기의 Localtonet 클라이언트가 사용하는 토큰입니다. 서버 리전 지연 시간을 줄이려면 기기와 가까운 리전을 선택하세요. 로컬 IP 주소 MongoDB가 클라이언트와 같은 기기에서 실행된다면 127.0.0.1을 입력하세요. 네트워크의 다른 컴퓨터에 있는 서버라면 그 컴퓨터의 주소를 입력하세요.로컬 포트 27017또는mongod.conf의net.port값.URL 유형 랜덤 서브도메인. 커스텀 서브도메인은 이름을 직접 선택할 수 있으며 잔액이 필요합니다. 터널 만들기를 선택하세요.
-
터널을 시작하고 주소 복사하기 #
터널이 내 터널 아래에 나타납니다. 시작을 선택하세요. URL 열에는 공개 주소가
host:port형태로, 서버 포트 열에는 포트만 따로 표시됩니다.
외부에서 연결하기 #
MongoDB 클라이언트는 연결 문자열을 사용합니다. 터널의 호스트와 포트를 넣은 mongodb:// 형식을 사용하세요. authSource는 사용자를 만든 데이터베이스의 이름이며 보통 admin입니다.
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=adminmongosh를 사용할 때는 명령어에 비밀번호를 넣지 마세요. 셸 기록에 저장되지 않도록 하기 위해서이며, mongosh가 비밀번호를 물어봅니다.
mongosh "mongodb://<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>" --username <DB_USER> --authenticationDatabase adminMongoDB Compass에서는 새 연결의 URI 필드에 연결 문자열을 붙여넣으세요.
터널 주소에는 mongodb+srv:// 형식을 사용하지 마세요. 이 형식은 터널 호스트 이름에 없는 DNS 레코드를 조회합니다.
터널 뒤에서 중요한 MongoDB 설정 #
액세스 제어 활성화하기 #
먼저 관리자를 만든 다음 mongod.conf에서 authorization을 켜고 MongoDB를 다시 시작하세요.
security:
authorization: enabled재시작한 뒤에는 자격 증명 없이 연결해도 데이터를 읽거나 변경할 수 없습니다. 전체 절차는 MongoDB 매뉴얼의 "Enable Access Control"에 나와 있습니다.
bindIp는 로컬로 둘 수 있습니다 #
Localtonet 클라이언트는 내 기기에서 MongoDB에 연결합니다. MongoDB가 공개 인터페이스에서 수신 대기할 필요는 없으며, 클라이언트가 같은 컴퓨터에서 실행된다면 기본값인 net.bindIp: 127.0.0.1으로 충분합니다. 외부에서 들어오는 유일한 경로가 터널이 되도록 그대로 두세요.
레플리카 세트에는 직접 연결이 필요합니다 #
드라이버가 레플리카 세트에 연결하면 서버가 구성원의 호스트 이름으로 응답하고, 드라이버는 그 이름으로 접속을 시도합니다. 이 이름은 내 네트워크 내부의 주소이므로 외부에서는 연결이 멈추거나 실패합니다. 연결 문자열에 directConnection=true를 추가해 터널의 주소에 머무르게 하세요.
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin&directConnection=true같은 주소 유지하기 #
호스트 이름은 터널에 고정되어 있습니다. 포트는 터널이 시작될 때 서버가 할당합니다. 터널의 설정에서 포트 예약을 켜 두면 터널이나 Localtonet 클라이언트가 다시 시작되어도 포트가 그대로 유지되며, 애플리케이션의 연결 문자열에는 이 방식이 필요합니다. 꺼 두면 재시작할 때마다 포트가 바뀝니다. 계정에 잔액이 있을 때 만든 터널은 포트 예약이 켜진 상태로 시작합니다. 이 옵션을 켜려면 잔액과 시작된 터널이 필요합니다.
잔액이 있으면 서버 포트 › 변경에서 포트를 직접 선택할 수도 있습니다. 예를 들어 해당 서버에서 다른 터널이 사용하지 않는다면 27017을 선택할 수 있습니다. 포트를 참고하세요.
무료 플랜. 무료 플랜에서는 TCP 터널이 30분 후에 중지되며 다시 시작할 수 있습니다. 시작할 때마다 포트가 달라질 수 있습니다. 요금제와 잔액을 참고하세요.
보안 설정하기 #
- 위에서 설명한 MongoDB의 액세스 제어. 건너뛸 수 없는 단계입니다.
- IP 제한. 터널의 설정에서 IP 제한 › 관리를 선택하고 이 항목만 허용을 고른 다음 연결하는 애플리케이션과 사람의 주소를 추가하세요. 내 IP 사용은 현재 주소를 자동으로 채웁니다. 변경 사항은 즉시 적용됩니다. IP 제한에는 잔액이 필요합니다. 접근 제어를 참고하세요.
- 관리자 대신 필요한 데이터베이스 하나에만
readWrite같은 역할을 가진 전용 사용자. - MongoDB의 TLS. 터널은 기본적으로 종단 간 암호화되지 않습니다. 서버에서
net.tls를 구성하고 연결 문자열에tls=true를 추가해 자격 증명과 데이터가 끝까지 암호화되도록 하세요. - 제한. 터널의 설정에 있는 만료일, 대역폭 제한, 속도 제한으로 터널을 사용할 수 있는 기간과 사용량을 제한할 수 있습니다. 제한 및 만료를 참고하세요.
- 요청 로그 › 표시에서는 터널에 접속한 연결을 방문자의 IP 주소와 함께 확인할 수 있습니다. MongoDB 자체는 모든 연결의 출처를 Localtonet 클라이언트로 기록합니다.
자주 발생하는 문제 #
MongoServerSelectionError 또는 MongoNetworkError: connection timed out
터널이 시작되어 있고 연결 열에 켜짐이 표시되는지, 서버 포트의 현재 포트를 사용하는지, 기기에서 터널의 로컬 IP 주소와 로컬 포트로 MongoDB가 응답하는지 확인하세요. 서버가 레플리카 세트라면 directConnection=true를 추가하세요. IP 제한을 사용 중이라면 현재 주소가 목록에 있는지 확인하세요.
MongoServerError: Authentication failed
터널은 정상 동작하며 MongoDB가 응답했습니다. 비밀번호와 authSource를 확인하세요. 이 값은 사용자를 만든 데이터베이스여야 합니다. 사용자 이름이나 비밀번호에 특수 문자가 있으면 연결 문자열에서 퍼센트 인코딩해야 합니다.
로그인하지 않고도 데이터를 읽을 수 있습니다
액세스 제어가 꺼져 있습니다. 터널을 중지하고 security.authorization을 활성화한 다음 MongoDB를 다시 시작하고 터널을 다시 시작하세요.
재시작 후 애플리케이션의 연결이 끊어졌습니다
포트가 예약되어 있지 않아 터널이나 클라이언트가 다시 시작될 때 포트가 바뀌었습니다. 포트 예약을 켜거나 연결 문자열의 포트를 업데이트하세요.
터널이 30분 후에 저절로 중지되었습니다
무료 플랜에서는 TCP 터널이 30분 후에 중지됩니다. 시작을 선택해 새 세션을 시작하거나, 잔액을 충전해 세션 제한을 없애세요.
"이 기능을 사용하려면 잔액을 구매해야 합니다."
포트 예약, 서버 포트, IP 제한, 커스텀 서브도메인에는 잔액이 필요합니다. 잔액에서 충전하세요.