본문으로 건너뛰기
Localtonet Localtonet 대시보드

Localtonet으로 PostgreSQL 서버에 접속하기

이 페이지 도움받기
이 페이지의 내용 섹션 9개
  1. 작동 방식
  2. 시작하기 전에
  3. 터널 만들기
  4. TCP - UDP 페이지 열기
  5. 양식 작성하기
  6. 터널을 시작하고 주소 복사하기
  7. 외부에서 연결하기
  8. 터널 뒤에서 중요한 PostgreSQL 설정
  9. listen_addresses는 로컬로 둬도 됩니다
  10. pg_hba.conf는 클라이언트의 주소로 판단하며, 그 주소는 Localtonet 클라이언트입니다
  11. 같은 주소 유지하기
  12. 보안 설정하기
  13. 자주 발생하는 문제
  14. 관련 페이지

다른 네트워크에서 psql, pgAdmin, DBeaver 또는 애플리케이션으로 내 컴퓨터의 PostgreSQL 서버에 연결합니다. TCP 터널이 포트 5432에 공개 호스트 이름과 포트를 부여합니다.

작동 방식 #

Localtonet 클라이언트는 PostgreSQL을 호스팅하는 컴퓨터 또는 같은 네트워크의 다른 기기에서 실행됩니다. TCP 터널은 PostgreSQL 포트인 5432를 가리킵니다. Localtonet은 터널에 호스트 이름과 포트로 이루어진 공개 주소를 부여합니다. 이 주소로 연결하는 PostgreSQL 클라이언트가 내 서버에 도달합니다. TCP 터널에 대한 자세한 내용은 TCP 페이지에 있습니다.

터널을 시작하기 전에 pg_hba.conf를 확인하세요. 터널을 통한 연결은 Localtonet 클라이언트에서 PostgreSQL에 도달하며, 이는 로컬 주소입니다. pg_hba.conf에 127.0.0.1에 대한 trust 규칙이 있으면, 터널에 도달한 누구나 비밀번호 없이 접속할 수 있습니다. 아래 설정을 참고하세요.

시작하기 전에 #

  • Localtonet 계정, 그리고 AuthToken으로 연결된 Localtonet 클라이언트가 필요합니다. 빠른 시작을 참고하세요.
  • 기기에서 PostgreSQL이 실행 중이어야 합니다. 기기에서 직접 psql -h 127.0.0.1 -p 5432 -U <DB_USER> -d <DB_NAME>이 작동하고 비밀번호를 요구하는지 확인하세요.
  • 원격 사용을 위한 PostgreSQL 롤이 필요합니다. 강력한 비밀번호를 설정하고 필요한 권한만 부여하세요. postgres 슈퍼유저는 사용하지 마세요.

터널 만들기 #

  1. TCP - UDP 페이지 열기 #

    내 터널 › TCP - UDP를 열고 TCP - UDP 터널 만들기를 펼칩니다.

  2. 양식 작성하기 #

    항목입력할 내용
    프로토콜TCP
    기기 토큰기기의 Localtonet 클라이언트가 사용하는 토큰입니다.
    서버 리전지연 시간을 줄이려면 기기와 가까운 리전을 선택하세요.
    로컬 IP 주소PostgreSQL이 클라이언트와 같은 기기에서 실행된다면 127.0.0.1. 네트워크의 다른 컴퓨터에 있는 서버라면 해당 컴퓨터의 주소를 입력하세요.
    로컬 포트5432, 또는 postgresql.conf의 port 값.
    URL 유형랜덤 서브도메인. 커스텀 서브도메인은 이름을 직접 정할 수 있으며 잔액이 필요합니다.

    터널 만들기를 선택합니다.

  3. 터널을 시작하고 주소 복사하기 #

    터널이 내 터널 아래에 나타납니다. 시작을 선택하세요. URL 열에 공개 주소가 host:port 형식으로 표시되고, 서버 포트 열에는 포트만 따로 표시됩니다.

외부에서 연결하기 #

psql에서는 호스트를 -h 뒤에, 포트를 소문자 -p 뒤에 입력합니다. psql이 비밀번호를 묻습니다.

터미널
psql -h <TUNNEL_HOST> -p <TUNNEL_PORT> -U <DB_USER> -d <DB_NAME>

애플리케이션에서는 보통 연결 URI를 사용합니다. sslmode=require를 지정하면 클라이언트가 암호화되지 않은 세션을 거부합니다.

연결 URI
postgresql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?sslmode=require

pgAdmin이나 DBeaver에서는 호스트 필드에 터널의 호스트 이름을, 포트 필드에 터널의 포트를 입력하세요.

터널 뒤에서 중요한 PostgreSQL 설정 #

listen_addresses는 로컬로 둬도 됩니다 #

Localtonet 클라이언트는 내 기기에서 PostgreSQL에 연결합니다. PostgreSQL이 공개 인터페이스에서 수신 대기할 필요는 없습니다. 클라이언트가 같은 컴퓨터에서 실행된다면 기본값인 listen_addresses = 'localhost'로 충분합니다. 이 설정을 그대로 두면 터널이 외부에서 들어오는 유일한 경로가 됩니다.

pg_hba.conf는 클라이언트의 주소로 판단하며, 그 주소는 Localtonet 클라이언트입니다 #

PostgreSQL은 연결이 들어오는 주소에 따라 pg_hba.conf에서 인증 방식을 고릅니다. 터널을 통하면 그 주소는 Localtonet 클라이언트입니다. 클라이언트가 PostgreSQL 컴퓨터에서 실행된다면 127.0.0.1입니다. 이에 해당하는 규칙은 비밀번호를 요구해야 합니다.

