JetBrains SFTP

요약

PyCharm, GoLand, IntelliJ 등 JetBrains IDE는 SFTP 프로토콜을 사용하여 원격 서버의 파일을 탐색, 복사, 편집할 수 있습니다. 이 가이드는 Teleport와 JetBrains IDE를 사용하여 SFTP로 파일에 접근하는 방법을 설명합니다.

PyCharm, GoLand, IntelliJ 등 JetBrains IDE는 SFTP 프로토콜을 사용하여 원격 서버의 파일을 탐색, 복사, 편집할 수 있습니다. Teleport를 IDE와 통합하면 타사 클라이언트 없이도 원격 머신과 파일을 복사할 수 있습니다.

이 가이드는 Teleport와 JetBrains IDE를 사용하여 SFTP로 파일에 접근하는 방법을 설명합니다.

작동 방식#

JetBrains IDE는 로컬 SSH 클라이언트를 사용하여 원격 서버에 접근할 수 있습니다. Teleport를 사용하여 로컬 SSH 클라이언트에 대한 설정을 생성할 수 있으며, 이 설정은 Teleport가 발급한 OpenSSH 인증서를 사용하여 Teleport로 보호된 Linux 서버에 연결하도록 클라이언트에게 지시합니다.

사전 요구 사항#

A running Teleport cluster. If you want to get started with Teleport, sign up for a free trial or set up a demo environment.
The `tsh` client.
Installing \`tsh\` client
1. Determine the version of your Teleport cluster. The `tsh` client must be at most one major version behind your Teleport cluster version. Send a GET request to the Proxy Service at /v1/webapi/find and use a JSON query tool to obtain your cluster version. Replace with the web address of your Teleport Proxy Service:
```
$ TELEPORT_DOMAIN=
$ TELEPORT_VERSION="$(curl -s https://$TELEPORT_DOMAIN/v1/webapi/find | jq -r '.server_version')"
```
2. Follow the instructions for your platform to install `tsh` client:

PyCharm, IntelliJ, GoLand 등의 JetBrains IDE. 전체 JetBrains IDE 목록은 Products를 참조하세요.
하나 이상의 Teleport SSH Service 인스턴스. 아직 설정하지 않은 경우, 시작하기 가이드를 읽어 설정 방법을 알아보세요.

1/3단계. 최초 설정#

로컬 SSH 클라이언트가 서버에 접근하도록 설정하세요. --proxy 플래그에 Teleport Proxy Service의 주소를 지정하세요(Teleport Cloud 사용자의 경우 예: mytenant.teleport.sh).

# 프록시에 로그인:
$ tsh login --proxy proxy.foo.example.com --user alice

# 프록시에 대한 OpenSSH 설정 생성:
$ tsh config --proxy proxy.foo.example.com

결과로 나온 설정 스니펫을 아래 경로에 있는 SSH 설정 파일에 추가하세요:

$HOME/.ssh/config

%UserProfile%\.ssh\config

<div class="admonition warning"><div class="admonition-title">Warning</div>

Windows에서 PowerShell을 사용하여 SSH 설정을 작성하는 경우, 일반적인 셸 리디렉션이 잘못된 인코딩으로 파일을 작성할 수 있습니다. 올바르게 작성하려면 다음을 시도하세요:

  ```code
  $ tsh.exe config | out-file .ssh\config -encoding utf8 -append
  ```

user를 서버에서 사용하려는 사용자명으로 바꾸어 다음 명령으로 원하는 서버에 연결할 수 있어야 합니다:

$ ssh user@[server name].[cluster name]

Teleport Cloud

앞서 생성한 SSH 설정은 SSH 클라이언트가 Teleport 클러스터의 서버에 접근하기 위해 `tsh proxy ssh`를 실행하도록 지시합니다. 그러나 `yourtenant.teleport.sh`의 Teleport Proxy Service에 대해 `ssh` 명령을 실행하면 오류가 발생합니다.

Note

OpenSSH 서버의 포트 번호(기본적으로 22)를 포함하지 않으면 오류가 발생할 수 있습니다. 자세한 내용은 OpenSSH 가이드를 참조하세요. OpenSSH 서버에 연결하는 예시:

$ ssh -p 22 user@[server name].[cluster name]

2/3단계. JetBrains IDE 설정#

IDE를 열고 Tools -> Deployment -> Browse Remote Host로 이동하세요.

왼쪽 상단 모서리의 플러스 기호를 클릭하여 새 서버를 추가하세요.

서버 추가

새 서버의 이름을 입력하세요.

새 배포

위 그림과 같이 SSH configuration 옆의 세 점을 클릭하세요.

SSH 설정

왼쪽 상단의 플러스 기호를 클릭하고 다음 정보를 제공하여 새 설정을 생성하세요:

Host - Teleport 서버의 이름.
Port - Teleport 서버의 SSH 포트 (기본값 3022 또는 OpenSSH 서버의 경우 22).
Username - 시스템 사용자명.

Authentication type으로 OpenSSH config and authentication agent를 선택하세요. 그런 다음 Test Connection을 클릭할 수 있습니다.

성공적으로 연결됨

3/3단계. 원격 호스트 탐색#

SSH 설정 창을 닫으면 IDE에서 Remote Host 메뉴를 볼 수 있습니다.

탐색 창

Note

Teleport의 인증서는 상당히 빨리 만료되며, 만료되면 SSH 시도가 다음과 같은 오류로 실패합니다:

alice@proxy.foo.example.com: Permission denied (publickey).
ERROR: exit status 255

kex_exchange_identification: Connection closed by remote host

이 오류가 표시되면 tsh login을 다시 실행하여 로컬 인증서를 갱신하세요.

다음 단계#

OpenSSH 클라이언트 사용#

이 가이드는 tsh config를 사용합니다. 추가 정보는 전용 가이드를 참조하세요.

추가 읽기 자료#

JetBrains - 원격 서버 설정 생성

JetBrains SFTP

원문 보기

번역일: 2026-04-04

요약

이 가이드는 Teleport와 JetBrains IDE를 사용하여 SFTP로 파일에 접근하는 방법을 설명합니다.

작동 방식#

사전 요구 사항#

A running Teleport cluster. If you want to get started with Teleport, sign up for a free trial or set up a demo environment.
The `tsh` client.
Installing \`tsh\` client
1. Determine the version of your Teleport cluster. The `tsh` client must be at most one major version behind your Teleport cluster version. Send a GET request to the Proxy Service at /v1/webapi/find and use a JSON query tool to obtain your cluster version. Replace with the web address of your Teleport Proxy Service:
```
$ TELEPORT_DOMAIN=
$ TELEPORT_VERSION="$(curl -s https://$TELEPORT_DOMAIN/v1/webapi/find | jq -r '.server_version')"
```
2. Follow the instructions for your platform to install `tsh` client:

PyCharm, IntelliJ, GoLand 등의 JetBrains IDE. 전체 JetBrains IDE 목록은 Products를 참조하세요.
하나 이상의 Teleport SSH Service 인스턴스. 아직 설정하지 않은 경우, 시작하기 가이드를 읽어 설정 방법을 알아보세요.

1/3단계. 최초 설정#

# 프록시에 로그인:
$ tsh login --proxy proxy.foo.example.com --user alice

# 프록시에 대한 OpenSSH 설정 생성:
$ tsh config --proxy proxy.foo.example.com

결과로 나온 설정 스니펫을 아래 경로에 있는 SSH 설정 파일에 추가하세요:

$HOME/.ssh/config

%UserProfile%\.ssh\config

<div class="admonition warning"><div class="admonition-title">Warning</div>

  ```code
  $ tsh.exe config | out-file .ssh\config -encoding utf8 -append
  ```

user를 서버에서 사용하려는 사용자명으로 바꾸어 다음 명령으로 원하는 서버에 연결할 수 있어야 합니다:

$ ssh user@[server name].[cluster name]

Teleport Cloud

Note

$ ssh -p 22 user@[server name].[cluster name]

2/3단계. JetBrains IDE 설정#

IDE를 열고 Tools -> Deployment -> Browse Remote Host로 이동하세요.

왼쪽 상단 모서리의 플러스 기호를 클릭하여 새 서버를 추가하세요.

서버 추가

새 서버의 이름을 입력하세요.

새 배포

위 그림과 같이 SSH configuration 옆의 세 점을 클릭하세요.

SSH 설정

왼쪽 상단의 플러스 기호를 클릭하고 다음 정보를 제공하여 새 설정을 생성하세요:

Host - Teleport 서버의 이름.
Port - Teleport 서버의 SSH 포트 (기본값 3022 또는 OpenSSH 서버의 경우 22).
Username - 시스템 사용자명.

Authentication type으로 OpenSSH config and authentication agent를 선택하세요. 그런 다음 Test Connection을 클릭할 수 있습니다.

성공적으로 연결됨

3/3단계. 원격 호스트 탐색#

SSH 설정 창을 닫으면 IDE에서 Remote Host 메뉴를 볼 수 있습니다.

탐색 창

Note

Teleport의 인증서는 상당히 빨리 만료되며, 만료되면 SSH 시도가 다음과 같은 오류로 실패합니다:

alice@proxy.foo.example.com: Permission denied (publickey).
ERROR: exit status 255

kex_exchange_identification: Connection closed by remote host

이 오류가 표시되면 tsh login을 다시 실행하여 로컬 인증서를 갱신하세요.

다음 단계#

OpenSSH 클라이언트 사용#

이 가이드는 tsh config를 사용합니다. 추가 정보는 전용 가이드를 참조하세요.

추가 읽기 자료#

JetBrains - 원격 서버 설정 생성