Read/Write Files from Disk 노드를 사용하여 n8n이 실행되는 머신에서/으로 파일을 읽고 씁니다.

이 노드가 접근할 수 있는 경로는 사용자의 n8n 배포 환경에 따라 다릅니다. 자세한 내용은 파일 위치를 참고하세요.

작업#

• Read File(s) From Disk: 이 작업을 사용하여 n8n을 실행하는 컴퓨터에서 하나 이상의 파일을 가져옵니다.
• Write File to Disk: 이 작업을 사용하여 n8n을 실행하는 컴퓨터에 바이너리 파일을 생성합니다.

각 작업에 대한 노드 구성 방법은 아래 섹션을 참고하세요.

디스크에서 파일 읽기#

다음 매개변수로 이 작업을 구성합니다:

• File(s) Selector: 읽으려는 파일의 경로를 입력합니다.
  • 여러 파일을 입력하려면 페이지 경로 패턴을 입력하세요. 경로 패턴을 정의할 때 다음 문자를 사용할 수 있습니다:
    • *: 경로 구분자를 제외한 모든 문자를 0회 이상 매칭합니다.
    • **: 경로 구분자를 포함한 모든 문자를 0회 이상 매칭합니다.
    • ?: 경로 구분자를 제외한 모든 문자를 1회 매칭합니다.
    • []: 대괄호 안의 문자를 매칭합니다. 예를 들어 [abc]는 문자 a, b, c만 매칭하며 그 외에는 매칭하지 않습니다.

이러한 문자와 예상 동작에 대한 자세한 내용은 Picomatch의 Basic globbing 문서를 참고하세요.

Read File(s) From Disk 옵션#

다음 Options로 이 작업을 구성할 수도 있습니다:

• File Extension: 노드 출력에서 파일의 확장자를 입력합니다.
• File Name: 노드 출력에서 파일의 이름을 입력합니다.
• MIME Type: 노드 출력에서 파일의 MIME 타입을 입력합니다. 파일 확장자와 해당 MIME 타입 목록은 일반적인 MIME 타입을 참고하세요.
• Put Output File in Field: 파일을 담을 출력 데이터의 필드 이름을 입력합니다.

디스크에 파일 쓰기#

다음 매개변수로 이 작업을 구성합니다:

• File Path and Name: 파일의 대상 경로, 파일 이름, 파일 확장자를 입력합니다.
• Input Binary Field: 바이너리 파일을 담을 노드 입력 데이터의 필드 이름을 입력합니다.

Write File to Disk 옵션#

다음 Options로 이 작업을 구성할 수도 있습니다:

이 작업에는 단일 옵션이 포함되어 있으며, 기존 파일에 데이터를 Append(추가)할지(켜짐) 아니면 기존 파일에 추가하는 대신 새 파일을 생성할지(꺼짐) 선택할 수 있습니다.

템플릿 및 예제#

Read/Write Files from Disk 통합 템플릿 둘러보기 또는 전체 템플릿 검색

파일 위치#

이 노드가 읽고 쓸 수 있는 경로는 사용자의 n8n 배포 환경에 따라 다릅니다.

n8n Cloud#

n8n Cloud에서는 이 노드가 /home/node/ 아래의 경로에만 접근할 수 있습니다. 이 디렉터리 밖의 경로(예: /tmp/ 또는 /data/)는 접근 오류와 함께 실패합니다.

셀프 호스팅 n8n#

셀프 호스팅 n8n에서는 기본적으로 n8n 프로세스가 접근할 수 있는 모든 경로에 이 노드가 접근할 수 있습니다. 접근을 제한하려면 N8N_RESTRICT_FILE_ACCESS_TO 환경 변수를 허용할 디렉터리 하나 이상(세미콜론으로 구분)으로 설정하세요.

Docker에서 n8n을 실행하는 경우, 경로는 Docker 호스트가 아니라 n8n 컨테이너의 파일 시스템을 가리킵니다. 호스트 디렉터리를 이 노드에서 사용할 수 있게 하려면 해당 디렉터리를 볼륨으로 컨테이너에 마운트하세요.

n8n은 오류를 방지하기 위해 절대 파일 경로를 사용할 것을 권장합니다.