Ir para o conteúdo
Localtonet Localtonet Painel

Acesse um servidor MongoDB pelo Localtonet

Ajuda com esta página
Nesta página 9 seções
  1. Como funciona
  2. Antes de começar
  3. Crie o túnel
  4. Abra a página TCP - UDP
  5. Preencha o formulário
  6. Inicie o túnel e copie o endereço
  7. Conecte-se de fora
  8. Configurações do MongoDB que importam por trás de um túnel
  9. Ative o controle de acesso
  10. O bindIp pode continuar local
  11. Conjuntos de réplicas exigem uma conexão direta
  12. Mantenha o mesmo endereço
  13. Proteja o acesso
  14. Problemas comuns
  15. Páginas relacionadas

Conecte-se a um servidor MongoDB na sua máquina, a partir de outra rede, com o mongosh, o MongoDB Compass ou um driver: um túnel TCP dá à porta 27017 um nome de host e uma porta públicos.

Como funciona #

O cliente do Localtonet é executado na máquina que hospeda o MongoDB, ou em outro dispositivo da mesma rede. Um túnel TCP aponta para a porta do MongoDB, 27017. O Localtonet dá ao túnel um endereço público composto por um nome de host e uma porta. Um cliente do MongoDB que se conecta a esse endereço alcança seu servidor. Os detalhes dos túneis TCP estão na página TCP.

Ative primeiro a autenticação. Um servidor MongoDB autogerenciado aceita todas as conexões sem nome de usuário nem senha até você ativar o controle de acesso. Um túnel iniciado é alcançável por qualquer pessoa que tenha o endereço dele, então um túnel para um servidor assim dá a estranhos acesso total aos seus dados.

Antes de começar #

  • Uma conta do Localtonet e o cliente do Localtonet conectado com seu AuthToken. Veja o Início rápido.
  • O MongoDB em execução no dispositivo com o controle de acesso ativado. Veja Configurações do MongoDB abaixo.
  • Um usuário do MongoDB para uso remoto, com uma senha forte e somente as funções de que precisa.

Crie o túnel #

  1. Abra a página TCP - UDP #

    Abra Meus túneis › TCP - UDP e expanda Criar túnel TCP - UDP.

  2. Preencha o formulário #

    CampoO que informar
    ProtocoloTCP
    Token do dispositivoO token que o cliente Localtonet no dispositivo usa.
    Região do servidorEscolha uma região próxima do seu dispositivo para ter menor latência.
    Endereço IP local127.0.0.1 quando o MongoDB é executado no mesmo dispositivo do cliente. Para um servidor em outra máquina da rede, informe o endereço dessa máquina.
    Porta local27017, ou o valor de net.port em mongod.conf.
    Tipo de URLSubdomínio aleatório. Subdomínio personalizado permite escolher o nome e exige saldo.

    Selecione Criar túnel.

  3. Inicie o túnel e copie o endereço #

    O túnel aparece em Seus túneis. Selecione Iniciar. A coluna URL mostra o endereço público como host:port, e a coluna Porta do servidor mostra só a porta.

Conecte-se de fora #

Os clientes do MongoDB usam uma string de conexão. Use o formato mongodb:// com o host e a porta do túnel. authSource indica o banco de dados em que o usuário foi criado, geralmente admin.

String de conexão
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin

Com o mongosh, deixe a senha fora do comando para que ela não fique no histórico do seu shell. O mongosh a pede:

Terminal
mongosh "mongodb://<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>" --username <DB_USER> --authenticationDatabase admin

No MongoDB Compass, cole a string de conexão no campo URI de uma nova conexão.

Não use o formato mongodb+srv:// com o endereço de um túnel. Esse formato consulta registros DNS que o nome de host de um túnel não tem.

Configurações do MongoDB que importam por trás de um túnel #

Ative o controle de acesso #

Crie primeiro um administrador, depois ative a autorização em mongod.conf e reinicie o MongoDB:

mongod.conf
security:
  authorization: enabled

Após a reinicialização, uma conexão sem credenciais não consegue mais ler nem alterar dados. O manual do MongoDB descreve o procedimento completo em "Enable Access Control".

O bindIp pode continuar local #

