10.2. 시스템 트레이¶
Backend.AI GO는 백그라운드에서 실행 중일 때 애플리케이션과 일반적인 작업에 빠르게 접근할 수 있는 시스템 트레이 아이콘을 제공합니다.
개요¶
시스템 트레이 아이콘을 통해 다음을 수행할 수 있습니다:
- 메인 창을 빠르게 표시하거나 포커스
- API 서버 제어
- 로드된 모델 관리
- 주요 페이지로 이동
- 시스템 폴더 접근
플랫폼 지원¶
| 플랫폼 | 위치 | 좌클릭 | 우클릭 |
|---|---|---|---|
| macOS | 메뉴 바 | 창 표시 | 컨텍스트 메뉴 |
| Windows | 시스템 트레이 | 창 표시 | 컨텍스트 메뉴 |
| Linux | 시스템 트레이 | 컨텍스트 메뉴* | 컨텍스트 메뉴 |
Linux 제한 사항
Linux에서는 플랫폼 제한으로 인해 좌클릭 이벤트가 발생하지 않을 수 있습니다. 우클릭을 사용하여 컨텍스트 메뉴에 접근하세요.
컨텍스트 메뉴 옵션¶
트레이 아이콘을 우클릭하면 다음 옵션에 접근할 수 있습니다:
서버 제어¶
| 메뉴 항목 | 설명 |
|---|---|
| API 서버 실행 중 / 중지됨 | 현재 서버 상태를 보여주는 상태 표시기 |
| API 서버 시작 / 중지 | API 서버 켜기 또는 끄기 |
| API 엔드포인트 복사 | API 엔드포인트 URL을 클립보드에 복사 (서버 실행 중일 때 사용 가능) |
모델 관리¶
| 메뉴 항목 | 설명 |
|---|---|
| 모델 (N개 로드됨) | 로드된 모든 모델을 보여주는 하위 메뉴; 모델을 클릭하여 언로드 |
| 모든 모델 언로드 | 현재 로드된 모든 모델을 한 번에 언로드 |
빠른 탐색¶
| 메뉴 항목 | 설명 |
|---|---|
| 채팅 열기 | 채팅 페이지로 직접 이동 |
| 모델 열기 | 모델 관리 페이지로 이동 |
| 모니터 열기 | 통계/모니터 페이지로 이동 |
시스템 연동¶
| 메뉴 항목 | 설명 |
|---|---|
| 모델 폴더 열기 | 파일 관리자에서 모델 디렉토리 열기 |
| 로그 폴더 열기 | 파일 관리자에서 로그 디렉토리 열기 |
기본 작업¶
| 메뉴 항목 | 설명 |
|---|---|
| 표시 | 메인 애플리케이션 창 표시 및 포커스 |
| 설정 | 설정 페이지 직접 열기 |
| 종료 | 애플리케이션 완전히 종료 |
트레이 아이콘 활성화/비활성화¶
시스템 트레이 아이콘을 전환하려면:
- 애플리케이션 열기
- 설정 → 일반으로 이동
- 트레이 아이콘 표시 토글 찾기
- 원하는 대로 활성화 또는 비활성화
설정은 재시작 없이 즉시 적용됩니다.
기본 동작¶
- 트레이 아이콘은 기본적으로 활성화됨
- 활성화되면 애플리케이션 시작 시 아이콘이 나타남
- 설정은 애플리케이션 재시작 후에도 유지됨
다국어 지원¶
트레이 메뉴는 애플리케이션 언어를 변경하면 자동으로 업데이트됩니다. 모든 메뉴 항목은 영어와 한국어로 제공됩니다.
동적 업데이트¶
트레이 메뉴는 다음 상황에서 자동으로 업데이트됩니다:
- API 서버가 시작되거나 중지될 때
- 모델이 로드되거나 언로드될 때
- 애플리케이션 언어가 변경될 때
문제 해결¶
트레이 아이콘이 나타나지 않음¶
- 설정 → 일반에서 설정이 활성화되어 있는지 확인
- 일부 Linux 배포판에서는 시스템 트레이 확장(예: AppIndicator)을 설치해야 할 수 있음
- 활성화 후 아이콘이 나타나지 않으면 애플리케이션 재시작
트레이 아이콘이 클릭에 응답하지 않음 (Linux)¶
이는 Linux에서 알려진 제한 사항입니다. 대신 우클릭을 사용하여 컨텍스트 메뉴에 접근하세요.
종료 후에도 아이콘이 남아 있음¶
애플리케이션 종료 후 트레이 아이콘이 남아 있는 경우:
- 일반적으로 시스템 수준 캐시 문제임
- 아이콘 위로 마우스를 이동하면 사라짐
- 로그아웃 후 다시 로그인하면 남아 있는 아이콘이 정리됨