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

Screenbird 자체는 443 포트의 HTTPS와 WebSocket Secure만 사용합니다. 통제가 엄격한 네트워크라면 아래 도메인을 허용 목록에 추가하세요. 대시보드용 목록과 스크린(플레이어)용 목록으로 나누어져 있습니다. Amazon Signage Stick이나 Fire TV를 사용한다면 'Amazon 기기의 시간 동기화' 항목도 확인하세요. 이 기기들은 별도의 추가 연결이 필요합니다.

어떤 경우에 필요합니까?

가정이나 사무실의 일반적인 네트워크에서는 별도 설정 없이 바로 작동합니다. 이 목록은 알 수 없는 도메인을 차단하는 네트워크, 프록시나 웹 필터를 사용하는 네트워크, 스크린이 인터넷 접근이 제한된 별도 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)를 사용합니다

Screenbird 자체는 그 밖의 포트를 사용하지 않습니다. 다만 Amazon Signage Stick이나 Fire TV는 시계를 맞추기 위해 추가 연결(UDP 123 포트와 TCP 80 포트)이 필요합니다. 아래 항목을 참고하세요.

Amazon 기기의 시간 동기화

이 항목은 Amazon Signage Stick과 Fire TV에만 해당합니다. Samsung, LG, Android TV, PC, Mac, Raspberry Pi를 사용한다면 건너뛰어도 됩니다.

이 기기들에는 전원이 꺼져도 계속 작동하는 시계가 없습니다. 부팅할 때 인터넷에서 시간을 가져오는데, 이 과정이 실패하면 몇 주에서 몇 달 전 날짜로 부팅됩니다. 날짜가 잘못되면 모든 보안 연결이 거부되므로, 포트 443이 완전히 열려 있고 모든 도메인이 허용 목록에 있어도 스크린은 오프라인 상태로 남습니다.

그러므로 다음 연결을 허용하세요.

ftv-smp.ntp-fireos.com(UDP, 123 포트): 시간을 가져옵니다. 이 이름은 time.aws.com으로 연결됩니다. 방화벽이 DNS 이름으로 허용 목록을 관리한다면 둘 다 허용하세요
firetvcaptiveportal.com, fireoscaptiveportal.com, kindle-time.amazon.com(TCP, 80 포트, 가로채지 않아야 함): 네트워크 확인과, 시간을 가져오는 대체 수단입니다

UDP 123이 열려 있어도 80 포트는 반드시 필요합니다. 기기는 확인을 마친 네트워크에서만 시간을 설정하는데, 그 확인 자체가 80 포트로 보내는 요청이기 때문입니다. 아웃바운드 80 포트가 차단되어 있으면 UDP 123에서 어떤 일이 일어나든 시계는 설정되지 않습니다.

기기는 네트워크에 연결할 때마다 다시 시도하고, 그 이후에는 7일에 한 번만 시도합니다. 첫 시도를 놓친 스크린은 오랫동안 잘못된 날짜로 남아 있을 수 있습니다. 방화벽을 고친 뒤에는 기기를 다시 시작하거나 네트워크에 다시 연결해 새로운 시도가 이루어지게 하세요.

주의할 점:

기기는 고정된 주소를 사용하며 네트워크가 제공하는 시간 서버를 받아들이지 않으므로, 자체 시간 서버를 지정해도 소용없습니다.
80 포트의 트래픽을 가로채면 안 됩니다. 요청을 인터넷으로 그대로 전달하는 투명 프록시는 괜찮습니다. 차단 페이지 등으로 직접 응답하는 프록시나 웹 필터는 시계를 그 프록시 자신의 시간으로 설정해 버리며, 이는 그 프록시의 시계가 맞을 때만 정확합니다. 오래된 응답을 다시 보내는 캐시는 오래된 시간을 설정할 수 있습니다.
로그인 페이지(캡티브 포털)가 없는 네트워크를 사용하세요. 로그인 페이지가 있는 네트워크에서는 기기가 한 번만 시도하고 결과를 저장하지 않으므로, 포털을 통과하기 전까지는 시계를 신뢰할 수 없습니다. 많은 게스트 네트워크가 바로 이렇게 동작합니다.

기기에 분명히 인터넷이 연결되어 있는데도 스크린이 페어링된 상태로 오프라인이라면, 가장 먼저 여기를 확인하세요.

대역폭

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

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

네트워크 확인 방법

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

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

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

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

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

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

대규모 도입 지원

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