termal.in

← 블로그

방화벽 뒤의 데이터베이스에 연결 — 포트를 노출하지 않고 SSH 터널로

· Termalin Team sshport-forwardingdatabasetunnelingsecurity

어딘가의 서버에 데이터베이스가 있고, 노트북에서 거기에 닿고 싶습니다 — 쿼리를 돌리고, GUI를 연결하고, 마이그레이션 도구가 접속하게 하는 일입니다. 그 데이터베이스는 5432(Postgres)나 3306(MySQL)에서 수신 대기하는데, 지금 내 노트북은 거기에 닿지 못합니다. 데이터베이스가 바깥에서 들어갈 경로가 없는 사설 네트워크에 있기 때문입니다. 그래서 가장 빠른 다리를 찾아 나서는데, 인터넷은 즉시 통하면서 사설 네트워크가 지켜 주던 바로 그것을 슬그머니 앗아 가는 지름길을 내놓습니다.

실수: 데이터베이스 포트를 세상에 여는 것

그 지름길은 데이터베이스를 닿을 수 있게 만드는 것입니다: 127.0.0.1 대신 0.0.0.0에 바인딩하고, 포트 5432를 위해 보안 그룹에 구멍을 뚫으면, 이제 어디서든 접속할 수 있습니다. 첫 시도에 되는데, 그게 바로 위험한 이유입니다.

공개 인터넷에 노출된 데이터베이스 포트는 상시 표적입니다. Postgres와 MySQL은 잘 알려진 포트로 통신하고, 인터넷 전체가 끊임없이 그 포트를 훑습니다 — 5432의 리스너는 올라온 지 몇 분 안에 로그인 시도를 모으기 시작합니다. 이제 인터넷과 내 데이터 사이에 남은 것은 데이터베이스 자체의 비밀번호, 프로토콜의 사소한 결함 하나, 또는 CVE 하나뿐입니다. 관리형 데이터베이스는 이런 일을 실수로 하게 두지 않습니다: RDS, Cloud SQL 등은 기본적으로 공개 IP가 없는 사설 서브넷을 쓰는데, 바로 데이터베이스야말로 인터넷을 마주하게 하고 싶지 않은 마지막 대상이기 때문입니다. 그런데도 열어 버리는 것 — “지금만” 쓰는 0.0.0.0/0 규칙 — 은 몇 분을 아끼자고 설계 전체를 내다 버리는 셈입니다. 제대로 된 해법은 그만큼이나 적은 비용으로 아무것도 포기하지 않습니다.

데이터베이스로 가는 SSH 터널이 실제로 하는 일

거의 틀림없이 이미 그 네트워크로 들어가는 길이 있을 것입니다: 데이터베이스를 볼 수 있는 서버 — 앱 서버, bastion, 같은 서브넷의 아무 상자 — 로의 SSH 로그인 말입니다. SSH 포트 포워딩은 새로 무엇을 노출하지 않고도 그 도달 범위를 빌려 쓰게 해 줍니다.

ssh -L 5432:db.internal:5432 deploy@bastion.example.com

왼쪽에서 오른쪽으로 읽으세요: 내 노트북에서 포트 5432를 열고, 거기 도착하는 모든 것을 bastion에서 해석된 db.internal:5432로 전달합니다. 그런 다음 클라이언트가 localhost를 가리키게 합니다:

psql -h 127.0.0.1 -p 5432 -U app appdb

psql은 내 머신에 접속하고, SSH가 이미 갖고 있던 연결을 통해 바이트를 암호화해 나릅니다. bastion은 사설 네트워크 안쪽에서 db.internal로 평범한 연결을 여는데, 거기서는 그게 허용됩니다. 데이터베이스 관점에서는 바뀐 것이 없습니다 — 여전히 자기 네트워크에서 오는 연결만 받습니다. 그리고 인터넷 어디에도 새 포트가 열리지 않았습니다. 노출 없이 도달 가능성을 얻은 것입니다.

모두가 걸려 넘어지는 세부 하나: db.internal은 내 노트북이 아니라 bastion에 의해 반대편에서 해석됩니다. 사설 네트워크만 아는 이름일 수도 있고, 내 노트북이 라우팅할 수 없는 원시 주소일 수도 있습니다:

