네트워크 요구 사항과 방화벽 설정

Screenbird는 443 포트의 HTTPS와 WebSocket Secure만 사용하며 다른 포트는 사용하지 않습니다. 통제가 엄격한 네트워크라면 아래 도메인을 허용 목록에 추가하세요. 대시보드용 목록과 스크린(플레이어)용 목록으로 나누어 정리했습니다.

어떤 경우에 필요합니까?

가정이나 사무실의 일반적인 네트워크에서는 별도 설정 없이 바로 작동합니다. 이 목록은 알 수 없는 도메인을 차단하는 네트워크, 프록시나 웹 필터를 사용하는 네트워크, 스크린이 인터넷 접근이 제한된 별도 VLAN에 연결된 경우에 필요합니다.

대시보드용 도메인

팀원이 콘텐츠를 관리하는 컴퓨터에서 필요합니다.

  • screenbird.app: 대시보드 자체
  • dev.screenbird.app: 스테이징 환경이며, 팀에서 사용할 때만 필요
  • *.supabase.co: 데이터베이스와 로그인, WebSocket 통신 포함
  • cdn.screenbird.app: 파일, 이미지, 동영상, 사용자 글꼴
  • integrations.screenbird.app: 대시보드 안의 앱 미리보기
  • lh3.googleusercontent.com, avatars.githubusercontent.com: 연결된 계정의 프로필 사진
  • challenges.cloudflare.com: 로그인과 가입 시의 보안 확인
  • wss://api.screenbird.app: 대시보드와 스크린 사이의 실시간 업데이트
  • js.stripe.com, *.js.stripe.com: 가입 및 구독 변경 시의 결제 창
  • api.stripe.com, hooks.stripe.com: 3D Secure를 포함한 결제 처리
  • m.stripe.com, m.stripe.network: Stripe의 부정 결제 확인

특정 기능을 쓸 때만 필요합니다.

  • apis.google.com, docs.google.com: Google Drive, 문서, 스프레드시트, 프레젠테이션 선택 창
  • images.pexels.com: 스톡 사진 라이브러리
  • api.qrserver.com: 디자인 템플릿의 QR 코드
  • geocoding-api.open-meteo.com: 날씨 앱의 지역 검색

스크린용 도메인

플레이어가 실행되는 모든 기기에서 필요합니다.

  • player.screenbird.app: 플레이어 자체
  • api.screenbird.app: 페어링, 하트비트, 콘텐츠 가져오기, WebSocket 통신 포함
  • cdn.screenbird.app: 스크린이 재생하는 콘텐츠
  • media.screenbird.app: 앱 설치 파일과 업데이트
  • integrations.screenbird.app: 모든 앱과 디자인이 실행되는 환경
  • mirror.screenbird.app: 화면 공유를 쓸 때만 필요하며 WebSocket 통신 포함
  • fonts.googleapis.com, fonts.gstatic.com: 앱과 디자인에서 쓰는 글꼴

특정 앱을 쓸 때만 필요합니다.

  • www.youtube.com, player.vimeo.com: 동영상 앱

사용하지 않는 연결이나 앱이 있다면 해당 도메인은 허용하지 않아도 됩니다.

포트와 프로토콜

  • 모든 통신은 443 포트의 HTTPS를 사용합니다
  • 대시보드와 스크린 사이의 실시간 업데이트는 같은 443 포트에서 WebSocket Secure(WSS)를 사용합니다

그 밖의 포트는 사용하지 않습니다.

대역폭

필요한 대역폭은 콘텐츠 용량에 따라 달라집니다. 스크린은 파일을 한 번만 내려받고 그다음부터는 기기에 저장된 파일을 재생하므로, 내려받은 뒤에는 통신량이 거의 없습니다. 대기 상태에서는 60 초에 한 번씩 하트비트를 보내 연결만 유지합니다. WebSocket이 작동하지 않는 경우에도 스크린은 한 시간마다 콘텐츠를 가져옵니다. 라이브 스트리밍과 새로운 데이터를 계속 가져오는 앱은 소스에 따라 대역폭을 계속 사용합니다.

짧은 네트워크 장애는 재생에 영향을 주지 않습니다. 이미 내려받은 콘텐츠는 그대로 재생됩니다.

네트워크 확인 방법

기기에서 브라우저를 열고 다음 주소로 접속해 보세요.

  • https://player.screenbird.app: 페어링 코드가 표시된 페어링 화면이 나타나야 합니다
  • https://screenbird.app: 대시보드 로그인 페이지가 나타나야 합니다

둘 중 하나라도 열리지 않으면 방화벽 로그에서 위 도메인 가운데 무엇이 차단되었는지 확인하세요.

데이터는 어디에 저장됩니까?

  • 데이터베이스는 파리에 있는 Supabase에서 운영됩니다(eu-west-3 리전).
  • 외부 백업은 암스테르담에 있는 Backblaze에 보관됩니다(eu-central-003 리전).
  • 대시보드와 앱, 파일은 전 세계 엣지 로케이션에서 운영되는 Cloudflare 네트워크를 통해 전달됩니다.

수탁 처리자 전체 목록과 보관 기간은 screenbird.app의 개인정보처리방침에 정리되어 있습니다.

대규모 도입 지원

사내 네트워크에 스크린을 많이 설치할 예정이고 IT 부서에 전달할 문서가 필요하다면 support@screenbird.app으로 메일을 보내 주세요.

관련 문서

© screenbird.app