지원 받기

필요한 정보를 한 번에 모으고, 개인적인 내용은 가리고, 알맞은 곳에 질문하세요.

질문하기 전에

1. 문제 해결에서 해당 증상을 읽어 보세요.
2. doctor를 실행하세요: docker exec holyarrs /holyarrs doctor. 설명이 나온 FAIL 줄은 모두 해결하세요.

지원 번들 모으기

지원 번들은 도와주는 사람이 가장 먼저 요청하는 것을 담은 zip 파일 하나입니다. 소유자와 관리자가 다운로드할 수 있습니다.

1. /health 페이지를 여세요.
2. Download support bundle(지원 번들 다운로드)을 클릭하세요. .zip 파일이 받아집니다.

파일	내용
log.txt	키, 토큰, 비밀번호를 지운 최신 로그.
about.json	버전과 설치 환경 정보.
doctor.txt	doctor 보고서.
health.json	현재 상태 점검 결과.

웹 페이지를 열 수 없다면 대신 doctor 출력과 로그 마지막 100줄을 보내세요: docker logs --tail 100 holyarrs.

개인적인 내용 가리기

비밀 값은 지워지지만, 번들에는 폴더 경로와 호스트 이름이 여전히 보일 수 있습니다. 무엇이든 올리기 전에 다음을 하세요.

• 호스트 이름, 도메인, 공인 IP 주소를 example로 바꾸세요.
• 경로에 들어간 본인 이름처럼 공개하고 싶지 않은 폴더 이름을 지우세요.
• holyarrs.key, API 키, 비밀번호, 비밀 값이 들어 있는 Compose 파일은 절대 올리지 마세요.

질문할 곳

장소	용도
Discord	질문과 설치 도움.
GitHub Issues	다시 일으킬 수 있는 버그.
r/HolyArrs	아이디어.

메시지에는 무엇을 했는지, 무엇을 기대했는지, 실제로 무슨 일이 일어났는지 적으세요. 번들을 첨부하거나 doctor 출력을 붙여 넣으세요.

고급 사용자용

API로 번들 받기

admin 범위를 가진 소유자 또는 관리자 키를 X-Api-Key에 담아 GET /api/v1/support/bundle을 호출하면 같은 zip을 돌려줍니다.

관련 문서

• 문제 해결
• 로그
• FAQ