--- url: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/getting-started/installation' title: 'Drupal 사이트에 DXPR Builder 설치 | DXPR' author: name: Jurriaan url: 'https://dxpr.com/users/jurriaan' date: '2026-10-24T14:02:47+00:00' updated: '2026-10-24T17:19:22+00:00' copyright: 'Copyright DXPR. All rights reserved.' type: article summary: |- 이미 운영 중인 Drupal 사이트에 DXPR Builder를 설치하고 제품 키를 추가한 뒤 하나의 콘텐츠 유형을 빌더로 전환합니다. 마지막에는 빌더가 표시되는 저장된 페이지가 준비되며 첫 요소를 추가할 수 있습니다. 새 사이트를 시작하나요? DXPR CMS 설치로 빌더, 테마, 콘텐츠 유형을 한 번에 설정합니다. 동영상 기존 콘텐츠 유형에 설치에서 이 페이지 끝 점검 목록의 2~8단계를 설명합니다. tags: - 'Install and update' image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' published: true og: site_name: DXPR updated_time: '2026-10-24T17:19:22+0000' 'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.' schema: '@context': 'https://schema.org' '@graph': - mainEntity: { } - '@type': TechArticle headline: 'Drupal 사이트에 DXPR Builder 설치' description: |- 이미 운영 중인 Drupal 사이트에 DXPR Builder를 설치하고 제품 키를 추가한 뒤 하나의 콘텐츠 유형을 빌더로 전환합니다. 마지막에는 빌더가 표시되는 저장된 페이지가 준비되며 첫 요소를 추가할 수 있습니다. 새 사이트를 시작하나요? DXPR CMS 설치로 빌더, 테마, 콘텐츠 유형을 한 번에 설정합니다. 동영상 기존 콘텐츠 유형에 설치에서 이 페이지 끝 점검 목록의 2~8단계를 설명합니다. image: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg' width: '1200' height: '630' datePublished: '2026-10-24T14:02:47+0000' dateModified: '2026-10-24T17:19:22+0000' author: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR url: 'https://dxpr.com/' logo: '@type': ImageObject url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg' width: '1348' height: '501' mainEntityOfPage: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/getting-started/installation' articleSection: '설치 및 업데이트' - '@type': WebPage '@id': 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/getting-started/installation' description: |- 이미 운영 중인 Drupal 사이트에 DXPR Builder를 설치하고 제품 키를 추가한 뒤 하나의 콘텐츠 유형을 빌더로 전환합니다. 마지막에는 빌더가 표시되는 저장된 페이지가 준비되며 첫 요소를 추가할 수 있습니다. 새 사이트를 시작하나요? DXPR CMS 설치로 빌더, 테마, 콘텐츠 유형을 한 번에 설정합니다. 동영상 기존 콘텐츠 유형에 설치에서 이 페이지 끝 점검 목록의 2~8단계를 설명합니다. breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: 홈 item: 'https://dxpr.com/ko' publisher: '@type': Organization '@id': 'https://dxpr.com/#organization' name: DXPR inLanguage: ko --- [도움말 센터](/ko/node/75)/[문서](/ko/hc/documentation) /[DXPR Builder 배우기](/ko/hc/documentation/learn-dxpr-builder) /[여기서 시작](/ko/hc/documentation/learn-dxpr-builder/start-here) /[설치 및 업데이트](/ko/hc/documentation/learn-dxpr-builder/start-here/install) # Drupal 사이트에 DXPR Builder 설치. DXPR Builder 배우기여기서 시작설치 및 업데이트 ## 이 가이드의 내용 관련 가이드 - [첫 페이지 만들기](/ko/hc/documentation/learn-dxpr-builder/getting-started/first-page) - [콘텐츠 유형에 DXPR Builder 사용](/ko/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types) - [DXPR Builder 업데이트](/ko/hc/documentation/learn-dxpr-builder/getting-started/updating) 이미 운영 중인 Drupal 사이트에 DXPR Builder를 설치하고 제품 키를 추가한 뒤 하나의 콘텐츠 유형을 빌더로 전환합니다. 마지막에는 빌더가 표시되는 저장된 페이지가 준비되며 첫 요소를 추가할 수 있습니다. 새 사이트를 시작하나요? [DXPR CMS 설치](/ko/hc/documentation/learn-dxpr-builder/getting-started/installing-dxpr-cms)로 빌더, 테마, 콘텐츠 유형을 한 번에 설정합니다. 동영상 [기존 콘텐츠 유형에 설치](/ko/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types)에서 이 페이지 끝 점검 목록의 2~8단계를 설명합니다. ## 시작하기 전에 - PHP 8.1 이상과 함께 Drupal 10.2 이상(Drupal 11 포함). 나머지는 [요구 사항](/ko/hc/documentation/learn-dxpr-builder/getting-started/requirements)을 참조하세요. - 프로젝트에 Composer와 Drush가 있습니다. - 제품 키. DXPR Builder가 작동하려면 필요합니다. [dxpr.com/getting-started](/getting-started)에서 확인합니다. ## 모듈 설치 1. Composer로 DXPR Builder 3.x를 다운로드합니다. 버전 3은 베타 릴리스로 게시되므로 허용합니다. ```bash composer require 'drupal/dxpr_builder:^3.0@beta' --with-all-dependencies ``` 일반 `composer require drupal/dxpr_builder`는 대신 안정적인 2.x 시리즈를 설치합니다. 2. 모듈을 활성화합니다. ```bash drush en dxpr_builder -y ``` Drush는 Key 모듈과 DXPR Builder에 필요한 코어 모듈(Field, Field UI, Views, Image, Block)도 함께 활성화합니다. ## 제품 키 추가 1. 메뉴 **DXPR Studio** > **DXPR Builder** > **일반 설정**(`/admin/dxpr_studio/dxpr_builder/settings`)으로 이동합니다. 2. 섹션 **라이선스**에서 **저장 방법**을 선택합니다. 3. 방식이 **구성 저장소**인 경우 **제품 키**에 키를 붙여넣습니다. **Key 모듈**인 경우 **키**에서 키를 선택합니다. 4. 마지막으로 **설정 저장**을 클릭합니다. **구성 저장소**는 키를 사이트 구성에 보관하므로 구성 내보내기에 포함됩니다. **Key 모듈**은 `/admin/config/system/keys`에서 먼저 만든 키에서 읽습니다. 내보내기에서도 제외하려면 해당 키에 **파일** 또는 **환경** 공급자를 지정합니다. ## 서브모듈 추가(선택 사항) DXPR Builder에는 세 개의 서브모듈이 포함되어 있습니다. `drush en`과 이름으로 활성화합니다. | 서브모듈 | 추가 기능 | 필요 사항 | |---|---|---| | `dxpr_builder_page` | 이미 빌더용으로 설정된 **드래그 앤 드롭 페이지** 콘텐츠 유형 | 다음 [Field Group](https://www.drupal.org/project/field_group) 모듈 | | `dxpr_builder_block` | 블록 영역의 빌더 콘텐츠용 **드래그 앤 드롭 블록** 블록 유형 | 먼저 활성화하는 코어 **블록 콘텐츠** 모듈 | | `dxpr_builder_media` | Entity Browser 기반의 레거시 미디어 브라우저. **확장** 페이지에서 숨겨짐 | Entity Browser와 Inline Entity Form | 대부분의 사이트에는 미디어 서브모듈이 필요하지 않습니다. 설치 시 코어 **미디어 라이브러리**가 활성화되어 있으면 빌더가 사용합니다. 그렇지 않으면 설정 페이지의 **미디어** > **브라우저 유형**에서 나중에 선택합니다. 자세한 내용은 [서브모듈 아키텍처](/ko/hc/documentation/learn-dxpr-builder/development/submodules)를 참조하세요. ## AI 기능 켜기(선택 사항) AI 페이지 생성, AI 텍스트, AI 이미지는 [AI](https://www.drupal.org/project/ai) 모듈과 [DXPR AI Provider](https://www.drupal.org/project/ai_provider_dxpr)를 통해 실행됩니다. 1. 두 모듈을 다운로드합니다. ```bash composer require drupal/ai drupal/ai_provider_dxpr ``` 2. 활성화합니다. ```bash drush en ai ai_provider_dxpr -y ``` 3. 페이지 `/admin/config/ai/providers/dxpr`로 이동하여 **DXPR API 키**에서 제품 키가 있는 키를 선택하고 저장합니다. 4. 페이지 `/admin/dxpr_studio/dxpr_builder/ai_settings`로 이동합니다. **AI 기능** 아래의 세 상자는 기본적으로 모두 선택되어 있습니다. 원하지 않는 기능은 선택을 해제합니다. 가이드 [AI 기능 가이드](/hc/documentation/learn-dxpr-builder/ai)에서 각 설정을 설명합니다. ## 설치 확인 빌더는 텍스트 필드에 **DXPR Builder** 포매터를 사용하는 콘텐츠에 표시됩니다. 다음 단계에서는 **본문** 필드가 있는 콘텐츠 유형에 설정합니다. 유형 **드래그 앤 드롭 페이지**(`dxpr_builder_page`)는 이미 설정되어 있으므로 2~5단계를 건너뛸 수 있습니다. 1. 메뉴 **DXPR Studio** > **DXPR Builder** > **일반 설정**으로 이동하여 **라이선스** 섹션에서 제품 키를 확인합니다. 2. 메뉴 **구조** > **콘텐츠 유형**으로 이동합니다. **본문** 필드가 있는 콘텐츠 유형 옆의 메뉴를 열고 **디스플레이 관리**를 클릭합니다. 3. 뷰 모드 개요가 열리면 **기본값**의 **관리**를 클릭합니다. 4. 본문의 **형식**을 **DXPR Builder**로 변경합니다. 5. 마지막으로 **저장**을 클릭합니다. 6. 해당 유형의 콘텐츠를 만들고 **제목**을 입력합니다. 7. 마지막으로 **저장**을 클릭합니다. 8. 콘텐츠 영역에 마우스를 올립니다. DXPR Builder 툴바가 표시됩니다. ## 표시 내용 저장된 페이지에는 본문 텍스트 위치에 빈 빌더가 표시됩니다. AI가 설정될 때까지 비활성화된 AI 프롬프트와 **템플릿 선택**, **요소 추가**가 제공됩니다. **요소 추가**를 클릭하면 **레이아웃**과 **콘텐츠** 탭이 있는 요소 선택 도구가 열립니다. DXPR Builder가 작동 중입니다. ## 빌더가 표시되지 않는 경우 - **페이지에 본문 텍스트는 표시되지만 빌더가 없습니다.** 필드가 여전히 다른 포매터를 사용합니다. **형식**을 **DXPR Builder**로, **기본값** 뷰 모드의 **구조** > **콘텐츠 유형** > **디스플레이 관리**에서 설정합니다. - **편집 양식에 일반 텍스트 영역이 표시됩니다.** DXPR Builder는 편집 양식이 아니라 저장된 페이지에서 작동합니다. 콘텐츠를 저장하고 해당 페이지를 엽니다. - **빌더가 관리자에게만 표시됩니다.** 다른 역할에는 **DXPR Builder로 편집** 권한이 없습니다. **사용자** > **권한**(`/admin/people/permissions`)에서 부여합니다. - **두 번째 에디터에게 “Only one account can use DXPR Builder on the DXPR Free tier”가 표시됩니다.** 무료 등급은 에디터 1명을 허용합니다. **라이선스**에 유료 구독의 제품 키를 입력합니다. - **“Your product key is not valid” 오류가 표시됩니다.** DXPR CDN이 키를 거부했습니다. **라이선스**(`/admin/dxpr_studio/dxpr_builder/settings`)에 전체 키를 다시 붙여넣습니다. - **“DXPR Builder cloud assets could not be loaded” 오류가 표시됩니다.** 브라우저가 `cdn2.dxpr.com`이나 `cdn.dxpr.com`에 연결할 수 없습니다. [방화벽 및 데이터 레지던시](/ko/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall)에서 설명하는 대로 두 호스트를 허용합니다. - **AI 프롬프트에 “AI features require the AI module”이라고 표시됩니다.** AI 모듈이 아직 설정되지 않았습니다. [AI 기능 켜기](#turn-on-ai-features-optional)를 따르거나 **AI 기능**(`/admin/dxpr_studio/dxpr_builder/ai_settings`)에서 해당 기능의 선택을 해제합니다. - **설정 저장 시 “Invalid product key”가 보고됩니다.** 붙여넣은 텍스트가 완전한 키가 아니거나 DXPR Builder 1.x용으로 만든 키입니다. 공백이나 줄 바꿈 없이 현재 키를 다시 복사합니다. [편집기가 표시되지 않음](/ko/hc/documentation/learn-dxpr-builder/troubleshooting/editor-not-loading)에서 다른 원인을 설명합니다. ## 다음 단계 - [첫 페이지](/ko/hc/documentation/learn-dxpr-builder/getting-started/first-page): 섹션, 행, 요소로 페이지를 만듭니다. - [기존 콘텐츠 유형에 설치](/ko/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types): 더 많은 콘텐츠 유형을 전환하거나 빌더 필드를 추가합니다. - [DXPR Builder 업데이트](/ko/hc/documentation/learn-dxpr-builder/getting-started/updating): 모듈을 최신 상태로 유지하고 매번 업데이트한 뒤 `drush updatedb`를 실행합니다. - [변형 테스트](/hc/documentation/learn-dxpr-builder/integrations/ab-testing-overview): [강화 학습](https://www.drupal.org/project/rl) 모듈로 A/B 테스트를 수행합니다.