안내

SSH로 접속하기

Windows, Mac, Linux에서 터미널로 대여 Mac에 접속: SSH 키, 첫 로그인, 파일 전송, tmux, VS Code. 추가 소프트웨어가 필요 없습니다.

대여한 Mac에는 당사 게이트웨이 gate.bohemiansilicon.com을 거쳐 일반 SSH로 접속합니다. 추가로 설치하거나 네트워크를 설정할 것은 없습니다. 전체 설정은 약 10분이면 끝나며 모든 대여의 첫 1시간은 무료이므로 여유 있게 준비할 수 있습니다.

접속 정보가 담긴 이메일로 사용자 이름, 포트 번호(2201 형태), Mac의 지문, 그리고 원격 데스크톱용 비밀번호를 보내 드립니다. 이 가이드에서 USERNAME와 PORT가 나오는 곳에는 이메일의 값을 사용하세요.

SSH의 경우 SSH 공개 키만 보내 주시면 됩니다. SSH 비밀번호 로그인은 비활성화되어 있으며 키로만 로그인합니다.

Windows

Windows 10과 11에는 SSH 클라이언트가 기본으로 들어 있어 따로 설치할 것이 없습니다.

1. SSH 키 만들기

Bohemian Silicon 전용 키를 따로 만드는 것을 권장합니다. 아래 명령은 키를 별도 이름으로 저장하므로 다른 곳에서 쓰는 키(예: GitHub용 id_ed25519)를 덮어쓰지 않습니다.

PowerShell을 여세요(시작을 클릭하고 PowerShell을 입력해 실행).
다음 명령을 실행하세요. 암호 문구(passphrase)를 물으면 입력하고 한 번 더 확인하세요(입력해도 화면에 표시되지 않습니다). 암호 문구는 누군가 파일을 복사했을 때 키를 보호합니다. 비워 둘 수도 있지만 보안이 약해집니다.

mkdir -Force $HOME\.ssh | Out-Null
ssh-keygen -t ed25519 -f $HOME\.ssh\bohemian_ed25519 -C bohemian-silicon

명령을 실행하면 파일 두 개가 만들어집니다. bohemian_ed25519는 개인 키로, 고객님의 컴퓨터에 두고 누구와도 공유하지 않습니다. bohemian_ed25519.pub는 공개 키로, 저희에게 보내는 파일입니다. 이 파일만으로는 로그인할 수 없으므로 일반 이메일로 보내도 안전합니다.

기존 키를 사용하고 싶으신가요? 그 키의 .pub 파일을 보내 주시고, 아래 명령에서 bohemian_ed25519 대신 해당 파일 이름을 사용하세요.

공개 키를 표시합니다:

Get-Content $HOME\.ssh\bohemian_ed25519.pub

ssh-ed25519로 시작하는 한 줄 전체를 복사하세요.

키를 이메일로 보내 주세요. .pub가 없는 파일은 절대 보내지 마세요. 그것은 개인 키이며 고객님의 컴퓨터에만 있어야 합니다.

접속할 때마다 키의 암호 문구를 입력합니다.

2. 접속하기

ssh -i $HOME\.ssh\bohemian_ed25519 -p PORT USERNAME@gate.bohemiansilicon.com

처음 접속하면 SSH가 Mac의 지문(ED25519 key fingerprint is SHA256:…)을 보여 주고 Are you sure you want to continue connecting?라고 묻습니다. 저희 이메일에 있는 지문과 비교하세요. 정확히 일치할 때만 yes를 입력하세요. 일치하지 않으면 no를 입력하고 저희에게 연락하세요.
%로 끝나는 줄이 보이면 로그인된 것입니다. exit로 연결을 끊습니다.

Mac

1. SSH 키 만들기

