---
url: "/ko/pixelay/faq/troubleshooting.md"
description: "확장 프로그램 설정, URL 문제, 내보내기 특이 사항, 네트워크 제한 등 Pixelay 문제를 해결하는 가이드예요."
---

# Pixelay 문제 해결

> 확장 프로그램 설정, URL 문제, 내보내기 특이 사항, 네트워크 제한 등 Pixelay 문제를 해결하는 가이드예요.

## URL에서 Pixelay가 로드되지 않아요(Chrome 확장 프로그램 필요)

Pixelay로 디자인을 URL과 비교하려면 [Pixelay Chrome 플러그인](https://chrome.google.com/webstore/detail/pixelay-for-figma/gnbafbeabkbkecmbedfgebgboicpnkpp)을 설치하세요. 이 플러그인은 백그라운드에서 실행되다가, 브라우저에서 Pixelay 플러그인의 URL이 감지되면 Pixelay를 불러와요.

## Next.js(Vercel) 앱이 로드되지 않아요

Pixelay로 Next.js 앱을 비교하려고 하면 가끔 “Application error: a client-side exception has occurred” 메시지가 표시되고 페이지가 로드되지 않을 수 있어요. 이럴 때는 Chrome 확장 프로그램을 사용하지 않는 아래 링크에 Pixelay ID를 넣어 시도해 보세요: https://pixelay.hypermatic.com/YOUR_PIXELAY_PROJECT_ID_HERE (예: https://pixelay.hypermatic.com/n4ok457201973)

## URL 만료

보안 링크와 이미지는 180일 동안 활동이 없으면(링크에 마지막으로 접근해 확인한 날로부터 180일 후) 자동으로 삭제돼요. 용도를 다한 링크와 이미지가 실수로 남아 있지 않도록 하기 위해서예요.

## 내보낸 이미지 가장자리에 얇은 흰색 선이 생겨요

가끔 이미지 가장자리에 희미하고 얇은 흰색 선이 생길 수 있어요. 레이어 위치가 정수 픽셀 값이 아니면(예: Y: 156.76 또는 X: 56.3) Figma가 [이런 현상을 일으켜](https://twitter.com/Skcrub/status/1255544876701270017) 이 서브픽셀 선이 내보내기에 자동으로 포함돼요. 문제를 해결하려면 레이어 위치가 모두 정수 픽셀 값인지 확인하세요.

## CSS 'vh' 단위를 사용하는 웹사이트

웹사이트 CSS에서 요소에 “vh” 단위를 사용한다면, Pixelay가 뷰포트 높이를 Figma 목업 전체 높이와 똑같이 설정하기 때문에 해당 요소가 일반적인 브라우저 높이에서보다 훨씬 길게 보일 수 있어요.

## Figma 파일에 새 URL 만들기

꽤 민감한 기능이라 클릭할 버튼이나 아이콘을 추가하는 대신, 플러그인이 실행 중일 때 키보드로 “코나미 커맨드(Konami Code)”를 입력해야만 이 기능이 작동하도록 만들었어요.

`Up, Up, Down, Down, Left, Right, Left, Right, B, A`

키보드로 이 키 순서를 입력하면 Pixelay 플러그인이 Figma 파일에 완전히 새로운 URL을 만들어요. 예를 들어 복제한 Figma 파일에서 이 순서를 입력하면 원본과 다른 새 URL을 부여할 수 있어요.

## 내보낸 이미지가 깨져 보여요

Figma의 이미지 에셋이 아직 점진적으로 로드되는 중에 디자인을 업로드하면, 이미지가 Figma 파일에서 완전히 로드되기 전에 내보내져 픽셀이 깨진 것처럼 보일 수 있어요. 이 문제를 해결하려면 Pixelay 플러그인으로 이미지를 업로드하기 전에 Figma 파일 안의 모든 이미지가 100% 로드되어 선명하게 보이는지 확인하세요.

이 문제를 더 줄이려면 [“Downsizer” 기능(영어)](/ko/tinyimage/downsize)으로 이미지 채우기를 레이어 크기에 맞게 줄이세요. 파일 크기가 줄어들어 Figma 파일에서 훨씬 빠르게 로드돼요.

## 플러그인에서 디자인이 업로드되지 않거나 웹 앱에서 이미지가 로드되지 않아요

인터넷 서비스 제공업체(ISP)가 QUIC 프로토콜을 차단하고 있는 것이 원인일 수 있어요. 브라우저나 Figma에서 개발자 콘솔을 열어 `ERR_QUIC_PROTOCOL_ERROR` 오류 메시지가 표시되는지 확인해 보세요.

이 문제는 다음 방법으로 우회할 수 있어요.

1. 컴퓨터의 인터넷 연결을 휴대폰의 Wi-Fi 핫스팟/테더링으로 전환하기
2. 브라우저에서 [QUIC 비활성화하기(영어)](https://kinsta.com/knowledgebase/err_quic_protocol_error/)

## Netskope가 Pixelay 프레임 로드를 차단해요

[Netskope](https://www.netskope.com/)가 Firebase 데이터베이스에 대한 접근을 차단하는 알려진 문제가 있어요. 이 문제를 해결하려면 `firestore.googleapis.com:443`을 허용하세요([이 스레드](https://stackoverflow.com/questions/52441316/firestore-grpc-behind-a-corporate-firewall-proxy) 참고).

## 중국에서는 VPN이 필요할 수 있어요

중국에 있다면 “만리방화벽(The Great Firewall of China)” 때문에 계정 서버에 연결하지 못할 _수도_ 있어요. 유효한 키를 입력했는데도 활성화 오류가 표시된다면 [VPN](https://protonvpn.com/free-vpn/)을 사용해야 문제가 해결될 가능성이 커요.

## “An error occurred while loading the plugin environment”

Figma 데스크톱 앱에서 Figma의 [Use Developer VM](https://www.figma.com/plugin-docs/debugging/#developer-vm) 디버그 설정이 실수로 켜져 있으면 이 오류가 발생할 수 있어요. 설정이 꺼져 있는지 확인하려면 Figma 캔버스 아무 곳에서나 **마우스 오른쪽 버튼을 클릭**하고, **Plugins** 위에 마우스를 올린 다음 **Development** 위에 마우스를 올려 **Use Developer VM**이 *선택 해제*되어 있는지 확인하세요. 선택이 해제되면(옆에 체크 아이콘이 _없으면_) Figma 플러그인을 다시 실행했을 때 정상적으로 작동할 거예요.