구성 참조

PhanTerm은 대부분의 관리 작업을 TUI 인터페이스를 통해 수행할 것을 권장하지만, 모든 기본 데이터는 사람이 읽을 수 있는 구조화된 일반 텍스트로 영구 저장됩니다. 이는 고급 사용자가 백업, 버전 제어 및 외부 자동화 스크립트를 작성하는 데 매우 편리합니다.

구성 파일 경로

모든 데이터는 사용자의 전용 로컬 구성 디렉터리에 저장됩니다.

Windows: %APPDATA%\phanterm\
Linux/macOS: ~/.config/phanterm/

핵심 파일 목록

파일 이름	용도	형식 설명
`config.yaml`	전역 기본 설정	언어, 업데이트 스위치 및 동시성 제한 등과 같은 기본 설정을 포함합니다.
`connections.yaml`	호스트 목록	서버 목록입니다. 비밀번호 등 민감한 필드는 시스템 키링에 의존하는 경우 비워 두거나 특수 참조로 표시되며, 그렇지 않으면 강력하게 암호화된 AES 암호문으로 저장됩니다.
`known_hosts.yaml`	신뢰할 수 있는 지문 라이브러리	확인된 모든 호스트 주소, 알고리즘 유형 및 SHA-256 지문을 기록합니다.
`snippets.yaml`	명령 스니펫 라이브러리	모든 사용자 정의 명령 스니펫과 태그 메타데이터를 저장합니다.
`master.key`	AES 대체 키	[일급 기밀] 이 파일을 안전하게 보관하고 공개 코드 저장소에 절대 커밋하지 마십시오.

사용자 지정 `config.yaml`

config.yaml은 애플리케이션의 전역 동작 제어를 제공합니다. 이 파일을 수동으로 편집하여 PhanTerm의 동작을 사용자 지정할 수 있습니다. 파일이 없는 경우 PhanTerm은 다음 번 실행 시 기본값이 포함된 구성 파일을 자동으로 생성합니다.

구성 예시

다음은 일반적인 config.yaml의 예시 버전입니다:

# 인터페이스 언어 설정, 현재 'en' (영어) 및 'zh' (중국어) 지원
locale: "en"

# 자동 업데이트 채널: 'stable' (안정 버전) 또는 'beta' (베타 버전)
update_channel: "stable"

# 시작 시 업데이트 자동 확인 여부
check_updates_on_startup: true

# Multi-Exec 병렬 일괄 실행 고급 구성 [Pro]
multi_exec:
  # 저장된 여러 서버에 임시 연결을 시작할 때의 최대 동시성 (기본값: 10, 범위: 1-10)
  temp_connect_concurrency: 10

  # 각 대상 서버에서 명령을 실행하는 최대 시간 초과, 단위는 초 (기본값: 300, 즉 5분)
  target_timeout_seconds: 300

구성 항목 설명

locale: TUI 인터페이스의 표시 언어를 정의합니다. 비어 있거나 지원되지 않는 언어의 경우 기본 영어 인터페이스로 되돌아갑니다.
update_channel 및 check_updates_on_startup: 애플리케이션이 새 버전 푸시를 가져오는 방법을 제어합니다.
multi_exec: 이 섹션은 특별히 Multi-Exec 기능의 기본 동작을 제어하는 데 사용됩니다. 네트워크 환경에 따라 temp_connect_concurrency를 조정하여 병렬 연결 설정 부하를 제어하거나 target_timeout_seconds를 늘려 매우 긴 시간이 소요되는 스크립트(예: 대용량 파일 패키징 또는 전체 시스템 업그레이드)가 강제 중단 없이 원활하게 완료되도록 허용할 수 있습니다.