이 가이드는 Windows 시스템에 Teleport를 설치하는 방법을 설명합니다.

Teleport 설치 방법 및 지원 플랫폼 개요는 설치를 참조하세요.

운영 체제 지원#

[1] tsh는 커맨드 라인 클라이언트(CLI)이며, Teleport Connect는 그래픽 사용자 인터페이스(GUI) 데스크톱 클라이언트입니다. 사용법 및 설치는 Teleport Connect 사용하기를 참조하세요.

[2] Teleport 서버는 아직 Windows에서 실행되지 않지만, tsh, tbot, tctl 및 Teleport Connect(Teleport 데스크톱 클라이언트)는 Windows 10 이상에서 대부분의 기능을 지원합니다.

최상의 결과를 위해서는 Teleport 클라이언트(tsh, tctl, tbot)가 연결하는 클러스터와 동일한 메이저 버전이어야 합니다. Teleport 서버는 동일한 메이저 버전 또는 한 메이저 버전 낮은 클라이언트와 호환됩니다. Teleport 서버는 더 새로운 메이저 버전의 클라이언트를 지원하지 않습니다. 자세한 내용은 업그레이드 가이드를 참고하십시오.

Teleport CLI 도구 설치#

대부분의 tsh 기능은 Windows 10 1607 이상에서 지원됩니다. tsh ssh 명령은 cmd.exe, PowerShell, Windows Terminal에서 실행할 수 있습니다.

Windows에 tsh, tbot, tctl을 설치하려면 PowerShell에서 다음 명령을 실행하십시오(이 명령들은 cmd.exe에서는 동작하지 않습니다):

Teleport Enterprise (Cloud)

# Set the desired teleport version
$ $TELEPORT_VERSION="(=cloud.version=)"

Teleport Enterprise (Self-Hosted)

# Set the desired teleport version
$ $TELEPORT_VERSION="(=teleport.version=)"

Teleport Community Edition

# Set the desired teleport version
$ $TELEPORT_VERSION="(=teleport.version=)"

  # Set the TLS level to TLS 1.2 (required on Windows Server 2016 and lower)
  $ [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  # Get the expected checksum for the Windows tsh package
  $ $Resp = Invoke-WebRequest https://cdn.teleport.dev/teleport-v$TELEPORT_VERSION-windows-amd64-bin.zip.sha256
  # PowerShell will return the binary representation of the response content
  # by default, so you need to convert it to a string
  $ [System.Text.Encoding]::UTF8.getstring($Resp.Content)
  # <checksum> <filename>
  $ Invoke-WebRequest -OutFile teleport-v$TELEPORT_VERSION-windows-amd64-bin.zip -Uri https://cdn.teleport.dev/teleport-v$TELEPORT_VERSION-windows-amd64-bin.zip
  $ certUtil -hashfile teleport-v$TELEPORT_VERSION-windows-amd64-bin.zip SHA256
  # SHA256 hash of teleport-v$TELEPORT_VERSION-windows-amd64-bin.zip:
  # <checksum>
  # CertUtil: -hashfile command completed successfully.

체크섬이 일치하는지 확인한 후, 아카이브를 추출할 수 있습니다. 실행 파일은 teleport-v$TELEPORT_VERSION-windows-amd64-bin\에서 사용할 수 있습니다.

$ Expand-Archive teleport-v$TELEPORT_VERSION-windows-amd64-bin.zip
$ cd teleport-v$TELEPORT_VERSION-windows-amd64-bin
$ .\tsh.exe version
Teleport v$TELEPORT_VERSION git:v$TELEPORT_VERSION go(=teleport.golang=)
$ .\tctl.exe version
Teleport v$TELEPORT_VERSION git:v$TELEPORT_VERSION go(=teleport.golang=)
$ .\tbot.exe version
Teleport v$TELEPORT_VERSION git:v$TELEPORT_VERSION go(=teleport.golang=)

tsh.exe, tbot.exe, tctl.exe를 반드시 PATH로 이동시키십시오.

`tsh.exe`를 `System32` 디렉터리에 두지 마십시오. WinSCP를 사용할 때 문제가 발생할 수 있습니다.
대신 이미 `%PATH%`에 포함되어 있는 `%SystemRoot%`(예: `C:\Windows`)를 사용하십시오.

사용 중인 Windows 시스템에 관리자 권한이 없는 경우, 대신 `%USERPROFILE%`
(예: `C:\Users\<username>`)를 사용할 수 있습니다. 다만 이 경우 `tsh.exe`와 같은 디렉터리에 있지 않으면
명령줄에서 `tsh` 명령을 전역적으로 실행할 수 없다는 점에 유의하십시오.