systemd: WebSocket/실시간 서버용 Node 유닛 팁

연결이 많은 서버에서 NOFILE, graceful shutdown, 재시작 정책을 포함한 systemd 예시

분야: DevOps/인프라 systemdnodejswebsocketops

WebSocket/실시간 서버는 “오래 유지되는 연결”이 많아, 기본값으로는 파일 디스크립터(NOFILE) 한도나 종료 타임아웃이 발목을 잡을 수 있습니다.

관련 템플릿: systemd: Node 서비스 유닛 템플릿 (EnvironmentFile 포함)

myrealtime.service 예시

[Unit]
Description=myrealtime (Node WebSocket)
After=network.target

[Service]
Type=simple
User=myrealtime
WorkingDirectory=/srv/myrealtime/current
EnvironmentFile=/etc/myrealtime/myrealtime.env

ExecStart=/usr/bin/node server.js
Restart=always
RestartSec=2

# 연결이 많은 서비스에서 자주 필요
LimitNOFILE=65535

# graceful shutdown을 위해 여유를 준다
TimeoutStopSec=20

[Install]
WantedBy=multi-user.target

운영 체크리스트

같은 분야의 템플릿

Dockerfile: Node 프로덕션 기본 패턴
멀티스테이지 빌드로 이미지 크기를 줄이는 기본 예시
journalctl: systemd 서비스 장애 디버깅
status/journalctl로 장애 원인을 빠르게 좁히는 실무 명령어 모음
nginx: ACME(Let’s Encrypt) webroot 챌린지 설정
/.well-known/acme-challenge/ 경로만 안전하게 열어 certbot/ACME HTTP-01을 통과시키는 패턴
nginx: 서브패스(/admin)에서 SPA 서빙 (alias + fallback)
/admin 아래에 React/Vue SPA를 배포할 때 새로고침 404를 막는 alias/try_files 패턴
nginx: 민감 파일(.env/.git/백업) 차단
실수로 웹루트에 올라온 시크릿/백업이 유출되지 않도록 기본 차단 룰을 추가
nginx: bot/스크래퍼 차단 (map 기반)
User-Agent 패턴을 map으로 분류하고, 필요한 엔드포인트만 보수적으로 차단하는 방법