cmux Cloud
Cloud 보안 및 문제 해결
이 페이지는 cmux Cloud가 머신을 비공개로 유지하는 방식을 설명하고, 흔한 오류와 해결 방법을 정리합니다.
보안 모델
- 머신에는 공개 인바운드 포트가 없습니다. 로그인된 본인의 Mac만 각 Mac에 보관된 WireGuard 키로 머신에 연결할 수 있습니다.
- 로그아웃하거나 Mac의 접근을 취소하면 그 Mac의 모든 네트워크 접근과 세션이 제거됩니다.
- 머신에는 cmux 계정 토큰이나 제어용 자격 증명이 저장되지 않습니다. 모델 자격 증명은 머신 외부에서 추가됩니다.
- 환경 변수와 시크릿 파일은 암호화된 cmux 링크로 전송되며 화면에 표시되지 않습니다.
- 파일 업로드에는 15분 후 만료되는 일회용 키와 고정된 호스트 키를 사용합니다. 파일 데이터는 cmux API를 거치지 않습니다.
- 머신의 모든 에이전트는 같은 Linux 사용자로 실행됩니다. 파일을 공유하면 안 되는 작업은 별도의 머신으로 나누세요.
- 로그인되어 있는 동안 cmux Cloud는 연결 타이밍과 오류 코드를 전송합니다. 터미널 내용과 자격 증명은 절대 전송되지 않습니다.
- 관리자는 관리 정책으로 Cloud Machines나 파일 전송을 끌 수 있습니다.
흔한 문제
| 문제 | 해결 방법 |
|---|---|
| Cloud 탭이나 New Cloud Machine 명령이 없음 | Settings › Beta Features › Cloud Machines를 켜세요. 그래도 Cloud가 보이지 않으면 관리자가 Cloud Machines를 비활성화했는지 확인하세요. |
| Cloud Machines가 비활성화되었거나 사용할 수 없음 | Cloud Machines는 Settings의 로컬 토글이 꺼져 있거나 관리자가 Cloud를 비활성화했기 때문에 꺼져 있습니다. 토글을 켜거나 관리자에게 Cloud 허용을 요청하세요. |
| Cloud VM에 접근하려면 로그인이 필요함 | cmux auth login을 실행한 뒤 다시 시도하세요. 세션이 거부되었다면 먼저 cmux auth logout을 실행하세요. |
| Cloud VM에는 유료 플랜이 필요함 | 무료 계정은 머신을 만들 수 없습니다. 가격 페이지에서 업그레이드하세요. |
| 선택한 크기에 더 높은 플랜이 필요함 | 16 GB보다 큰 머신에는 cmux Max가 필요합니다. 더 작은 크기를 고르거나 업그레이드하세요. |
| 활성 머신 한도에 도달함 | 머신을 일시 중지하거나 삭제한 뒤 다시 시도하세요. |
| Cloud VM 리소스 부족 | 활성 머신이 이미 공유 vCPU나 메모리를 사용하고 있습니다. 머신을 일시 중지하거나 삭제하거나, 더 작은 크기를 고르거나, Max로 업그레이드하세요. |
| 머신이 잠겨 있음 | 유료 플랜이 종료되었고 머신이 생성된 지 7일이 지났습니다. 업그레이드하면 다시 연결할 수 있습니다. 파일은 유지됩니다. |
| claude 또는 codex: command not found | 머신이 아직 설정 중입니다. 잠시 기다리거나 /tmp/cmux/provision.log를 확인하세요. |
| cmux vm exec 시간 초과 | exec는 짧은 명령용입니다. cmux vm run, cmux vm agent, 또는 워크스페이스 터미널을 사용하세요. |
| 첫 명령이 느림 | 머신이 일시 중지되어 있었습니다. 스크립트 전에 --wake와 함께 cmux vm wait를 실행하세요. |
| 체크포인트나 포크가 거부됨 | 머신의 프로바이더가 해당 작업을 지원하지 않습니다. |
| cmux vm ssh 실패 | 대부분의 머신에서 예상된 동작입니다. cmux vm shell, cmux vm exec, 또는 cmux vm open을 사용하세요. |
| 업로드 크기가 너무 큼 | 업로드는 256 MB로 제한됩니다. 저장소는 머신 안에서 clone하세요. |
| 업로드 후 .git이 없음 | 업로드는 기본적으로 .git을 건너뜁니다. --no-default-excludes를 붙이세요. |
| Cloud 세션 연결이 끊어짐 | Reconnect를 클릭하세요. 터미널은 머신에서 계속 실행 중입니다. |
| 도메인 확인이 보류 중임 | DNS 변경에는 시간이 걸릴 수 있습니다. cmux cloud domains verify를 다시 실행하세요. |
| 방문자가 공개 URL을 열 수 없음 | cmux cloud domains access로 접근 모드를 확인하거나, 방문자의 이메일에 접근 권한을 부여하세요. |
| 조직에서 파일 전송을 비활성화함 | 관리 정책이 파일 전송을 끄고 있습니다. 관리자에게 문의하세요. |
도움 받기
생성에 실패하면 알림의 Copy Error를 사용하고, 추적 ID가 있으면 함께 포함해 지원팀에 문의하세요.
이 페이지가 도움이 되었나요?
이슈 등록