환경  nginx 1.3.4 이후 · Linux(systemd) 기준 · 2026-11-16 확인

systemctl start nginx 나 restart 뒤에 nginx 가 올라오지 않고, 오류 로그나 journalctl 에 [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use) 가 찍힙니다. 같은 줄이 다섯 번쯤 반복되다 still could not bind() 로 끝나기도 합니다. nginx -t 는 멀쩡히 통과하는데 시작만 안 되니 설정을 의심하기 쉽습니다. 실제 원인은 대개 셋 중 하나이고, 어느 쪽인지는 명령 두 개면 가려집니다.

Address already in use 문구가 말하는 것

98 은 리눅스의 EADDRINUSE 오류 번호입니다. 소켓을 어떤 주소와 포트에 묶으려 했는데 그 자리를 다른 소켓이 이미 차지하고 있다는 뜻입니다. 리눅스에서는 같은 로컬 주소와 포트 조합에 IP 소켓 하나만 묶을 수 있습니다.

그래서 이 오류는 nginx 설정 문법과 상관이 없습니다. nginx -t 는 설정 파일을 읽고 검사할 뿐 포트를 실제로 열지 않습니다. 포트는 프로세스가 진짜로 시작할 때 엽니다. -t 가 successful 을 내도 시작에서 막히는 게 정상인 이유입니다.

먼저 할 일은 지금 그 포트를 누가 쥐고 있는지 보는 것입니다. ss 의 -l 은 대기 중인 소켓만, -t 는 TCP 만, -n 은 숫자 그대로, -p 는 소켓을 연 프로세스까지 보여 줍니다. 프로세스 이름은 root 권한이 있어야 다른 사용자 것까지 나오니 sudo 를 붙입니다.

# 오류 확인
sudo journalctl -u nginx -n 20 --no-pager
# nginx: [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use)
# nginx: [emerg] still could not bind()

# 80번을 쥔 쪽 찾기 (443 이면 :443)
sudo ss -ltnp 'sport = :80'
# LISTEN 0 511 0.0.0.0:80 0.0.0.0:* users:(("apache2",pid=812,fd=4),...)

users:(( )) 안의 이름이 이 글의 갈래를 정합니다

nginx -t 통과는 이 오류와 무관합니다. 포트는 시작할 때 열립니다.

다른 프로그램이 80번 포트를 쥐고 있을 때

ss 결과에 apache2·httpd·lighttpd 같은 다른 웹 서버 이름이 나오면 이 갈래입니다. 배포판 패키지로 아파치를 함께 깔면 설치 직후 바로 80번을 열고, 부팅할 때마다 자동으로 뜨도록 등록됩니다. nginx 를 앞에 두고 아파치를 뒤에 둘 생각이었다면 아파치의 Listen 을 8080 같은 다른 포트로 옮기면 되고, 아파치가 필요 없다면 서비스를 끄고 자동 시작도 해제합니다.

docker-proxy 가 나오면 컨테이너가 호스트의 80번을 쓰고 있다는 뜻입니다. docker run -p 80:80 이나 compose 의 ports: 80:80 이 남아 있는 경우입니다. docker ps 의 PORTS 칸에서 0.0.0.0:80->80/tcp 가 붙은 컨테이너를 찾아 포트 매핑을 바꾸거나 멈춥니다. 도커의 userland-proxy 를 끈 환경에서는 ss 에 프로세스 이름이 안 보일 수 있으니, 이름 칸이 비어 있으면 docker ps 부터 확인합니다.

어느 경우든 상대 프로세스를 kill 로 바로 죽이는 건 피하는 편이 낫습니다. 서비스 관리자가 다시 살려 내면 같은 오류가 반복됩니다. systemctl 로 끄거나 설정에서 포트를 옮기는 게 원래 자리입니다.

# 아파치가 쥔 경우: 끄고 부팅 자동 시작도 해제
sudo systemctl disable --now apache2   # RHEL 계열은 httpd

# 컨테이너가 쥔 경우: 어느 컨테이너인지 확인
docker ps --format '{{.Names}}\t{{.Ports}}' | grep ':80->'

# 비운 뒤 nginx 시작
sudo systemctl start nginx
sudo ss -ltnp 'sport = :80'

상대를 끄거나 포트를 옮긴 다음 nginx 를 다시 띄웁니다

nginx 가 이미 떠 있는데 한 번 더 띄웠을 때

ss 에 나온 이름이 nginx 라면 문제는 nginx 자신입니다. 이미 도는 nginx 가 포트를 잡고 있는데 새 nginx 가 같은 포트를 열려다 막힌 겁니다. 설정을 바꾼 뒤 sudo nginx 를 다시 치거나, 수동으로 띄운 nginx 가 남은 상태에서 systemctl start nginx 를 하면 이렇게 됩니다.

