Session Manager Plugin for the AWS CLI

어떤 작업에 사용하는가

AWS 서버를 관리하는 개발자와 운영자가 로컬 터미널에서 원격 점검할 때 사용하는 도구입니다. 플러그인은 사용자 컴퓨터에 설치하고, 접속 대상에는 SSM Agent가 실행되어야 합니다. 일반 셸 연결은 서버의 인바운드 관리 포트나 별도 배스천 서버 없이 구성할 수 있습니다. 접근 대상과 작업 권한은 IAM 정책으로 통제합니다. 이러한 접근 제어는 플러그인 단독 기능이 아니라 Session Manager 서비스와의 연동으로 제공됩니다.

지원 환경과 버전 검토

공식 설치 문서는 macOS 외에 Windows Server, Linux, Ubuntu Server를 안내합니다. Mac에는 Intel용 x86_64와 Apple silicon용 패키지가 있습니다. AWS CLI의 문서상 최소 버전은 1.16.12입니다.

2026-10-24 확인한 공식 GitHub 배포 목록에서는 1.2.896.0이 최신으로 표시됩니다. 공식 버전 이력 문서는 최소 지원 버전을 1.2.764.0으로 명시하므로 이전 버전 사용자는 업데이트를 검토해야 합니다. 제품 전체의 지원 종료 공지는 확인되지 않았습니다. 2026-12-31 폐지 예고는 기존 Session Manager 콘솔 페이지에 관한 것으로, 기능은 통합 콘솔에서 계속 제공된다고 안내합니다.

Mac 설치와 첫 접속 순서

먼저 AWS CLI를 설치하고 사용할 계정 인증과 리전을 구성합니다. 대상 서버의 SSM Agent, 노드 역할, 사용자 세션 권한과 서비스 엔드포인트 연결도 준비합니다. 이후 공식 macOS 설치 문서에서 칩에 맞는 서명된 .pkg를 받아 설치하고 안내된 심볼릭 링크를 생성합니다.

session-manager-plugin --version으로 버전을 확인한 뒤 aws ssm start-session --target 실제_인스턴스_ID로 첫 연결을 시작합니다. ZIP 번들 방식을 선택한다면 Python 3.10 이상 요구와 공백이 포함된 설치 경로 제한을 확인해야 합니다. .pkg 설치 명령이 실패할 때는 /usr/local/bin 디렉터리 존재 여부도 살펴봅니다.

실무 활용과 기록의 한계

예를 들어 비공개 서버에서 실행 중인 웹 관리 화면을 점검할 때 서버 포트를 Mac의 로컬 포트로 전달하고, 브라우저에서 해당 로컬 주소를 열 수 있습니다. 셸 세션으로 접속해 서비스 상태를 점검하는 방식도 가능합니다.

일반 세션의 입출력 기록은 설정에 따라 S3나 CloudWatch Logs에 보낼 수 있습니다. 다만 SSH와 포트 포워딩 세션의 내용 로깅은 지원하지 않습니다. API 호출 이력과 실제 명령·통신 내용 기록을 구분해 감사 요구에 맞는 연결 방식을 선택해야 합니다.

무료 배포와 AWS 이용 비용

플러그인은 Apache 2.0 라이선스로 공개되어 있습니다. 무료판과 유료판의 기능 차이보다 연결 대상과 연동 서비스의 과금 조건을 확인하는 것이 중요합니다. 공식 요금표상 EC2에서 Session Manager를 사용하는 데는 추가 요금이 없습니다.

하이브리드·멀티클라우드 노드는 2026-09-30부터 세션당 미화 0.05달러가 적용됩니다. 기존 Advanced Instances Tier는 2026-06-30 제거되었으므로 과거의 인스턴스별 요금 설명을 그대로 적용하면 안 됩니다. 서버 실행, 로그 저장, 데이터 전송 등 함께 사용하는 AWS 자원에는 별도 비용이 발생할 수 있습니다.

접속 실패 시 확인 순서

플러그인을 찾지 못한다면 설치 여부, 실행 파일 위치, 터미널의 PATH와 심볼릭 링크부터 확인합니다. 권한 오류라면 사용 중인 AWS 계정과 IAM 세션 권한을 점검합니다. 대상이 연결되지 않거나 SSM Agent가 오프라인이면 계정·리전·대상 ID가 맞는지 확인한 다음 에이전트 상태와 노드 역할을 살펴봅니다. 이어 방화벽, 라우팅, 프록시가 Systems Manager 엔드포인트 통신을 막는지 확인하는 순서가 적절합니다.

다른 접속 방식과 선택 기준

간헐적인 셸 점검에는 AWS 콘솔의 브라우저 세션도 선택할 수 있습니다. Mac 터미널 작업 흐름을 유지하거나 포트 포워딩이 필요하다면 AWS CLI와 이 플러그인 조합이 적합합니다. 기존 SSH 도구를 계속 사용하려면 대상의 SSH 설정과 인증서를 별도로 준비해야 하며, Session Manager 터널을 쓴다고 SSH 자체의 인증 요구가 없어지지는 않습니다.

공식 안내

• Install the Session Manager plugin for the AWS CLI · 확인 2026-10-24
• Install the Session Manager plugin on macOS · 확인 2026-10-24
• Releases · aws/session-manager-plugin · 확인 2026-10-24
• Session Manager plugin latest version and release history · 확인 2026-10-24
• AWS Systems Manager Session Manager · 확인 2026-10-24
• Start a session · 확인 2026-10-24
• Troubleshooting Session Manager · 확인 2026-10-24
• AWS Systems Manager pricing · 확인 2026-10-24
• aws/session-manager-plugin · 확인 2026-10-24