Neo4j

​

어디에 쓰이나요?

• 지식 그래프(Knowledge Graph): 개념 간의 관계를 저장하고 탐색 (예: “서울 → 수도 → 대한민국”)
• GraphRAG: 문서에서 추출한 엔티티와 관계를 그래프로 구성하여 LLM의 답변 품질 향상
• 소셜 네트워크: 사용자 간 팔로우, 친구 관계 분석
• 추천 시스템: “이 상품을 산 사람이 함께 산 상품” 같은 관계 기반 추천
• 사기 탐지: 계좌 간 자금 흐름을 그래프로 분석

​

Docker Compose

services:
  neo4j:
    image: neo4j:5-community
    container_name: neo4j
    restart: unless-stopped
    ports:
      - "7474:7474"
      - "7687:7687"
    environment:
      - NEO4J_AUTH=neo4j/changeme
      - NEO4J_PLUGINS=["apoc"]
    volumes:
      - neo4j_data:/data
      - neo4j_logs:/logs

volumes:
  neo4j_data:
  neo4j_logs:

​

실행

docker compose up -d

​

접속 확인

• Username: neo4j
• Password: changeme

docker exec -it neo4j cypher-shell -u neo4j -p changeme "RETURN 1 AS result"

​

기본 정보

​

환경 변수

​

APOC 플러그인

environment:
  - NEO4J_PLUGINS=["apoc"]

​

라이선스

​

참고

• Neo4j Docker 설치 가이드
• Neo4j 공식 문서

​

설치 점검 목록

• docker compose up -d 후 docker compose ps로 컨테이너 상태를 확인했습니다.
• 기본 포트/계정/비밀번호를 문서대로 점검했습니다.
• 운영용으로 사용할 때 기본 비밀번호/시크릿 값을 변경했습니다.
• 장애 분석을 위해 docker compose logs -f 확인 방법을 숙지했습니다.

​

문제 해결 가이드

• 컨테이너가 실행되지 않으면 docker compose logs -f로 오류 원인을 먼저 확인합니다.
• 포트 충돌이 나면 기존 프로세스를 종료하거나 포트 매핑 값을 변경합니다.
• 이미지 pull 실패 시 네트워크 연결 및 레지스트리 접근 권한을 확인합니다.
• 설정 변경 후 문제가 지속되면 docker compose down 후 다시 up -d로 재기동합니다.

​

관련 문서