Nginx 오류 해결: "could not build server_names_hash, you should increase server_names_hash_bucket_size: 64"

 

Nginx를 설정할 때 nginx: [emerg] could not build server_names_hash, you should increase server_names_hash_bucket_size: 64 오류 메시지를 만나는 경우가 있습니다. 이 오류는 Nginx의 서버 이름 해시 테이블이 구성된 서버 이름을 저장하기에 충분히 크지 않다는 것을 의미합니다. 이는 일반적으로 많은 수의 서버 이름 또는 매우 긴 서버 이름을 정의할 때 발생합니다. 이 문제를 해결하기 위해 server_names_hash_bucket_size를 증가시키는 방법을 알아보겠습니다.

1. 문제 원인

Nginx의 server_names_hash_bucket_size 디렉티브는 서버 이름 해시 테이블의 버킷 크기를 정의합니다. 기본값은 일반적으로 32 또는 64로 설정되어 있지만, 많은 수의 서버 이름을 사용하거나 매우 긴 서버 이름을 사용할 때 이 크기가 부족할 수 있습니다.

2. 해결 방법

server_names_hash_bucket_size를 증가시켜 Nginx가 더 큰 해시 테이블을 생성하도록 합니다. 다음은 이를 수행하는 단계입니다.

2.1 Nginx 설정 파일 열기

먼저 Nginx 설정 파일을 엽니다. 이 파일은 일반적으로 /etc/nginx/nginx.conf 또는 /usr/local/nginx/conf/nginx.conf 경로에 위치합니다.

sudo nano /etc/nginx/nginx.conf

 

2.2 http 블록 찾기

설정 파일에서 http 블록을 찾습니다. 이 블록 내에 server_names_hash_bucket_size 디렉티브를 추가하거나 수정합니다.

http { 
     server_names_hash_bucket_size 128; # 또는 더 큰 값으로 설정
}

 

2.3 설정 파일 저장 및 종료

변경 사항을 저장하고 편집기를 종료합니다. (nano를 사용했다면 Ctrl + X, Y, Enter를 차례로 눌러 저장 후 종료)

2.4 Nginx 설정 테스트

새로운 설정이 올바른지 테스트합니다.

sudo nginx -t

 

2.5 Nginx 재시작 또는 리로드

설정 테스트가 성공하면 Nginx를 리로드하여 변경 사항을 적용합니다.