image
Akan.js
한국어
문서컨벤션레퍼런스Cheatsheet
image
Akan.js
문서컨벤션레퍼런스Cheatsheet
MIT 라이선스 하에 배포되었습니다.
Akan.js 공식 컨설팅 서비스Akansoft
Copyright © 2026 Akan.js 모든 권리 보유.
시스템 관리자bassman
일반
• 인증
• 스키마 설계
• 엣지 컴퓨팅
• 파일 관리
• Single Sign-On
• DataList & Enum
인터페이스
• CRUD
• Endpoint
• Form
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 도커
• 쿠버네티스
일반
• 인증
• 스키마 설계
• 엣지 컴퓨팅
• 파일 관리
• Single Sign-On
• DataList & Enum
인터페이스
• CRUD
• Endpoint
• Form
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 도커
• 쿠버네티스
이전
캐싱
다음
지연 로딩

이미지 최적화

Akan Image는 작은 이미지 최적화기처럼 동작합니다. width와 quality가 포함된 최적화 URL을 만들고, 가능하면 WebP로 제공하며, 생성된 결과를 캐시합니다.
  • UI에 보여주는 이미지는 `Image`를 사용하세요.
  • `akan.config.ts`에서 허용할 size와 외부 domain을 설정합니다.
  • Cache hit을 높이려면 size option을 너무 많이 늘리지 마세요.

Image 사용

File 형태의 객체나 직접 src를 넘길 수 있습니다. width와 height가 있으면 Akan이 가까운 캐시 size를 고르기 쉽습니다.
Article cover

설정

기본 설정은 일반적인 반응형 size를 포함합니다. UI에서 반복해서 쓰는 이미지 크기가 명확할 때만 바꾸는 것이 좋습니다.
akan.config.ts

remotePatterns

외부 이미지는 host와 path가 `remotePatterns`에 맞아야 허용됩니다. 최적화 요청이 bad request로 실패하면 이 설정을 먼저 확인하세요.
CDN 이미지 허용

Cache hit

Optimizer cache key는 URL, width, quality, output format이 바뀌면 달라집니다. Width나 quality 선택지가 너무 많으면 캐시가 잘게 쪼개져 잘 재사용되지 않습니다.
  • 매번 다른 width보다 반복되는 카드 size 몇 개를 사용하세요.
  • `qualities`는 보통 `[75]`처럼 작게 유지하세요.
  • Data URL, SVG, 이미 다른 시스템에서 최적화된 이미지는 `unoptimized`를 고려하세요.
이미지 최적화
Image 사용
설정
remotePatterns
Cache hit