데스크톱 앱

LabPod Connect는 가벼운 데스크톱 연결 관리자이자 런처입니다. LabPod, DQueHPC 또는 다른 웹 서비스를 데스크톱 창에서 열기 때문에 http://<ip>:<port> URL을 기억할 필요가 없습니다. LabPod 연결에서는 별도 인터페이스가 아니라 브라우저에서 쓰던 것과 같은 LabPod 웹 앱을 불러옵니다.

기능

• 저장한 연결: 사용하는 LabPod 워크스테이션, DQueHPC 서비스 또는 일반 웹 서비스를 등록합니다. 목록은 앱을 종료해도 유지되며 각 연결에 LabPod, DQueHPC 또는 Web 유형이 표시됩니다.
• 빠른 연결: 왼쪽 사이드바에서 연결을 선택하면 메인 창에 불러옵니다.
• 연결 순서 바꾸기: 사이드바에서 연결 카드를 드래그해 순서를 바꿉니다.
• 패널 새로고침: 서비스가 재시작된 뒤 페이지가 멈추면 연결을 끊거나 다시 만들지 않고 페이지만 다시 불러옵니다.
• 기본 브라우저로 열기: 저장한 연결의 메뉴에서 시작 페이지를 기본 브라우저로 엽니다. SSH 연결은 필요하면 터널을 먼저 연결합니다.
• 테스트: 연결하기 전에 선택한 서비스에 도달할 수 있는지 확인합니다.

LabPod 연결에서는 로그인, 워크스페이스 생성, Jupyter 열기, 터미널 사용 등 모든 작업이 창 안의 같은 웹 UI에서 이루어집니다. 워크스페이스 앱도 해당 워크스테이션 패널 안에서 열립니다. DQueHPC 연결은 플랫폼과 서버가 알려 준 게이트웨이 주소를 패널 안에서 엽니다. Web 연결은 저장한 서비스만 불러오며 두 제품의 워크스페이스 게이트웨이 탐색 기능은 사용하지 않습니다.

Connect 0.7.0 이상 필요

DQueHPC 유형, Reload page 기능, 아래에서 설명하는 빈 포트 Auto 기본값은 Connect 0.7.0 이상에서 사용할 수 있습니다. 0.6.2 이하에서는 DQueHPC 서버를 Web service로 저장하고 0.7.0이 나오면 Connect를 업데이트합니다. DQueHPC 지원은 Connect의 연결 유형일 뿐입니다. 큐, 작업, 스케줄러 같은 DQueHPC 기능이 LabPod 서버에 생기지는 않습니다.

플랫폼

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

LabPod Connect는 LabPod 서버와 별개로 버전을 매기고 릴리스합니다. 최신 데스크톱 번들은 LabPod Connect 릴리스 페이지에서 다운로드합니다.

LabPod Connect 업데이트

LabPod Connect 업데이트는 LabPod 서버 업데이트와 별개입니다. 데스크톱 앱을 업데이트하는 데 LabPod 서버의 root 또는 관리자 계정은 필요하지 않습니다. Connect가 보호된 위치에 설치되어 있으면 설치 중 운영체제가 로컬 관리자 승인을 요청할 수 있습니다.

0.5.1에서 처음 업데이트할 때

0.5.1에는 데스크톱 업데이트 기능이 없습니다. 릴리스 페이지에서 0.6.0 이상을 한 번 직접 설치합니다. 그다음 Connect 업데이트부터 Settings를 사용할 수 있습니다.

1. 메인 워크스테이션 창에서 Settings를 엽니다.
2. Software update에서 Check now를 클릭합니다. Connect가 현재 버전, 사용할 수 있는 최신 버전, 마지막으로 확인한 시각을 보여줍니다.
3. 새 Connect 버전이 있으면 현재 버전과 최신 버전을 확인한 뒤 Update and restart를 클릭합니다.
4. 업데이트를 확인합니다. Connect가 해당 플랫폼용 패키지를 내려받아 릴리스 서명을 검증한 뒤 창과 SSH 터널을 닫고 업데이트를 설치하고 재시작합니다. 진행 상황은 단계마다 화면에 계속 표시됩니다. 보호된 위치에 설치되어 관리자 승인 창이 나타나면 운영체제의 안내에 따라 승인합니다.

