개발/Nginx
Nginx 설치 및 배포 설정 정리
hanks
2025. 6. 1. 15:09
1. Nginx 설치 및 시작
sudo apt update
sudo apt install nginx
sudo systemctl status nginx
sudo systemctl start nginx
2. conf 파일 설정
- 설정 파일 생성:
sudo nano /etc/nginx/sites-available/wms.ootcha.com
sudo nano /etc/nginx/sites-available/api.ootcha.com
기본 HTTP(80) 설정 예시 (인증서 발급 전)
server {
listen 80;
server_name api.ootcha.com;
location /.well-known/acme-challenge/ {
root /var/www/html;
}
access_log /app/logs/api.ootcha.com.access.log;
error_log /app/logs/api.ootcha.com.error.log;
location / {
proxy_pass http://192.168.0.14:10010;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
주의: 인증서 발급 전에 443 포트 설정을 하지 말 것. 오류 발생 가능성 있음.
인증서 발급 후 HTTP+HTTPS 통합 설정 예시
server {
listen 80;
listen 443 ssl;
server_name api.ootcha.com;
ssl_certificate /etc/letsencrypt/live/api.ootcha.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/api.ootcha.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
add_header Strict-Transport-Security "max-age=31536000; includeSubdomains" always;
if ($scheme = http) {
return 301 https://$host$request_uri;
}
access_log /etc/nginx/log/api.ootcha.com.access.log;
error_log /etc/nginx/log/api.ootcha.com.error.log warn;
location / {
proxy_pass http://192.168.0.13:20011;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
3. 심볼릭 링크 설정
sudo ln -s /etc/nginx/sites-available/wms.ootcha.com /etc/nginx/sites-enabled/
sudo ln -s /etc/nginx/sites-available/api.ootcha.com /etc/nginx/sites-enabled/
4. 설정 적용 및 재시작
sudo nginx -t
sudo systemctl restart nginx
5. 인증서 발급 (Certbot)
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d wms.ootcha.com -d api.ootcha.com
- 여러 도메인 동시 발급:
sudo certbot --nginx -d db.solutionil.com -d git.solutionil.com -d one-api.solutionil.com -d one.solutionil.com
6. 문제 해결 체크리스트
- 공유기 포트포워딩 및 방화벽 확인
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload
- 443 설정으로 오류 발생 시:
- 443 관련 conf 삭제 후 80으로만 테스트
- 기본 설정 중복 확인: sudo grep -R "api.ootcha.com" /etc/nginx/
- default 파일에서 중복 설정된 경우 삭제 필요
- nginx 재시작 오류 시:
sudo pkill nginx
sudo systemctl start nginx
기타
- HTTP -> HTTPS 자동 리다이렉트 여부는 certbot에서 2번 선택 시 적용됨