O cliente do Localtonet se conecta ao MongoDB a partir do seu próprio dispositivo. O MongoDB não precisa escutar em uma interface pública: o padrão net.bindIp: 127.0.0.1 basta quando o cliente é executado na mesma máquina. Deixe assim, para que o túnel seja o único caminho vindo de fora.

Conjuntos de réplicas exigem uma conexão direta #

Quando um driver se conecta a um conjunto de réplicas, o servidor responde com os nomes de host dos seus membros, e o driver então tenta alcançar esses nomes. Eles são os endereços dentro da sua rede, então a conexão trava ou falha a partir de fora. Adicione directConnection=true à string de conexão para continuar no endereço do túnel:

String de conexão
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin&directConnection=true

Mantenha o mesmo endereço #

O nome de host permanece com o túnel. A porta é atribuída pelo servidor quando o túnel inicia. Com Porta reservada? ativado nas Configurações do túnel, a porta continua a mesma quando o túnel ou o cliente do Localtonet reinicia, que é o que uma string de conexão em um aplicativo precisa. Com a opção desativada, a porta muda a cada reinício. Os túneis que você cria enquanto sua conta tem saldo começam com Porta reservada? ativado. Ativá-lo exige saldo e um túnel iniciado.

Com saldo, você também pode escolher a porta em Porta do servidor › Alterar, por exemplo 27017, se nenhum outro túnel desse servidor a usar. Veja Portas.

Plano Grátis. Um túnel TCP para após 30 minutos no plano Grátis e pode ser iniciado de novo. A porta pode ser diferente a cada início. Veja Planos e saldo.

Proteja o acesso #

  • Controle de acesso no MongoDB, como descrito acima. Este é o único passo que você não pode pular.
  • Restrição de IP. Nas Configurações do túnel, selecione Restrição de IP › Gerenciar, escolha Permitir só estes e adicione os endereços dos aplicativos e das pessoas que se conectam. Usar meu IP preenche o seu endereço atual. As alterações valem imediatamente. A Restrição de IP exige saldo. Veja Controle de acesso.
  • Um usuário dedicado com funções no único banco de dados de que precisa, por exemplo readWrite, em vez de um administrador.
  • TLS no MongoDB. Os túneis não são criptografados de ponta a ponta por padrão. Configure net.tls no servidor e adicione tls=true à string de conexão para que as credenciais e os dados sejam criptografados por todo o caminho.
  • Limites. Data de expiração, Limite de banda e Limites de velocidade nas Configurações do túnel restringem por quanto tempo e em que volume o túnel pode ser usado. Veja Limites e expiração.
  • Log de requisições › Mostrar lista as conexões feitas ao túnel com o endereço IP do visitante. O próprio MongoDB registra o cliente do Localtonet como origem de todas as conexões.

Problemas comuns #

MongoServerSelectionError ou MongoNetworkError: connection timed out

Verifique se o túnel está iniciado e a coluna Conexão mostra LIG, se você usa a porta atual de Porta do servidor e se o MongoDB responde no dispositivo no Endereço IP local e na Porta local do túnel. Se o servidor é um conjunto de réplicas, adicione directConnection=true. Se você usa a Restrição de IP, verifique se o seu endereço atual está na lista.

MongoServerError: Authentication failed

O túnel funciona e o MongoDB respondeu. Verifique a senha e o authSource: ele deve ser o banco de dados em que o usuário foi criado. Caracteres especiais no nome de usuário ou na senha devem ser codificados em porcentagem em uma string de conexão.

Consigo ler dados sem entrar

O controle de acesso está desativado. Pare o túnel, ative security.authorization, reinicie o MongoDB e inicie o túnel de novo.

O aplicativo perdeu a conexão após uma reinicialização

A porta não está reservada, então ela mudou quando o túnel ou o cliente reiniciou. Ative Porta reservada? ou atualize a porta na string de conexão.

O túnel parou sozinho depois de meia hora

No plano Grátis, um túnel TCP para após 30 minutos. Selecione Iniciar para começar outra sessão ou adicione saldo para remover o limite de sessão.

"Você precisa comprar saldo para usar este recurso."

Porta reservada?, Porta do servidor, Restrição de IP e Subdomínio personalizado exigem saldo. Adicione-o em Saldo.

Suporte