마스터와 대시보드

마스터는 떠 있지만 UI가 깨지거나 API에 접속할 수 없는 상황입니다.

웹 대시보드가 502 / 504 반환

web-ui (Nginx) 컨테이너는 떠 있지만 api-server에 닿지 못하는 상태입니다. 다음으로 확인합니다.

~$ curl http://localhost:28080/health
~$ docker logs mac-api-server | tail

API 서버가 정상이라면 Nginx를 재시작합니다.

~$ docker compose -f /etc/mango/mac/docker-compose.master.yml restart web-ui

기본 자격 증명은 admin / admin입니다. MAC_ADMIN_PASSWORD로 초기 비밀번호를 지정했다면, 그 변수가 최초 기동 전에 설정되어 있었는지 확인하세요 — 이후에 변경해도 반영되지 않습니다.
admin 비밀번호를 재설정하려면, 마스터를 중지하고 api-server 데이터 볼륨 (사용자 정보 users.json과 /app/data/의 JWT 시크릿이 들어 있는 곳)을 삭제한 뒤 다시 기동합니다. Prometheus와 Loki 볼륨은 분리되어 있어 영향을 받지 않습니다.
```
~$ mac stop master
~$ docker volume rm mac-api-data
~$ mac env set MAC_ADMIN_PASSWORD=<새 비밀번호>
~$ mac start master
```

대시보드는 로컬에서는 잘 동작하지만, 원격에서 :28080으로 curl 하면 실패하는 경우입니다.

방화벽 확인: sudo ufw status.
도커가 포트를 노출하는지 확인: docker ps | grep 28080의 결과에 0.0.0.0:28080->28080/tcp가 있어야 합니다.