소셜 공유 이미지 및 아이콘
누군가가 사이트 링크를 X, LinkedIn, Slack, Discord 또는 WhatsApp에 붙여넣으면 읽기 쉬운 제목이 포함된 큰 이미지가 나타나야 합니다. 브라우저와 휴대폰은 선명한 아이콘을 표시해야 합니다.
1. 검사
- App 폴더(
src/app/또는app/), 기존favicon.ico,icon.*,apple-icon.*,opengraph-image.*,twitter-image.*확인. - 루트 레이아웃의
metadataBase. 이것이 없으면 og:image URL이 상대 경로가 되어 소셜 플랫폼이 무시합니다. 없으면 추가하세요 (launch-seo스킬 참조 또는metadataBase: new URL("https://your-domain.com")설정). next.config.*:output: "export"?- 브랜드: 이름, 태그라인, 기본 색상, 로고 (SVG 권장).
globals.css에서 토큰을 재사용하세요. - 버전에 맞는 문서 읽기:
node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/opengraph-image.mdnode_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.mdnode_modules/next/dist/docs/01-app/03-api-reference/04-functions/image-response.md
2. 오픈그래프 이미지 (사이트 전체)
assets/opengraph-image.tsx를 app/opengraph-image.tsx로 복사하고 브랜드 값을 수정하세요. alt, size (1200×630), contentType을 내보내며, next/og의 ImageResponse로 이미지를 그립니다.
공유 이미지 디자인 규칙:
- 최소 64px 이상, 가독성이 높은 3~8단어의 제목. 300px 너비의 썸네일에서도 읽을 수 있어야 합니다.
- 중요한 콘텐츠는 중앙 1000×500 영역 안에 유지하세요. 일부 플랫폼은 가장자리를 자릅니다.
- 브랜드 마크 + 도메인 이름을 구석에 넣어 링크가 어디로 가는지 알 수 있게 하세요.
- Flexbox만 사용:
ImageResponse는 CSS의 일부만 지원합니다 (display: flex, 그리드 없음). 자식이 두 개 이상인 모든 요소에는display: "flex"가 필요합니다. - 글꼴: 기본 글꼴은 별도 설정 없이 작동합니다. 사용자 정의 글꼴의 경우
.ttf/.otf/.woff파일 (.woff2아님)을readFile로 로드하여fonts옵션에 전달하세요 (문서 참조). - 크기 제한: 오픈그래프는 8MB, Twitter는 5MB. 생성된 PNG는 일반적으로 100KB 미만입니다.
twitter-image는 선택 사항입니다. 없으면 X는 오픈그래프 이미지를 사용합니다. 루트 메타데이터가 twitter: { card: "summary_large_image" }를 설정하는지 확인하세요.
3. 페이지별 이미지 (블로그 게시물, 문서, 제품 페이지)
동적 세그먼트 내부에 opengraph-image.tsx를 추가하세요. 예: app/blog/[slug]/opengraph-image.tsx. 이 파일은 params (Promise)를 받아 게시물 제목을 로드할 수 있습니다. 이미지 파일에서 generateStaticParams를 내보내 모든 이미지가 사전 렌더링되도록 하세요. 모든 공유가 하나의 브랜드처럼 보이도록 동일한 템플릿을 유지하세요.
이는 생각보다 중요합니다. 페이지가 metadata/generateMetadata에서 자체 openGraph를 설정하면 상위의 openGraph 객체를 덮어써서 해당 페이지에서 루트 공유 이미지가 사라집니다. 세그먼트 레벨의 opengraph-image 파일 (또는 명시적인 openGraph.images)이 이 문제를 해결합니다.
4. 아이콘
파일 (app/ 내) | 크기 | 용도 |
|---|---|---|
favicon.ico | 32×32 (멀티사이즈 가능) | 브라우저 탭, 앱 루트에 필수 |
icon.png 또는 icon.svg | 512×512 PNG 또는 SVG | 최신 브라우저, Android |
apple-icon.png | 180×180 | iOS 홈 화면 |
ImageResponse를 사용하여 icon.tsx / apple-icon.tsx를 생성할 수도 있습니다. — assets/icon.tsx 참조. 출시 전에 기본 create-next-app favicon.ico를 교체하세요. .ico 도구를 사용할 수 없으면 32×32 icon.png로 대체하고 이전 favicon.ico를 삭제해도 괜찮습니다.
5. 정적 내보내기 참고 사항
output: "export" (Next.js 16.4에서 테스트됨) 사용 시:
cacheComponents는 정적 내보내기에서 꺼야 하며, 모든 생성된 이미지 파일 (opengraph-image.tsx,icon.tsx,apple-icon.tsx)은export const dynamic = "force-static";가 필요합니다. 그렇지 않으면 빌드가 실패합니다. 동적 세그먼트에도generateStaticParams가 필요합니다.- 생성된 이미지는 파일 확장자 없이 내보내집니다 (
out/opengraph-image). 따라서 정적 호스트는Content-Type헤더 없이 서비스합니다 (Cloudflare Pages에서 확인됨). 일부 크롤러는 이를 거부합니다. 사이트 전체 이미지에 대한 최선의 해결책: 실행 중인 사이트에서/opengraph-image를 열고 저장한 후app/opengraph-image.png로 커밋합니다 (그런 다음.tsx는 삭제). 올바른 타입의opengraph-image.png로 내보내집니다. 아이콘도 마찬가지입니다 (app/icon.png,app/apple-icon.png). 게시물별 이미지의 경우 호스트의 헤더 파일에서 해당 경로에Content-Type: image/png를 설정하세요 (Cloudflare Pages/Netlify의public/_headers).
6. 검증
-
npm run build가 통과해야 합니다. 빌드 출력은opengraph-image라우트를 나열합니다. -
사이트를 시작하고 (
npm run start또는out/폴더 서비스) 검사기를 실행합니다 (Node 18+, 종속성 없음).<skill-dir>은 이 SKILL.md가 포함된 폴더입니다:node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/some-post페이지의
og:*및twitter:*태그를 읽고, 이미지를 다운로드한 후 절대 URL, HTTP 상태, 파일 크기, 크기 (1200×630),og:image:alt,twitter:card를 확인합니다. 태그의 localhost URL은metadataBase가 없거나 프로덕션에 대해 잘못 설정되었음을 의미하므로 보고됩니다. -
브라우저에서 이미지 URL을 열고 확인하세요. 브라우저 창이 좁을 때 텍스트를 읽을 수 있는지 확인하세요.
-
배포 후 사용자에게 플랫폼별 도구 (LinkedIn Post Inspector, Facebook Sharing Debugger)로 테스트하도록 알리세요. 이 도구들은 캐시된 미리보기도 새로고침합니다.
보고서
생성된 이미지 및 아이콘 파일 목록, 검사기 출력, 그리고 플랫폼이 미리보기를 캐시한다는 알림을 나열하세요. 이미지 변경 후에는 위 도구들로 다시 스크랩하세요.