정적 파일

http.static handler는 server에 직접 mount되어 filesystem entry의 SPA, asset 또는 user upload를 제공합니다.

분류: static-handler reference. YAML block은 지정된 HTTP server가 존재한다고 가정합니다. host-authored example에서 relative fs.directory path는 project working directory에서 resolve됩니다. module-owned entry는 base: project로 구성하지 않으면 owning module의 source root에서 relative path를 resolve합니다. referenced file은 별도로 생성해야 합니다.

설정

- name: static
  kind: http.static
  meta:
    server: gateway
  path: /
  fs: app:public
  static_options:
    spa: true
    index: index.html
    cache: "public, max-age=3600"

파일시스템 통합

정적 파일은 파일시스템 엔트리에서 서빙됩니다. 모든 파일시스템 타입이 작동합니다:

entries:
  # Local directory
  - name: public
    kind: fs.directory
    directory: ./public

  # Static handler
  - name: static
    kind: http.static
    meta:
      server: gateway
    path: /static
    fs: public

/static/css/style.css 요청은 ./public/css/style.css를 서빙합니다.

하위 디렉토리를 서빙하려면 그 위치를 루트로 하는 파일시스템 엔트리를 fs로 참조하세요—예를 들어 directory:를 해당 하위 디렉토리로 설정한 fs.directory입니다:

entries:
  - name: content
    kind: fs.directory
    directory: ./app/documentation/html

  - name: docs
    kind: http.static
    meta:
      server: gateway
    path: /docs
    fs: content

SPA 모드

Single Page Application은 클라이언트 사이드 라우팅을 위해 모든 라우트에서 동일한 인덱스 파일을 서빙해야 합니다:

- name: spa
  kind: http.static
  meta:
    server: gateway
  path: /
  fs: app:frontend
  static_options:
    spa: true
    index: index.html

캐시 제어

다양한 에셋 타입에 적절한 캐싱 설정:

entries:
  - name: app_fs
    kind: fs.directory
    directory: ./dist

  # Versioned assets - cache forever
  - name: assets
    kind: http.static
    meta:
      server: gateway
    path: /assets
    fs: app_fs
    static_options:
      cache: "public, max-age=31536000, immutable"

  # HTML - short cache, must revalidate
  - name: app
    kind: http.static
    meta:
      server: gateway
    path: /
    fs: app_fs
    static_options:
      spa: true
      index: index.html
      cache: "public, max-age=0, must-revalidate"

일반적인 캐시 패턴:

• 버전화된 에셋: public, max-age=31536000, immutable
• HTML/인덱스: public, max-age=0, must-revalidate
• 사용자 업로드: private, max-age=3600

미들웨어

압축, CORS, 또는 기타 처리를 위해 미들웨어 적용:

- name: static
  kind: http.static
  meta:
    server: gateway
  path: /
  fs: app:public
  middleware:
    - compress
    - cors
  options:
    compress.level: "best"
    cors.allow.origins: "*"

미들웨어는 순서대로 정적 핸들러를 래핑합니다. 요청은 파일 서버에 도달하기 전에 각 미들웨어를 통과합니다.

참고

• 서버 - HTTP server configuration
• 라우팅 - router 및 endpoint
• 파일시스템 - Filesystem module
• 미들웨어 - available middleware