gori는 전역 환경설정을 JSON 설정 파일에 보관하고, 각 프로젝트를 자체 SQLite 데이터베이스로 저장합니다. 이 페이지는 첫날 필요한 핵심만 다룹니다. 무엇이 어디에 있는지, 프록시가 어떻게 바인딩되는지, 클라이언트가 gori의 CA를 어떻게 신뢰하는지입니다. 키 단위 전체 설명은 설정 레퍼런스를 참고하세요.
gori 홈 디렉터리
gori가 쓰는 파일은 모두 GORI_HOME 트리 하나 아래에 있습니다. 해당 환경 변수가 설정되어 있고 비어 있지 않으면 $GORI_HOME으로, 아니면 ~/.gori로 해석됩니다. 여기에는 settings.json(전역 환경설정), projects/ 아래의 프로젝트 데이터베이스, ca/의 루트 CA, 그리고 themes/와 wordlists/가 담깁니다. 전체 트리는 저장소 레이아웃을 참고하세요.
한 세션만 격리된 홈을 쓰려면:
GORI_HOME=/tmp/gori-scratch gori
전역 설정
전역 환경설정은 settings.json에 저장됩니다. 경로를 출력하거나 $EDITOR에서 열려면:
gori settings # settings.json 경로 출력
gori settings --edit # 에디터에서 열기
파일을 직접 편집할 일은 거의 없습니다. 파일의 모든 항목은 Preferences 모달에서 편집할 수 있고, 서브탭 다섯 개(General, Appearance, Editor & Keys, Network & Tabs, AI)로 나뉩니다.
| 여는 방법 | 도착 지점 |
|---|---|
어디서나 Ctrl-, |
그룹 스트립. 그룹을 먼저 고릅니다 |
상단 바의 ⚙ 칩 |
Ctrl-,와 동일 |
Ctrl-P → Settings: … 항목 |
해당 섹션의 필드로 바로 |
Ctrl-,는 프로젝트 선택기에서도, 즉 프로젝트를 열기 전에도 동작하므로 첫 실행에서 테마를 정할 수 있습니다. 저장한 변경은 재시작 없이 즉시 적용됩니다. 모든 섹션과 필드는 설정 가이드를, 그 아래의 키는 설정 레퍼런스를 참고하세요.
네트워크
업스트림 설정이나 프로세스 프록시 환경변수가 없으면 프록시는 127.0.0.1:8070에서 수신하며 대상에 직접 연결합니다. gori 쪽 경로를 바꿀 수 있는 곳은 세 군데이며, 우선순위가 높은 순서대로:
- 프로젝트별: Project 탭이나 헤드리스로
gori run project network를 써서 한 프로젝트의 바인드 주소, 포트, 업스트림을 고정합니다. 해당 프로젝트에 한해 우선합니다. - CLI 플래그:
--listen/--port는 현재 프로세스에 한해 전역 기본값을 재정의하며 디스크에 기록되지 않습니다. settings.json의network: 공유되는 기본값으로, 첫 실행 마법사와 Preferences → Network가 편집합니다.
아무것도 설정되지 않으면 공장 기본값은 127.0.0.1:8070, 직접 연결입니다. network.upstream_proxy가 비어 있으면 gori는 일반적인 HTTPS_PROXY, HTTP_PROXY, ALL_PROXY 환경변수(소문자 표기도 지원)와 NO_PROXY / no_proxy 예외도 사용하며, localhost와 루프백 목적지는 항상 직접 연결합니다. 프로젝트 업스트림, 업스트림 규칙, 비어 있지 않은 network.upstream_proxy는 이 환경변수보다 우선합니다. 모든 키는 network를, 정확한 우선순위는 프로젝트별 재정의를 참고하세요.
루트 CA
HTTPS를 인터셉트하려면 클라이언트가 gori의 루트 인증서를 신뢰해야 합니다. 이 인증서는 $GORI_HOME/ca(기본값 ~/.gori/ca)에 root.crt.pem과 root.key.pem으로 보관됩니다.
gori ca # 인증서 경로 출력
gori ca --pem # PEM을 stdout으로 출력
gori ca --ca-dir /path # 다른 CA 디렉터리 사용
gori ca regenerate --yes # 루트 CA 교체 (스크립트/CI용, 이전 신뢰 무효화)
TUI 커맨드 팔레트(Regenerate CA certificate)에서, 또는 대화식으로 gori ca regenerate(regenerate를 입력해 확인)로 CA를 교체할 수도 있습니다. 두 경로 모두 확인 절차를 거치는데, 교체하면 이전에 발급된 모든 신뢰가 무효화되기 때문입니다. 이미 실행 중인 gori는 재시작 전까지 기존 CA를 유지합니다.
자체 CA 사용하기
CA 하나를 팀이나 여러 머신에서 재사용하려면, 루트를 외부에서 생성한 뒤 가져오세요(인증서 및 키: gori는 키로 리프 인증서에 서명하고, 클라이언트는 인증서만 신뢰합니다):
openssl ecparam -genkey -name prime256v1 -out root.key.pem
openssl req -x509 -new -key root.key.pem -days 3650 -subj "/CN=my ca" -out root.crt.pem
gori ca import --cert root.crt.pem --key root.key.pem --yes
같은 동작을 팔레트(Import CA certificate)에서도 할 수 있습니다. gori는 가져오기 전에 키가 인증서와 일치하는지, 그 인증서가 CA인지, 그리고 그 키로 실제로 리프 인증서를 서명할 수 있는지 확인합니다. 리프는 SHA-256으로 서명하므로 Ed25519 · Ed448 루트는 거부됩니다. 신뢰용으로는 root.crt.pem만 배포하고, root.key.pem은 비밀로 유지하세요. gori ca import를 참고하세요.
팔레트의 Open browser 동작은 이미 CA를 신뢰하고 프록시를 경유하는 격리된 프로파일로 설치된 브라우저를 실행합니다(빠른 시작 참조).
커맨드라인 도구에는 팔레트의 Open shell 동작이 같은 일을 터미널에 해줍니다. Open shell here는 프록시와 CA 번들이 설정된 $SHELL에 이 터미널을 넘겨주고(그동안 gori는 계속 캡처하며, 셸을 나가면 돌아옵니다. 셸이 화면을 쓰는 동안에는 붙잡힌 요청을 넘길 수 없으므로 캡처는 켜져 있고 인터셉트는 꺼져 있어야 합니다), Copy env는 다른 창에 붙여 넣을 한 줄 명령(eval "$(gori run shell --print ...)")을 클립보드에 복사합니다. 어느 터미널에서든 gori run shell로도 같은 일을 할 수 있습니다(gori run shell 참조).