설정을 다시 읽힐 때는 새로 띄우지 않고 기존 master 프로세스에 신호를 보냅니다. nginx -s reload 나 systemctl reload nginx 가 그 일을 합니다. master 는 새 설정 문법부터 검사하고, 괜찮으면 새 worker 를 띄운 뒤 옛 worker 를 순서대로 내립니다. 새 설정에 문제가 있으면 바꾸지 않고 옛 설정으로 계속 돕니다. 포트를 놓았다 다시 잡는 과정이 없어서 이 오류가 날 일이 없습니다.

까다로운 건 systemd 밖에서 뜬 nginx 입니다. systemctl status nginx 는 failed 인데 ps 에는 nginx master 가 살아 있다면 이 경우입니다. 이 master 는 systemd 가 모르는 프로세스라 systemctl stop 으로는 안 내려갑니다. nginx -s quit 은 pid 파일에 적힌 master 에게 정상 종료 신호를 보내는데, pid 파일이 엉뚱한 번호를 가리키면 ps 로 찾은 master 의 pid 에 직접 QUIT 신호를 보냅니다.

# 떠 있는 nginx 와 systemd 상태를 같이 본다
ps -C nginx -o pid,ppid,user,cmd
systemctl status nginx --no-pager | head -5

# systemd 밖의 master 를 정상 종료 (요청 처리 끝나고 내려간다)
sudo nginx -s quit
# pid 파일이 어긋나 있으면 master pid 에 직접
sudo kill -QUIT <master_pid>

# 이후로는 새로 띄우지 말고 reload
sudo nginx -t && sudo systemctl reload nginx

master process 줄의 pid 가 대상입니다. worker 를 죽여도 master 가 다시 띄웁니다

설정을 바꾼 뒤에는 nginx 를 다시 띄우지 말고 reload 합니다.

listen 이 같은 포트를 두 번 열 때, ipv6only=off

ss 를 봐도 80번을 쥔 프로세스가 없는데 오류가 난다면 nginx 설정이 스스로 부딪히는 경우를 의심합니다. 대표적인 게 listen 80; 과 listen [::]:80 ipv6only=off; 를 함께 쓰는 설정입니다.

ipv6only 는 [::] 같은 IPv6 와일드카드 주소로 연 소켓이 IPv6 만 받을지, IPv4 까지 받을지를 정합니다. nginx 1.3.4 부터 기본값이 on 이라 [::]:80 소켓은 IPv6 만 받고, IPv4 는 listen 80; 이 따로 받습니다. 그런데 ipv6only=off 를 붙이면 [::]:80 소켓 하나가 IPv4 연결까지 맡게 됩니다. 이 상태에서 0.0.0.0:80 을 또 열려고 하니 nginx 가 자기 소켓과 부딪힙니다.

고치는 방법은 둘 중 하나만 남기는 것입니다. 보통은 ipv6only=off 를 지우고 listen 80; 과 listen [::]:80; 을 나란히 두는 형태가 가장 흔합니다. 이 옵션은 시작할 때 한 번만 정해지기 때문에 reload 로는 바뀌지 않습니다. 고친 다음에는 restart 로 다시 띄웁니다.

listen 줄은 sites-enabled 아래 여러 파일과 include 로 흩어져 있기 쉽습니다. nginx -T 는 include 를 모두 펼친 최종 설정을 한 번에 출력하니, 여기서 listen 줄만 걸러 보면 어디서 같은 포트를 두 번 여는지 바로 보입니다.

# include 를 다 펼친 설정에서 listen 줄만
sudo nginx -T 2>/dev/null | grep -nE '^\s*listen'
#   listen 80;
#   listen [::]:80 ipv6only=off;   <- IPv4 까지 받으므로 위 줄과 부딪힌다

# 고친 형태
#   listen 80;
#   listen [::]:80;

sudo nginx -t && sudo systemctl restart nginx
sudo ss -ltnp 'sport = :80'   # 0.0.0.0:80 과 [::]:80 이 둘 다 보이면 정상

ipv6only 는 시작할 때만 정해지므로 reload 가 아니라 restart 입니다

조치 후 확인할 것

  • sudo ss -ltnp 'sport = :80' 에 nginx 만 보이는가 (443 도 같은 방식으로)
  • ps -C nginx 의 master 가 하나뿐이고 systemctl status nginx 가 active 인가
  • nginx -T 의 listen 줄에 ipv6only=off 와 0.0.0.0 대기가 같은 포트로 겹치지 않는가
  • 아파치·컨테이너를 정리했다면 재부팅 뒤에도 다시 80번을 잡지 않도록 자동 시작·포트 매핑까지 바꿨는가

이 오류는 겉으로는 하나지만 손댈 곳은 셋 중 하나입니다. ss 로 포트 주인을 먼저 보고, 주인이 남이면 그쪽을 정리하고, nginx 자신이면 중복으로 뜬 프로세스나 겹친 listen 을 찾습니다. 순서만 지키면 설정 파일을 이것저것 뒤지지 않아도 됩니다.