---
title: 지역 환경
slug: docs-kr/local-development/parse-server-local
description: 로컬에서 Parse 서버 설치 및 설정으로 앱 개발 환경 최적화 방법
image: https://www.back4app.com/_public/img/back4app-og.png
createdAt: 2024-01-25T15:38:19.203Z
---

Back4app 로컬 개발 환경을 사용하면 데이터베이스, 클라우드 기능, 파일, 인증 및 웹 호스팅과 같은 핵심 기능을 사용하여 앱을 로컬에서 구축하고 테스트할 수 있습니다. 이 설정은 오픈 소스 Parse Server, Parse Dashboard 및 로컬에 설치된 데이터베이스로 구성되어 있어 프로토타입을 신속하게 만들고 반복할 수 있습니다.

이 설정은 프로토타입 제작, 개발 및 지속적인 통합 워크플로우에 이상적입니다.

## 목표

Back4app으로 로컬 개발 환경을 설정하세요.

자세한 설명을 보려면 튜토리얼 비디오를 시청하세요:
[Back4app 로컬 설정 가이드.](https://www.youtube.com/watch?v=Zy8k-B6FLzY)

## 1 - CLI를 사용하여 로컬 머신을 Back4app 서버에 연결하기

기존 앱을 로컬 머신에 연결하거나 새 앱을 만들기 위한 단계를 따르세요.
CLI 가이드를 참조하세요: [Parse CLI 문서](https://www.back4app.com/docs/local-development/parse-cli) 

## 2 - Parse Server 설치 및 실행

Parse Server를 로컬에 설치하는 가장 쉬운 방법은 NPM을 사용하는 것입니다. 터미널에서 다음 명령을 실행하세요:

:::BlockQuote
npm install -g parse-server mongodb-runner
:::

설치 후, Parse Server가 데이터를 저장할 수 있도록 데이터베이스를 시작하세요:

:::BlockQuote
mongodb-runner start
:::

Back4app 대시보드로 이동하여 **대시보드 > 앱 설정 > 보안 및 키**에서 APPLICATION\_ID, CLIENT\_KEY 및 MASTER\_KEY를 복사하세요. 이 값을 사용하여 Parse Server를 시작하세요:

:::BlockQuote
parse-server --appId APPLICATION\_ID --clientKey CLIENT\_KEY --masterKey MASTER\_KEY --databaseURI mongodb://localhost/test
:::

## 3- Parse 대시보드 설치

개발 경험을 향상시키기 위해 사용자 친화적인 인터페이스를 위한 Parse 대시보드를 설치하세요:

:::BlockQuote
npm install -g parse-dashboard
:::

이전 단계에서 사용한 동일한 자격 증명을 사용하고 대시보드를 시작하기 위해 다음 명령을 실행하세요:

:::BlockQuote
parse-dashboard --dev --appId APPLICATION\_ID --masterKey MASTER\_KEY --serverURL http\://localhost:1337/parse --appName MY\_APP
:::

Parse 대시보드가 로드되지 않으면 URL `http://0.0.0.0:4040/`을 `http://localhost:4040/`로 교체하세요.

## 4 - 서버 URL 업데이트

기본적으로 Back4app의 주요 서버 URL은 `https://parseapi.back4app.com`입니다. 그러나 로컬 인스턴스의 경우 앱 코드를 업데이트하여 `http://localhost:1337/parse`를 가리키도록 해야 합니다.

## 문제 해결

- **일반 대시보드 오류**: 로컬에서 Parse 대시보드에 접근할 수 없는 경우 올바른 localhost URL을 사용하고 있는지 확인하세요.
- **데이터베이스 문제**: Parse 서버를 시작하기 전에 `mongodb-runner` 서비스가 제대로 실행되고 있는지 확인하세요.


결론
--

로컬 Parse 서버와 Parse 대시보드가 설정되었으므로 이제 Back4app 애플리케이션을 개발하고 테스트할 수 있는 완전한 기능의 환경이 마련되었습니다. 이 로컬 설정을 통해 새로운 기능을 프로토타입하고, 문제를 디버깅하며, 라이브 환경에 의존하지 않고 더 빠르게 앱을 만들 수 있습니다.