n8n + 솔라피 연동 방법 (도커 사용)
n8n은 오픈소스 워크플로 자동화 도구로 Zapier나 Make 같은 서비스의 대안으로 자체 호스팅으로 돌리면 추가 비용 없이 무제한 워크플로를 실행할 수 있는 장점이 있습니다.
이번 글에서는 맥에서 도커를 이용해 n8n을 띄우고 솔라피와 연동하는 방법을 소개합니다. n8n 도커 설명은 아래 공식 문서를 참고하세요.
도커를 이용한 n8n 띄우기
n8n 띄우는 과정은 아래와 같이 매우 간단합니다.
- 도커에서 데이터 휘발을 막기 위해 볼륨을 하나 만들어 줍니다.
docker volume create n8n_data- 타임존을 한국시간으로 하여 도커 이미지를 실행합니다.
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="Asia/Seoul" \
-e TZ="Asia/Seoul" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-e N8N_RUNNERS_ENABLED=true \
-v n8n_data:/home/node/.n8n \
docker.n8n.io/n8nio/n8n
도커가 실행되고 위 캡처 이미지와 같이 메시지가 출력되면 웹브라우저를 열어 다음 주소로 접속하면 콘솔화면으로 접근할 수 있습니다.
http://localhost:5678n8n이 처음이시라면 회원가입과 메일로 라이선스 키를 받아 활성화해야 합니다.
라이선스 키 활성화 이후에는 셀프 호스팅으로 무제한 사용이 가능합니다.
솔라피 커뮤니티 노드 연동
n8n에서 Gmail, Google Sheets 같은 앱 단위를 노드라고 부르며 n8n 자체 제공 노드 이외에 커뮤니티에서 제공하는 노드를 커뮤니티 노드로 칭하고 있습니다.
"googe" 로 검색하면 웬만한 구글 서비스는 다 나오네요.
(아쉽지만) 솔라피는 커뮤니티 노드로 설치 과정을 거쳐야 합니다. 설치를 위해 좌측 하단의 로그인 User name 오른쪽 ... 버튼을 눌러 Settings 으로 들어갑니다.
제일 아래 메뉴의 Community nodes 를 선택하여 npm Package Name 에 "n8n-nodes-solapi" 를 입력하고 [Install] 버튼을 눌러 설치합니다.
솔라피 노드 테스트
n8n이 처음이시라면 아래와 같이 간단히 솔라피를 테스트해 보실 수 있습니다.
1. Trigger manually 를 선택하여 수동 실행이 가능하도록 합니다.
- 솔라피 커뮤니티 노드가 정상적으로 설치되었다면 "solapi"로 검색이 가능합니다.
- 제일 아래 Send text message a message (문자메세지 보내기) 를 선택합니다.
- Create new credential 을 눌러 인증 키 설정 화면을 띄웁니다.
- 솔라피 콘솔에서 개발자 허브 → API Keys 메뉴에서 [새로운 API Key]를 눌러 API Key를 생성하고 Key, Secret 쌍을 복사해 옵니다.
- 인증 방법을 API Key(HMAC-SHA256) 으로 선택하여 API Key, API Secret 에 각각 붙여넣기합니다.
- To (수신전화번호), From (발신전화번호), Text (문자 내용)을 각각 입력합니다.
- 모든 입력이 끝나면 좌측 상단의 [Back to canvas] 를 눌러 나갑니다.
- [Execute workflow] 버튼을 눌러 테스트 실행합니다.
솔라피 계정에 잔액이 있고 n8n 워크플로우 설정이 정상적이라면 실제 테스트 문자를 받아보실 수 있습니다.
지금까지 도커를 이용한 셀프 호스팅 n8n + 솔라피 노드의 기본적인 사용 방법에 대해 알아보았습니다. 다음 포스팅에서 좀 더 심화 과정의 내용으로 만나뵙겠습니다.
n8n + 솔라피 커뮤니티 노드https://t.co/c68hGbMzd0
— 솔라피 (@xsolapi) September 9, 2025