워크스페이스는 LabPod 서버에서 실행되므로 Connect를 업데이트하는 동안에도 계속 작동합니다. 업데이트가 끝나면 Connect를 다시 열고 서버에 연결합니다. 확인 또는 설치에 실패하면 Release page에서 릴리스를 살펴보거나 직접 다운로드할 수 있습니다.

수동 로컬 빌드처럼 업데이트 기능이 빠진 빌드에서는 Settings에 안내 문구와 Release page 버튼이 표시됩니다. 이 버튼을 누르면 공개 빌드를 직접 내려받을 수 있습니다.

Connect는 사용자가 Check now를 클릭할 때만 업데이트를 확인합니다. 백그라운드에서 자동으로 확인하거나 동의 없이 설치하지 않습니다. 개발 빌드에서는 공개 업데이트를 설치할 수 없습니다.

업데이트 서명과 OS 코드 서명

Connect는 설치 전에 업데이트 패키지를 검증합니다. Windows와 macOS 앱 번들은 아직 Authenticode 서명이나 공증을 적용하지 않았으므로 업데이트 후 처음 실행할 때도 SmartScreen 또는 Gatekeeper가 일반적인 경고를 표시할 수 있습니다.

저장한 연결 사용하기

각 연결 카드에는 LabPod, DQueHPC 또는 Web 배지가 표시됩니다. 더보기 메뉴에서 다음 작업을 선택합니다.

• Open in default browser: 직접 연결은 URL을 바로 엽니다. SSH 연결은 터널을 먼저 연결한 뒤 주 로컬 URL을 엽니다.
• Edit: 저장한 연결을 변경합니다. 실행 중인 SSH 터널은 편집하기 전에 연결을 끊어야 합니다.
• Test connection: 저장한 LabPod, DQueHPC 또는 Web 유형을 바꾸지 않고 서비스 연결을 확인합니다.
• Delete: 확인 후 저장한 연결을 삭제하고 SSH 터널도 닫습니다.

서비스가 재시작된 뒤 선택한 페이지가 멈추면 펼친 사이드바에서 Reload page를 사용합니다. 접힌 레일에도 같은 기능이 있습니다. 툴팁에 Reload the page in the right pane이라고 표시되는 원형 화살표 버튼입니다. 오른쪽 패널을 Settings가 가리고 있어도 이 버튼을 누르면 워크스테이션 패널이 앞으로 나옵니다. 연결을 선택하거나 접힌 레일에서 현재 워크스페이스의 상세 정보 또는 파일 바로가기를 눌러도 워크스테이션 패널이 앞으로 나옵니다.

기본 브라우저와 내장 패널은 로그인 세션을 공유하지 않으므로 브라우저에서 다시 로그인해야 할 수 있습니다. Connect에 저장한 자체 서명 인증서 지문도 브라우저에는 설치되지 않으므로 브라우저가 별도의 인증서 경고를 표시할 수 있습니다.

LabPod, DQueHPC 또는 웹 서비스 추가하기

1. 사이드바에서 +(또는 추가)를 클릭합니다.
2. 레이블을 입력한 뒤 Service를 선택합니다. 각 항목의 동작은 다음과 같습니다.
   • Auto: 입력한 포트만 확인합니다. 포트를 비워 두면 LabPod 기본값 24680과 DQueHPC 기본값 13570만 확인합니다. 일반 웹 서비스의 80 포트는 빈 포트에서 자동 감지하지 않습니다. Web service를 선택하거나 포트를 직접 입력합니다. 두 제품 포트가 모두 응답하거나 모두 응답하지 않으면 포트와 유형을 직접 선택합니다.
   • LabPod: 기본 포트는 24680이며 인접한 워크스페이스 게이트웨이 포트와 한 쌍으로 사용합니다.
   • DQueHPC: 기본 포트는 13570이며 서비스가 알려 준 플랫폼과 게이트웨이 구성을 사용합니다.
   • Web service: 기본 포트는 80이며 사용자가 구성한 포트만 사용합니다.
3. Host에 서비스 IP 또는 호스트 이름을 입력합니다. https://service.example.org/tools처럼 기본 경로가 포함된 전체 HTTP 또는 HTTPS URL을 붙여 넣어도 됩니다.
4. Test를 클릭하여 서비스에 연결되는지 확인하고 Connect가 감지한 내용을 검토합니다.
5. Save를 클릭합니다.