pg_hba.conf
# TYPE  DATABASE   USER        ADDRESS         METHOD
host    <DB_NAME>  <DB_USER>   127.0.0.1/32    scram-sha-256

127.0.0.1/32 또는 ::1/128에 대한 trust 규칙이 있다면 모두 바꾸고 PostgreSQL을 다시 로드하세요. 클라이언트가 다른 기기에서 실행된다면 규칙에 그 기기의 주소를 사용하고, PostgreSQL이 자신의 네트워크 주소에서도 수신 대기하도록 listen_addresses를 설정하세요.

같은 이유로 pg_hba.conf의 주소 규칙으로는 방문자를 구분할 수 없습니다. 대신 터널의 IP 제한으로 방문자를 제한하세요.

같은 주소 유지하기 #

호스트 이름은 터널에 고정되어 있습니다. 포트는 터널이 시작될 때 서버가 할당합니다. 터널의 설정에서 포트 예약을 켜 두면 터널이나 Localtonet 클라이언트가 다시 시작되어도 포트가 그대로 유지되며, 애플리케이션의 연결 URI에 필요한 것이 바로 이것입니다. 꺼 두면 다시 시작할 때 포트가 바뀝니다. 계정에 잔액이 있는 상태에서 만든 터널은 포트 예약이 켜진 채로 시작됩니다. 이 옵션을 켜려면 잔액과 시작된 터널이 필요합니다.

잔액이 있으면 서버 포트 › 변경에서 포트도 직접 선택할 수 있습니다. 예를 들어 해당 서버의 다른 터널이 사용하지 않는다면 5432를 고를 수 있습니다. 포트를 참고하세요.

무료 플랜. 무료 플랜에서는 TCP 터널이 30분 후에 중지되며 다시 시작할 수 있습니다. 시작할 때마다 포트가 달라질 수 있습니다. 플랜 및 잔액을 참고하세요.

보안 설정하기 #

  • IP 제한. 터널의 설정에서 IP 제한 › 관리를 선택하고 이 항목만 허용을 고른 다음, 연결하는 애플리케이션과 사람의 주소를 추가하세요. 내 IP 사용을 선택하면 현재 주소가 채워집니다. 변경 사항은 즉시 적용됩니다. IP 제한에는 잔액이 필요합니다. 접근 제어를 참고하세요.
  • 로컬 주소에 대한 비밀번호 인증(위에서 설명한 대로)과 슈퍼유저 권한이 없는 전용 롤.
  • PostgreSQL의 TLS. 터널은 기본적으로 종단 간 암호화되지 않으므로 PostgreSQL이 세션을 암호화하게 하세요. 서버에 인증서를 두고 ssl = on을 설정한 다음 sslmode=require로 연결합니다.
  • 제한. 터널의 설정에 있는 만료일, 대역폭 제한, 속도 제한으로 터널을 얼마나 오래, 얼마나 많이 사용할 수 있는지 제한합니다. 제한 및 만료를 참고하세요.
  • 요청 로그 › 표시에는 터널에 연결한 내역이 방문자의 IP 주소와 함께 나열됩니다.

자주 발생하는 문제 #

psql: connection refused 또는 연결 시간 초과

터널이 시작되었고 연결 열에 켜짐이 표시되는지, 서버 포트의 현재 포트를 사용하고 있는지, 기기에서 터널의 로컬 IP 주소와 로컬 포트로 PostgreSQL이 응답하는지 확인하세요. IP 제한을 사용한다면 현재 주소가 목록에 있는지 확인하세요.

FATAL: no pg_hba.conf entry for host "127.0.0.1"

터널은 작동하며 PostgreSQL이 응답했습니다. pg_hba.conf에 Localtonet 클라이언트의 주소와 내 사용자 및 데이터베이스에 모두 일치하는 규칙이 없습니다. 위에 나온 규칙을 추가하고 PostgreSQL을 다시 로드하세요.

FATAL: password authentication failed for user "…"

터널은 작동합니다. 롤의 비밀번호가 맞는지, 그리고 롤에 비밀번호가 있는지 확인하세요. 비밀번호 없이 만든 롤은 scram-sha-256으로 로그인할 수 없습니다.

비밀번호 없이 접속되었습니다

trust 규칙이 Localtonet 클라이언트의 주소와 일치합니다. 터널을 중지하고, 규칙을 scram-sha-256으로 바꾸고, PostgreSQL을 다시 로드한 다음, 터널을 다시 시작하세요.

다시 시작한 후 애플리케이션의 연결이 끊어졌습니다

포트가 예약되지 않아서 터널이나 클라이언트를 다시 시작할 때 바뀐 것입니다. 포트 예약을 켜거나 애플리케이션의 포트를 업데이트하세요.

터널이 30분 후에 저절로 중지되었습니다

무료 플랜에서는 TCP 터널이 30분 후에 중지됩니다. 시작을 선택해 새 세션을 시작하거나, 잔액을 추가해 세션 제한을 없애세요.

"이 기능을 사용하려면 잔액을 구매해야 합니다."

포트 예약, 서버 포트, IP 제한, 커스텀 서브도메인에는 잔액이 필요합니다. 잔액에서 추가하세요.

이 페이지에 도움이 필요하신가요? 커뮤니티에 질문하거나 지원 티켓을 만들어 주세요.

지원