업무 자동화 툴인 n8n 도커 설치에 대한 내용을 정리해 드립니다. 제가 직접 경험해본 바로는 n8n은 오픈소스면서도 무료로 사용할 수 있는 훌륭한 도구입니다. 이 글을 통해 도커를 이용한 n8n 설치 방법과 보안 설정에 대한 정보를 자세히 알아보세요.
n8n 설치하기
n8n은 정말 매력적인 도구입니다. 제가 처음 설치해본 결과, 매우 직관적인 인터페이스를 가지고 있어 사용이 편리했어요. 설치 방법은 공식 문서를 따라서 진행해보았습니다. 아래는 제가 사용한 명령어입니다.
bash
$ sudo docker volume create n8n_data
$ sudo docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
위의 명령어를 실행하고 나면 n8n 프로세스가 초기화되며, http://localhost:5678로 접속하라는 메시지가 나옵니다. 저는 이렇게 연결하여 로컬에서 사용해보았는데요, 아주 쉽게 통합 업무 자동화를 구현할 수 있었습니다.
- 도커 컨테이너 생성
도커로 컨테이너를 생성할 때, 명령어의 각 요소가 어떻게 동작하는지 궁금하지 않으신가요? 아래의 표를 통해 도커 컨테이너 생성 과정을 쉽게 이해할 수 있습니다.
| 명령어 | 설명 |
|---|---|
| docker volume create n8n_data | n8n 데이터를 저장할 볼륨을 생성합니다. |
| docker run | 새 컨테이너를 실행합니다. |
| -it | 상호작용 모드로 실행합니다. |
| –rm | 컨테이너가 종료될 때 자동으로 삭제됩니다. |
| –name n8n | 컨테이너의 이름을 n8n으로 지정합니다. |
| -p 5678:5678 | 호스트의 포트 5678을 컨테이너의 포트 5678에 매핑합니다. |
| -v n8n_data:/home/node/.n8n | 생성한 볼륨을 지정된 경로에 마운트합니다. |
이렇게 각 명령어를 통해 n8n을 쉽고 빠르게 사용할 수 있게 됩니다.
2. 로컬 환경에서의 접속 확인
명령어 실행 후 n8n이 정상 작동하는지 확인하기 위해 http://localhost:5678로 접근해보았습니다. 잘 작동하더라고요. 설문지, 캠페인 자동화 등 다양한 프로세스를 설정할 수 있어 놀랐습니다. 하지만 로컬 환경에서만 작동하는 것은 아쉬운 부분이었어요.
외부 접속을 위한 설치
로컬에서 사용해본 n8n의 매력에 빠진 저는 개인 서버에서 사용하는 방법을 고민하게 되었죠. 이 경우 더 편리하게 언제 어디서나 접속할 수 있었으면 좋겠어요. 아래에 제가 겪었던 문제와 해결 방법을 정리해보았습니다.
1. 외부 접속 시 필수 설정
서버에 설치 후 IP로 접속을 시도했는데, 접속이 되지 않았습니다. 이 결과는 제가 실수한 두 가지 주된 이유 때문이었어요.
- 보안 접속 요구: 외부에서 직접 접속할 때는 보안 설정이 필요합니다.
- 설정 오류: 보안 설정 없이 기본적으로 호출하려고 했더니 접근이 차단되었습니다.
이럴 경우, n8n의 추천 방법이 아닌 임시 방편으로 N8N_SECURE_COOKIE 환경변수를 false로 설정할 수 있었습니다. 이를 통해 컨테이너를 다음과 같이 생성했습니다.
bash
$ sudo docker run -it --rm --name n8n -e N8N_SECURE_COOKIE=false -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
이렇게 해결하고 나니 웹페이지가 정상적으로 표시되고 본격적으로 사용할 수 있었습니다.
2. 외부 접근을 위한 보안 설정
앞서 언급했듯이, 매번 비추천 방법을 사용하는 것은 위험이 크니 보안 설정을 반드시 해야 해요. 저는 이미 Letsencrypt로 인증서를 설치했기 때문에, 아래와 같이 보안 설정을 해주고 n8n을 실행했습니다.
bash
$ sudo docker run -it --rm --name n8n -p 5678:5678 \
-e N8N_PROTOCOL=https \
-e N8N_HOST=my-domain.com \
-v /etc/letsencrypt/live/my-domain.com/fullchain.pem:/home/node/fullchain.pem:ro \
-v /etc/letsencrypt/live/my-domain.com/privkey.pem:/home/node/privkey.pem:ro \
-e N8N_SSL_KEY=privkey.pem \
-e N8N_SSL_CERT=fullchain.pem \
-v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
그러나 접근 권한 에러가 발생하더라고요. privkey.pem 파일에 대한 권한이 없어서 에러가 발생했으니 주의해야 해요!
보안 접속 설정
안전한 제어를 위해 꼭 필요한 보안 설정은 무엇일까요? 방금 위에서 설명한 인증서의 접근 권한 확인이 가장 중요한 부분이었어요. 권한 체크 후 진행해야 하며, 예를 들어 다음과 같은 명령어로 문제를 해결했습니다.
- pem 파일 복사: 먼저 인증서를 다른 디렉토리로 복사했습니다.
bash
$ sudo cp /etc/letsencrypt/live/my-domain.com/fullchain.pem /opt/letsencrypt/fullchain.pem
$ sudo cp /etc/letsencrypt/live/my-domain.com/privkey.pem /opt/letsencrypt/privkey.pem
- 읽기 권한 부여: 이제는 적절한 읽기 권한을 부여했습니다.
bash
$ sudo chmod 644 /opt/letsencrypt/*.pem
이후 컨테이너를 다시 생성하니 정상적으로 HTTPS로 접속할 수 있었습니다.
자주 묻는 질문 (FAQ)
n8n 이란 무엇인가요?
n8n은 오픈소스 기반의 자동화 도구로, 다양한 서비스를 연결하고 프로세스를 자동화하는 데 사용됩니다.
n8n을 사용하는 데 어떤 비용이 드나요?
n8n은 오픈소스 소프트웨어로, 현재는 무료로 이용할 수 있습니다. 도커를 통해 손쉽게 설치할 수 있어요.
외부에서 n8n에 안전하게 접속하는 방법은 무엇인가요?
HTTPS를 통해 Letsencrypt 인증서를 설정한 후 접근하시면 안전하게 사용할 수 있습니다. 또한 N8N_SECURE_COOKIE와 같은 환경 변수 설정도 이를 돕습니다.
n8n을 설치하기 위한 최적의 환경은 무엇인가요?
n8n은 도커를 통해 여러 환경에서 설치가 가능하며, 저와 같이 Linux 서버에 설치하여 사용하기에 적합합니다.
이렇게 n8n의 도커 설치 및 보안 설정에 대해 설명해 드렸는데요, 직접 경험해본 내용을 바탕으로 작성했답니다. n8n을 통해 손쉽게 업무 재편성을 할 수 있으니 많은 분들이 유용하게 활용하시기를 바랍니다.
태그: n8n, 도커, 자동화 도구, 업무 자동화, 나의 자동화, 서버 관리, 보안 설정, 오픈소스, IT, 개발, 도커 설치