일반적인 Nginx 오류 메시지를 수정하는 방법: 단계별 가이드

NGINX 오류는 어떻게 수정합니까?

몇 가지 일반적인 NGINX 오류를 확인했으므로 'NGINX 오류를 수정하려면 어떻게 해야 합니까?'라는 질문이 생길 수 있습니다.

답은 생각보다 어렵지 않습니다. NGINX 오류에 사용할 수 있는 다양한 문제 해결 방법이 있습니다. 그러나 이러한 문제 해결 방법은 초기 단계에만 해당된다는 점에 유의해야 합니다. 문제의 정확한 원인을 파악하려면 추가 조사가 필요합니다.

기본적으로 NGINX 오류에 대한 문제 해결 과정을 시작하는 데 도움이 되는 세 가지 명령이 있습니다.

• sudo cat /var/log/nginx/error.log 명령을 사용하여 문제에 대한 오류 로그 및 세부 정보를 가져옵니다.
• Nginx 활성 상태 확인: sudo systemctl status nginx
• 구성 파일의 구문 오류를 확인하려면: sudo nginx -t

1. 오류 로그로 Nginx 오류 문제 해결

NGINX에 문제가 발생하면 이러한 NGINX 오류의 대부분은 모호하며 실제 문제를 간단히 파악하기가 쉽지 않습니다. 더 큰 문제로 인해 오류가 발생하거나 완전히 관련이 없을 수 있습니다.

이것은 모두 NGINX 설정을 구성한 방법과 직면한 특정 상황에 따라 다릅니다.

발생하는 NGINX 오류를 더 잘 이해하기 위해 명령을 실행하여 이러한 오류 목록을 볼 수 있습니다. 명령은 다음과 같습니다.

sudo cat /var/log/nginx/error.log

이 명령을 실행하려면 권한이 있는 사용자여야 합니다. 루트 사용자를 사용하는 대신 sudo 액세스 권한을 갖는 것이 좋습니다.

이 명령을 사용하면 NGINX 오류 로그가 포함된 /var/log/nginx/error.log 파일의 전체 내용을 읽을 수 있습니다. 터미널 창에 이러한 로그가 표시됩니다.

이 명령을 실행하면 기록된 NGINX 오류 목록을 볼 수 있습니다. 로그에 기록된 오류가 없는 경우 한 가지만 기억하십시오. 명령을 실행할 때 출력이 표시되지 않습니다.

다음은 참조용 오류 로그의 예입니다.

2023/05/31 10:15:23 [error] 1234#0: *1 open() "/var/www/html/missing-page.html"
failed (2: No such file or directory), client: 192.168.0.1, server: example.com,
request: "GET /nonexistent-page HTTP/1.1", host: "example.com"

2023/05/31 12:45:57 [error] 1234#0: *2 upstream timed out (110: Connection timed out)
while reading response header from upstream, client: 192.168.0.2, server:
example.com, request: "GET /api/data HTTP/1.1", upstream:
"http://127.0.0.1:8000/api/data", host: "example.com"

2023/05/31 15:22:10 [error] 1234#0: *3 rewrite or internal redirection cycle while internally redirecting to "/index.php", client: 192.168.0.3, server: example.com, request: "GET /category/products/ HTTP/1.1", host: "example.com"

이 예에서 각 줄은 NGINX에서 기록한 별도의 오류를 나타냅니다. 제공된 정보를 분석해 보겠습니다.

