• ctrl/command + k 를 누르면, 필요한 정보를 더 쉽게 검색할 수 있습니다.
• 공식 문서를 ChatGPT를 활용해 번역을 진행했으며, 모든 출처는 버블 공식 문서입니다.
• 공식 문서 양이 방대해 시간이 날 때마다 꾸준하게 작업 중입니다.
앱을 생성할 때 Bubble은 제공한 이름을 사용하여 앱의 개발 및 라이브 브랜치를 모두 실행할 수 있는 고유한 URL을 생성합니다. 예를 들어, 앱의 이름이 my-bubble-application이면 Bubble은 아래와 같은 URL을 생성합니다.
Development:
https://my-bubble-application.bubbleapps.io/version-test/
Live:
https://my-bubble-application.bubbleapps.io
JavaScript
복사
Connecting a custom domain
Setting up a domain
Registering your domain
도메인은 도메인 등록 업체라고 알려진 회사에서 구입됩니다. 한 번 구입되면 웹에서 고유한 식별자가 되며 누구도 동일한 도메인을 등록할 수 없습니다. 많은 도메인이 처음 등록되지만 몇 달러에서 수백만 달러에 이르는 기존 도메인을 구매하는 시장도 있습니다.
사용자는 브라우저 주소 표시줄에 도메인을 입력하여 앱에 액세스합니다. 이는 물리적 주소의 디지털 등가물로 인터넷에서 찾을 수 있는 방법입니다.
Configuring the domain in Bubble
Bubble에서 구성하는 도메인과 상관없이 도메인의 DNS 설정을 변경할 수 있으면 됩니다. 이 작업은 두 단계로 이루어집니다.
1.
Bubble에서 도메인 설정
2.
등록 업체의 인터페이스에서 Bubble을 가리키도록 DNS 레코드 설정
앱과 함께 도메인을 설정하려면 설정 - 도메인 섹션의 입력 상자에 도메인을 입력하고 "이 도메인 설정"을 클릭하십시오. 이 작업을 완료하면 Bubble은 등록 업체에서 입력해야 할 DNS 레코드를 제공합니다. 도메인이 등록되면 Bubble은 등록 업체에서 등록해야 할 DNS 레코드를 제공합니다.
설정에서 DNS 세부 정보를 가져온 후에는 Bubble 내에서 추가 조치가 필요하지 않습니다. 다음 단계는 도메인이 관리되는 등록 업체 서비스에서 수행해야 합니다.
1.
등록 업체 대시 보드에서 DNS 설정 또는 DNS Zone File을 찾으세요.
2.
이 섹션에서 이름이 ('') 또는 'www'인 기존 A 레코드를 제거하고 앞서 제공된 레코드로 대체하세요. 어떤 등록 업체는 빈 도메인을 나타내기 위해 '@'를 사용하는 경우도 있습니다. 레코드를 해당하는대로 추가하세요.
이 프로세스를 탐색하는 것은 등록 업체 간에 인터페이스가 다르기 때문에 어느 정도 기술적일 수 있습니다. 도움이 필요하면 등록 업체의 고객 지원에 문의하거나 커뮤니티 포럼에서 도움을 얻을 수 있습니다. 다른 사용자 중에는 동일한 등록 업체에 경험이 있는 경우 도움이 될 수 있습니다.
Propagating the changes
DNS 레코드를 설정한 후 새로운 설정이 인터넷에 전파되어야 합니다. 이 작업은 최대 24시간까지 소요될 수 있지만 일반적으로 2~4시간 후에 결과를 볼 수 있습니다.
Who do DNS settings need time to propagate?
Checking the DNS settings
Bubble은 레코드 아래에서 작업의 성공을 확인할 수 있도록 하고 "내 설정 확인" 버튼을 클릭하여 프로세스를 확인할 수 있습니다. 오류가 발생하면 레코드가 올바르게 구성되지 않았거나 변경 사항이 시스템을 통해 전파되지 않았을 수 있습니다.
도메인이 올바르게 구성되면 yourapp.bubbleapps.io로의 모든 요청이 자동으로 yourdomain.com으로 리디렉션됩니다.
Setting up a subdomain
What is a subdomain?
이미 도메인을 사용하고 있고 Bubble 앱을 가리키는 서브도메인을 사용하려면(예: app.yourapp.com), 입력 상자에 이를 도메인으로 사용하기만 하면 됩니다.
DNS 레코드는 다를 수 있지만 등록 업체 서비스에서 입력하는 방법은 위와 유사합니다.
Configuring DNS records
2019년 10월 이전에 Bubble 앱에 할당된 커스텀 도메인이 있다면 Legacy 고객으로 간주됩니다. 이전에 Bubble 앱에 커스텀 도메인을 할당한 적이 없는 경우 Legacy 고객을 위한 지침은 무시하세요.
(example.com) or (www.example.com)
사용자는 일반적으로 example.com 및 www.example.com에서 도메인을 로드할 수 있을 것으로 예상합니다. SEO 목적을 위해 우리는 이 중 하나를 다른 주소로 정확하게 리디렉션합니다.
예를 들어, example.com을 커스텀 도메인으로 선택하면 DNS 레코드가 올바르다면 자동으로 www.example.com을 example.com으로 리디렉션합니다!
커스텀 도메인을 선택하면 Bubble이 등록 업체에서 생성하도록 지시하는 네 개의 레코드를 만들어야 합니다.
유형: A 이름: 값: 104.xxx.xxx.xxx
유형: A 이름: 값: 104.xxx.xxx.xxx
유형: A 이름: www 값: 104.xxx.xxx.xxx
유형: A 이름: www 값: 104.xxx.xxx.xxx
JavaScript
복사
이들은 중복성을 위해 제공되지만 대부분의 경우 커스텀 도메인이 하나 이상의 기록을 갖고 있으므로 중요한 점은 하나는 빈 도메인을 위한 기록이 있어야 하고 하나는 www를 위한 기록이 있어야 한다는 것입니다.
(app.example.com)
커스텀 도메인이 app.example.com과 같은 형식이라면 이를 Bubble 앱에서 설정하고 설정 -> 도메인으로 이동하세요.
Bubble이 등록 업체에서 생성하도록 지시하는 두 개의 레코드를 만들어야 합니다.
유형: A 이름: app 값: 104.xxx.xxx.xxx
유형: A 이름: app 값: 104.xxx.xxx.xxx
JavaScript
복사
이들은 중복성을 위해 제공되지만 대부분의 경우 커스텀 도메인이 하나 이상의 기록을 갖고 있으므로 중요한 점은 하나는 빈 도메인을 위한 기록이 있어야 하고 하나는 www를 위한 기록이 있어야 한다는 것입니다.
이를 등록 업체에 입력할 수 있습니다:
Bubble과 Cloudflare에서 도메인이 업데이트되었다는 확인을 받으면 커스텀 도메인이 작동할 것입니다!
Changing/removing a domain
도메인을 변경하려면 현재 도메인을 제거해야 합니다. '이 도메인 이름 삭제'를 클릭하면 앱과 도메인 간의 연결이 끊어집니다.
도메인은 등록 업체 서비스에서 DNS 레코드를 제거하기 전까지 여전히 Bubble의 서버를 가리킵니다. 도메인이 제거되면 앱과 이 도메인이 연결되지 않았다는 메시지가 표시되는 Bubble 페이지가 표시됩니다. 도메인을 제거한 후에는 위에서 설명한대로 새로운 도메인을 추가할 수 있습니다.
만약 도메인을 제거하고 처음에는 appname.bubbleapps.io 도메인을 사용하려면 브라우저 캐시를 지워야 할 수 있습니다. 리디렉션이 일반적으로 브라우저 수준에서 캐시되기 때문입니다.
도메인 변경이 업로드된 파일 URL 및 동적 URL 표현식에 영향을 미치나요?
도메인 변경이 완료되면 동적 URL 표현식에는 영향을 미치거나 무효화시키지 않아야 합니다. 업로드된 파일은 도메인 자체가 아니라 S3/appforest에 저장되므로 모든 것이 적절하게 리디렉션됩니다.
SSL encryption (HTTPS)
2019년 10월 이후에 생성된 모든 앱에 대해 SSL은 의무적이며 이 설정은 변경할 수 없습니다. 아래 섹션은 이 이전에 생성된 앱에만 관련이 있습니다.
모든 bubbleapps.io 하위 도메인에서 제공되는 모든 앱은 모든 요금제에서 SSL 지원을 제공합니다. SSL 암호화를 사용하면 사용자에게 트래픽이 사이트와 그 사이에 누구도 가로챌 수 없다는 것을 보장할 수 있으며 사용자의 개인 정보를 보호합니다. SSL 암호화는 검색 엔진 순위에 도움이 되며 일부 기능을 사용하는 데 필요할 수 있습니다(Chrome에서 지리 위치 액세스, Stripe 결제 사용 등).
Setting up SSL
도메인을 올바르게 구성하고 Bubble이 A 레코드를 확인한 후에 진행할 수 있습니다. 사이트에서 SSL을 활성화하려면 확인란을 선택하십시오.
이 변경은 최대 1시간이 소요될 수 있습니다. Cloudflare를 사용하는 고객의 경우 SSL은 필수입니다.
Domain & DNS FAQs
Q: 내 도메인이 Cloudflare로 이동하는 데 얼마나 걸릴까요?
A: DNS 레코드가 업데이트되는 데 따라 2분에서 몇 시간이 걸릴 수 있습니다.
Bubble과 Cloudflare에 커스텀 도메인을 등록하면 도메인은 두 서비스에 모두 등록됩니다. 올바르게 작동하려면 Cloudflare가 DNS 항목이 자신의 서버를 가리키도록 유효성을 검사해야 합니다.
DNS 레코드를 업데이트할 때(레코드 추가, 제거 또는 이름 변경) 레코드가 사용 가능한 시간은 레코드의 TTL(Time-To-Live) 값에 따라 결정됩니다.
예를 들어, 레코드를 변경하고 해당 레코드의 TTL이 1시간인 경우 1시간 후에 해당 서버가 새 레코드를 인터넷에 보고한 것을 확신할 수 있습니다. 그러나 인터넷에는 많은 네임 서버가 있으며 모든 서버가 가장 최신의 레코드를 가지고 있어야 합니다. 평균적으로 레코드가 인터넷 전체에 방송되기까지는 TTL의 두 배의 시간이 소요될 것으로 예상됩니다. 따라서 TTL이 1시간인 경우 레코드가 2시간 후에 모든 곳에서 볼 수 있습니다.
레코드가 어디에서든 최신 상태로 업데이트되면 Cloudflare는 도메인을 소유하고 있다는 것을 확인할 수 있으며 앱이 활성화됩니다.
Q. 나는 Legacy 고객이며 Cloudflare를 일시적으로 비활성화하려면 어떻게 해야 하나요?
A. A 레코드를 이전에 사용한 A 레코드로 변경하세요.
Cloudflare에서 발생할 수 있는 문제가 Cloudflare에서 발생한 것으로 생각되면 A 104.xxx.xxx.xxx에서 A 레코드로 일시적으로 비활성화할 수 있습니다.
문제를 식별하고 Cloudflare를 다시 켜려면 A 레코드를 삭제하고 Bubble이 제공한 A 레코드로 다시 바꾸면 됩니다.
Q. 사용자가 "이 연결은 안전하지 않습니다" 오류를 받는 이유는 무엇인가요?
A. Cloudflare가 도메인을 아직 유효성을 검사하지 않았습니다.
"고급"을 클릭하고 인증서 세부 정보를 확인하면 인증서가 ssl123456.cloudflare.net과 같은 형식이면 DNS 항목이 올바른 위치를 가리키고 있지만 Cloudflare가 아직 도메인을 유효성을 검사하지 않았습니다. 1시간을 기다려 다시 확인하십시오.
Q. 내 사이트가 Cloudflare에서 작동하는지 어떻게 알 수 있나요?
A. 여러 도구가 있습니다.
첫 번째는 도메인 레코드가 전파되었는지 확인하는 것입니다.
도메인 레코드를 변경한 후 A 레코드 탭으로 이동하여 A 레코드가 전파되었는지 확인할 수 있습니다.
mywebpage.us. 299 IN A 104.19.241.93
mywebpage.us. 299 IN A 104.19.240.93
JavaScript
복사
What's my DNS와 같은 서비스를 활용할 수도 있습니다. 이 서비스는 전 세계 다양한 위치에서 사용자의 사용자 정의 도메인을 테스트합니다. 이 페이지에 몇 개의 빈 항목이 나타나는 것은 흔한 일이지만, 찾고 있는 것은 오류를 반환하는 기록(빨간 X)이나 기대한 결과와 다른 결과입니다.
Cloudflare은 자체 도메인에서 호스팅되는 모든 사이트의 특정 경로에 페이지를 제공합니다. /cdn-cgi/trace. Bubble의 페이지는 bubble.io/cdn-cgi/trace에서 확인할 수 있습니다. 자신의 사용자 정의 도메인으로 바꿔보세요(로드된 후) 작동 여부를 확인하려면 'bubble.io'를 대체하십시오.
결과는 다음과 같이 보일 것입니다:
fl=xxxxx
h=bubble.io
ip=xxx.xxx.xxx.xxx
ts=1572657558.41
visit_scheme=http
uag=Mozilla/5.0 [...]
colo=EWR
http=http/1.1
loc=US
tls=off
sni=off
warp=off
JavaScript
복사
Q. 여기에 모든 지침을 따랐지만 "이 연결은 안전하지 않습니다" 오류가 계속 발생합니다. 어떻게 해야 하나요?
A. 우리가 SSL 인증서를 발급할 수 없을 수 있습니다. CAA 레코드를 제거하고 다시 시도해야 합니다. Google DNS 조회 도구의 CAA 탭으로 이동하여 베어 도메인(예: example.com)에 CAA 레코드가 있는지 확인하십시오. CAA 레코드는 도메인을 위한 인증서를 발급할 수 있는 공급업체를 제한합니다. (Bubble 앱의 약 1%만이 CAA 레코드를 가지고 있습니다.)
예를 들어, 이 도구로 google.com을 조회하면 다음 레코드가 표시됩니다:
id 61662
opcode QUERY
rcode NOERROR
flags QR RD RA
;QUESTION
google.com. IN CAA
;ANSWER
. 21599 IN CAA 0 issue "pki.goog"
;AUTHORITY
;ADDITIONAL
JavaScript
복사
이는 google.com 도메인 전체의 사이트에 대해 인증서를 발급할 수 있는 것은 pki.goog 뿐이라는 의미입니다.
SSL 인증서 발급은 Bubble과 Cloudflare에서 사이트가 작동하는 데 중요한 부분이므로 CAA 레코드를 찾으면 삭제하세요. 사이트는 몇 분 안에 작동하기 시작해야 합니다.
Q. 방금 Cloudflare를 켰는데 사이트에서 525 오류가 발생하고 있습니다! 어떻게 해야 하나요?
A. 1시간 기다렸다가 다시 확인하세요.
Cloudflare로 전환하기 전에 SSL을 사용하지 않았던 레거시 고객이라면 일부 Bubble 서버에 업데이트된 인증서가 없을 수 있습니다. 525 오류는 오리진 서버(사이트가 Bubble에서 호스팅되는 곳)가 안전하지 않은 콘텐츠(http)를 안전한 콘텐츠(https)를 기대하는 서버에 제공할 때 발생합니다. 모든 서버에서 SSL 및 인증서 설정을 1시간마다 새로 고치므로 최근에 설정을 변경한 경우 기다렸다가 다시 시도하세요.
Q. 1001 오류가 발생하는 경우 어떻게 해야 하나요?
A. A 레코드를 확인하고 2시간 기다렸다가 다시 확인하세요.
Cloudflare는 A 레코드가 Bubble의 IP를 가리키고 있는지 확인해야 합니다. A 레코드가 올바르다고 확신한다면 Cloudflare는 여러 일(1분 간격에서 시작하여 최대 2시간 간격으로 증가) 동안 레코드를 재확인하도록 예약합니다. 2시간 후에도 사이트에 1001 오류가 표시되면 Bubble로 이동하여 사용자 정의 도메인을 삭제하고 1분 기다렸다가 다시 만드세요.
Q. 사이트에서 1014 오류가 발생하고 있습니다!
A. DNS에 Cloudflare를 사용 중인 경우 프록시 설정을 해제하세요.
1014 오류가 발생하는 가장 일반적인 원인은 Cloudflare를 DNS에 사용하고 '오렌지 클라우드'(프록시) 설정을 사용하는 경우입니다. 프록시 설정을 해제하려면 오렌지 클라우드를 클릭하세요(회색 클라우드로 변경).
Q. 여기에 답이 없는 Cloudflare 전환 후 다른 문제가 발생하고 있습니다. 어떻게 해야 하나요?
A. 그것은 상황에 따라 다릅니다.
포럼에서 동일한 문제를 겪은 다른 사용자가 있는지 확인하세요.
여기나 저기서 답을 찾을 수 없다면 버그 보고서를 제출하세요.
