구성 옵션

설정 파일 위치

WSL Dashboard의 설정 파일과 로그는 기본적으로 사용자의 개인 디렉터리에 저장됩니다:

파일/디렉터리	경로	설명
설정 디렉터리	~\.wsldashboard\	모든 영구 데이터를 저장하는 루트 디렉터리
설정 파일	~\.wsldashboard\settings.toml	모든 UI 설정, 경로 설정 등
로그 디렉터리	~\.wsldashboard\logs\	실행 로그 파일 저장

TIP

~는 현재 Windows 사용자의 홈 디렉터리(일반적으로 C:\Users\사용자명)를 나타냅니다.

부팅 시 자동 시작 (/scheduler)

WSL Dashboard는 안정적인 부팅 시 자동 시작 메커니즘을 제공합니다.

작동 원리

설정에서 "부팅 시 자동 시작"을 켜면 앱은 단순히 바로 가기를 "시작" 폴더에 넣는 대신 **Windows 작업 스케줄러(Task Scheduler)**를 통해 고성능 시작 작업을 생성합니다.

• 조용한 시작: 작업 스케줄러는 시작 시 /scheduler 인자를 함께 전달합니다. 이 인자는 앱이 최소화 상태로 시스템 트레이에 직접 시작되도록 하여, 메인 창이 떠서 작업을 방해하지 않습니다.
• 자동 복구: 앱을 수동으로 시작할 때마다 경로 이동이나 권한 문제로 인해 무효화된 시작 작업을 확인하고 자동으로 복구하여 자동 시작이 항상 유효하도록 보장합니다.

설정 가능한 항목

앱의 "설정" 보기에서 다음 옵션을 조정할 수 있습니다:

일반 설정

• 언어: UI 표시 언어 선택(중국어 간체, 영어 등 20개 이상 언어 지원).
• 기본 설치 디렉터리: 새 WSL 인스턴스의 기본 저장 경로 설정.
• 부팅 시 자동 시작: 켜면 WSL Dashboard가 Windows와 함께 시작됩니다.
• 시작 시 트레이로 최소화: 켜면 앱 시작 후 바로 시스템 트레이로 들어가 메인 창을 표시하지 않습니다(조용한 모드).

인터페이스 및 동작

• 외관 테마: 라이트, 다크 또는 시스템 팔로우 지원.
• 종료 동작: 닫기 버튼을 클릭할 때 "프로그램 종료" 또는 "시스템 트레이로 최소화"를 설정할 수 있습니다.
• 업데이트 자동 확인: 새 버전 확인 주기 설정.

로그 설정

• 로그 디렉터리: 로그 파일의 저장 위치 지정.
• 로그 레벨: Error, Warn, Info, Debug, Trace의 5단계를 제공하며 기본값은 Info입니다. 문제가 발생하면 더 많은 디버그 정보를 얻기 위해 Debug 또는 Trace로 조정하는 것을 권장합니다.

설정 파일 (settings.toml)

앱의 모든 설정은 ~\.wsldashboard\settings.toml에 영구 저장됩니다. 이 파일을 수동으로 편집할 수도 있지만, UI를 통해 변경하는 것을 권장합니다.

설정 초기화

모든 설정을 기본값으로 되돌리려면 ~\.wsldashboard 파일을 삭제한 후 WSL Dashboard를 다시 시작하세요.