---
url: 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/troubleshooting/images-and-media'
title: '이미지가 업로드되지 않거나 사라집니다 | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T14:17:29+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  업로드를 되살리고 업로드된 파일을 사이트에 유지합니다. 이미지는
  빌더 자체 업로드나 사이트가 쓰는 경우 Media Library를 통해
  페이지에 도착합니다. 대부분의 실패는 미디어 설정, 파일 권한,
  서버에 닿지 못한 업로드 때문입니다.
tags:
  - 'Fix a problem'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T14:17:29+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: '이미지가 업로드되지 않거나 사라집니다'
      description: |-
        업로드를 되살리고 업로드된 파일을 사이트에 유지합니다. 이미지는
        빌더 자체 업로드나 사이트가 쓰는 경우 Media Library를 통해
        페이지에 도착합니다. 대부분의 실패는 미디어 설정, 파일 권한,
        서버에 닿지 못한 업로드 때문입니다.
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T14:17:29+0000'
      dateModified: '2026-10-24T14:17:29+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/troubleshooting/images-and-media'
      articleSection: '문제 해결'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/ko/hc/documentation/learn-dxpr-builder/troubleshooting/images-and-media'
      description: |-
        업로드를 되살리고 업로드된 파일을 사이트에 유지합니다. 이미지는
        빌더 자체 업로드나 사이트가 쓰는 경우 Media Library를 통해
        페이지에 도착합니다. 대부분의 실패는 미디어 설정, 파일 권한,
        서버에 닿지 못한 업로드 때문입니다.
      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/manage) /[문제 해결](/ko/hc/documentation/learn-dxpr-builder/troubleshooting) # 이미지가 업로드되지 않거나 사라집니다.

 DXPR Builder 배우기사이트 관리문제 해결

   ## 이 가이드의 내용

 관련 가이드

- [미디어 라이브러리에서 사진 배치하기](/ko/hc/documentation/learn-dxpr-builder/integrations/media-library)

업로드를 되살리고 업로드된 파일을 사이트에 유지합니다. 이미지는 빌더 자체 업로드나 사이트가 쓰는 경우 Media Library를 통해 페이지에 도착합니다. 대부분의 실패는 미디어 설정, 파일 권한, 서버에 닿지 못한 업로드 때문입니다.

## 미디어 브라우저가 없거나 비어 있습니다

1. 다음 경로로 이동하여 섹션을 엽니다. **DXPR Studio** > **DXPR Builder** > **General Settings**(`/admin/dxpr_studio/dxpr_builder/settings`)에서 **Media** 섹션을 엽니다.
2. 다음을 설정하고 클릭합니다. **Browser type**을 **Media Library**로 설정하고 **Save settings**를 클릭합니다. 해당 옵션은 코어 Media Library 모듈이 활성화될 때만 표시됩니다. Acquia DAM을 쓰면 **Media Library (Acquia DAM)**을 선택합니다.
3. 다음으로 이동하여 머신 이름을 확인합니다. **Structure** > **Media types**로 이동하고 머신 이름이 `image`인 미디어 유형이 있는지 확인합니다(동영상은 `video`). 빌더는 해당 유형에서 Media Library를 엽니다.

**Note:** **Basic file upload**는 컴퓨터에서 직접 업로드하는 일반 **Select image** 버튼을 표시합니다. Media Library가 활성화되지 않았을 때 기본값입니다. Entity Browser는 레거시 옵션입니다. Media Library를 권장합니다.

## 업로드가 오류와 함께 실패합니다

- **"Destination file path is not writable" or "File could not be saved".** 웹 서버가 파일 디렉터리에 쓸 수 없습니다. 웹 서버 사용자용으로 `sites/default/files`를 쓰기 가능하게 만든 뒤 **Reports** > **Status report**를 확인합니다.
- **"Only files with the following extensions are allowed".** 빌더는 GIF, JPEG, PNG, WebP, AVIF, SVG 이미지와 WebM, Ogg, MP4 동영상을 받습니다. Media Library에서는 미디어 유형이 정합니다. 이미지 필드의 **Allowed file extensions** 아래에 확장자를 추가합니다. 위치는 **Structure** > **Media types** > **Image** > **Manage fields**입니다.
- **"exceeding the maximum file size", or "The uploaded video is too large".** 파일이 PHP 허용량보다 큽니다. PHP에서 `upload_max_filesize`와 `post_max_size`, 웹 서버나 프록시의 본문 크기 제한을 높입니다.
- **403 또는 405 `/dxpr_builder/ajax/file_upload` 오류.** 프록시나 방화벽이 해당 경로의 POST 요청을 차단하거나 리디렉션합니다. 허용 목록에 추가하고 사이트가 리디렉션하지 않는지 확인합니다. 예를 들면 HTTP에서 HTTPS로 바뀌지 않아야 합니다.
- **미디어 브라우저 안에서 편집자에게 “Access denied” 메시지가 표시됩니다.** 역할에는 Media Library를 여는 **View media**와 업로드용 **Image: Create new media**가 필요합니다. 둘 다 **People** > **Permissions**에서 부여합니다.

## 업로드 몇 시간 후 이미지가 사라집니다

파일이 `sites/default/files/dxpr_builder_images`에서 사라졌고 페이지에 깨진 이미지가 표시됩니다.

3.0.0-alpha85 이전 릴리스는 Media 모듈이 꺼져 있을 때 빌더 업로드를 임시 파일로 저장했습니다. Drupal의 cron은 6시간 뒤 임시 파일을 삭제합니다.

1. 현재 릴리스로 업데이트합니다. 업로드를 영구 파일로 저장하고 사용 내역을 기록합니다.
2. 빠진 이미지를 다시 업로드하거나 백업에서 같은 폴더로 복원합니다.

**Note:** 업로드는 기본 파일 디렉터리의 `dxpr_builder_images`, `dxpr_builder_videos`, `dxpr_builder_files`에 들어갑니다.

## 에디터에는 보이지만 방문자에게는 보이지 않습니다

- **다시 로드하면 이미지가 사라졌습니다.** 컨테이너가 저장되지 않았습니다. 이미지를 다시 추가하고 컨테이너 표시줄에서 **Save**를 클릭합니다.
- **이미지는 보이지만 방문자에게는 보이지 않습니다.** **Apply text format filters to frontend content**가 **General Settings** > **Text Filters** 아래에서 켜져 있으며, 필드의 텍스트 형식이 `img` 태그나 속성을 제거합니다. 에디터는 항상 필터링되지 않은 콘텐츠를 봅니다. 설정을 끄거나 해당 텍스트 형식에서 `img`를 허용합니다.
- **방문자에게 이전 버전의 페이지가 보입니다.** 캐시가 이전 페이지를 제공합니다. [Visitors see something different](/hc/documentation/learn-dxpr-builder/troubleshooting/visitors-see-something-else)을 참조합니다.

## 수정 확인하기

Image 요소에 이미지를 업로드하고 컨테이너를 저장합니다. 비공개 창에서 익명 방문자에게 이미지가 표시됩니다.

## 다음 단계

[Media Library integration](/ko/hc/documentation/learn-dxpr-builder/integrations/media-library)은 빌더에서 기존 미디어를 재사용할 때 확인합니다.