---
title: "서버 운영 가이드"
description: "docs.klounge.kr 문서 사이트를 수정하고 확인하고 배포하는 순서입니다."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.klounge.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 서버 운영 가이드

이 페이지는 현재 서버의 Nimbus 문서 사이트를 운영하는 방법을 설명합니다. 사이트 주소는 [docs.klounge.kr](https://docs.klounge.kr)입니다. Nginx가 빌드된 정적 파일을 제공하므로 평소에는 개발 서버를 켜둘 필요가 없습니다.

## 1. 프로젝트로 이동

서버 터미널에서 다음 명령을 실행합니다.

```bash
cd /home/nimbus
```

## 2. 문서 수정

이 사이트의 문서 원본은 `apps/www/src/content/docs/`에 있습니다. 기존 `.mdx` 파일을 수정하거나 새 파일을 추가할 수 있습니다. 새 문서에는 제목을 포함한 머리말이 필요합니다.

```mdx
---
title: 새 문서
description: 이 문서의 짧은 설명입니다.
---

여기에 내용을 작성합니다.
```

사이드바에 새 문서를 표시하려면 `apps/www/astro.config.ts`의 `sidebar.items`에도 문서 경로를 추가합니다. 예를 들어 `src/content/docs/example.mdx`는 `"example"`로 등록합니다.

## 3. 로컬에서 미리보기

```bash
pnpm --filter @nimbus/www dev
```

터미널에 표시된 주소에서 변경 사항을 확인합니다. 서버 밖에서 접속하려면 SSH 터널을 사용하거나 서버의 접근 설정을 별도로 구성해야 합니다. 작업을 끝낼 때는 `Ctrl+C`를 누릅니다.

## 4. 배포 파일 빌드

저장소 루트(`/home/nimbus`)에서 순서대로 실행합니다.

```bash
pnpm --filter @cloudflare/nimbus-docs build
pnpm --filter @nimbus/www build
```

빌드 결과는 `apps/www/dist/`에 생성됩니다. 빌드가 실패했다면 다음 단계로 진행하지 말고 오류를 먼저 해결합니다.

## 5. 실제 사이트에 반영

```bash
cp -a apps/www/dist/. /var/www/docs.klounge.kr/
```

Nginx가 정적 파일을 직접 제공하므로 다시 시작할 필요는 없습니다. [docs.klounge.kr](https://docs.klounge.kr)를 새로고침해 변경 사항을 확인합니다.

## 새 Nimbus 사이트를 만들고 싶다면

현재 사이트를 수정하는 대신 별도의 문서 사이트를 만들려면 다음 명령을 사용합니다.

```bash
npx @cloudflare/create-nimbus-docs@latest my-docs
cd my-docs
pnpm dev
```

생성 과정에서 의존성 설치를 건너뛰었다면 `pnpm install`을 먼저 실행합니다. 자세한 내용은 [설치 안내](/installation)를 참고하세요.

Source: https://docs.klounge.kr/server-guide/index.mdx