터미널을 여세요(응용 프로그램 → 유틸리티 → 터미널).
다음 명령을 실행하세요. 암호 문구(passphrase)를 물으면 입력하고 한 번 더 확인하세요(입력해도 화면에 표시되지 않습니다). 암호 문구는 누군가 파일을 복사했을 때 키를 보호합니다. 비워 둘 수도 있지만 보안이 약해집니다.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

기존 키를 사용하고 싶으신가요? 그 키의 .pub 파일을 보내 주시고, 아래 명령에서 bohemian_ed25519 대신 해당 파일 이름을 사용하세요.

공개 키를 표시합니다:

pbcopy < ~/.ssh/bohemian_ed25519.pub

이제 키가 클립보드에 복사되었습니다. ⌘V로 붙여 넣으세요.

키를 이메일로 보내 주세요. .pub가 없는 파일은 절대 보내지 마세요. 그것은 개인 키이며 고객님의 컴퓨터에만 있어야 합니다.

팁: 매번 암호 문구를 입력하지 않으려면 macOS 키체인에 저장하세요:

ssh-add --apple-use-keychain ~/.ssh/bohemian_ed25519

2. 접속하기

ssh -i ~/.ssh/bohemian_ed25519 -p PORT USERNAME@gate.bohemiansilicon.com

처음 접속하면 SSH가 Mac의 지문(ED25519 key fingerprint is SHA256:…)을 보여 주고 Are you sure you want to continue connecting?라고 묻습니다. 저희 이메일에 있는 지문과 비교하세요. 정확히 일치할 때만 yes를 입력하세요. 일치하지 않으면 no를 입력하고 저희에게 연락하세요.
%로 끝나는 줄이 보이면 로그인된 것입니다. exit로 연결을 끊습니다.

Linux

1. SSH 키 만들기

터미널을 여세요.
다음 명령을 실행하세요. 암호 문구(passphrase)를 물으면 입력하고 한 번 더 확인하세요(입력해도 화면에 표시되지 않습니다). 암호 문구는 누군가 파일을 복사했을 때 키를 보호합니다. 비워 둘 수도 있지만 보안이 약해집니다.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

기존 키를 사용하고 싶으신가요? 그 키의 .pub 파일을 보내 주시고, 아래 명령에서 bohemian_ed25519 대신 해당 파일 이름을 사용하세요.

공개 키를 표시합니다:

cat ~/.ssh/bohemian_ed25519.pub

ssh-ed25519로 시작하는 한 줄 전체를 복사하세요.

키를 이메일로 보내 주세요. .pub가 없는 파일은 절대 보내지 마세요. 그것은 개인 키이며 고객님의 컴퓨터에만 있어야 합니다.

팁: 대부분의 Linux 데스크톱에서는 SSH 에이전트가 이미 실행 중이어서 로그인 세션당 한 번만 암호 문구를 입력하면 됩니다:

ssh-add ~/.ssh/bohemian_ed25519

2. 접속하기

ssh -i ~/.ssh/bohemian_ed25519 -p PORT USERNAME@gate.bohemiansilicon.com

처음 접속하면 SSH가 Mac의 지문(ED25519 key fingerprint is SHA256:…)을 보여 주고 Are you sure you want to continue connecting?라고 묻습니다. 저희 이메일에 있는 지문과 비교하세요. 정확히 일치할 때만 yes를 입력하세요. 일치하지 않으면 no를 입력하고 저희에게 연락하세요.
%로 끝나는 줄이 보이면 로그인된 것입니다. exit로 연결을 끊습니다.

파일 전송

scp는 대여한 Mac이 아니라 고객님의 컴퓨터에서 실행하세요.

Windows

scp -i $HOME\.ssh\bohemian_ed25519 -P PORT data.zip USERNAME@gate.bohemiansilicon.com:~/
scp -i $HOME\.ssh\bohemian_ed25519 -P PORT USERNAME@gate.bohemiansilicon.com:~/results.zip .

Mac, Linux

