n8n 설치 전 필수 소프트웨어 설정하기

n8n을 셀프호스팅 환경에 설치하기 전, 몇 가지 필수 소프트웨어를 설치하고 설정해야 합니다. 이 가이드는 Node.js, npm, PostgreSQL, Redis 등 n8n 실행에 필요한 도구들을 단계별로 설정하는 방법을 안내합니다.

1. Node.js 설치

n8n은 Node.js 기반으로 작동하므로, 가장 먼저 최신 버전의 Node.js를 설치해야 합니다.

Ubuntu에서 Node.js 설치 방법

curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs

설치가 완료되면 버전 확인:

node -v

2. npm (Node Package Manager)

npm은 Node.js와 함께 설치되며, 자바스크립트 패키지를 관리하는 도구입니다. n8n은 내부적으로 여러 패키지를 사용하므로 npm이 정상적으로 작동해야 합니다.

npm 버전 확인

npm -v

npm이 잘 설치되었다면, 다음 단계로 넘어갑니다.

3. PostgreSQL 데이터베이스 설정

n8n은 기본적으로 SQLite를 사용하지만, PostgreSQL 사용 시 더 나은 성능과 확장성을 제공합니다. PostgreSQL 설치 후, 데이터베이스와 사용자를 생성하여 n8n과 연결합니다.

PostgreSQL 설치 (Ubuntu 기준)

sudo apt update
sudo apt install postgresql postgresql-contrib

데이터베이스 생성

sudo -u postgres psql

PostgreSQL 셸에서 다음 명령어를 입력:

CREATE DATABASE n8n;
CREATE USER n8n_user WITH ENCRYPTED PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE n8n TO n8n_user;

4. Redis 설치 (선택 사항)

Redis는 캐시 및 성능 최적화를 위해 사용할 수 있는 인메모리 데이터베이스입니다. 대규모 워크플로우를 운영하거나 고속 처리가 필요한 경우에 추천됩니다.

Redis 설치 및 실행

sudo apt install redis-server
sudo systemctl enable redis-server
sudo systemctl start redis-server

설치 확인

redis-cli ping

정상이라면 PONG이 출력됩니다.

5. 환경 변수 설정 예시

n8n은 다양한 시스템 설정을 환경 변수로 제어합니다. 아래는 PostgreSQL과 Redis 환경 변수 예시입니다:

DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=localhost
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_USER=n8n_user
DB_POSTGRESDB_PASSWORD=your_password

REDIS_HOST=localhost
REDIS_PORT=6379

이 환경 변수들은 .env 파일이나 Docker Compose 환경 블록, 실행 명령어에 직접 삽입할 수 있습니다.

6. n8n 실행 준비 완료

이제 Node.js, npm, PostgreSQL, Redis 등의 설치와 설정이 완료되었으므로, 본격적으로 n8n을 설치하고 실행할 준비가 되었습니다.

다음 강의에서는 실제로 n8n을 실행하고, 기본 워크플로우를 구성하는 방법을 소개합니다. n8n 셀프호스팅의 첫 걸음을 성공적으로 마치셨습니다!