SSH로 연결
SSH로 이 컴퓨터에서 Linux 서버나 다른 컴퓨터의 Octoboard을(를) 데스크톱 앱이나 브라우저로 사용합니다. 중계 서비스나 클라우드 서비스 없이 그 컴퓨터에 바로 연결하는 암호화된 연결입니다.
이 방법이 맞는지 잘 모르겠나요? 연결 방법 선택에서 SSH가 필요 없는 브라우저 전용 방법과 비교해 보세요.
이 컴퓨터의 데스크톱 앱 · SSH 포워드를 통한 브라우저 ⟷ SSH ⟷ Linux 서버 또는 다른 컴퓨터
처음이라면
- 호스트: Octoboard이(가) 실행되는, 접속하려는 컴퓨터입니다. Linux 서버나 다른 Mac, Windows PC가 해당합니다.
- 서버: 여기서는 네트워크로 로그인하는 Linux 컴퓨터를 뜻합니다. 보통 임대한 것이고 화면이 따로 없습니다.
- SSH: 다른 컴퓨터에 로그인해서 명령을 입력하는 표준 암호화 방식입니다. macOS, Windows, Linux에 기본으로 들어 있습니다.
- 터미널: 명령을 입력하는 창입니다. macOS에서는 터미널, Windows에서는 PowerShell입니다.
- SSH 포워드: 호스트에 있는 것이 내 컴퓨터에서도 보이게 만들어, 브라우저로 열 수 있게 해 주는 SSH 명령입니다.
- 지문(호스트 키): 컴퓨터의 SSH를 식별하는 짧은 코드입니다. 한 번 확인해 두면 제대로 된 컴퓨터에 접속했음을 알 수 있습니다.
- 키 파일: 비밀번호 대신 로그인해 주는 파일입니다. 서버 제공업체가 주는 경우가 있습니다.
필요한 것
섹션 제목: “필요한 것”-
호스트에 SSH로 로그인할 수 있는 방법. Linux 서버라면 제공업체가 주소와 사용자 이름을 알려 줍니다. 되는지 확인하려면 터미널(macOS) 또는 PowerShell(Windows)을 열고, 내 사용자 이름과 서버 주소로 아래 명령을 실행하세요. 처음에는 서버를 신뢰할지 물으면
yes라고 답하세요.Terminal window ssh <you>@<server>Mac이나 Windows PC가 호스트라면 시스템 설정에서 SSH 로그인을 켜야 합니다. 방법은 다른 컴퓨터를 호스트로 사용하기에 나와 있습니다.
-
Linux 서버라면 서버에 Octoboard을(를) 설치하고 시작해 두세요. 방법은 설치 › Linux 서버에 나와 있습니다. Octoboard 서버 프로그램인 octoboardd를 앱에서는 ‘데몬’이라고 부릅니다.
-
이 컴퓨터에 설치한 Octoboard 앱(macOS 또는 Windows). 브라우저만 쓸 거라면 필요 없습니다.
Linux 서버에 연결하기
섹션 제목: “Linux 서버에 연결하기”-
Octoboard을(를) 실행하는 사용자로 서버에 SSH 로그인한 다음, 이 명령을 실행하고
octoboard+ssh://(으)로 시작하는 줄을 복사하세요. 앱이 어디에 어떻게 연결할지 알려 주는 연결 정보입니다.Terminal window octoboardd connection이 컴퓨터에서 서버에 다른 주소나 SSH 포트로 접속한다면, 명령에
--host또는--ssh-port을(를) 덧붙여 올바른 연결 정보가 출력되게 하세요.함께 출력되는 QR 코드에도 같은 줄이 들어 있습니다. 아직은 이를 스캔하는 앱이 없습니다.
-
이 컴퓨터의 Octoboard 앱에서 왼쪽 레일의 원격 기기를 열거나, macOS에서는 메뉴 막대에서 원격 › 원격 기기를 선택하세요. Windows에서는 창의 시스템 메뉴나 작업 표시줄 아이콘의 점프 목록에서도 원격 기기를 선택할 수 있습니다.
-
원격 데몬 추가를 누른 다음 연결 정보 아래의 붙여넣기를 눌러 입력란을 채우세요.
-
인증에서 계정 비밀번호로 로그인한다면 암호를 선택하세요. 서버 제공업체가 대신 키 파일을 줬다면(이름이
id_ed25519같거나.pem으로 끝나는 경우가 많습니다) 키 파일을 선택하고, 이 컴퓨터에서 그 파일이 있는 위치를 입력하세요. -
저장을 누른 다음 연결을 누르세요. 물으면 비밀번호를 입력하세요.
연결 정보를 붙여넣었다면 서버의 신원(지문)이 함께 들어 있어 앱이 대신 확인해 줍니다. 주소를 직접 입력했다면 처음에 앱이 지문을 보여 줍니다. 제대로 된 컴퓨터에 접속했는지 확인하려면, 서버에서 이 명령으로 출력되는 지문과 비교해 보고 일치할 때만 연결하세요.
Terminal window ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
별도의 Octoboard 창이 열리고 서버의 프로젝트와 세션이 보이면 성공입니다.
다른 컴퓨터를 호스트로 사용하기
섹션 제목: “다른 컴퓨터를 호스트로 사용하기”Octoboard 앱이 실행 중인 Mac이나 Windows PC에도 접속할 수 있습니다.
- 접속하려는 컴퓨터에서 Octoboard의 설정 › 원격 접근을 여세요.
- 거기서 시스템 설정 열기(macOS) 또는 설정 열기(Windows)를 누르고, 해당 항목에 나온 경로를 따라 원격 로그인(macOS) 또는 OpenSSH Server(Windows)를 켜서 이 컴퓨터가 SSH 로그인을 받게 하세요. 관리자 권한이 필요합니다. Octoboard으로 돌아오면 해당 항목에 켬이라고 표시됩니다.
- 원격 접근 허용을 켜고 허용을 눌러 확인한 다음, Octoboard을(를) 계속 실행해 두세요. 종료하면 원격 접근이 멈춥니다.
- Octoboard 앱 탭에서 연결 정보 복사를 누르고, 이메일이나 메신저 등으로 다른 컴퓨터에 보내세요.
- 작업할 컴퓨터에서 Linux 서버에 연결하기의 2~5단계와 같이 호스트를 추가하되, 보낸 연결 정보를 붙여넣으세요. 호스트의 사용자 이름과 비밀번호로 로그인하세요.
별도의 창이 열리고 호스트의 프로젝트와 세션이 보이면 성공입니다.
브라우저에서 연결하기
섹션 제목: “브라우저에서 연결하기”-
SSH 포워드 명령을 가져오세요.
-
Mac이나 Windows 호스트라면 먼저 다른 컴퓨터를 호스트로 사용하기의 1~3단계를 하세요. 그런 다음 브라우저 탭의 1단계: SSH 포워드를 보세요. 명령에 있는 주소를 눌러 다른 컴퓨터가 이 컴퓨터에 접속할 방법을 고르고(또는 주소 직접 입력을 선택하고 나중에
<server>을(를) 직접 바꾸고), 포워딩 명령 복사를 누르세요. 또 2단계: 브라우저 주소 아래의 주소 복사도 누르세요. -
Linux 서버라면 서버에서 다음을 실행하세요. 브라우저 주소가 출력되고, 이어서 실행할 SSH 명령이 출력됩니다.
Terminal window octoboardd address명령의
<server>을(를) 서버 주소로 바꾸세요.
-
-
브라우저를 쓸 컴퓨터의 터미널(macOS) 또는 PowerShell(Windows)에서 SSH 명령을 실행하세요. 비밀번호를 물을 수 있고, 그 뒤에는 아무것도 표시되지 않는데 정상입니다. 작업하는 동안 창을 열어 두세요. 닫으면 브라우저 연결이 끊어집니다.
-
http://127.0.0.1:로 시작하는 브라우저 주소를 브라우저에서 여세요.
로그인하라는 요청 없이 브라우저 탭에서 Octoboard이(가) 열리면 성공입니다.
SSH 포워드로 Octoboard에 접속할 수 있는 사람만 이 주소를 쓸 수 있습니다. 주소는 비공개로 하세요. 주소에 든 키는 전체 제어 권한을 주고, 브라우저 방문 기록과 북마크에 남으며, 브라우저 동기화를 켜 두면 다른 기기에도 동기화됩니다.
연결되지 않을 때
섹션 제목: “연결되지 않을 때”- “서버에 연결할 수 없습니다”라고 나오거나, SSH 명령이 “Connection refused”라고 하거나 시간이 초과될 때: 호스트의 SSH 로그인이 꺼져 있거나 주소 또는 SSH 포트가 틀렸습니다. 원격 로그인 또는 OpenSSH Server가 켜져 있는지, 위의
ssh명령으로 로그인할 수 있는지 확인하세요. - “로그인할 수 없습니다”라고 나오거나 “Permission denied”일 때: 사용자 이름, 비밀번호 또는 키 파일이 틀렸습니다.
- “호스트 키가 일치하지 않습니다”라고 나올 때: 응답한 컴퓨터가 이전에 연결했던 컴퓨터가 아닙니다. 서버를 다시 설치한 뒤에 생기기도 하지만, 뭔가 잘못됐다는 뜻일 수도 있습니다. 이유를 알기 전에는 계속하지 마세요.
- 브라우저 페이지가 열리지 않을 때: SSH 창을 닫았거나 그 명령이 멈췄습니다. 다시 실행하고 페이지를 새로 고치세요.
- 추가로 공개되는 포트 없음: Octoboard은(는) 호스트 자신으로부터의 연결만 받으므로, 다른 컴퓨터에서 접속하려면 먼저 SSH로 호스트에 로그인해야 합니다. 그래서 SSH나 중계 서비스 중 하나가 필요합니다.
- 어느 컴퓨터에 접속하는지 확인: 앱은 처음 연결에 성공할 때 호스트 키(그 컴퓨터의 SSH 신원)를 기억해 두고, 나중에 그 신원이 바뀌면 경고를 띄우고 연결을 차단합니다.
- 비밀번호를 저장하지 않음: 처음에 비밀번호나 내 키 파일로 로그인하고 나면, 앱이 이 컴퓨터가 앞으로 로그인할 때 쓸 별도의 SSH 키를 설정합니다.
- 컴퓨터의 접속 권한 없애기: 호스트의 허용된 SSH 키 목록(Linux와 macOS에서는
~/.ssh/authorized_keys)에서 그 컴퓨터의 항목을 지우세요. 그러면 그 키로는 다시 로그인할 수 없고, 이미 열린 연결은 끝날 때까지 유지됩니다.
원격 창에서
섹션 제목: “원격 창에서”- SSH 접속 대상마다 창 하나: 사용자 이름, 호스트, SSH 포트 중 하나라도 다른 연결은 각자 창을 열므로 프로젝트, 세션, 알림이 섞이지 않습니다.
- 연결마다 상태 보기: macOS에서는 앱의 메뉴 막대 아이콘을, Windows에서는 알림 영역 아이콘을 열면 연결마다 탭이 보입니다.
- 원격 웹사이트를 여기서 열기: 에이전트가 호스트에서 웹사이트를 시작하면 에이전트가 알려 주는
localhost링크를 누르세요. 앱이 SSH를 통해 그 웹사이트를 이 컴퓨터에서 열어 줍니다. - 원격 파일을 여기서 열기: 원격 창에서 파일을 보거나, 사본을 내려받아 이 컴퓨터에서 그 파일의 기본 앱으로 열 수 있습니다.
- 자동으로 다시 연결: 네트워크가 끊기면 창이 연결될 때까지, 또는 창을 닫을 때까지 계속 다시 연결을 시도합니다.