저장한 연결을 선택하면 서비스를 불러옵니다. LabPod 유형은 LabPod 웹 앱을 열고 DQueHPC 유형은 플랫폼과 검증된 게이트웨이 주소를 엽니다. Web 유형은 사용자가 구성한 서비스 주소만 엽니다.

DQueHPC 서버 호환성

DQueHPC 유형을 사용하려면 /api/version 응답에 platform_port, 그다음 번호인 gateway_port, HTTP 또는 HTTPS 형식의 gateway_origin이 있어야 합니다. 이전 DQueHPC 서버는 업그레이드할 때까지 Web service로 저장합니다. Web 유형은 저장한 주소 하나만 열며 워크스페이스 게이트웨이 탐색은 사용하지 않습니다.

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

1. LabPod 또는 DQueHPC라면 같은 컴퓨터의 브라우저에서 http://<호스트>:<포트>/api/version을 엽니다. LabPod 서버는 정확한 name: "labpod"와 비어 있지 않은 version 값이 포함된 JSON을 반환합니다. DQueHPC 서버는 정확한 name: "dque", 비어 있지 않은 version, 0이 아닌 platform_port, 플랫폼 포트보다 1 큰 gateway_port, HTTP 또는 HTTPS 주소만 담은 gateway_origin을 반환합니다. 이 정보가 일부라도 없으면 Web service로 처리하므로 구성한 시작 URL을 엽니다.
2. 포트 입력란에 구성한 서비스 포트가 있는지 확인합니다. LabPod 기본값은 24680, DQueHPC 기본값은 13570, Web service 기본값은 80입니다. Auto에서 포트를 비워 두면 표준 웹 포트 대신 앞에서 설명한 두 제품 포트만 확인합니다. 유형을 직접 선택한 경우에는 포트를 비워 두면 그대로 표준 HTTP 포트 80 또는 HTTPS 포트 443을 사용합니다. 리버스 프록시 뒤에 둔 서비스가 이 방식을 씁니다.
3. macOS 15 이상에서는 시스템 설정 → 개인정보 보호 및 보안 → 로컬 네트워크를 열어 LabPod Connect를 허용한 뒤 다시 시도합니다. 새로 설치한 버전이 처음 LAN 워크스테이션에 접속할 때 표시되는 권한 요청도 허용합니다.
4. 별도의 로컬 개발 빌드가 아니라 /Applications/LabPod Connect.app에 설치한 앱을 기준으로 진단합니다. macOS는 로컬 빌드와 내려받은 서명 없는 앱을 서로 다른 네트워크 권한 대상으로 추적하기도 합니다. 권한을 확인할 때는 앱 복사본 하나만 엽니다.

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

원격 접근

로컬 네트워크 밖에 있는 서비스에는 다음 두 가지 방법으로 연결합니다.

SSH 터널

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

1. Add를 클릭하고 서비스 프로필을 선택한 뒤 Use an SSH tunnel instead를 클릭합니다.
2. SSH 호스트 이름, 포트, 사용자 이름을 입력합니다. 유형을 직접 선택했다면 포워딩할 웹 서비스가 HTTP와 HTTPS 중 무엇을 사용하는지도 선택합니다.
3. 포트 포워딩을 확인합니다. LabPod와 DQueHPC 유형은 기본 포트와 인접한 워크스페이스 게이트웨이 포트를 한 쌍으로 포워딩합니다. DQueHPC의 기본 원격 서비스 포트는 13570이며 터널을 열기 전에 테스트에서 확인한 포트 구성을 다시 검증합니다. Web 유형은 목록에 추가한 규칙만 사용하며 기본 원격 서비스 포트는 80입니다.
4. LabPod, DQueHPC 또는 Web service 프로필이라면 Test를 클릭한 뒤 Save, Connect 순서로 클릭합니다. 포워딩할 로컬 포트는 모두 비어 있어야 합니다.
5. SSH 호스트 키는 최초 사용 시 신뢰(TOFU) 방식으로 검증되고 ~/.ssh/known_hosts에 저장됩니다. 키가 변경되면 명시적으로 다시 검증할 때까지 연결이 차단됩니다.