• 타임스탬프: 각 줄의 첫 번째 부분은 오류가 발생한 날짜와 시간을 YYYY/MM/DD HH:MM:SS 형식으로 표시합니다.
• 오류 수준: [error] 태그는 이 라인이 오류를 나타냄을 나타냅니다.
• 프로세스 ID: # 기호 뒤의 숫자(예: 1234#0 )는 요청을 처리하는 NGINX 프로세스 ID를 나타냅니다.
• 오류 메시지: 오류 메시지는 특정 오류에 대한 세부 정보를 제공합니다. 여기에는 파일 또는 리소스 액세스 실패, 업스트림 연결 시간 초과 또는 내부 리디렉션 문제와 같은 정보가 포함됩니다.
• 클라이언트 IP: client 필드에는 서버에 요청하는 클라이언트의 IP 주소가 표시됩니다.
• 서버 이름: server 필드는 오류가 발생한 서버 이름 또는 가상 호스트를 나타냅니다.
• 요청 세부 정보: request 필드에는 HTTP 메서드, 요청된 URL 및 클라이언트에서 사용하는 프로토콜 버전이 표시됩니다.
• 호스트: host 필드는 요청에 사용된 호스트 이름 또는 IP 주소를 지정합니다.

각 오류 로그 항목은 오류 유형, 영향을 받는 리소스, 클라이언트 IP 및 기타 관련 세부 정보에 대한 정보를 제공하여 문제를 진단하고 해결하는 데 도움이 됩니다.

2. 상태를 확인하여 NGINX 문제 해결

NGINX 문제를 해결하기 위해 시도할 수 있는 또 다른 방법은 상태, 즉 활성화 여부를 확인하는 것입니다. 특정 이유로 인해 설치 프로세스를 완료할 수 없거나 서비스가 아직 활성화되지 않았을 가능성이 있습니다.

NGINX 서비스 상태를 확인하려면 다음 명령을 사용하십시오.

sudo systemctl status nginx

NGINX 서비스가 활성화되면 출력은 다음과 같습니다.

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset:
enabled)
Active: active (running) since Mon 2023-05-31 14:30:00 UTC; 5min ago
Docs: http://nginx.org/en/docs/
Process: 1234 ExecStart=/usr/sbin/nginx -g daemon on;
master_process on;
(code=exited, status=0/SUCCESS)
Main PID: 1234 (nginx)
Tasks: 2 (limit: 2319)
Memory: 3.9M
CGroup: /system.slice/nginx.service
├─1234 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
└─5678 nginx: worker process

NGINX 상태가 비활성인 경우 sudo systemctl status nginx 명령은 다음과 같이 서비스가 비활성 또는 중지되었음을 나타냅니다.

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: inactive (dead)
Docs: http://nginx.org/en/docs/

이 경우 다음 명령을 사용하여 NGINX 서비스를 다시 시작하기만 하면 됩니다.

sudo systemctl restart nginx

그런 다음 status 명령을 다시 사용하여 NGINX 서비스가 현재 활성 상태인지 확인할 수 있습니다.

3. 구문 오류를 확인하여 NGINX 문제 해결

구문 오류는 스크립트, 코드를 작성하거나 Nginx 파일을 구성할 때 발생할 수 있는 일반적인 문제입니다.

잘못된 구문 구조를 사용했거나 특정 문자를 생략했는지 여부에 관계없이 잘못된 구문으로 인해 코드 또는 구성이 올바르게 작동하지 않습니다.

Nginx 구성 파일의 경우 적절한 기능을 위해 각 지시문을 정확하게 선언해야 하는 다양한 지시문으로 구성됩니다. 그렇지 않으면 의도한 대로 작동하지 않습니다.

Nginx 구성 파일에서 구문 오류를 확인하려면 다음 명령을 사용하십시오.

sudo nginx -t

구문이 올바른 것으로 판명되면 출력은 다음과 같습니다.

nginx: configuration file /etc/nginx/nginx.conf test is successful

그러나 구문에 문제가 있는 경우 출력은 다음과 같이 표시됩니다.

nginx: [emerg] unexpected end of file, expecting ";" or "}" in
/etc/nginx/nginx.conf:42
nginx: configuration file /etc/nginx/nginx.conf test failed

이 검사를 수행하면 구문 오류를 식별하고 수정하여 Nginx 구성이 정확하고 완전함을 보장할 수 있습니다. 구성 파일을 변경할 때마다 또는 Nginx를 다시 시작하기 전에 이 명령을 실행하여 구문 오류로 인한 문제를 방지하는 것이 좋습니다.