dotnet 명령으로 Blazor Web App(Blazor Server 방식) 생성하기

11/30/2025
3 minutes to read

예제 프로젝트명: Hawaso

1. 사전 준비

Blazor Web App(Blazor Server 방식) 프로젝트 생성을 위해 다음 도구가 설치되어 있어야 합니다.

.NET SDK (10 이상 권장) 설치 여부는 다음 명령으로 확인할 수 있습니다.
```
dotnet --version
```
터미널 환경
- Windows: PowerShell, Windows Terminal
- macOS / Linux: 기본 Terminal

SDK 버전이 정상적으로 출력되면 다음 단계로 진행할 수 있습니다.

2. 작업 폴더 준비

프로젝트를 저장할 폴더를 생성한 뒤 해당 폴더로 이동합니다.

mkdir DotNetProjects
cd DotNetProjects

이미 작업용 폴더가 준비되어 있다면 이 단계는 생략할 수 있습니다.

3. Blazor Web App(Blazor Server) 프로젝트 생성

.NET 8 이후의 Blazor 템플릿은 Blazor Web App 구조이며, 옵션을 통해 Blazor Server 방식으로 생성할 수 있습니다.

다음 명령으로 Hawaso라는 이름의 Blazor Server 프로젝트를 생성합니다.

dotnet new blazor -n Hawaso --interactivity Server

옵션 설명

dotnet new blazor Blazor Web App 기본 템플릿을 생성합니다.
--interactivity Server Blazor Server 방식으로 실행되는 프로젝트를 생성합니다. (기본값은 WebAssembly + Server 혼합 모드이며, 본 옵션으로 명확히 Server 모드로 설정할 수 있습니다.)

생성 결과

명령을 실행하면 다음과 같은 구조가 생성됩니다.

Hawaso/
 ├─ Components/
 │   ├─ Layout/
 │   └─ Pages/
 ├─ wwwroot/
 ├─ appsettings.json
 └─ Program.cs

Blazor Server 인터랙티브 모드가 기본 적용된 구성입니다.

4. 프로젝트 디렉터리로 이동

생성된 프로젝트 폴더로 이동합니다.

cd Hawaso

5. 의존성 복원

프로젝트가 필요로 하는 NuGet 패키지를 복원합니다.

dotnet restore

dotnet run 실행 시 자동 복원되지만, 명확한 초기 작업을 위해 별도로 실행할 수 있습니다.

6. 로컬 실행

Kestrel 웹 서버를 통해 Blazor Server 애플리케이션을 실행합니다.

dotnet run

실행 후 아래와 유사한 로그가 출력됩니다.

Building...
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5269
info: Microsoft.Hosting.Lifetime[0]
      Application started.

포트는 시스템 환경에 따라 다를 수 있습니다.