SSHPortForwarder Support Doc.ko

🌐 English · العربية · Deutsch · Español · Français · Italiano · 日本語 · 한국어 · Nederlands · Português (BR) · Русский · ภาษาไทย · Türkçe · 简体中文 · 繁體中文

---

SSH 포트 포워더 지원 문서

시작하기

SSH 포트 포워더(SSHPortForwarder)는 SSH 포트 포워드와 SOCKS 프록시를 생성하는 macOS 앱입니다. 원격 호스트, 포트, 인증(비밀번호 또는 개인 키)을 구성한 후, 터미널을 떠나거나 SSH 설정을 변경하지 않고 로컬 포트나 SOCKS 프록시를 얻기 위해 포워드를 시작할 수 있습니다. 이 앱은 빠른 시작/중지를 위해 메뉴 바에서 실행할 수 있습니다. 구성, 비밀번호(Keychain에 저장), 키 파일 접근 권한은 사용자의 Mac에 유지되며, 앱은 사용자 데이터를 업로드하지 않습니다.

SSH 포트 포워더 시작하기

1. 앱을 다운로드하여 설치합니다(앱 스토어 또는 배포 채널에서).
2. 앱을 실행합니다. 구성을 관리하려면 메인 창을 사용하거나, 빠른 접근을 위해 메뉴 바 아이콘을 사용할 수 있습니다.
3. 포워딩 구성을 추가하거나 선택합니다:
   • 이름, 원격 호스트, SSH 포트(기본값 22), 사용자 이름을 입력합니다.
   • 인증 방법으로 비밀번호 또는 개인 키를 선택합니다. 개인 키를 사용하는 경우, 키 경로 옆의 찾아보기 버튼을 사용하여 키 파일을 선택합니다(샌드박스 환경에서 앱이 접근하려면 필요합니다).
   • SOCKS 프록시(로컬 SOCKS 프록시) 또는 로컬 포워드(특정 원격 포트를 로컬 포트로 포워드)를 선택하고, 로컬 포트(및 로컬 포워드의 경우 원격 포트)를 설정합니다.
4. 필요에 따라 테스트를 사용하여 시작 전 SSH 연결을 확인합니다.
5. 시작을 클릭하여 포워딩을 시작합니다. 메뉴 바 아이콘을 사용하여 포워드를 빠르게 시작하거나 중지할 수 있습니다.
6. 구성을 저장하여 지속적으로 유지합니다; 비밀번호를 사용하는 경우 시스템 Keychain에 저장됩니다.

중요: 개인 키 파일 및 재선택

개인 키 인증을 사용하고 앱에서 키 파일을 선택한 경우:

• 앱은 시스템 북마크(경로 + 파일 식별자)를 통해 해당 파일에 대한 접근 권한을 기억합니다.
• 해당 키 파일을 삭제한 후 동일한 이름(또는 동일한 경로)으로 새 파일을 생성하면, 앱은 여전히 이전 파일을 가리킵니다. 북마크가 무효화되거나 잘못된 파일을 가리킬 수 있습니다.
• 클라이언트에서 키 파일을 다시 선택해야 합니다: 구성을 열고, 키 경로 옆의 찾아보기를 클릭하여 새 키 파일을 선택한 후 저장합니다. 그렇지 않으면 앱이 연결에 실패하거나 권한 오류를 표시할 수 있습니다.

문제 해결

• 연결 또는 인증 실패

  • 원격 호스트, SSH 포트, 사용자 이름을 확인합니다.
  • 비밀번호 인증의 경우: 비밀번호가 정확하고 저장되었는지(Keychain) 확인합니다.
  • 개인 키의 경우: 찾아보기를 통해 키를 선택했는지, 키 형식이 지원되는지(OpenSSH 또는 PEM), 키에 암호가 있는 경우 프롬프트에 입력했는지 확인합니다. 키 파일을 교체한 경우(예: 동일한 이름으로 삭제 후 재생성), 앱에서 키 파일을 다시 선택하고 저장합니다.

• “키 파일을 읽을 권한이 없습니다” 또는 키 관련 오류

  • 찾아보기 버튼을 사용하여 개인 키 파일을 다시 선택한 후 저장합니다. 키 파일을 교체한 후(예: 동일한 경로/이름의 새 키)에도 필요합니다.

• 로컬 포트 사용 중

  • 구성에서 다른 로컬 포트를 선택하거나, 현재 포트를 사용 중인 애플리케이션을 중지합니다.

• 포워드가 시작되지 않거나 “연결 중” 상태 유지

  • 테스트를 실행하여 SSH 연결을 확인합니다. 방화벽과 네트워크를 확인합니다. 원격 호스트가 SSH를 허용하는지, 로컬 포워드의 경우 원격 포트가 올바른지 확인합니다.

• 메뉴 바 아이콘 또는 메인 창

  • 앱은 메뉴 바 아이콘만으로 실행할 수 있습니다. 구성을 위해 전체 창을 열거나 포워드를 시작/중지하려면 메뉴를 사용합니다.

피드백 및 제안

SSH 포트 포워더를 개선하기 위한 여러분의 피드백과 제안을 소중히 생각합니다.
아이디어나 제안이 있으시면 aidoge@yeah.net으로 보내주세요.

SSH 포트 포워더를 사용해 주셔서 감사합니다!