Strapi v5 완전 정복 — 신규 설치부터 n8n WordPress 자동 발행 파이프라인까지 2026

// ── v4 방식 ──────────────────────────────────
const entry = $json.body.entry;
const blogPostId = entry.id;                             // 숫자 42
const coverUrl = $json.data.attributes
  .coverImage.data.attributes.url;                       // 중첩 attributes
// PUT URL: /api/blog-posts/42

// ── v5 방식 ──────────────────────────────────
const entry = $json.body.entry;
const blogPostDocId = entry.documentId;                  // 문자열 "a1b2c3def456"
const coverUrl = $json.data.coverImage.url;              // flat — 중첩 없음
// PUT URL: /api/blog-posts/a1b2c3def456

docker stop strapi
docker ps | grep strapi
# 아무것도 안 나오면 중지 완료

# strapi-v5: 애플리케이션 코드 (git으로 관리)
mkdir -p /mnt/data/02_automation/strapi-v5

# strapi-postgres: DB 데이터만 별도 분리 (매우 중요)
mkdir -p /mnt/data/02_automation/strapi-postgres/data

cd /mnt/data/02_automation/strapi-v5

docker run --rm -it \
  -v /mnt/data/02_automation/strapi-v5:/app \
  -w /app \
  node:20-bookworm-slim \
  bash -c "
    apt-get update -qq && apt-get install -y python3 make g++ &&
    npx create-strapi-app@5 . \
      --no-run \
      --skip-cloud \
      --ts \
      --dbclient=postgres \
      --dbhost=strapi-pg-db \
      --dbport=5432 \
      --dbname=strapi_db \
      --dbusername=strapi \
      --dbpassword=strapi1234 (REWRwerwer\!0101 - 느낌표 넣고싶을 땐 \로 구분)
  "

# 완료 후 파일 확인 — package.json, src/, config/ 가 생성되어야 함
ls /mnt/data/02_automation/strapi-v5/

