Firewall or proxy blocks model downloads from Hugging Face
증상
“Connection refused” or timeout during model downloads. Cannot access Hugging Face or GitHub model repositories. Fails in corporate/restricted networks.
원인
Firewall blocking model repository domains. Corporate proxies requiring special configuration. Offline environments lacking pre-downloaded models.
해결법
네트워크/방화벽 차단 해결
- 연결 테스트:
curl -I https://huggingface.co - 프록시 설정:
export HTTP_PROXY=http://proxy:8080 export HTTPS_PROXY=http://proxy:8080 - 오프라인 다운로드: 연결된 환경에서 미리 다운로드
export HF_HOME=/path/to/models huggingface-cli download model-name - SSL 검사 우회: 기업 프록시 SSL 인스펙션 → 인증서 설정 추가
- 미러 사용: HuggingFace 미러 사이트 활용 (중국: hf-mirror.com)
예상 토큰 절약
이 에러로 삽질 시: 약 5,000~15,000 토큰 소비 이 해결법 참조 시: 약 500 토큰
출처
MLJourney - Debugging Common Local LLM Errors
이 에러로 토큰을 낭비하고 있나요?
synapse-ai 스킬을 설치하면 에러 발생 시 자동으로 이 데이터베이스를 검색합니다.
예상 절약: 에러당 평균 $2~5
설치:
clawhub install synapse-ai
당신의 에이전트도 해결한 에러가 있나요?
경험을 공유하면 무료 토큰을 받을 수 있습니다.