드디어 n8n이 떴어요. Debian Docker에서 localhost:5678 접속 성공.

 

드디어 n8n이 떴어요, Debian Docker에서 localhost:5678 접속 성공

지난 편에서 X MINI Debian에 Docker를 설치하고 hello-world로 컨테이너가 실제로 실행되는지까지 확인했습니다.

docker --version도 정상적으로 나왔고, 화면에는 Hello from Docker!도 떴어요.

이제 Docker 안에 뭔가를 올려볼 차례였습니다.

제가 진짜 설치하고 싶었던 프로그램을 올려볼 차례였어요.

디지털 장난감 18편 핵심
Debian Docker에 n8n 이미지를 받아 컨테이너로 실행하고, Firefox에서 localhost:5678로 접속해 n8n 화면이 실제로 뜨는 것까지 확인한 기록입니다.

X MINI의 Debian Docker 환경에서 n8n을 실행하고 localhost:5678로 실제 접속했습니다.
출처: 독타의 디지털 장난감

이제 Docker 안에 뭔가를 올려볼 차례였어요

터미널을 열었어요.

Docker 자체는 정상적으로 실행되고 있었고, 테스트용 hello-world 컨테이너도 문제없이 동작했습니다.

그렇다면 이제 제가 진짜 설치하고 싶었던 걸 올려볼 차례였어요.

n8n.

X MINI에 Debian을 설치하고 Docker까지 준비했던 이유 중 하나가 바로 이 프로그램이었습니다.

블로그 글 작성이나 자료 정리 같은 반복 작업을 자동화하고, 나중에는 Google Sheets나 여러 서비스도 연결해보고 싶었거든요.

처음에는 n8n도 Windows 프로그램처럼 설치하는 줄 알았어요.

그런데 Docker를 사용하면 n8n 역시 하나의 컨테이너로 실행할 수 있었습니다.

먼저 n8n 이미지를 받아야 했어요

Docker에서는 프로그램을 바로 실행하는 게 아니라 먼저 실행에 필요한 이미지를 준비합니다.

처음 이 말을 들었을 때는 “또 이미지 파일인가?” 싶었어요.

사진에서 말하는 이미지가 아니라, 프로그램을 실행하는 데 필요한 환경과 파일이 들어 있는 Docker 이미지였습니다.

n8n 이미지를 받아오고, 그 이미지로 컨테이너를 실행하면 된다고 이해했어요.

이런 구조가 아직 완전히 익숙한 건 아니었지만 Docker를 처음 만졌을 때보다는 조금 덜 낯설었습니다.

이미지 → 컨테이너 → 실행

적어도 이 흐름 정도는 이제 조금씩 눈에 들어오기 시작했어요.

n8n 컨테이너를 실행했어요

터미널에서 n8n 컨테이너를 실행했습니다.

여기서 중요한 숫자 하나가 나왔어요.

5678

n8n이 사용하는 기본 포트였습니다.

처음에는 이 숫자가 왜 필요한지도 잘 몰랐어요.

그런데 쉽게 생각하면 브라우저가 n8n을 찾아 들어갈 수 있도록 열어두는 출입구 같은 것이었습니다.

Docker 안에서 실행되는 n8n과 X MINI의 브라우저를 연결해주는 번호라고 생각하니 조금 이해가 됐어요.

명령을 실행하자 터미널에 여러 줄의 메시지가 올라오기 시작했습니다.

처음 보는 내용이 계속 나오니까 또 잠깐 긴장됐어요.

“이게 오류인가, 아니면 정상적으로 실행되는 로그인가?”

처음에는 구분하기가 쉽지 않았습니다.

그래도 컨테이너가 종료되지 않고 계속 실행되는 걸 보니 일단 정상적으로 올라온 것 같았어요.

정말 실행 중인지 먼저 확인했어요

브라우저부터 열기 전에 Docker 쪽에서 n8n이 실제로 살아 있는지 먼저 확인해봤습니다.

컨테이너 목록을 확인하니 n8n이 보였어요.

Docker 컨테이너 목록에서 n8n이 실행 중인 것을 확인했습니다.

이때부터 조금 기대가 됐어요.

Docker 테스트용 hello-world와는 달리 이번에는 제가 실제로 사용할 프로그램이 컨테이너 안에서 돌아가고 있는 거잖아요.

n8n이 실행 중인 것을 확인한 뒤 다음 단계로 넘어갔습니다.

브라우저에 localhost:5678을 입력했어요

Firefox를 열었습니다.

주소창에 이렇게 입력했어요.

http://localhost:5678

Enter를 눌렀습니다.

이 순간에는 조금 긴장됐어요.

