bootstrap-remote-codex은(는) 무엇을 하나요?
Codex Desktop을 SSH 점프 호스트를 통해 Docker 컨테이너에 연결하기 위한 재사용 가능한 Codex 스킬입니다.
개요
이 스킬은 Codex Desktop이 원격 Docker 컨테이너에 안전하게 연결할 수 있도록 SSH 점프 호스트를 구성합니다. 점프 호스트는 프록시 역할을 하여 직접 노출되지 않은 사설 네트워크의 Docker 호스트에 접근할 수 있게 합니다.
사용 방법
- SSH 키가 점프 호스트와 대상 Docker 호스트에 설정되어 있는지 확인합니다.
- 필요한 환경 변수를 설정합니다:
JUMP_HOST: SSH 점프 호스트 주소DOCKER_HOST_IP: 대상 Docker 호스트의 IP 주소SSH_USER: SSH 사용자 이름 (선택 사항, 기본값:root)SSH_PORT: SSH 포트 (선택 사항, 기본값:22)
- 이 스킬을 활성화하면 Codex Desktop이 자동으로 SSH 터널을 생성하고 원격 Docker 소켓에 연결합니다.
요구 사항
- Codex Desktop 설치됨
- SSH 클라이언트 (OpenSSH 권장)
- 점프 호스트와 Docker 호스트 모두에 SSH 접근 권한
- 원격 Docker 호스트에서 Docker 데몬 실행 중
지원 플랫폼
- Linux
- macOS
- Windows (WSL2 또는 Git Bash)
작동 방식
이 스킬은 SSH 로컬 포트 포워딩을 사용하여 원격 Docker 소켓(/var/run/docker.sock)을 로컬 시스템의 임시 포트로 터널링합니다. 그런 다음 Codex Desktop이 로컬 포트를 통해 원격 Docker 데몬과 통신합니다.
문제 해결
- SSH 연결이 거부되는 경우 SSH 키와 권한을 확인하십시오.
- Docker 명령어가 실패하면 원격 호스트에서 Docker 데몬이 실행 중인지 확인하십시오.
- 자세한 로그는
--verbose플래그를 사용하여 확인할 수 있습니다.
보안 정보
- SSH 키 기반 인증만 지원되며 비밀번호 인증은 지원되지 않습니다.
- 터널링된 연결은 로컬 시스템으로 제한됩니다 (기본적으로
127.0.0.1에 바인딩). - 점프 호스트와 Docker 호스트 모두 최소 권한 원칙에 따라 구성하는 것이 좋습니다.
라이선스
MIT