scp -i ~/.ssh/bohemian_ed25519 -P PORT data.zip USERNAME@gate.bohemiansilicon.com:~/
scp -i ~/.ssh/bohemian_ed25519 -P PORT USERNAME@gate.bohemiansilicon.com:~/results.zip .

첫 번째 줄은 파일을 대여한 Mac에 업로드하고, 두 번째 줄은 파일을 현재 폴더로 내려받습니다. 폴더 전체를 복사하려면 -r을 붙이세요.

오래 걸리는 작업(tmux)

터미널을 닫거나 연결이 끊기면 그 안에서 실행한 프로그램도 종료됩니다. 모델 다운로드나 학습처럼 오래 걸리는 작업은 tmux 안에서 실행하세요. 연결을 끊어도 세션은 Mac에서 계속 실행됩니다. Mac에 로그인한 뒤 세션을 시작하세요:

tmux new -s work

그 안에서 작업을 실행하세요. 작업을 계속 실행해 둔 채 연결을 끊으려면 Ctrl+B를 누르고 두 키를 뗀 다음 D를 누르세요. 다시 접속한 뒤에는 다음과 같이 세션으로 돌아갑니다:

tmux attach -t work

tmux ls는 세션 목록을 보여 주며, 세션 안에서 exit를 입력하면 세션이 종료됩니다. 모든 세션은 늦어도 대여가 끝나 계정이 삭제될 때 종료됩니다.

Visual Studio Code(Remote-SSH)

VS Code에서 Microsoft의 Remote - SSH 확장 프로그램을 설치하세요.
F1을 누르고 Remote-SSH: Add New SSH Host…를 선택한 뒤 다음 명령을 입력하세요(Windows, Mac, Linux 모두 동일):

ssh -i ~/.ssh/bohemian_ed25519 -p PORT USERNAME@gate.bohemiansilicon.com

제안된 SSH 구성 파일에 저장하세요. 그런 다음 다시 F1을 누르고 Remote-SSH: Connect to Host…와 Mac 주소를 선택하세요. 플랫폼을 물으면 macOS를 고르세요.
처음 접속할 때 VS Code가 Mac의 고객님 계정에 서버 구성 요소를 설치하며, 1~2분 정도 걸립니다. 그 후에는 Mac의 폴더를 열고 터미널을 VS Code 안에서 바로 사용할 수 있습니다.

문제 해결

연결 시간이 초과되거나 거부되는 경우: 주소 gate.bohemiansilicon.com과 -p 뒤의 포트 번호를 확인하세요. 일부 회사나 호텔 네트워크는 흔하지 않은 포트로 나가는 연결을 차단합니다. 휴대폰 핫스팟 등 다른 네트워크를 시도하거나 저희에게 연락해 주세요.
Permission denied (publickey) 또는 비밀번호 입력 요청: 키가 사용되지 않았습니다. 키를 만든 컴퓨터에서 접속하고, -i로 키 경로를 지정하며, 사용자 이름을 확인하세요.
REMOTE HOST IDENTIFICATION HAS CHANGED: 중단하고 접속하지 마세요. 먼저 저희에게 연락하세요. Mac을 다시 설치했는지 알려 드리고 새 지문을 보내 드립니다. 그다음에만 ssh-keygen -R "[gate.bohemiansilicon.com]:PORT"를 실행하고 새 지문을 확인하며 다시 접속하세요.

대여가 끝나면

대여가 끝나면 홈 폴더를 포함한 macOS 계정을 삭제하고 공유 임시 폴더(/tmp, /Users/Shared)에서 고객님의 파일을 지웁니다. 보관하려는 모든 것은 대여가 끝나기 전에 내려받으세요. 그 후에는 고객님의 컴퓨터에서도 키를 삭제할 수 있습니다. .ssh 폴더의 bohemian_ed25519와 bohemian_ed25519.pub 파일입니다.

막히셨나요? hello@bohemiansilicon.com로 스크린샷이나 오류 메시지를 첨부해 메일을 보내 주세요. 보통 몇 분 안에 답변드립니다.