🔑 SSH 키 만들기와 등록

일반 설정·로그 작업은 Carrot Web으로 충분합니다. SSH는 진단이나 개발에 필요한 경우에 사용합니다.

공개키와 개인키

파일	역할	보관
id_ed25519.pub	장치가 접속자를 확인하는 공개키	GitHub의 인증용 SSH 공개키에 등록
id_ed25519	접속할 때 증명하는 개인키	본인 PC·휴대폰에만 보관

개인키를 GitHub, 채팅, 공개 문서에 붙여넣지 않습니다. 장치의 GitHub 사용자 등록은 해당 계정의 SSH 공개키를 가져오는 흐름입니다.

Windows PC 예시

아래는 PC PowerShell에서 실행하는 명령입니다.

ssh-keygen -t ed25519 -C "carrotpilot-device-access"

저장 위치를 확인하고 키 암호를 설정합니다. 기존 키가 있다면 덮어쓰지 않고 다른 이름을 지정합니다. 기본 위치는 사용자 홈의 .ssh 폴더입니다.

1. GitHub 계정 설정의 SSH keys에서 생성한 .pub 내용을 인증용 키로 등록합니다.
2. 장치에서 SSH를 켜고 GitHub 사용자명을 등록합니다. 장치 UI 형태에 따라 메뉴 위치는 다를 수 있습니다.
3. 같은 네트워크의 PC에서 해당 개인키로 접속합니다.

ssh -i "$env:USERPROFILE/.ssh/id_ed25519" comma@192.168.0.25

IP는 예시이며 내 장치 IP로 바꿉니다. 최초 호스트 키 확인은 대상 장치가 맞는지 확인한 뒤 진행합니다.

접속이 안 될 때

• Timeout: 장치 전원·같은 네트워크·현재 IP·SSH 활성화를 확인합니다.
• Permission denied: 사용자 comma, 선택한 개인키, GitHub에 등록된 공개키를 확인합니다.
• .pub 선택: 개인키가 필요한 접속 앱에 공개키를 넣은 것은 아닌지 확인합니다.
• 호스트 키 변경: IP 재사용·재설치 여부를 확인한 뒤 처리합니다.

PC로 접속 · 휴대폰으로 접속.

---

문서 기준

2026-10-30 확인 · carrot-wip · 10bf0a56.

openpilot/selfdrive/ui/widgets/ssh_key.py · docs/user/ko/carrot-web.md

개발 브랜치는 계속 변경됩니다. 내 장치의 브랜치·커밋·현재 설정을 함께 확인하세요.