Strapi V4 Docker 설치 가이드 — WordPress 자동 발행 연동까지 완전 정복 (n8n)

mkdir -p /mnt/data/02_automation/strapi
mkdir -p /mnt/data/02_automation/strapi-postgres/data
mkdir -p /mnt/data/02_automation/strapi-uploads
cd /mnt/data/02_automation/strapi

cd /mnt/data/02_automation
mkdir -p strapi && cd strapi

docker run --rm -it \
  -v "$(pwd):/opt/app" -w /opt/app \
  node:20-bookworm-slim \
  npx create-strapi-app@latest . \
  --typescript --dbclient=postgres \
  --dbhost=strapi-pg-db --dbport=5432 \
  --dbname=strapi --dbusername=strapi \
  --dbpassword=ChangeThisPassword123! \
  --no-run --skip-cloud

grep '"pg"' package.json || echo "❌ pg 누락 — 아래로 추가"

docker run --rm -it -v "$(pwd):/opt/app" -w /opt/app \
  node:20-bookworm-slim npm install pg --save

grep '"pg"' package.json   # 반드시 있어야 함

node_modules
.tmp
.cache
build
.git
.env
*.md
.editorconfig

# Stage 1: 빌드
FROM node:20-bookworm-slim AS builder
WORKDIR /opt/app
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential python3 git libvips-dev && rm -rf /var/lib/apt/lists/*
COPY package.json package-lock.json ./
RUN npm ci
RUN npm install pg --save
COPY . .
ENV NODE_ENV=production
RUN npm run build

# Stage 2: 운영 실행 (경량)
FROM node:20-bookworm-slim AS production
WORKDIR /opt/app
RUN apt-get update && apt-get install -y --no-install-recommends \
    libvips && rm -rf /var/lib/apt/lists/*
COPY package.json package-lock.json ./
RUN npm ci --omit=dev && npm cache clean --force
COPY --from=builder /opt/app/build ./build
COPY --from=builder /opt/app/config ./config
COPY --from=builder /opt/app/database ./database
COPY --from=builder /opt/app/public ./public
COPY --from=builder /opt/app/src ./src
COPY --from=builder /opt/app/favicon.png ./favicon.png
ENV NODE_ENV=production
EXPOSE 1337
CMD ["npm", "run", "start"]

  strapi-pg-db:
    image: postgres:16-alpine
    container_name: strapi-pg-db
    restart: always
    environment:
      POSTGRES_DB: strapi
      POSTGRES_USER: strapi
      POSTGRES_PASSWORD: ${STRAPI_DB_PASSWORD}
    volumes:
      - /mnt/data/02_automation/strapi-postgres/data:/var/lib/postgresql/data
    networks: [ai-common-net]
    logging: *default-logging

  strapi:
    build:
      context: /mnt/data/02_automation/strapi
      dockerfile: Dockerfile.prod
    container_name: strapi
    restart: always
    env_file: /mnt/data/.env
    environment:
      - DATABASE_CLIENT=postgres
      - DATABASE_HOST=strapi-pg-db
      - DATABASE_PORT=5432
      - DATABASE_NAME=strapi
      - DATABASE_USERNAME=strapi
      - DATABASE_PASSWORD=${STRAPI_DB_PASSWORD}
      - NODE_ENV=production
    ports: ["1337:1337"]
    volumes:
      - /mnt/data/02_automation/strapi-uploads:/opt/app/public/uploads
    depends_on: [strapi-pg-db]
    networks: [ai-common-net]
    logging: *default-logging

cd /mnt/data/02_automation/strapi
cat >> .env << EOF
APP_KEYS=$(openssl rand -base64 32),$(openssl rand -base64 32)
API_TOKEN_SALT=$(openssl rand -base64 32)
ADMIN_JWT_SECRET=$(openssl rand -base64 32)
TRANSFER_TOKEN_SALT=$(openssl rand -base64 32)
JWT_SECRET=$(openssl rand -base64 32)
EOF
echo "STRAPI_DB_PASSWORD=ChangeThisPassword123!" >> /mnt/data/.env

cd /mnt/data
docker compose build strapi
docker compose up -d strapi-pg-db strapi
docker logs strapi -f

which tmux || sudo apt install -y tmux

#!/bin/bash
set -e
ENV_FILE="/mnt/data/.env"
STRAPI_DIR="/mnt/data/02_automation/strapi"
DEV_PORT=1338

STRAPI_DB_PASSWORD=$(grep -E '^STRAPI_DB_PASSWORD=' "$ENV_FILE" | head -1 | cut -d '=' -f2-)
[[ -z "$STRAPI_DB_PASSWORD" ]] && { echo "❌ STRAPI_DB_PASSWORD 못 찾음"; exit 1; }

docker inspect strapi-pg-db &>/dev/null || { echo "❌ strapi-pg-db가 안 떠있음"; exit 1; }
NETWORK_NAME=$(docker inspect strapi-pg-db --format '{{range $k,$v := .NetworkSettings.Networks}}{{$k}}{{end}}')
docker rm -f strapi-dev-temp &>/dev/null || true

echo "Dev 모드 시작 — http://192.168.0.100:${DEV_PORT}/admin"
cd "$STRAPI_DIR"

docker run --rm -it \
  --name strapi-dev-temp \
  --network "$NETWORK_NAME" \
  -v "$(pwd):/opt/app" -w /opt/app \
  -p "${DEV_PORT}:1337" \
  -e NODE_ENV=development \
  -e DATABASE_CLIENT=postgres \
  -e DATABASE_HOST=strapi-pg-db \
  -e DATABASE_PORT=5432 \
  -e DATABASE_NAME=strapi \
  -e DATABASE_USERNAME=strapi \
  -e DATABASE_PASSWORD="${STRAPI_DB_PASSWORD}" \
  node:20-bookworm-slim \
  bash -c "npm install && npm run develop"

chmod +x ~/strapi-dev-mode.sh

# 1. 이름이 있는 tmux 세션 새로 생성
tmux new -s strapi-dev

# 2. (tmux 안으로 들어온 화면에서) 스크립트 실행
~/strapi-dev-mode.sh
# npm install 3~7분 소요. "To manage your project" 메시지 나오면 준비 완료

# 세션 목록 확인 (이름이 기억 안 날 때)
tmux ls

# 해당 세션으로 재접속
tmux attach -t strapi-dev

# tmux 세션으로 들어가서
tmux attach -t strapi-dev

# 로그 화면에서 Ctrl+C로 종료 → --rm이라 컨테이너 자동 삭제

# 확인 (결과 없어야 정상)
docker ps -a --filter "name=strapi-dev-temp"

cd /mnt/data/02_automation/strapi
ls src/api/blog-post/content-types/blog-post/schema.json
ls src/components/meta/

cd /mnt/data
docker compose build strapi
docker compose up -d strapi

module.exports = [
  'strapi::logger',
  'strapi::errors',
  {
    name: 'strapi::cors',
    config: {
      origin: [
        'https://agibop.com',
        'https://n8n.agibop.com',
        'http://192.168.0.100:1337',
      ],
    },
  },
  'strapi::security',
  'strapi::poweredBy',
  'strapi::query',
  'strapi::body',
  'strapi::session',
  'strapi::favicon',
  'strapi::public',
];

# 저장(Ctrl+O → Enter → Ctrl+X) 후
cd /mnt/data
docker compose build strapi
docker compose up -d strapi

obsidian-vault/
├── 0. system/          ← Obsidian 설정·플러그인 등
├── 1. blog-content/     ← 이 STEP에서 사용
│   ├── attachments/     ← 본문에 넣는 이미지 등 첨부파일
│   ├── logs/             ← (선택) 처리 이력 기록용
│   ├── posts/            ← 작성 중인(아직 미완성) 글
│   ├── published/        ← Strapi 전송 완료 후 보관
│   ├── ready/             ← n8n이 주기적으로 감시하는 폴더
│   ├── scripts/           ← (n8n 방식에서는 사용 안 함)
│   └── templates/         ← 새 글 작성용 frontmatter 템플릿
├── 2. work/              ← 모바일/PC 업무용 (이 파이프라인과 무관)
└── 3. life/              ← (이 파이프라인과 무관)

sudo apt install -y nfs-common
sudo mkdir -p /mnt/obsidian-vault
sudo mount -t nfs 192.168.0.150:obsidian-vault /mnt/obsidian-vault

# 재부팅 후에도 유지되게 fstab에 등록
echo "192.168.0.150:obsidian-vault /mnt/obsidian-vault nfs defaults 0 0" | sudo tee -a /etc/fstab

---
title: 
category: 
subCategory: 
excerpt: 
seoTitle: 
focusKeyword: 
secondaryKeywords: 
metaDescription: 
categoryPath: 
wpTags: 
snsTags: 
fileName: 
altText: 
imageTitle: 
caption: 
description: 
snsSummary: 
snsComment: 
tistorySummary: 
---

  
여기부터 본문 HTML 작성...

Schedule Trigger (10분마다)
    ↓
SFTP: ready/ 폴더 목록 조회 (List)
    ↓
SFTP: 파일별로 다운로드 (Download)
    ↓
Code: frontmatter 파싱 (순수 JavaScript, 외부 라이브러리 불필요)
    ↓
HTTP Request: Strapi에 Draft 생성 (POST /api/blog-posts)
    ↓
SFTP: 성공한 파일을 published/로 이동 (Rename)

# 1) SFTP 노드 — List
Operation: List
Path: obsidian-vault/1. blog-content/ready

# 2) SFTP 노드 — Download (위 결과의 각 파일에 대해 반복)
Operation: Download
Path: ={{ $json.path }}

const item = $input.first();
const binary = item.binary?.data;

if (!binary) return [];

let raw;

try {
  if (binary.id !== undefined) {
    // binaryDataMode: filesystem — 디스크 파일을 helpers로 읽음
    // (직접 .toString() 하면 참조 객체만 오고 내용이 읽히지 않음)
    const buffer = await this.helpers.getBinaryDataBuffer(0, 'data');
    raw = buffer.toString('utf-8');
  } else if (binary.data) {
    // binaryDataMode: default(memory) — base64 인코딩 상태
    raw = Buffer.from(binary.data, 'base64').toString('utf-8');
  } else {
    return [];
  }
} catch(e) {
  // 읽기 실패 → 조용히 건너뜀 (다음 주기에 재시도 가능)
  return [];
}

// BOM 제거 (Sublime Text UTF-8 with BOM → \uFEFF 로 시작)
// Windows 줄바꿈 정규화 (\r\n → \n, 단독 \r → \n)
raw = raw.replace(/^\uFEFF/, '').replace(/\r\n/g, '\n').replace(/\r/g, '\n');

// frontmatter 파싱
const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
if (!match) return [];

const meta = {};
match[1].split('\n').forEach(line => {
  const idx = line.indexOf(':');
  if (idx === -1) return;
  const key = line.slice(0, idx).trim();
  let val = line.slice(idx + 1).trim();
  if (val.startsWith('"') && val.endsWith('"')) val = val.slice(1, -1);
  meta[key] = val;
});

const body = match[2];
if (!meta.title) return [];

return [{ json: { meta, body, fileName: $('1) SFTP 목록 조회').item.json.name } }];

Authentication: Bearer Auth (STEP 16 ③과 동일한 Strapi 토큰 Credential 재사용)

Body (JSON):
{
  "data": {
    "title": {{ JSON.stringify($json.meta.title) }},
    "content": {{ JSON.stringify($json.body) }},
    "excerpt": {{ JSON.stringify($json.meta.excerpt) }},
    "category": {{ JSON.stringify($json.meta.category) }},
    "subCategory": {{ JSON.stringify($json.meta.subCategory) }},
    "imageMeta": {
      "fileName": {{ JSON.stringify($json.meta.fileName) }},
      "altText": {{ JSON.stringify($json.meta.altText) }},
      "imageTitle": {{ JSON.stringify($json.meta.imageTitle) }},
      "caption": {{ JSON.stringify($json.meta.caption) }},
      "description": {{ JSON.stringify($json.meta.description) }}
    },
    "seoMeta": {
      "seoTitle": {{ JSON.stringify($json.meta.seoTitle) }},
      "focusKeyword": {{ JSON.stringify($json.meta.focusKeyword) }},
      "secondaryKeywords": {{ JSON.stringify($json.meta.secondaryKeywords) }},
      "metaDescription": {{ JSON.stringify($json.meta.metaDescription) }},
      "categoryPath": {{ JSON.stringify($json.meta.categoryPath) }},
      "wpTags": {{ JSON.stringify($json.meta.wpTags) }},
      "snsTags": {{ JSON.stringify($json.meta.snsTags) }}
    },
    "socialMeta": {
      "snsSummary": {{ JSON.stringify($json.meta.snsSummary) }},
      "snsComment": {{ JSON.stringify($json.meta.snsComment) }},
      "tistorySummary": {{ JSON.stringify($json.meta.tistorySummary) }}
    }
  }
}

Operation: Rename
Old Path: =obsidian-vault/1. blog-content/ready/{{ $json.fileName }}
New Path: =obsidian-vault/1. blog-content/published/{{ $json.fileName }}

① templates/blog-post-template.md 복사
        ↓
② posts/내글제목.md 로 이름 바꾸고 그 안에서 작성 (작성 중, 안전)
        ↓
③ 완성되면 Obsidian에서 ready/내글제목.md 로 이동
  (Synology Drive가 [NAS]에 즉시 동기화)
        ↓
④ n8n Schedule Trigger(10분마다 자동 실행)
   → SFTP로 ready/ 스캔 → .md 파일 발견
   → frontmatter 파싱 → Strapi에 Draft 생성
   → 성공하면 published/로 자동 이동 / 실패하면 FAILED_ 접두사 표시
        ↓
⑤ Strapi(1337) 접속 → 생성된 Draft 확인·검수
   → coverImage 등 Obsidian으로 못 채운 부분 보완 → Publish
        ↓
(이후는 STEP 16~23과 동일한 자동 파이프라인)

curl -s "http://192.168.0.100:1337/api/blog-posts?populate=*" \
  -H "Authorization: Bearer YOUR_API_TOKEN" | jq

curl -s "http://192.168.0.100:1337/api/blog-posts/1?populate=*" \
  -H "Authorization: Bearer YOUR_API_TOKEN" | jq

add_action('rest_api_init', function() {
    $fields = [
        'rank_math_title'             => 'string',
        'rank_math_description'       => 'string',
        'rank_math_focus_keyword'     => 'string',
        'rank_math_secondary_keyword' => 'string',
    ];
    foreach ($fields as $key => $type) {
        register_post_meta('post', $key, [
            'show_in_rest'  => true,
            'single'        => true,
            'type'          => $type,
            'auth_callback' => function() { return current_user_can('edit_posts'); }
        ]);
    }
});

title/category로 프롬프트 작성 (Code 노드)
    ↓ ComfyUI POST /prompt (작업 등록)
    ↓ GET /history/{id} 반복 확인 (완료 대기, Wait+IF 루프)
    ↓ GET /view (완성 이미지 가져오기)
    ↓ Strapi POST /api/upload (Media Library 업로드)
    ↓ Strapi PUT /api/blog-posts/:id (coverImage 연결)

GET https://agibop.com/wp-json/wp/v2/categories?slug={{ entry.subCategory }}
응답: [{ "id": 23, ... }]

# 1) Strapi 이미지 다시 받기 (populate=coverImage로 채워진 URL 사용)
GET http://strapi:1337{{ coverImage URL }}

# 2) WP 미디어 업로드
POST https://agibop.com/wp-json/wp/v2/media
Authentication: Basic Auth (Application Password)
Content-Disposition: attachment; filename="{{ imageMeta.fileName }}.png"
Content-Type: image/png
Body: (위 binary, Input Data Field Name: data)
응답: { "id": 1234 }

# 3) alt/caption/title 채우기
POST https://agibop.com/wp-json/wp/v2/media/{{ wpMediaId }}
Body: { "alt_text": JSON.stringify(imageMeta.altText),
        "caption": JSON.stringify(imageMeta.caption),
        "title": JSON.stringify(imageMeta.imageTitle) }

GET https://agibop.com/wp-json/wp/v2/categories?slug={{ entry.category }}
응답: [{ "id": 5, ... }]

const entry = $('4. Code: 프롬프트 생성 + 슬러그 매핑').item.json;
const tagNames = (entry.seoMeta.wpTags || '').split(',').map(s => s.trim()).filter(Boolean);

// 태그가 없으면 빈 배열 — 다음 노드(22번)가 아예 실행 안 되고 자연스럽게 건너뜀
return tagNames.map(name => ({ json: { tagName: name } }));

POST https://agibop.com/wp-json/wp/v2/tags
Authentication: Basic Auth
Body: { "name": "{{ $json.tagName }}" }
Options → Response → Never Error: ON

성공 시 응답:  { "id": 99, "name": "...", ... }
이미 있을 때 응답(이제는 정상으로 받아짐):
  { "code": "term_exists", "data": { "status": 400, "term_id": 99 } }

const items = $input.all();
const tagIds = [];
for (const item of items) {
  const d = item.json;
  if (d.id) tagIds.push(d.id);                                    // 새로 생성된 태그
  else if (d.data && d.data.term_id) tagIds.push(d.data.term_id);  // 이미 존재하던 태그
}

const entry = $('4. Code: 프롬프트 생성 + 슬러그 매핑').item.json;
const parentCategoryId = $('20. WP 부모 카테고리 ID 조회').item.json.id;
const childCategoryId = $('12. HTTP: WP 카테고리 ID 조회').item.json.id;

return [{ json: { ...entry, tagIds, parentCategoryId, childCategoryId } }];

{
  "title": JSON.stringify(title),
  "slug": JSON.stringify(slug),
  "content": JSON.stringify(content),
  "excerpt": JSON.stringify(excerpt),
  "status": "publish",
  "categories": [parentCategoryId, childCategoryId],
  "tags": [tagIds 전체],
  "featured_media": wpMediaId,
  "meta": {
    "rank_math_title": JSON.stringify(seoMeta.seoTitle),
    "rank_math_description": JSON.stringify(seoMeta.metaDescription),
    "rank_math_focus_keyword": JSON.stringify(seoMeta.focusKeyword),
    "rank_math_secondary_keyword": JSON.stringify(seoMeta.secondaryKeywords),
    "rank_math_primary_category": childCategoryId
  }
}
응답: { "id": 5678, "link": "https://agibop.com/..." }

PUT http://strapi:1337/api/blog-posts/{{ strapiId }}
Body: { "data": { "wordpressPostId": {{ wpPostId }} } }

# 1) 페이지 게시
POST https://graph.facebook.com/v22.0/{PAGE_ID}/feed
Body: { "message": "={{ $json.socialMeta.snsSummary }}", "access_token": "YOUR_PAGE_TOKEN" }
응답: { "id": "PAGEID_POSTID" }

# 2) 댓글 작성 (워드프레스 링크 포함)
POST https://graph.facebook.com/v22.0/{{ $json.postId }}/comments
Body: { "message": "={{ $json.socialMeta.snsComment }}", "access_token": "YOUR_PAGE_TOKEN" }

Strapi에서 글 작성 + 6개 메타 섹션 입력 → Publish 클릭
        ↓ (webhook, X-Webhook-Secret 검증, 즉시 200 응답)
n8n 워크플로우 시작
        ↓
① 프롬프트 생성 → ComfyUI 이미지 생성 → Strapi coverImage 연결
        ↓
② 슬러그로 WP 카테고리 ID 조회 + 같은 이미지를 WP 미디어로 업로드
        ↓
③ WordPress 글 발행 (Rank Math 메타, featured_media 포함)
        ↓
④ wordpressPostId를 Strapi에 역기록
        ↓
⑤ 페이스북 페이지에 snsSummary로 게시 → ⑥ snsComment로 댓글 작성
        ↓
(인스타그램 — 앱 심사 완료 후 동일 구조로 추가)
(티스토리 — tistorySummary 참고 수동 게시 → tistoryUrl 기록)