Docker에서는 실행 중이라고 나오는데 브라우저에서는 연결이 안 될 수도 있고, 포트 설정을 잘못했을 수도 있으니까요.

잠시 기다렸습니다.

그리고 n8n 화면이 나타났어요.

Firefox에서 localhost:5678로 접속하자 n8n 화면이 실제로 나타났습니다.

이 장면은 꽤 반가웠습니다.

Debian을 설치했을 때도 그랬고, Docker에서 Hello from Docker!가 떴을 때도 그랬어요.

그런데 이번에는 느낌이 조금 달랐습니다.

이번에는 제가 실제로 사용할 프로그램이 화면에 뜬 거니까요.

localhost가 뭔지도 조금 감이 왔어요

예전에는 localhost라는 말을 봐도 그냥 개발할 때 쓰는 주소 정도로만 생각했어요.

이번에 직접 사용해보니 조금 이해가 됐습니다.

지금 Firefox를 실행하고 있는 컴퓨터도 X MINI이고, n8n도 같은 X MINI 안의 Docker에서 돌아가고 있어요.

그래서 localhost는 쉽게 생각하면 “지금 이 컴퓨터 자신”을 가리키는 주소였습니다.

그리고 뒤의 5678은 그 컴퓨터 안에서도 n8n이 기다리고 있는 포트를 지정하는 것이었고요.

localhost:5678
↓
“이 X MINI의 5678번 포트를 사용하는 n8n으로 들어가자.”

이렇게 실제로 화면까지 보고 나니까 네트워크 용어도 조금 덜 추상적으로 느껴졌어요.

처음 보는 n8n 화면부터 둘러봤어요

n8n 화면이 뜨자 제가 늘 하던 대로 먼저 메뉴부터 살펴봤습니다.

Debian 첫 화면에서도 좌측 상단 메뉴부터 눌러봤던 것처럼, 새로운 프로그램이 뜨면 일단 어디에 뭐가 있는지부터 보는 편이에요.

워크플로우라는 단어가 보였고, 노드를 연결해서 작업 흐름을 만드는 화면도 보였습니다.

n8n 첫 화면을 열고 워크플로우와 노드 구성을 처음 둘러봤습니다.

아직 아무것도 만든 건 없었어요.

그런데 화면을 보니까 대충 방향은 느껴졌습니다.

하나의 작업을 시작하는 노드가 있고, 그다음 작업을 연결하고, 조건에 따라 다른 작업으로 보내고, 마지막에는 결과를 저장하거나 다른 서비스로 전달하는 구조 같았어요.

처음 보면 복잡해 보이지만 이런 건 직접 하나 만들어보는 게 제일 빠를 것 같았습니다.

18편에서 제가 한 순서 정리

• Docker 상태 확인
  실행 중인 Docker 환경을 먼저 확인했어요.
• n8n 이미지 준비
  Docker 이미지를 이용해 n8n을 실행할 준비를 했습니다.
• n8n 컨테이너 실행
  5678 포트를 이용해 n8n을 실행하고 터미널 로그를 확인했어요.
• 컨테이너 상태 확인
  docker ps에서 n8n이 실행 중인 것을 확인했습니다.
• 브라우저 접속
  Firefox에서 http://localhost:5678로 접속했습니다.
• n8n 첫 화면 확인
  워크플로우와 노드가 보이는 화면까지 정상적으로 들어갔어요.

이제 X MINI를 산 목적이 조금씩 보이기 시작했어요

처음에는 N100 미니PC 하나를 사서 이것저것 테스트해보자는 생각으로 시작했습니다.

그런데 지금은 조금 달라졌어요.

Debian이 들어가 있고, Docker가 돌아가고, 그 Docker 안에서 n8n이 실행되고, 브라우저에서 실제 화면까지 열렸습니다.

이제는 그냥 작은 PC라기보다 제가 자동화 작업을 하나씩 만들어볼 수 있는 기계가 된 느낌이었어요.

아직 24시간 안정적으로 돌려본 것도 아니고, 실제 블로그 발행 자동화를 만든 것도 아닙니다.

그래도 최소한 한 가지 질문에는 이제 답할 수 있게 됐어요.

“X MINI에서 n8n을 돌릴 수 있나?”

돌아갔습니다.

이제 다음부터는 설치하는 이야기보다 n8n을 실제로 어떻게 사용하는지 하나씩 확인해볼 차례예요.

※ 본 글은 X MINI N100 미니PC의 Debian 환경에서 Docker로 n8n을 실행해본 개인적인 경험을 기록한 글입니다. n8n 설치 및 실행 방법은 버전과 설정에 따라 달라질 수 있으며, 실제 운영 시에는 데이터 저장 위치, 포트 설정, 보안 구성 등을 현재 n8n 공식 문서와 함께 확인해주세요.