문서

빠른 시작

빌드된 프로젝트에서 명령어 하나를 실행하세요. 계정이 필요 없으며, 로그인하여 가져오지 않으면 사이트는 6시간 동안 유지됩니다.

npx lobsite

폴더는 인수, lobsite.toml의 dir 또는 dist/, build/, out/, _site/, public/ 중 첫 번째입니다. 변경된 파일만 업로드됩니다.

AI 에이전트

코딩 에이전트(Claude Code, Cursor, Codex 등)는 같은 명령어로 배포합니다. 에이전트 아래에서 CLI는 질문하지 않으며, 출력은 URL과 계정 없는 사이트의 경우 사이트를 유지할 가져오기 링크가 담긴 "Tell the user:" 줄로 끝납니다.

npx -y lobsite --yes

코딩 에이전트용 MCP 서버, ChatGPT와 Claude.ai용 원격 서버, Node 없는 샌드박스용 curl 명령어도 있습니다. 에이전트 설정.

끌어다 놓기

로그인하고 대시보드 아무 곳에나 폴더나 zip을 끌어다 놓으세요. 업로드 전에 같은 검사가 실행되며 시크릿 파일은 항상 제외됩니다.

lobsite.toml

site = "quiet-fox-4821"
dir  = "dist"
spa  = false            # true: paths that aren't files open index.html

[[redirects]]
from   = "/blog/:slug"
to     = "/posts/:slug"
status = 301            # 301 | 302 | 307 | 308

[[headers]]
for = "/assets/*"
[headers.values]
Cache-Control = "public, max-age=31536000, immutable"

[forms.contact]
required = ["email", "message"]
redirect = "/thanks"

알 수 없는 키는 오류이며 가장 가까운 유효한 키를 제안합니다. 구성은 각 배포와 함께 이동하므로 롤백하면 복원됩니다.

싱글 페이지 앱

React Router, Vue Router, TanStack Router 같은 클라이언트 라우팅을 사용하는 앱에는 index.html이 하나 있으며 모든 페이지를 브라우저에서 그립니다. /dashboard/settings를 직접 열거나 새로고침하면 서버에 존재하지 않는 파일을 요청합니다. 싱글 페이지 모드는 해당 경로에 index.html로 응답하여 앱의 라우터가 넘겨받게 합니다. 켜는 방법은 세 가지입니다.

• lobsite.toml의 spa = true. 각 배포와 함께 이동하므로 롤백하면 복원됩니다. lobsite 0.1.8 이상이 필요하며, 이전 버전은 "Unknown key"로 중단됩니다.
• 대시보드 사이트 설정의 싱글 페이지 앱. 끌어다 놓은 폴더는 lobsite.toml을 보내지 않으므로 끌어다 놓는 사이트를 위한 방법입니다. 사이트 설정이므로 배포와 롤백을 해도 그대로 유지됩니다.
• 사이트 최상위의 200.html. index.html 대신 제공되며 모든 CLI 버전과 끌어다 놓기에서 작동합니다. Surge의 방식입니다.

Vite(React, Vue, Svelte, Solid)에서는 설정을 추가하고 평소처럼 dist/를 배포하세요.

npm run build
npx lobsite

페이지 요청에만 앱이 제공됩니다. 마지막 부분에 확장자가 없는 경로(/dashboard, /users/42) 또는 브라우저가 HTML을 요청하는 모든 요청(/users/jane.doe)입니다. /assets/index-3f9a.js 같은 없는 파일은 실제 404를 받습니다. 이는 배포 직후 중요합니다. 이전 버전을 열어 둔 방문자는 이전 스크립트 대신 HTML이 아니라 명확한 오류를 받습니다.

Netlify에서 온다면 _redirects 규칙 /* /index.html 200은 spa = true이며, Vercel에서는 /(.*)를 /index.html로 리라이트하는 것이 같습니다.

.lobsiteignore

.lobsiteignore의 패턴과 일치하는 파일은 배포되지 않습니다. 구문은 .gitignore와 같습니다.

drafts/
*.psd
/notes.txt
!keep.psd

파일은 배포하는 폴더와 프로젝트 루트(lobsite.toml 옆)에서 읽으며, 루트 파일의 패턴은 루트 기준입니다. .git, node_modules, .DS_Store, .lobsiteignore 자체는 항상 제외됩니다.

시크릿 파일(.env*, *.pem과 id_rsa 같은 개인 키, .npmrc, .netrc 등)은 제거하거나 무시할 때까지 배포를 중단합니다. 터미널에서 CLI는 .lobsiteignore에 추가하고 이를 제외하여 배포하도록 제안합니다.

폼

<form action="/_lobsite/forms/contact" method="POST">
  <input name="email" type="email" required>
  <textarea name="message" required></textarea>
  <button>Send</button>
</form>

폼은 배포 시 찾습니다. 스팸 방지(허니팟, 타이밍, 속도 제한)가 자동으로 추가됩니다. 제출 내용은 대시보드의 제출 내용 페이지와 이메일로 들어옵니다. 폼 자세히 보기: 예제, JavaScript로 보내기, 프레임워크, 설정.

무료 플랜에서 폼은 제한 모드로 실행됩니다. 사이트별 월간 할당량, 계정 이메일로만 알림, 웹훅 없음입니다. Standard 플랜에는 웹훅, 인증된 모든 알림 주소, 더 높은 할당량이 추가됩니다.

커스텀 도메인

커스텀 도메인은 무료 플랜을 포함한 모든 계정에 제공됩니다. lobsite domain add www.example.com이 추가할 레코드를 출력합니다. cname.lobsite.app로의 CNAME입니다. 인증서는 자동으로 발급되고 갱신됩니다. 다른 계정도 도메인을 추가했다면 TXT 레코드로 소유권을 증명합니다.

미리보기와 롤백

모든 배포에는 자체 URL <id>--<site>.lobsite.app이 있습니다. lobsite deploy --preview는 프로덕션을 건드리지 않으며, lobsite rollback과 lobsite promote는 업로드 없이 공개 배포를 전환합니다.

CLI

한도

Bandwidth is per month per account (per site lifetime for anonymous sites). At the limit, free and anonymous sites stop serving until the next month; on Standard there's no cap and sites keep serving: past 1 TB a month, we contact you.