SSH에서 Auto 감지를 사용하려면 해당 SSH 호스트가 Connect의 키를 이미 인증해야 합니다. 처음 SSH 연결할 때는 알고 있는 LabPod, DQueHPC 또는 Web service 프로필과 웹 포트를 선택하고 테스트하거나 연결하여 키를 인증합니다. 인증에 성공한 뒤에는 연결을 편집하거나 새로 추가해 Auto로 포트를 테스트합니다. 인증된 터널을 열기 전에는 Auto가 알 수 없는 서비스를 식별하지 못합니다.

개인 키는 컴퓨터마다 로컬에서 만들며 기기를 벗어나지 않습니다. 처음 연결할 때 계정 비밀번호로 키를 한 번 인증하거나 수동 키 명령을 사용합니다. Connect는 입력한 비밀번호를 즉시 폐기합니다. 선택 사항인 패스프레이즈로 키를 보호할 수 있으며 패스프레이즈는 OS 키링에 저장됩니다.

SSH 호스트가 만료된 계정 비밀번호를 대화형으로 바꾸도록 요구하면 Connect가 Change the account password from a terminal first와 실행할 ssh 명령을 표시합니다. 터미널에서 이 명령을 실행하고 안내에 따라 새 비밀번호를 정한 뒤, 새 비밀번호로 Connect를 다시 인증합니다. 키를 수동으로 설치해도 필수 비밀번호 변경을 건너뛸 수 없으며 포트 포워딩도 복구되지 않습니다.

자체 서명 TLS

서버가 자체 서명 HTTPS 인증서를 사용한다면:

1. 서버를 추가할 때 https:// URL을 사용합니다.
2. 앱이 첫 연결 시 인증서의 SHA-256 지문을 고정합니다(최초 사용 시 신뢰).
3. 이후 연결 시 지문이 일치하는지 확인합니다. 지문이 달라지면(예를 들어 인증서를 갱신한 경우) 앱이 경고를 표시하고 사용자가 명시적으로 다시 고정해야 합니다.
4. LabPod 서버라면 관리자가 구성한 지문을 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

Connect는 변경한 연결 파일을 저장하는 데 성공한 뒤에만 새 상태를 적용합니다. 저장이나 삭제에 실패하면 이전 연결 데이터가 그대로 유지됩니다. 삭제가 실패한 경우 실행 중인 SSH 터널도 계속 연결되어 있습니다.

이전 Connect 버전은 최신 버전이 기록한 연결 데이터와 호환되지 않으면 업데이트하라고 안내할 뿐 파일을 바꾸지 않습니다. 이 메시지가 나타나도 파일을 삭제하면 안 됩니다. 파일에는 새 연결 정보와 보안 설정이 들어 있을 수 있습니다.

Connect 0.7.0 사용 후 다운그레이드

Connect 0.7.0은 연결 상태를 다음에 저장할 때 연결 저장소 스키마 v5로 기록합니다. 테스트, 연결, 인증서 지문 저장이 모두 연결 상태를 기록하므로 평소처럼 한 번만 써도 파일이 v5로 바뀝니다. Connect 0.6.2 이하에서는 스키마 v5 파일을 읽을 수 없습니다. Appearance(아래 참고) 선택 기능이 포함된 이후 버전의 Connect는 연결 상태를 다시 저장할 때 파일을 스키마 v6로 올리며, 아직 v5까지만 아는 Connect는 그 설정을 조용히 버리는 대신 v6 파일 자체를 거부합니다. 다운그레이드할 가능성이 있다면 미리 connections.json을 백업합니다. 백업이 없다면 다운그레이드한 뒤 호환되는 백업을 복원하거나 저장한 연결을 다시 만듭니다.

외관

Settings → Appearance에서 LabPod Connect 자체 사이드바, Settings, 로컬 상태 페이지에 적용할 팔레트를 고릅니다. System(기본값, OS 설정을 실시간으로 따름), Light, Dark 중에서 선택할 수 있습니다. 이 설정은 Connect 자체 화면에만 적용되며, 워크스테이션 패널 안에서 불러온 LabPod나 DQueHPC 웹 앱은 각자의 스타일을 그대로 유지합니다.