Accede a un servidor PostgreSQL a través de Localtonet
En esta página 9 secciones
- Cómo funciona
- Antes de empezar
- Crea el túnel
- Abre la página TCP - UDP
- Rellena el formulario
- Inicia el túnel y copia la dirección
- Conéctate desde fuera
- Ajustes de PostgreSQL que importan detrás de un túnel
- listen_addresses puede seguir siendo local
- pg_hba.conf decide según la dirección del cliente, y ese cliente es el de Localtonet
- Mantén la misma dirección
- Protégelo
- Problemas habituales
- Páginas relacionadas
Conéctate a un servidor PostgreSQL de tu máquina desde otra red con psql, pgAdmin, DBeaver o tu aplicación: un túnel TCP da al puerto 5432 un nombre de host y un puerto públicos.
Cómo funciona #
El cliente de Localtonet se ejecuta en la máquina que aloja PostgreSQL, o en otro dispositivo de la misma red. Un túnel TCP apunta al puerto de PostgreSQL, 5432. Localtonet da al túnel una dirección pública formada por un nombre de host y un puerto. Un cliente de PostgreSQL que se conecta a esa dirección llega a tu servidor. Los detalles de los túneles TCP están en la página TCP.
Revisa pg_hba.conf antes de iniciar el túnel. Las conexiones a través del túnel llegan a PostgreSQL desde el cliente de Localtonet, que es una dirección local. Si pg_hba.conf tiene una regla trust para 127.0.0.1, cualquiera que llegue al túnel entra sin contraseña. Consulta los ajustes más abajo.
Antes de empezar #
- Una cuenta de Localtonet y el cliente de Localtonet conectado con tu AuthToken. Consulta Inicio rápido.
- PostgreSQL en ejecución en el dispositivo. Comprueba que
psql -h 127.0.0.1 -p 5432 -U <DB_USER> -d <DB_NAME>funciona en el propio dispositivo y pide una contraseña. - Un rol de PostgreSQL para uso remoto, con una contraseña segura y solo los privilegios que necesita. No uses el superusuario
postgres.
Crea el túnel #
-
Abre la página TCP - UDP #
Abre Mis túneles › TCP - UDP y expande Crear túnel TCP - UDP.
-
Rellena el formulario #
Campo Qué introducir Protocolo TCP Token del dispositivo El token que usa el cliente de Localtonet del dispositivo. Región del servidor Elige una región cercana a tu dispositivo para tener menor latencia. Dirección IP local 127.0.0.1cuando PostgreSQL se ejecuta en el mismo dispositivo que el cliente. Para un servidor en otra máquina de la red, introduce la dirección de esa máquina.Puerto local 5432, o el valor deportenpostgresql.conf.Tipo de URL Subdominio aleatorio. Subdominio personalizado te permite elegir el nombre y requiere saldo. Selecciona Crear túnel.
-
Inicia el túnel y copia la dirección #
El túnel aparece en Tus túneles. Selecciona Iniciar. La columna URL muestra la dirección pública como
host:porty la columna Puerto del servidor muestra solo el puerto.
Conéctate desde fuera #
Con psql, el host va después de -h y el puerto después de -p en minúscula. psql pide la contraseña.
psql -h <TUNNEL_HOST> -p <TUNNEL_PORT> -U <DB_USER> -d <DB_NAME>Las aplicaciones suelen aceptar una URI de conexión. sslmode=require hace que el cliente rechace una sesión sin cifrar:
postgresql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?sslmode=requireEn pgAdmin o DBeaver, introduce el nombre de host del túnel en el campo de host y el puerto del túnel en el campo de puerto.
Ajustes de PostgreSQL que importan detrás de un túnel #
listen_addresses puede seguir siendo local #
El cliente de Localtonet se conecta a PostgreSQL desde tu propio dispositivo. PostgreSQL no tiene que escuchar en una interfaz pública: el valor predeterminado listen_addresses = 'localhost' basta cuando el cliente se ejecuta en la misma máquina. Déjalo así, de modo que el túnel sea la única vía desde fuera.
pg_hba.conf decide según la dirección del cliente, y ese cliente es el de Localtonet #
PostgreSQL elige el método de autenticación de pg_hba.conf según la dirección desde la que llega una conexión. A través del túnel, esa dirección es la del cliente de Localtonet: 127.0.0.1 cuando el cliente se ejecuta en la máquina de PostgreSQL. La regla que coincida debe exigir una contraseña:
# TYPE DATABASE USER ADDRESS METHOD
host <DB_NAME> <DB_USER> 127.0.0.1/32 scram-sha-256Sustituye cualquier regla trust para 127.0.0.1/32 o ::1/128 y recarga PostgreSQL. Si el cliente se ejecuta en otro dispositivo, usa la dirección de ese dispositivo en la regla y define listen_addresses para que PostgreSQL también escuche en su propia dirección de red.
Por la misma razón, las reglas de dirección de pg_hba.conf no pueden distinguir a unos visitantes de otros. Limita los visitantes en el túnel con Restricción de IP.
Mantén la misma dirección #
El nombre de host se queda con el túnel. El puerto lo asigna el servidor cuando el túnel se inicia. Con ¿Puerto reservado? activado en la Configuración del túnel, el puerto se mantiene igual cuando el túnel o el cliente de Localtonet se reinician, que es lo que necesita una URI de conexión en una aplicación. Con la opción desactivada, el puerto cambia en un reinicio. Los túneles que creas mientras tu cuenta tiene saldo se inician con ¿Puerto reservado? activado. Activarlo requiere saldo y un túnel iniciado.
Con saldo también puedes elegir el puerto en Puerto del servidor › Cambiar, por ejemplo 5432 si ningún otro túnel de ese servidor lo usa. Consulta Puertos.
Plan gratuito. Un túnel TCP se detiene tras 30 minutos en el plan gratuito y se puede volver a iniciar. El puerto puede ser distinto tras cada inicio. Consulta Planes y saldo.
Protégelo #
- Restricción de IP. En la Configuración del túnel, selecciona Restricción de IP › Gestionar, elige Permitir solo la lista y añade las direcciones de las aplicaciones y las personas que se conectan. Usar mi IP rellena tu dirección actual. Los cambios se aplican de inmediato. La Restricción de IP requiere saldo. Consulta Control de acceso.
- Autenticación con contraseña para las direcciones locales, como se describe arriba, y un rol dedicado sin derechos de superusuario.
- TLS en PostgreSQL. Los túneles no están cifrados de extremo a extremo de forma predeterminada, así que deja que PostgreSQL cifre la sesión: define
ssl = oncon un certificado en el servidor y conéctate consslmode=require. - Límites. Fecha de caducidad, Límite de ancho de banda y Límites de velocidad en la Configuración del túnel acotan cuánto tiempo y cuánto se puede usar el túnel. Consulta Límites y caducidad.
- Registro de solicitudes › Mostrar enumera las conexiones realizadas al túnel con la dirección IP del visitante.
Problemas habituales #
psql: connection refused, o la conexión agota el tiempo de espera
Comprueba que el túnel esté iniciado y que su columna Conexión muestre SÍ, que uses el puerto actual de Puerto del servidor y que PostgreSQL responda en el dispositivo, en la Dirección IP local y el Puerto local del túnel. Si usas Restricción de IP, comprueba que tu dirección actual esté en la lista.
FATAL: no pg_hba.conf entry for host "127.0.0.1"
El túnel funciona y PostgreSQL respondió. Ninguna regla de pg_hba.conf coincide con la dirección del cliente de Localtonet junto con tu usuario y tu base de datos. Añade la regla mostrada arriba y recarga PostgreSQL.
FATAL: password authentication failed for user "…"
El túnel funciona. Comprueba la contraseña del rol y que el rol tenga una: un rol creado sin contraseña no puede iniciar sesión con scram-sha-256.
Entré sin contraseña
Una regla trust coincide con la dirección del cliente de Localtonet. Detén el túnel, cambia la regla a scram-sha-256, recarga PostgreSQL y vuelve a iniciar el túnel.
La aplicación perdió su conexión tras un reinicio
El puerto no está reservado, así que cambió cuando se reiniciaron el túnel o el cliente. Activa ¿Puerto reservado? o actualiza el puerto en la aplicación.
El túnel se detuvo solo al cabo de media hora
En el plan gratuito, un túnel TCP se detiene tras 30 minutos. Selecciona Iniciar para empezar otra sesión, o añade saldo para quitar el límite de sesión.
"Necesitas comprar saldo para usar esta función."
¿Puerto reservado?, Puerto del servidor, Restricción de IP y Subdominio personalizado requieren saldo. Añádelo en Saldo.