> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SSH로 연결하기

> VM Cluster의 각 노드에 SSH로 접속하고, 자주 겪는 문제를 해결하는 방법을 안내해요.

클러스터의 각 노드에는 전용 공인 IP가 있고, Account manager가 클러스터에 등록한 대표 공개 키로 SSH 접속을 받아요.

## 사전 준비

* **Active** 상태의 클러스터가 필요해요.
* Account manager가 클러스터에 등록한 <strong>대표 SSH 공개 키</strong>와 짝이 되는 비밀 키가 필요해요.

## 연결하기

각 노드의 공인 IP는 클러스터의 **Node management** 탭에서 확인한 다음, 아래 명령으로 접속해요.

<div>
  <Frame>
    <img src="https://mintcdn.com/dora/5t6p_q3y3A1ut21q/images/vm-clusters-node-list.png?fit=max&auto=format&n=5t6p_q3y3A1ut21q&q=85&s=9d36221459882a923c0d709ec323d7a5" alt="각 노드의 공인 IP와 Copy all SSH config 버튼이 있는 Node management 탭" width="3600" height="2086" data-path="images/vm-clusters-node-list.png" />
  </Frame>

  <small>예시: 노드별 공인 IP와 Copy all SSH config 버튼이 있는 Node management 탭</small>
</div>

```bash theme={null}
ssh -i ~/.ssh/<key> ubuntu@<node-ip>
```

`ubuntu` 사용자로 로그인해요. root 권한으로 명령을 실행하려면 `sudo`로 권한을 올려요(예: `sudo -i`).

각 노드에는 저마다 전용 공인 IP가 있어요. **Node management** 탭에 표시된 IP로 노드마다 따로 접속하세요.

## 문제 해결

| 증상                              | 원인과 해결                                                                                                                                       |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `Permission denied (publickey)` | 클러스터에 등록한 키와 다른 키로 접속하고 있어요. 비밀 키가 등록한 공개 키와 짝이 맞는지 확인하세요.                                                                                   |
| 연결 타임아웃                         | 22번 포트로 들어오는 인바운드 트래픽이 허용되지 않았어요. [방화벽 규칙](/ko/vm-clusters/firewall-rules)에서 프로토콜 `tcp`, 포트 `22`로 인바운드 규칙을 추가하고, 소스 CIDR에 내 IP가 포함되도록 설정하세요. |