Nginx unknown directive가 나오면 오타와 모듈을 나눠 확인

문법 이름이 맞아도 모듈이 없을 수 있습니다

Nginx의 일부 기능은 빌드 시 포함하거나 동적 모듈로 준비해야 합니다. unknown directive 오류를 보았다고 지시어 이름을 임의로 바꾸지 말고 해당 기능의 모듈과 현재 패키지 구성을 확인합니다.

버전·빌드 옵션·로드 구성을 비교합니다

공식 문서가 요구하는 모듈과 버전을 현재 실행 바이너리의 정보와 비교합니다. 다른 서버에 설치된 Nginx와 같은 이름이라도 기능 구성은 다를 수 있습니다. 문서의 상용 기능 여부도 구분합니다.

설치 교체는 설정 보존 계획과 분리합니다

모듈을 얻으려고 운영 바이너리를 즉시 교체하면 패키지 경로와 서비스 관리가 달라질 수 있습니다. 먼저 필요한 기능과 지원 패키지를 확인하고 시험 환경에서 설정 검증을 합니다. 이 글은 실제 패키지를 설치하거나 운영 서비스를 재시작하지 않습니다.

서버 운영 실행 전 점검표

• 문법 이름이 맞아도 모듈이 없을 수 있습니다
• 버전·빌드 옵션·로드 구성을 비교합니다
• 설치 교체는 설정 보존 계획과 분리합니다