2026-05-29 · 바이브코딩

블로그 운영에서 소스 경로와 배포 경로를 헷갈리지 않는 방법

Futory 운영 과정에서 도메인, Nginx 설정, 내부 포트, Next.js 프로세스, 실제 작업 디렉터리를 연결해 소스 경로와 배포 경로를 명확히 구분하는 방법을 정리했습니다.

요약

블로그 운영에서 경로를 헷갈리는 문제는 생각보다 자주 발생합니다. 비슷한 이름의 폴더가 여러 개 있거나, 과거 배포 경로와 현재 서비스 경로가 다르거나, 컨테이너에서 보이는 경로와 호스트에서 보이는 경로가 다르면 잘못된 앱을 수정하고도 배포했다고 착각할 수 있습니다.

Futory 운영에서는 도메인에서 시작해 Nginx 설정, 내부 포트, 실행 프로세스, 작업 디렉터리까지 한 줄로 연결해서 확인하는 방식이 필요합니다.

먼저 공개 도메인이 어떤 서버를 바라보는지 확인합니다.

getent hosts futory.oig.kr
curl -I https://futory.oig.kr/

이 단계에서는 DNS와 공개 웹서버 응답을 확인합니다. Futory는 Nginx가 공개 요청을 받고 내부 Next.js 앱으로 프록시하는 구조입니다.

정적 사이트라면 Nginx 설정에 root나 alias가 나오고, 앱 서버 구조라면 proxy_pass가 나옵니다.

grep -R "futory.oig.kr\|proxy_pass\|root \|alias " -n /etc/nginx/sites-enabled /etc/nginx/sites-available

Futory의 핵심 흐름은 다음과 같습니다.

futory.oig.kr → nginx → 127.0.0.1:8042

즉 Nginx 설정만으로는 Markdown 글 폴더가 직접 나오지 않습니다. 8042 포트를 띄운 프로세스를 확인해야 실제 앱 경로를 알 수 있습니다.

내부 포트를 사용하는 프로세스는 ss로 찾을 수 있습니다.

ss -ltnp "sport = :8042"

PID를 찾은 뒤 작업 디렉터리를 확인합니다.

PID=$(ss -ltnp "sport = :8042" | grep -oP "pid=\K[0-9]+" | head -1)
readlink -f /proc/$PID/cwd

Futory의 현재 기준 경로는 다음과 같습니다.

/opt/futory

기존 경로였던 /opt/wordblog는 /opt/futory를 가리키는 호환용 symlink로 유지할 수 있습니다.

운영자가 자주 실수하는 부분은 /opt/blog 같은 다른 앱 폴더를 Futory로 착각하는 것입니다. 그래서 작업 전에는 항상 다음 기준을 확인해야 합니다.

Futory 실제 폴더: /opt/futory
호환 경로: /opt/wordblog -> /opt/futory
다른 앱: /opt/blog

이 기준이 정리되어 있으면 새 글 추가, 빌드, 장애 대응에서 혼동을 줄일 수 있습니다.

운영에서 중요한 것은 “아마 이 폴더일 것”이 아니라 “도메인부터 실행 디렉터리까지 설명할 수 있는 것”입니다. Futory의 현재 서비스 흐름은 다음 한 줄로 정리됩니다.

futory.oig.kr → nginx → 127.0.0.1:8042 → next-server → /opt/futory

이 기준을 유지하면 AI와 함께하는 블로그 운영에서도 안전하게 배포할 수 있습니다.

정적 사이트라면 root나 alias로 알 수 있지만, Futory처럼 proxy_pass 구조라면 내부 포트를 띄운 프로세스의 작업 디렉터리까지 확인해야 합니다.

실제 기준 경로는 /opt/futory입니다. 다만 기존 경로 호환을 위해 /opt/wordblog를 /opt/futory로 연결하는 symlink로 남겨둘 수 있습니다.

안 됩니다. /opt/blog는 Futory가 아닌 다른 블로그 관리 앱일 수 있으므로 Futory 작업은 /opt/futory를 기준으로 해야 합니다.

경로 혼동을 막으려면 도메인, Nginx, 내부 포트, 프로세스, 작업 디렉터리를 하나의 흐름으로 확인해야 합니다. Futory의 기준 경로는 /opt/futory입니다.