구성

config.yaml은 선택 사항입니다. 없으면 프록시는 아래의 기본값으로 시작합니다.

기본 설정 파일 경로

OS	경로
macOS	~/Library/Application Support/sotatek-proxy/config.yaml
Linux	~/.config/sotatek-proxy/config.yaml ($XDG_CONFIG_HOME 준수)
Windows	%ProgramData%\SotatekProxy\config.yaml

전체 예시

# 로컬 리스너 포트. 루프백 바인딩은 하드코딩됨 — `host`는 설정 불가.
port: 3817

# 업스트림 Bifrost 게이트웨이. 경로는 1:1로 전달됨 (제거 없음).
upstream_url: 'https://bifrost.sotatek.works'

# {pid → git-remote} 캐시의 TTL(초). 0이면 비활성화.
cache_ttl_seconds: 60

# 로깅 — lumberjack을 통한 로테이션, stdout으로 동시 출력.
log:
  # file: <OS별 기본값 — 비워두세요>
  max_size_mb: 50 # 현재 파일이 이 크기를 초과하면 로테이션
  max_backups: 5 # N개의 로테이션된 (.gz) 파일 유지
  max_age_days: 30 # 이보다 오래된 로테이션 파일 삭제
  json: false # JSON 로그 출력을 위해 true로 설정 (Loki/ELK 수집)

# 선택적 프로파일링 엔드포인트. 기본값으로 비활성화됨. 시작 시 루프백 전용 강제 적용.
pprof:
  enable: false
  addr: '127.0.0.1:8316'

# 상세 로깅 (gin 디버그 모드 + logrus 디버그 레벨).
debug: false

필드 참조

필드	타입	기본값	비고
port	int	3817	1–65535. 루프백 바인딩 하드코딩.
upstream_url	string	https://bifrost.sotatek.works	http:// 또는 https://로 시작해야 합니다. http://는 시작 시 경고를 트리거합니다 (API 키가 네트워크를 통해 평문으로 전송됨).
cache_ttl_seconds	int	60	0이면 캐시 비활성화.
log.file	string	OS 기본값	빈 문자열은 기본값 유지.
log.max_size_mb	int	50	로테이션 크기 임계값.
log.max_backups	int	5	유지할 로테이션된 .gz 파일 수.
log.max_age_days	int	30	이보다 오래된 로테이션 파일 삭제.
log.json	bool	false	로그 수집을 위한 JSON 라인 형식.
pprof.enable	bool	false	/debug/pprof/* 활성화.
pprof.addr	string	127.0.0.1:8316	루프백으로 확인되어야 합니다 (시작 시 검증).
debug	bool	false	상세 로그 + Gin 디버그 모드.

환경 변수 재정의

변수를 설정한 후 데몬을 시작합니다. 환경 변수 값이 YAML을 덮어씁니다.

변수	필드	예시
SOTATEK_PROXY_PORT	port	3818
SOTATEK_PROXY_UPSTREAM	upstream_url	https://bifrost-staging.sotatek.works
SOTATEK_PROXY_DEBUG	debug	true
SOTATEK_PROXY_LOG_JSON	log.json	true

핫 리로드

config.yaml을 편집하고 저장하면 약 500ms 이내에 변경 사항이 적용됩니다 (fsnotify 디바운스). 다음 항목은 재시작 없이 적용됩니다:

• debug
• cache_ttl_seconds
• log.max_size_mb, log.max_backups, log.max_age_days
• log.json

재시작이 필요한 필드

다음 변경 사항은 감지되어 경고와 함께 기록되지만, 데몬을 재시작할 때까지 실행 중인 설정은 변경되지 않습니다:

• port (리스너 재바인딩 필요)
• upstream_url (프록시 재설정 필요)
• log.file (파일 핸들 재오픈 필요)
• pprof.enable, pprof.addr

이 항목 중 하나를 편집한 후에는 명시적으로 재시작하세요:

sotatek-proxy stop && sotatek-proxy start

요청 본문 크기 제한

인바운드 요청 본문은 로컬 클라이언트의 과부하를 방어하기 위해 100 MiB로 제한됩니다. SSE / 스트리밍 응답은 영향을 받지 않습니다. 이 제한은 현재 컴파일 타임 상수입니다.