테마
문제 해결
서버가 뜨지 않아요
컨테이너 로그의 마지막 줄을 보세요.
| 로그 | 원인 | 대처 |
|---|---|---|
필수 환경 변수가 비어 있어요: … | 적힌 값이 비어 있음 | 그 환경 변수를 넣어요 |
BRIDGE_URL 이 주소 형식이 아니에요 | https:// 가 빠졌거나 오타 | https://bridge.example.com 처럼 넣어요 |
RUN_TIMEOUT 은 10m 이상의 기간이어야 해요 | 4시간 처럼 썼거나 너무 짧음 | 4h, 90m 처럼 Go 기간 형식으로 |
규칙 파일을 읽지 못했어요 | 마운트 경로가 다르거나 권한이 없음 | RULES_FILE 경로와 마운트, 파일 권한(다른 사용자 읽기)을 확인해요 |
규칙 파일이 비어 있어요 | 파일에 공백만 있음 | 내용을 채우거나 RULES_FILE 을 지워 내장 규칙을 써요 |
기록 파일 읽기 실패 | runs.json 을 읽을 수 없거나 JSON 이 깨짐 | 파일 권한과 내용을 확인해요. 깨졌다면 백업으로 바꾸거나 옮겨 두고 다시 시작해요 |
트리거가 거절돼요
| 응답 | 원인 | 대처 |
|---|---|---|
401 토큰이 맞지 않아요 | Authorization: Bearer 값이 다르거나 AUTOFIX_TOKEN 이 비어 있음 | 양쪽 값을 맞춰요. Bearer 뒤 공백 하나까지 정확히 |
400 JSON 을 읽지 못했어요 | 본문이 JSON 이 아니거나 4MB 를 넘음 | jq . findings.json 으로 검사하고, 크면 나눠 보내요 |
500 기록 저장 실패 | /data 에 쓸 수 없음 | 볼륨을 uid 10001 이 쓸 수 있게 해요(서버 올리기) |
200 {"skipped": …} | findings 가 비었음 | 정상이에요. 할 일이 없었어요 |
202 {"status": "skipped"} | 이전 실행이 진행 중 | 정상이에요. 진행 중인 실행이 오래 걸리면 아래를 보세요 |
실행이 바로 실패해요
기록의 빨간 글이 원인이에요. agent-bridge 의 응답이 bridge POST /api/service/sessions: HTTP <코드> <문구> 꼴로 들어가요.
| 빨간 글 | 원인 | 대처 |
|---|---|---|
HTTP 401 서비스 토큰이 맞지 않아요 | 두 서버의 BRIDGE_SERVICE_TOKEN 이 다르거나, agent-bridge 에 BRIDGE_SERVICE_UID 가 없음 | 두 값을 맞추고 agent-bridge 를 다시 배포해요 |
HTTP 404 그런 맥이 없어요 | BRIDGE_HOST 가 그 사람의 맥 이름·id 와 다름 | agent-bridge 화면의 맥 이름을 그대로 넣어요(대소문자는 무시) |
HTTP 409 맥이 연결돼 있지 않아요 | 맥이 꺼졌거나 잠들었거나 연동 탭이 닫힘 | 맥을 깨워 agent-bridge 에 다시 붙여요. 다음 트리거 때 다시 맡겨져요 |
HTTP 404 없는 경로예요, 또는 로그인을 요구하는 401·403 | agent-bridge 가 서비스 API 가 없는 옛 판(1.320 전)이거나 BRIDGE_URL 에 경로가 붙음 | agent-bridge 를 올리고, BRIDGE_URL 은 주소만 넣어요 |
규칙 파일을 읽지 못했어요 | 실행 중에 규칙 파일이 사라짐 | 마운트를 확인해요 |
연결 오류(dial tcp …, timeout) | BRIDGE_URL 로 닿지 않음 | 컨테이너 안에서 그 주소에 닿는지 확인해요 |
확인 대기에서 멈춰 있어요
세션이 위험한 호출이나 질문 앞에서 사람을 기다리는 중이에요. 빨간 글의 사람 확인 대기: … 가 무엇을 기다리는지예요.
- agent-bridge 에서 그 세션을 열고(세션 id 는 카드 아래에 있어요) 카드에 답해요.
- 같은 이유로 자주 멈춘다면 규칙에 판단 기준을 더해요. 예: "강제 push 가 필요해 보이면 하지 말고 실패로 적어요".
확인 대기 동안 오는 트리거는 모두 건너뛰어요.
시간 초과로 끝났어요
- 세션이 아직 일하는 중일 수 있어요. agent-bridge 에서 확인하고, 끝나면 결과는 거기서 읽어요. autofix 기록은 다시 바뀌지 않아요.
- 목록이 길어 자주 넘친다면
RUN_TIMEOUT을 늘리거나, 스캐너에서 한 번에 보내는 양을 줄여요. - 맥이 오래 끊겨 상태를 못 읽은 경우에도 시간 초과가 돼요. 컨테이너 로그에
상태 읽기 실패가 반복돼요.
완료인데 결과가 이상해요
- 결과가 짧거나 중간 요약 같아요: 세션의 마지막 답변이 그대로 들어가요. 규칙의 마지막에 결과 형식을 적어 두세요.
- 완료가 늦게 찍혀요: 정상이에요. 세션이 답을 마친 뒤 2분 동안 그대로인지 보고, 1분 간격으로 확인하니 2~3분 늦어요.
- 결과 끝이
…(잘림)이에요: agent-bridge 가 답변을 20,000자에서 잘라 보내요. 결과를 짧게 쓰라고 규칙에 적어요.
로그 보기
autofix 는 실행마다 한 줄씩 남겨요.
[run 20261025-0030-a1b2c3] 세션 0f1e… 시작 (취약점 3건)
[run 20261025-0030-a1b2c3] done
[run 20261025-0030-a1b2c3] 상태 읽기 실패: …
[run 20261025-0030-a1b2c3] 세션 시작 실패: …