Naar de inhoud
Localtonet Localtonet Dashboard

Een MongoDB-server bereiken via Localtonet

Hulp bij deze pagina
Op deze pagina 9 secties
  1. Hoe het werkt
  2. Voordat je begint
  3. De tunnel aanmaken
  4. Open de pagina TCP - UDP
  5. Vul het formulier in
  6. De tunnel starten en het adres kopiëren
  7. Van buitenaf verbinden
  8. MongoDB-instellingen die achter een tunnel belangrijk zijn
  9. Schakel toegangsbeheer in
  10. bindIp kan lokaal blijven
  11. Replicasets hebben een directe verbinding nodig
  12. Houd hetzelfde adres
  13. Beveilig het
  14. Veelvoorkomende problemen
  15. Gerelateerde pagina's

Maak met mongosh, MongoDB Compass of een driver vanuit een ander netwerk verbinding met een MongoDB-server op je computer: een TCP-tunnel geeft poort 27017 een openbare hostnaam en poort.

Hoe het werkt #

De Localtonet-client draait op de computer waarop MongoDB staat, of op een ander apparaat in hetzelfde netwerk. Een TCP-tunnel wijst naar de MongoDB-poort, 27017. Localtonet geeft de tunnel een openbaar adres dat bestaat uit een hostnaam en een poort. Een MongoDB-client die verbinding maakt met dat adres, bereikt je server. De details van TCP-tunnels staan op de pagina TCP.

Schakel eerst authenticatie in. Een zelfbeheerde MongoDB-server accepteert elke verbinding zonder gebruikersnaam of wachtwoord totdat je toegangsbeheer inschakelt. Een gestarte tunnel is bereikbaar voor iedereen die het adres kent, dus een tunnel naar zo'n server geeft vreemden volledige toegang tot je gegevens.

Voordat je begint #

  • Een Localtonet-account en de Localtonet-client verbonden met je AuthToken. Zie Snelstart.
  • MongoDB draait op het apparaat met toegangsbeheer ingeschakeld. Zie MongoDB-instellingen hieronder.
  • Een MongoDB-gebruiker voor extern gebruik, met een sterk wachtwoord en alleen de rollen die nodig zijn.

De tunnel aanmaken #

  1. Open de pagina TCP - UDP #

    Open Mijn tunnels › TCP - UDP en klap TCP-/UDP-tunnel aanmaken open.

  2. Vul het formulier in #

    VeldWat je invult
    ProtocolTCP
    ApparaattokenHet token dat de Localtonet-client op het apparaat gebruikt.
    ServerregioKies een regio dicht bij je apparaat voor een lagere latentie.
    Lokaal IP-adres127.0.0.1 als MongoDB op hetzelfde apparaat draait als de client. Voor een server op een andere computer in het netwerk vul je het adres van die computer in.
    Lokale poort27017, of de waarde van net.port in mongod.conf.
    URL-typeWillekeurig subdomein. Met Eigen subdomein kies je zelf de naam; daarvoor is saldo nodig.

    Selecteer Tunnel aanmaken.

  3. De tunnel starten en het adres kopiëren #

    De tunnel verschijnt onder Je tunnels. Selecteer Starten. De kolom URL toont het openbare adres als host:port en de kolom Serverpoort toont de poort apart.

Van buitenaf verbinden #

MongoDB-clients gebruiken een verbindingsreeks. Gebruik de vorm mongodb:// met de host en poort van de tunnel. authSource noemt de database waarin de gebruiker is aangemaakt, meestal admin.

Verbindingsreeks
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin

Laat bij mongosh het wachtwoord uit de opdracht weg, zodat het niet in de geschiedenis van je shell wordt opgeslagen. mongosh vraagt er zelf om:

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

Plak in MongoDB Compass de verbindingsreeks in het veld URI van een nieuwe verbinding.

Gebruik de vorm mongodb+srv:// niet met een tunneladres. Die vorm zoekt DNS-records op die een tunnelhostnaam niet heeft.

MongoDB-instellingen die achter een tunnel belangrijk zijn #

Schakel toegangsbeheer in #

Maak eerst een beheerder aan, schakel daarna autorisatie in in mongod.conf en herstart MongoDB:

mongod.conf
security:
  authorization: enabled

Na de herstart kan een verbinding zonder inloggegevens geen gegevens meer lezen of wijzigen. De MongoDB-handleiding beschrijft de volledige procedure onder "Enable Access Control".

bindIp kan lokaal blijven #

De Localtonet-client verbindt vanaf je eigen apparaat met MongoDB. MongoDB hoeft niet op een openbare interface te luisteren: de standaard net.bindIp: 127.0.0.1 is genoeg wanneer de client op dezelfde computer draait. Laat het zo, zodat de tunnel het enige pad van buitenaf is.

