설정 및 실행 옵션
명령줄 옵션
| 옵션 | 설명 |
|---|---|
-c | 설정 디렉터리. 환경 변수 GATELY_CONFIG_DIR로도 지정할 수 있습니다 |
-listen | 관리 UI 수신 주소를 덮어씁니다. 예: :16680 |
-apply | 선언적 설정 디렉터리. 환경 변수 GATELY_APPLY_DIR로도 지정할 수 있습니다. 아래 내용을 참고하세요 |
-version | 버전 정보를 출력합니다 |
| 환경 변수 | 설명 |
|---|---|
GATELY_INITIAL_PASSWORD | 최초 실행 시 사용할 관리자 초기 비밀번호(8자 이상). 설정하지 않으면 기본 비밀번호 gately.cn을 사용합니다. 계정이 이미 있으면 적용되지 않습니다 |
설정 디렉터리
모든 설정은 설정 디렉터리에 저장되며 모듈마다 <name>.json 일반 파일 하나를 사용합니다. 파일은 원자적으로 기록되고 권한은 0600입니다. 따라서 다음이 가능합니다.
- 텍스트 편집기로 바로 열어 볼 수 있습니다.
- 디렉터리를 git에 넣어 변경 사항을 diff로 감사하고 언제든 롤백할 수 있습니다.
- 백업은 디렉터리를 복사하는 것으로 끝납니다.
주의
ssl.json에는 인증서 개인 키가 들어 있습니다. 버전 저장소에 넣기 전에 저장소가 비공개인지 확인하거나 이 파일을 무시 목록에 추가하세요.
선언적 설정
-apply <디렉터리>를 지정하면 실행할 때마다 해당 디렉터리의 <이름>.json 파일을 설정 디렉터리에 덮어씁니다. 내용이 같은 파일은 다시 쓰지 않습니다. git 저장소, Kubernetes ConfigMap, 배포 스크립트로 설정을 일괄 배포할 때 적합합니다.
- 기록하기 전에 올바른 JSON인지 검사하며, 하나라도 잘못된 파일이 있으면 실행을 거부합니다.
account.json과tokens.json은 덮어쓸 수 없습니다. 계정과 토큰은 관리 UI에서만 관리합니다.- 덮어쓴 이전 내용은 설정 기록에 저장되며 언제든 되돌릴 수 있습니다.
외부 프로그램 디렉터리
Tailscale, frp, cloudflared 모듈은 공식 외부 프로그램을 관리하며 다음 순서로 실행 파일을 찾습니다.
- 모듈 설정에 입력한 경로
PATH- 설정 디렉터리 아래의
bin/하위 디렉터리
Docker로 배포할 때는 마운트한 설정 디렉터리에 바이너리를 넣으면 됩니다. 예: ./gately-data/bin/frpc. Tailscale은 tailscale과 tailscaled가 모두 필요합니다. 자세한 내용은 Tailscale / frp / cloudflared를 참고하세요.
실행 로그
시스템과 각 모듈의 실행 로그는 기본적으로 설정 디렉터리의 logs/에 기록되므로, 재시작하거나 업그레이드한 뒤에도 「시스템 로그」와 각 모듈 페이지에서 볼 수 있습니다.
- 출처마다 JSON Lines 파일 하나:
logs/<모듈 ID>.log, 시스템 로그는logs/gately.log. 시작할 때 「로그 보관 줄 수」만큼 최근 로그를 파일에서 복원합니다. - 새 로그는 최대 1초 늦게 묶어서 기록합니다. 파일이 상한(기본 2 MB)을 넘으면
.1로 교체하고 그 하나만 보관하므로, 출처마다 최대 상한의 두 배를 사용합니다. - 「설정 → 네트워크 및 실행 → 실행 매개변수」에서 「로그 영구 저장」을 끄거나 「로그 파일 상한」을 바꿀 수 있으며 즉시 적용됩니다. 끄면 로그는 메모리에만 보관되고 재시작하면 지워집니다.
- 화면에서 모듈 로그를 지우면 해당 파일도 함께 삭제됩니다.
- 설정 백업에는
logs/와 작업 감사 로그audit.log가 포함되지 않습니다.
백업 및 복원
「설정」에서 설정 백업과 복원을 제공하며 Lucky 설정을 가져오는 진입점도 여기에 있습니다.