# bastion만 볼 수 있는 데이터베이스, 사설 IP로
ssh -L 5432:10.0.0.9:5432 deploy@bastion.example.com

그게 요령의 전부이고, 로컬·리모트·다이내믹까지 깊이 있게 SSH 포트 포워딩 설명에서 다룹니다. 여기서는 로컬(-L) 경우만 필요합니다.

터널의 출발점은 bastion

터널이 지나가는 상자는 보통 사설 네트워크에서 셸을 얻으려고 이미 점프하는 바로 그 게이트웨이입니다. 내부 서버에 ProxyJump로 닿는다면, 데이터베이스 터널에 필요한 조각을 이미 갖고 있는 셈입니다. 둘은 상호 보완적입니다: ProxyJump는 셸을 게이트웨이 뒤의 호스트로 올려 주고, -L은 반대편의 서비스 포트를 내 localhost로 가져옵니다. 두 게이트웨이를 거쳐야 한다면, 그것들을 체인으로 엮으세요:

ssh -J bastion.example.com -L 5432:db.internal:5432 deploy@app.internal

사람들이 여전히 터널을 틀리게 쓰는 이유

메커니즘은 깔끔합니다. 터널을 손으로 운영하는 일상이 바로 너덜너덜해지는 지점입니다:

  • 명령이 셸 기록 속에서 썩습니다. 다음 주면 어느 로컬 포트가 어느 데이터베이스에, 어느 bastion에서, 어느 환경에 매핑됐는지 다시 떠올리고 있습니다. 스테이징과 프로덕션 둘 다 5432를 원하는데, 노트북에서는 한 번에 하나씩만 쓸 수 있습니다.
  • 로컬 포트는 내 머신의 모든 프로세스에 열려 있습니다. -L 5432는 127.0.0.1:5432에서 수신 대기합니다 — 이제 노트북의 어떤 프로그램이든 터널이 떠 있는 동안 SSH 인증 없이 그걸 통해 프로덕션 데이터베이스에 닿을 수 있습니다. (그리고 -L 0.0.0.0:5432:...는 그것을 LAN 전체에 슬그머니 노출합니다.)
  • 터널이 세션 도중에 죽으면서 쿼리까지 데려갑니다. 노트북 절전, Wi-Fi 전환, 유휴 타임아웃이면 포워드가 조용히 끊깁니다 — 보통 -N, -f, ServerAliveInterval 30으로 해결하는데, 처음엔 그중 아무것도 기억나지 않았죠.
  • 데이터베이스마다 ssh -L 하나씩. 프라이머리, 읽기 복제본, MySQL 상자, Redis — 네 개의 로컬 포트에 네 개의 터널 명령이고, 각각 연결이 끊길 때마다 다시 실행해야 하며, 어느 것도 아직 떠 있는지 한눈에 알려 주지 않습니다.

저장된 ssh_config 블록 — LocalForward, ProxyJump, 킵얼라이브 — 이 대부분을 매끄럽게 다듬어 줍니다. 하지만 여전히 손으로 시작하고, 여전히 지켜보고, 여전히 클라이언트를 알맞은 루프백 포트로 직접 가리켜야 합니다.

Termalin의 Data 클라이언트는 어떻게 하나