FROM node:20-bookworm-slim AS build
WORKDIR /opt/app
RUN apt-get update && apt-get install -y python3 make g++ && rm -rf /var/lib/apt/lists/*
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:20-bookworm-slim
WORKDIR /opt/app
RUN apt-get update && apt-get install -y python3 make g++ && rm -rf /var/lib/apt/lists/*
COPY --from=build /opt/app ./
EXPOSE 1337
CMD ["npm", "run", "start"]

  strapi-pg-db:
    image: postgres:16-alpine
    container_name: strapi-pg-db
    restart: unless-stopped
    environment:
      POSTGRES_USER: strapi
      POSTGRES_PASSWORD: ${STRAPI_DB_PASSWORD}
      POSTGRES_DB: strapi_db           # DB 이름 strapi_db 로 통일
    volumes:
      # DB 데이터는 별도 디렉토리에 분리 보관
      - /mnt/data/02_automation/strapi-postgres/data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U strapi -d strapi_db"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - ai-common-net

  strapi:
    build:
      context: /mnt/data/02_automation/strapi-v5
      dockerfile: Dockerfile
    container_name: strapi
    restart: unless-stopped
    ports:
      - "1337:1337"
    environment:
      NODE_ENV: production              # 스키마 확정 후 production 사용
      HOST: 0.0.0.0
      PORT: 1337
      APP_KEYS: ${STRAPI_APP_KEYS}
      JWT_SECRET: ${STRAPI_JWT_SECRET}
      ADMIN_JWT_SECRET: ${STRAPI_ADMIN_JWT_SECRET}
      API_TOKEN_SALT: ${STRAPI_API_TOKEN_SALT}
      DATABASE_CLIENT: postgres
      DATABASE_HOST: strapi-pg-db
      DATABASE_PORT: 5432
      DATABASE_NAME: strapi_db         # POSTGRES_DB 값과 반드시 동일
      DATABASE_USERNAME: strapi
      DATABASE_PASSWORD: ${STRAPI_DB_PASSWORD}
      DATABASE_SSL: "false"
    volumes:
      # ✅ uploads 폴더만 마운트 — 전체 /opt/app 마운트 금지
      - /mnt/data/02_automation/strapi-v5/public/uploads:/opt/app/public/uploads
    depends_on:
      strapi-pg-db:
        condition: service_healthy
    networks:
      - ai-common-net

# 아래 명령어 실행 후 각 값을 .env에 직접 붙여넣기 (변수 치환 오류 방지)
echo "STRAPI_DB_PASSWORD=$(openssl rand -base64 24)"
echo "STRAPI_APP_KEYS=$(openssl rand -base64 32),$(openssl rand -base64 32)"
echo "STRAPI_API_TOKEN_SALT=$(openssl rand -base64 24)"
echo "STRAPI_ADMIN_JWT_SECRET=$(openssl rand -base64 24)"
echo "STRAPI_JWT_SECRET=$(openssl rand -base64 24)"

ai-lab
finance
home-lab

local-ai
workflow
music-gen
image-media-gen
prompt
daily-stock-reports
investment-automation
stock-etf
nas
devops
security
server-network

openssl rand -hex 16
# 예: a3f8d2c1b9e4f7a0c5d2e8f1b6a3c9d4

// Rank Math 메타 필드를 REST API에서 읽기/쓰기 가능하도록 등록
add_action('rest_api_init', function() {
    $meta_fields = [
        'rank_math_title',
        'rank_math_description',
        'rank_math_focus_keyword',
        'rank_math_secondary_keyword',
        'rank_math_primary_category',
    ];
    foreach ($meta_fields as $field) {
        register_post_meta('post', $field, [
            'show_in_rest' => true,
            'single'       => true,
            'type'         => ($field === 'rank_math_primary_category') ? 'integer' : 'string',
        ]);
    }
});

// ❌ v4 방식 — 숫자 id
const blogPostId = entry.id;

// ✅ v5 방식 — 문자열 documentId
const blogPostDocId = entry.documentId;

// ❌ v4 — PUT URL
http://strapi:1337/api/blog-posts/{{ $('4_extract').item.json.blogPostId }}?populate=coverImage

// ✅ v5 — PUT URL (documentId 사용)
http://strapi:1337/api/blog-posts/{{ $('4_extract').item.json.blogPostDocId }}?populate=coverImage

// ❌ v4 — coverImage URL 추출 (중첩 attributes)
http://strapi:1337{{ $('11_cover').item.json.data.attributes.coverImage.data.attributes.url }}

// ✅ v5 — coverImage URL 추출 (flat)
http://strapi:1337{{ $('11_cover').item.json.data.coverImage.url }}

// ❌ v4
http://strapi:1337/api/blog-posts/{{ $('4_extract').item.json.blogPostId }}

// ✅ v5
http://strapi:1337/api/blog-posts/{{ $('4_extract').item.json.blogPostDocId }}

---
title: 
category: home-lab
subCategory: devops
excerpt: 
seoTitle: 
focusKeyword: 
secondaryKeywords: 
metaDescription: 
categoryPath: 
wpTags: 
snsTags: 
fileName: 
altText: 
imageTitle: 
caption: 
description: 
snsSummary: 
snsComment: 
tistorySummary: 
---
<div class="dp">
  <p>여기부터 본문 작성...</p>
</div>

docker exec -it strapi sh -c "cd /opt/app && npm install strapi-plugin-meilisearch"
docker compose restart strapi

export default ({ env }: { env: (key: string) => string }) => ({
  meilisearch: {
    config: {
      host: 'http://meilisearch:7700',
      apiKey: env('MEILI_MASTER_KEY'),
    },
  },
});

{
  "data": {
    "title": "글 제목",
    "slug": "geul-jeomok",
    "content": "본문 HTML",
    "excerpt": "요약",
    "category": "home-lab",
    "subCategory": "devops",
    "wordpressPostId": 123
  }
}
# v4와 동일한 Body 구조 — v5에서도 POST 요청 방식은 동일합니다

① Strapi Admin → Content Manager → Blog Posts → + Create new entry
   → 모든 필드 채우기 (title, category, subCategory, excerpt, seoMeta, socialMeta)
   → coverImage는 비워둠 (ComfyUI가 자동 생성)
   → Draft 저장 → 내용 확인 후 Publish 버튼 클릭
        ↓
② Webhook 발생 → n8n 1번 노드(Webhook) 수신
        ↓
③ n8n 파이프라인 자동 진행:
   3번: X-Webhook-Secret 헤더 시크릿 검증 ✅
   4번: entry.documentId 추출 (v5 핵심)
   5~9번: ComfyUI 대표 이미지 생성
   10번: Strapi에 이미지 파일 업로드
   11번: coverImage 연결 (PUT by documentId)
   12~16번: WordPress에 글 + 이미지 발행
   17번: Strapi에 WP Post ID 역기록 (PUT by documentId)
        ↓
④ 확인:
   WordPress agibop.com → 새 글 발행 확인
   Strapi Blog Post → wordpressPostId 필드에 WP ID 기록됐는지 확인

# v5 API 응답 구조 확인 (documentId, flat 구조 눈으로 확인)
curl -s "http://192.168.1.253:1337/api/blog-posts?populate=coverImage" \
  -H "Authorization: Bearer ${STRAPI_API_TOKEN}" | python3 -m json.tool | head -40

# n8n 실행 로그 확인
docker logs -f n8n --tail 50

curl -X POST http://192.168.1.253:5678/webhook/strapi-publish \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Secret: 설정한_시크릿값" \
  -d '{
    "event": "entry.publish",
    "model": "blog-post",
    "uid": "api::blog-post.blog-post",
    "entry": {
      "documentId": "test-document-id-abc123",
      "id": 1,
      "title": "테스트 발행",
      "slug": "test-publish"
    }
  }'

# 성공 시 n8n Executions 탭에 실행 기록이 생성됩니다

# Strapi Admin → Settings → Webhooks → 해당 Webhook → Trigger 버튼
# 또는 Strapi API로 직접 테스트
curl -X POST "http://192.168.1.253:1337/api/blog-posts/문서ID/actions/publish" \
  -H "Authorization: Bearer ${STRAPI_API_TOKEN}" \
  -H "Content-Type: application/json"