Astro는 기본적으로 정적 사이트를 빌드합니다. 모든 페이지는 dist/의 HTML 파일이 되며, JavaScript는 아일랜드에 필요한 만큼만 포함됩니다. Lobsite에 필요한 것은 이 폴더뿐입니다. npm run build를 실행한 다음 프로젝트에서 npx lobsite를 실행하면 HTTPS가 적용된 *.lobsite.app 주소로 사이트가 공개됩니다. 위 상자에 dist/를 끌어다 놓을 수도 있습니다.
작동 방식
npm run build(즉astro build)로 사이트를 빌드하세요. 페이지, 이미지, 스크립트가dist/에 생성됩니다.- 프로젝트에서
npx lobsite를 실행하세요. Astro가 이미 빌드에 복사한public/이 아니라dist/를 배포합니다. 첫 배포는 계정이 필요 없으며 6시간 동안 유지됩니다. - 가져오기 링크로 무료 계정에 사이트를 유지하세요. 폴더가
lobsite.toml에 저장되므로 다음 빌드도 같은npx lobsite로 배포됩니다.
astro.config.mjs에서 확인할 설정
import { defineConfig } from "astro/config";
export default defineConfig({
site: "https://my-site.lobsite.app",
trailingSlash: "ignore",
});
- **
site**는 전체 주소입니다. Astro는 이를 대표 URL,Astro.site,@astrojs/sitemap의 사이트맵에 사용합니다.*.lobsite.app주소로 설정하고, 내 도메인으로 옮기면 변경하세요. - **
base**는 설정하지 마세요. 사이트는 GitHub Pages 프로젝트 사이트처럼 하위 폴더가 아니라 주소의 최상위에서 제공됩니다. - **
build.format**은 기본값으로 두어도 됩니다.about/index.html은/about/에서,about.html파일은/about에서 열립니다.
작동하는 것과 서버가 필요한 것
Astro가 빌드 시 렌더링하는 모든 것이 작동합니다. 콘텐츠 컬렉션, Markdown과 MDX, astro:assets 이미지(빌드 중 최적화), 브라우저에서 실행되는 React, Vue, Svelte, Solid 아일랜드가 해당합니다. 요청마다 실행되는 것은 작동하지 않습니다. export const prerender = false 페이지, output: "server", Astro Actions, 사전 렌더링되지 않는 API 엔드포인트입니다. 이들은 서버 어댑터가 필요하며, Lobsite는 파일만 제공합니다. 문의 폼은 Astro Action 대신 /_lobsite/forms/contact로 지정하세요. 폼을 참고하세요.
파일은 해시로 저장됩니다. 변경되지 않은 사이트를 다시 배포하면 0바이트가 업로드됩니다.
공개 전에 미리 보세요. 리디렉션까지 포함해 클릭 한 번으로 롤백합니다.
모든 사이트는 첫 배포부터 HTTPS가 적용된 *.lobsite.app 주소를 받습니다.
폼의 대상을 /_lobsite/forms/contact로 지정하세요. 스팸 필터링이 포함됩니다.
리디렉션, 헤더, 폼은 lobsite.toml에 있으며 각 배포와 함께 이동합니다.
계정 없는 배포는 6시간 동안 공개됩니다. 가져오기 링크로 무료로 유지할 수 있습니다.
Astro 호스트 비교
| Lobsite | Netlify | Vercel | GitHub Pages | |
|---|---|---|---|---|
| 정적 Astro 사이트 | 예 | 예 | 예 | 예, Astro의 GitHub Action 사용 |
| 서버 렌더링(어댑터) | 아니요 | 예 | 예 | 아니요 |
| 서버에서 빌드 | 아니요: dist/ 배포 |
예 | 예 | GitHub Actions에서 |
| 첫 배포 전 계정 | 불필요: 6시간 공개 후 무료로 유지 | 필요 | 필요 | 필요, 저장소도 필요 |
| 백엔드 없는 폼 | 예, 사이트가 계정에 있으면 | 예 | 아니요 | 아니요 |
| 커스텀 도메인 | 예, 무료 | 예 | 예 | 예 |
사이트 일부를 요청 시 렌더링한다면 Astro 어댑터가 있는 호스트를 선택하세요. Astro의 기본값인 정적 사이트라면 Lobsite가 내 컴퓨터, CI 또는 AI 에이전트에서 몇 초 만에 배포하며, 빌드에서 변경된 파일만 업로드합니다.
자주 묻는 질문
Lobsite에서 Astro를 호스팅하려면 어댑터가 필요한가요?
아니요. 어댑터는 서버 렌더링용입니다. 기본값인 정적 Astro 사이트는 어댑터가 필요 없으며 dist/ 폴더를 배포하면 됩니다.
npx lobsite가 public/이 아닌 dist/를 배포하는 이유는 무엇인가요?
Astro 프로젝트의 public/에는 favicon.svg처럼 빌드가 그대로 복사하는 파일이 있습니다. 빌드된 사이트는 dist/입니다. Lobsite는 package.json에서 astro를 보고 public/을 건너뜁니다.
Astro 사이트에 커스텀 404 페이지를 추가할 수 있나요?
네. src/pages/404.astro를 만들면 Astro가 404.html로 빌드하고, Lobsite는 존재하지 않는 주소에 404 상태로 제공합니다.
Astro의 이미지 최적화가 작동하나요?
네. astro:assets는 astro build 중에 이미지 크기를 조정하고 변환하므로, 배포할 때 최적화된 파일이 이미 dist/에 있습니다. 요청마다 실행되는 주문형 이미지 서비스만 서버가 필요합니다.