데스크톱 앱

LabPod Connect는 별도의 인터페이스가 아닌 경량 기본 런처입니다. 브라우저에서 접근하는 것과 동일한 LabPod 웹 앱을 로드하되 http://<ip>:<port> URL을 기억하지 않아도 되도록 기본 창으로 감싸줍니다.

기능

• 저장된 서버: 접근하는 각 LabPod 워크스테이션을 등록합니다 (레이블과 URL). 목록은 앱을 종료해도 유지됩니다.
• 원클릭 연결: 왼쪽 사이드바에서 서버를 클릭하면 메인 창에 로드됩니다.
• 테스트: 앱이 연결 전에 서버에 도달할 수 있는지 확인합니다.

로그인, 워크스페이스 생성, Jupyter 열기, 터미널 사용 등 그 외 모든 것은 창 내에서 실행되는 동일한 웹 UI입니다. 워크스페이스 앱도 해당 워크스테이션 패널 안에서 열립니다.

플랫폼

앱은 시스템의 기본 웹 렌더러를 사용합니다 (Windows는 WebView2, macOS는 WKWebView, Linux는 WebKitGTK). 현재 바이너리는 서명되지 않았습니다.

LabPod Connect는 LabPod 서버와 독립적으로 버전이 지정되고 릴리스됩니다. 최신 데스크톱 번들은 LabPod Connect 릴리스 페이지에서 다운로드하세요.

서버 추가하기

1. 사이드바에서 + (또는 추가)를 클릭합니다.
2. 레이블을 입력하고 호스트에 워크스테이션 IP 또는 호스트 이름을 입력합니다. 운영자가 다른 LabPod 포트를 구성하지 않았다면 포트의 기본값 24680을 그대로 둡니다. 호스트 입력란에 http://192.168.1.10:24680 같은 전체 URL을 붙여 넣어도 됩니다.
3. 테스트를 클릭해 서버에 도달할 수 있는지 확인합니다.
4. 저장을 클릭합니다.

서버 이름을 클릭하면 로드됩니다. 메인 창에 LabPod 웹 앱이 열리면 평소처럼 로그인하세요.

테스트가 서버에 도달하지 못하는 경우

1. 같은 컴퓨터의 브라우저에서 http://<호스트>:<포트>/api/version을 엽니다. LabPod 서버라면 비어 있지 않은 version 값이 포함된 JSON을 반환합니다.
2. 포트 입력란에 운영자가 안내한 LabPod 포트(기본값 24680)가 남아 있는지 확인합니다. 빈 포트는 HTTP 표준 포트 80 또는 HTTPS 표준 포트 443을 의미합니다.
3. macOS 15 이상에서는 시스템 설정 → 개인정보 보호 및 보안 → 로컬 네트워크를 열어 LabPod Connect를 허용한 뒤 다시 시도합니다. 새로 설치한 버전이 처음 LAN 워크스테이션에 접속할 때 표시되는 권한 요청도 허용합니다.
4. 별도의 로컬 개발 빌드가 아니라 /Applications/LabPod Connect.app에 설치한 앱을 기준으로 진단합니다. macOS는 로컬 빌드와 다운로드한 서명되지 않은 앱을 서로 다른 네트워크 권한 대상으로 추적할 수 있습니다. 권한을 확인할 때 여러 앱 복사본을 동시에 열지 마세요.

테스트는 네이티브 연결 오류 전체를 표시합니다. Windows와 Linux에는 이와 같은 앱별 LAN 권한이 없으므로 주소, 라우팅 또는 VPN, 방화벽, 서버 리스너를 확인하세요.

원격 접근

앱은 로컬 네트워크에 없는 서버에 연결하는 두 가지 방법을 지원합니다:

SSH 터널

워크스테이션에 SSH로 접근할 수 있다면 앱이 터널을 열 수 있습니다:

1. http://127.0.0.1:<localport> URL로 서버를 추가합니다.
2. SSH 연결 세부 정보를 설정합니다: 호스트명, 포트, SSH 사용자 이름.
3. 사이드바에서 연결을 클릭합니다. 앱이 SSH 세션을 열고 로컬 플랫폼 포트와 인접한 워크스페이스 게이트웨이 포트를 워크스테이션으로 포워딩합니다. 두 로컬 포트가 모두 비어 있어야 합니다.
4. SSH 호스트 키는 최초 사용 시 신뢰 (TOFU) 방식으로 검증되고 ~/.ssh/known_hosts에 저장됩니다. 키가 변경되면 명시적으로 재검증할 때까지 연결이 차단됩니다.

개인 키는 머신별로 로컬에서 생성되며 기기를 벗어나지 않습니다. 키는 LabPod 비밀번호를 사용해 서버에 한 번 인증됩니다 (비밀번호는 이후 폐기됨). 패스프레이즈를 설정해 키를 보호할 수도 있습니다. 키는 OS 키링에 저장됩니다.

자체 서명 TLS

서버가 자체 서명 HTTPS 인증서로 구성된 경우:

1. 서버를 추가할 때 https:// URL을 사용합니다.
2. 앱이 첫 연결 시 인증서의 SHA-256 지문을 고정합니다 (최초 사용 시 신뢰).
3. 이후 연결 시 지문이 일치하는지 확인합니다. 변경된 경우 (예: 인증서 갱신), 앱이 경고를 표시하고 명시적으로 재고정해야 합니다.
4. 관리자가 구성한 지문을 확인하려면: sudo labpod admin tls-fingerprint.

Linux에서 저장한 HTTPS 고정을 지웠다면 해당 서버에 다시 연결하기 전에 LabPod Connect를 재시작하세요. WebKit은 앱이 종료될 때까지 이전 인증서 예외를 유지하므로, 재시작해야 다음 연결에서 받은 인증서를 검증하고 다시 고정합니다.

연결 데이터

서버 목록은 다음 위치에 로컬로 저장됩니다:

플랫폼	경로
Windows	%APPDATA%\com.labpod.connect\connections.json
macOS	~/Library/Application Support/com.labpod.connect/connections.json
Linux	~/.config/com.labpod.connect/connections.json