환경 변수

autofix

이름	필수	기본값	뜻
BRIDGE_URL	✓		agent-bridge 서버 주소. http·https 만, 끝의 / 는 떼요
BRIDGE_HOST	✓		일을 맡을 맥의 이름(대소문자 무시) 또는 id
BRIDGE_WORKDIR	✓		그 맥에서 세션을 열 폴더. 규칙의 {{workdir}} 자리에도 들어가요
VIEW_USER	✓		기록 화면 Basic 인증 아이디
VIEW_PASSWORD			기록 화면 비밀번호. 비면 화면과 GET /api/runs 가 늘 401
AUTOFIX_TOKEN			트리거 토큰. 비면 POST /api/trigger 가 늘 401
BRIDGE_SERVICE_TOKEN			agent-bridge 의 같은 이름 값. 비면 세션을 열지 못해 실행이 실패해요
RULES_FILE		내장 rules.md	규칙 파일 경로. 내장 규칙을 통째로 대신해요
RUN_TIMEOUT		4h	실행 제한 시간. Go 기간 형식(90m, 6h), 최소 10m
DATA_DIR		/data	기록 파일 runs.json 이 있는 폴더
PORT		8080	들을 포트
TZ			컨테이너 로그의 시간대(예: Asia/Seoul). 화면 시각은 늘 한국 시간이에요

시작할 때 검사

다음 중 하나라도 걸리면 시작하지 않고 이유를 로그에 남겨요.

• 필수 값 넷 중 빈 값이 있어요(빠진 이름을 모두 적어요).
• BRIDGE_URL 이 http(s)://호스트 꼴이 아니에요.
• RUN_TIMEOUT 을 읽을 수 없거나 10분보다 짧아요.
• RULES_FILE 을 읽을 수 없거나 비어 있어요.
• DATA_DIR/runs.json 이 있는데 읽을 수 없거나 JSON 이 깨졌어요.

토큰 셋 중 비어 있는 게 있으면 시작은 하되 경고를 한 줄 남겨요.

agent-bridge

서비스 API 를 켜려면 agent-bridge 서버에 두 값을 넣어요. 자세한 내용은 agent-bridge 환경 변수를 보세요.

이름	뜻
BRIDGE_SERVICE_TOKEN	서비스 API 토큰. 32자 이상, 짧으면 서버가 뜨지 않아요
BRIDGE_SERVICE_UID	토큰으로 행동할 사용자 id (예: gh12345). 그 사람의 맥에만 세션을 열어요

두 값이 다 있어야 켜져요. 하나라도 비면 서비스 API 는 늘 401 이에요.

스캐너

스캐너 쪽 이름은 자유지만, 이 문서의 예시는 이렇게 써요.

이름	뜻
AUTOFIX_URL	autofix 주소 (예: https://autofix.example.com)
AUTOFIX_TOKEN	autofix 의 AUTOFIX_TOKEN 과 같은 값