Replicasets hebben een directe verbinding nodig #

Wanneer een driver verbinding maakt met een replicaset, antwoordt de server met de hostnamen van zijn leden en probeert de driver die namen vervolgens te bereiken. Het zijn de adressen binnen je netwerk, dus de verbinding blijft hangen of mislukt van buitenaf. Voeg directConnection=true toe aan de verbindingsreeks om op het adres van de tunnel te blijven:

Verbindingsreeks
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin&directConnection=true

Houd hetzelfde adres #

De hostnaam blijft bij de tunnel. De poort wordt door de server toegewezen wanneer de tunnel start. Met Gereserveerd? aan in de Instellingen van de tunnel blijft de poort hetzelfde wanneer de tunnel of de Localtonet-client opnieuw start, en dat heeft een verbindingsreeks in een applicatie nodig. Met de optie uit verandert de poort bij een herstart. Tunnels die je aanmaakt terwijl je account saldo heeft, starten met Gereserveerd? aan. Om de optie in te schakelen is saldo nodig en een gestarte tunnel.

Met saldo kun je de poort ook kiezen onder Serverpoort › Wijzigen, bijvoorbeeld 27017 als geen andere tunnel op die server die gebruikt. Zie Poorten.

Gratis-abonnement. Een TCP-tunnel stopt in het Gratis-abonnement na 30 minuten en kan opnieuw worden gestart. De poort kan na elke start anders zijn. Zie Abonnementen en saldo.

Beveilig het #

  • Toegangsbeheer in MongoDB, zoals hierboven beschreven. Dit is de ene stap die je niet kunt overslaan.
  • IP-beperking. Selecteer in de Instellingen van de tunnel IP-beperking › Beheren, kies Alleen deze toestaan en voeg de adressen toe van de applicaties en mensen die verbinden. Mijn IP gebruiken vult je huidige adres in. Wijzigingen gelden direct. Voor IP-beperking is saldo nodig. Zie Toegangsbeheer.
  • Een eigen gebruiker met rollen op de ene database die nodig is, bijvoorbeeld readWrite, in plaats van een beheerder.
  • TLS in MongoDB. Tunnels zijn standaard niet end-to-end versleuteld. Configureer net.tls op de server en voeg tls=true toe aan de verbindingsreeks, zodat inloggegevens en gegevens helemaal versleuteld zijn.
  • Limieten. Met Vervaldatum, Bandbreedtelimiet en Snelheidslimieten in de Instellingen van de tunnel beperk je hoe lang en hoeveel de tunnel kan worden gebruikt. Zie Limieten en vervaldatum.
  • Verzoeklogboek › Tonen toont de verbindingen die met de tunnel zijn gemaakt, met het IP-adres van de bezoeker. MongoDB zelf logt de Localtonet-client als bron van elke verbinding.

Veelvoorkomende problemen #

MongoServerSelectionError of MongoNetworkError: connection timed out

Controleer of de tunnel is gestart en de kolom Verbinding AAN toont, of je de huidige poort uit Serverpoort gebruikt en of MongoDB op het apparaat antwoordt op het Lokale IP-adres en de Lokale poort van de tunnel. Is de server een replicaset, voeg dan directConnection=true toe. Gebruik je IP-beperking, controleer dan of je huidige adres in de lijst staat.

MongoServerError: Authentication failed

De tunnel werkt en MongoDB heeft geantwoord. Controleer het wachtwoord en de authSource: dat moet de database zijn waarin de gebruiker is aangemaakt. Speciale tekens in de gebruikersnaam of het wachtwoord moeten in een verbindingsreeks percent-gecodeerd worden.

Ik kan gegevens lezen zonder in te loggen

Toegangsbeheer staat uit. Stop de tunnel, schakel security.authorization in, herstart MongoDB en start de tunnel daarna opnieuw.

De applicatie verloor na een herstart de verbinding

De poort is niet gereserveerd, dus is veranderd toen de tunnel of de client opnieuw startte. Schakel Gereserveerd? in, of werk de poort in de verbindingsreeks bij.

De tunnel stopte vanzelf na een half uur

In het Gratis-abonnement stopt een TCP-tunnel na 30 minuten. Selecteer Starten om een nieuwe sessie te beginnen, of voeg saldo toe om de sessielimiet op te heffen.

"Je moet saldo kopen om deze functie te gebruiken."

Gereserveerd?, Serverpoort, IP-beperking en Eigen subdomein vereisen saldo. Voeg het toe onder Saldo.

Support