Termalin은 최근 Data 클라이언트를 갖추게 된 크로스 플랫폼 SSH 클라이언트입니다 — 데스크톱 앱과 termal.in/account의 웹 캐비닛에 있는 데이터베이스 클라이언트죠. 데이터베이스는 서버를 추가하듯 추가합니다: 엔진을 고르고, 호스트와 포트와 자격 증명을, 선택적으로 기본 데이터베이스를 지정합니다. 폭넓은 엔진을 지원합니다 — PostgreSQL, MySQL, SQL Server, ClickHouse, MongoDB, Redis, Elasticsearch, Neo4j 등입니다. 이 글이 다루는 부분은 그 데이터베이스가 방화벽 뒤에 있을 때 무슨 일이 일어나는가입니다 — 포트를 열지도, ssh -L을 손으로 실행하지도 않습니다:

  • 이미 라우팅할 수 있는 네트워크의 데이터베이스는 직접 닿습니다. Termalin이 내가 준 호스트와 포트로 연결합니다.
  • 방화벽 뒤의 데이터베이스는 터널을 거쳐 닿습니다. 데스크톱에서는 저장된 SSH 호스트 — bastion, 점프 호스트 등 — 를 연결에 붙입니다. Termalin이 그 세션에 로컬 포워드를 열고 드라이버를 그 결과인 127.0.0.1:<port>로 가리켜 주므로, localhost에서만 수신하거나 VPN 뒤에 있는 데이터베이스가 마치 로컬인 것처럼 들어옵니다. 웹 캐비닛에서는 같은 일을 Connector가 합니다: Termalin이 Connector의 SSH 세션을 열고, 그것을 통해 루프백 포트를 포워딩하고, 그 위에서 쿼리를 실행합니다. 어느 쪽이든 암호화된 SSH 세션이 데이터베이스를 볼 수 있는 상자로 트래픽을 나르고, 데이터베이스 자체는 결코 인터넷을 마주하지 않습니다.

그래서 사설 서브넷이 주려던 것 — 자기 네트워크 안에서만 닿을 수 있는 데이터베이스 — 을 그대로 지키면서, 노트북에서는 제대로 작동하는 쿼리 편집기를 얻습니다. 터널은 연결과 함께 올라오고, 연결을 닫으면 그것이 연 루프백 포트와 함께 내려갑니다. 기억할 명령도, 돌봐야 할 포워드도, 보안 그룹에 남겨진 0.0.0.0/0 규칙도 없습니다.

터널은 권한 부여가 아니라 도달 가능성

분명히 짚어 둘 만합니다. 터널이 하지 않는 단 하나가 바로 이것이기 때문입니다: 데이터베이스까지 연결을 잇는 것은, 거기 닿은 뒤 무엇을 해도 되는지를 정하는 것과 같지 않습니다. 터널은 선이고, 선은 중립적입니다 — 반대편에 누가 있든 여전히 내가 건넨 데이터베이스 사용자로 접속합니다. 연결을 최소 권한 역할로 향하게 하고, 반대편에 에이전트가 올 거라면 그것을 별개의 결정으로 두세요 — 그건 이 글이 아니라 AI 에이전트에 읽기 전용 데이터베이스 액세스 주기(영어)의 주제입니다.

Termalin이 들어맞는 자리

개발자라면 누구나 ssh -L을 훤히 알아야 합니다 — 데이터베이스를 세상에 열지 않고 닿는 정직한 방법이고, 그 멘탈 모델(내 쪽에서 포트를 열고, 반대편이 볼 수 있는 무언가로 전달한다)이 핵심의 전부입니다. 마찰은 개념이 아니라 언제나 뒤치다꺼리였습니다: 기록 속의 명령들, 저글링하는 포트들, 끊기는 터널들, 데이터베이스마다 하나씩인 포워드 말입니다.

Termalin은 터널과 데이터베이스 연결을 하나의 저장된 대상으로 묶어 둡니다. 점프 호스트나 Connector를 붙이면, 사설 서브넷의 데이터베이스에 닿는 일은 클릭 한 번입니다 — 포워드는 연결과 함께 열리고, 드라이버는 루프백 포트를 대신 가리키며, 데이터베이스는 제자리에 정확히 머뭅니다: 방화벽 뒤에서, 자기 네트워크에만 귀 기울이며.


Termalin은 내장 터널, 점프 호스트, Data 클라이언트를 갖춘 무료 크로스 플랫폼 SSH·데이터베이스 클라이언트입니다 — 다운로드하거나, 키와 자격 증명을 안전하게 다루는 방식을 확인하세요.

호스트 한 대에서 먼저 써 보세요.

Termalin은 여러분과 여러분의 에이전트를 위한 빠른 SSH 클라이언트입니다.

무료 요금제 · Pro 14일 무료 체험 · 요금

Google에서 Termalin을 선호 소스로 추가