Field Note
Astro로 개인 블로그와 제휴 링크를 같이 운영하는 기준
개인 기술 블로그를 Astro, MDX, 정적 HTML로 운영하면서 검색 엔진과 AI 검색이 읽기 쉬운 형태로 제휴 링크를 다루는 기준을 정리한다.
astroseoaeoaffiliatecoolify
요약
- 글 원본은 MDX 파일로 두고 Git에서 리뷰한다.
- 빌드 결과는 정적 HTML이라 크롤러와 독자가 같은 본문을 읽는다.
- 제휴 링크는 disclosure와 rel 속성을 기본값으로 고정한다.
- Coolify에는 Dockerfile 기반 정적 사이트로 배포할 수 있다.
결론
이 블로그는 런타임 CMS가 아니라 Astro 기반 정적 사이트다. 글은 src/content/posts/*.mdx에
저장하고, 배포 시점에 HTML로 빌드한다.
AI가 글을 발행하는 흐름에서는 이 방식이 유리하다. 관리자 UI를 자동화할 필요 없이 새 MDX 파일을 만들고 frontmatter를 채우면 된다. 빌드가 실패하면 스키마가 어디서 깨졌는지 바로 알 수 있다.
제휴 링크 처리
제휴 링크는 일반 링크처럼 숨기지 않는다. 글 상단에 관계를 공개하고, 실제 링크에는
검색 엔진이 이해할 수 있게 rel="sponsored nofollow noopener noreferrer"를 붙인다.
위 링크는 예시다. 실제 운영에서는 Partner Center에서 발급받은 CID와 등록된 도메인을 사용해야 한다.
AEO/SEO 기본값
이 사이트의 기본값은 다음과 같다.
| 항목 | 구현 |
|---|---|
| 본문 | 빌드된 HTML에 직접 포함 |
| 사이트맵 | sitemap-index.xml 자동 생성 |
| RSS | /rss.xml |
| AI 안내 | /llms.txt |
| 구조화 데이터 | BlogPosting, 선택적 FAQPage |
| 제휴 공시 | 글 상단 disclosure + 링크 rel |
Coolify 배포 형태
Coolify에는 Dockerfile 애플리케이션으로 배포한다. 빌드 단계에서 Astro가 dist/를 만들고,
런타임 단계에서는 Nginx가 정적 파일만 서빙한다. DB가 없으므로 백업, 마이그레이션,
관리자 계정 같은 운영 부담이 없다.