데스크톱 수신기

시작하기 전에

Windows 또는 Linux 컴퓨터가 필요해요. 수신하는 동안 계속 켜져 있어야 해요. 사업자 로그인과 현장 모드에는 Business 요금제가 필요해요. 개인 모드는 내 휴대폰의 페어링 링크로 페어링하며, 계정이 필요 없어요.

단계

• 다운로드 페이지에서 Windows 설치 프로그램(NSIS)이나 Linux AppImage 또는 deb를 내려받고, 바로 옆에 게시된 SHA-256 값을 확인하세요. 지금은 빌드에 서명이 없어서 운영 체제가 한 번 경고를 띄울 수 있어요. Windows에서는 SmartScreen이 “Windows의 PC 보호”라고 보여 주니, “추가 정보”를 누른 다음 “실행”을 누르세요. 설치 프로그램은 관리자 권한을 한 번 요청하고, 컴퓨터의 모든 사용자를 위해 설치하며, 개인, 공용, 도메인 네트워크에서 이 앱을 위해 방화벽을 열어요. Ubuntu 24.04에서는 AppImage를 --no-sandbox로 실행하기 전에는(./WhispShare-Receiver-…AppImage --no-sandbox) 시작되지 않아요. Ubuntu 24.04가 Chromium에 필요한 샌드박스를 제한하기 때문이에요. deb 패키지는 이 설정을 알아서 해 주어 그대로 정상 실행돼요.
• 이 컴퓨터가 받는 방식을 고르세요. 사업자 로그인(소유자가 브라우저에서 승인하는 8자리 기기 코드), 개인 모드(「내 휴대폰과 페어링」, 내 휴대폰의 페어링 링크 사용), 또는 현장 전용(인터넷이 없는 이 Wi-Fi의 방문 손님용) 중 하나예요. 개인 모드에서는 브라우저가 열려 있지 않아도 이 컴퓨터가 휴대폰에서 오는 파일을 계속 받아요. 휴대폰에서 WhispShare를 열고 페어를 시작한 뒤, 페어링 링크를 이 컴퓨터로 보내세요(이메일이나 나에게 보내는 메모로). 「내 휴대폰과 페어링」 화면에 붙여 넣고 「내 휴대폰과 페어링」을 누르세요(무언가 페어링되기 전까지 트레이 메뉴에도 같은 항목이 있어요). 파일을 보내는 동안에는 휴대폰과 컴퓨터가 모두 온라인이어야 해요. 이 컴퓨터는 휴대폰이 시작한 페어의 반대편으로 기다려요. 자체 QR 코드는 표시하지 않아요.
• 저장 폴더를 고르세요. 세션마다 자기 폴더에 저장돼요: <저장 폴더>/<연-월>/<링크 라벨, 룸 이름 또는 “Direct”>/<날짜와 시간> <보내는 사람 이름 또는 “Visitor”> <세션 코드 끝 4자>/. 각 파일 옆에는 사이드카 파일 <파일>.whispshare.json이 만들어져요. 사이드카에는 세션, 보내는 사람의 이름과 기기, 링크와 그 라벨, 보낸 대로의 파일 이름과 저장된 파일 이름, 크기, 형식, SHA-256이 기록되고, 전송이 끝나면 검증된 세그먼트 해시도 더해져요. 보내는 사람이 보낸 텍스트와 카드는 사이드카에 들어가지 않아요. 수신기가 일일 로그(저장 폴더의 received-<date>.jsonl)에 보관해요.
• 수신기는 계속 실행해 두세요. 트레이에 있고, 컴퓨터를 켤 때 함께 시작할 수 있어요. 트레이 메뉴에는 수신기가 지금 무엇을 하는지 글로 나와요(휴대폰에서 받는 중, 비즈니스를 위해 받는 중, 일시 중지됨, 오프라인, 관리자 받은편지함 키를 기다리는 중, 아직 페어링되지 않음). 그리고 항상 「저장 폴더 변경」과 「저장 폴더 열기」를 보여줘요. 같은 두 버튼은 창 아래쪽에도 있어요. 수신기는 컴퓨터의 언어를 따르고(영어, 아랍어, 독일어, 스페인어, 프랑스어, 히브리어, 이탈리아어, 일본어, 한국어, 네덜란드어, 폴란드어, 브라질 포르투갈어, 루마니아어, 터키어, 중국어), 트레이 메뉴나 설정에서 다른 언어를 고를 수도 있어요.
• 룸의 공유를 모으려면 “룸 참여”를 사용하세요. 수신기는 룸에 받기 전용으로 들어가 멤버가 공유한 것을 저장해요.
• 이 컴퓨터의 수신을 멈추려면, 비즈니스 설정에서 수신기를 취소하거나, 컴퓨터 자체의 설정에서 「이 기기 페어링 해제」를 선택하세요. 페어링을 해제하면 서버에서 수신기의 자리가 수신기 자신의 기기 토큰으로 풀리고, 그다음 컴퓨터에서 토큰, 페어링, 룸, 받은편지함 키가 지워져요. 서버에 연결할 수 없으면 컴퓨터는 페어링이 해제되지만, 창에는 서버가 해제를 확인하지 않았다고 표시돼요. 그때는 관리자에게 비즈니스 콘솔에서 수신기를 제거해 달라고 요청하세요. 그렇지 않으면 그 자리는 계속 차지된 것으로 세어져요.

키가 보관되는 곳

수신기의 신원과 받은 편지함 키는 수신기 상태 폴더에 있는 키로 암호화돼요. 데스크톱 앱은 그 키를 운영체제의 보안 저장소(Windows 자격 증명 관리자의 DPAPI, macOS 키체인, 또는 libsecret이나 KWallet을 통한 Linux 키링)에 보관해요. 이 키는 운영체제의 키 저장소를 통해 이 컴퓨터와 이 사용자 계정에 묶여 있어요. 그래서 백업, 동기화 클라이언트, 디스크 이미지에서 가져온 상태 폴더 사본에는 키가 함께 들어가지 않아요. About 화면에서 키가 어떻게 저장되는지 확인할 수 있어요. 키링이 없는 Linux 컴퓨터에서는 키가 보호된 파일(모드 0600)에 저장되며, About 화면에 그렇게 표시돼요. 보호하려면 gnome-keyring 또는 KWallet을 설치하세요. 로그인 직후 키링이 아직 잠겨 있으면 수신기는 약 30초 동안 기다려요. 나중에 키를 열 수 없으면(키링이나 계정이 초기화된 경우) 종료하거나 다시 페어링할지 제안해요. 새 키를 몰래 만드는 일은 절대 없어요. 헤드리스 수신기(whispshare-receiver)에는 운영체제 키 저장소가 없으므로, 상태 폴더(<folder>/.whispshare/) 자체가 키예요. 그 폴더를 복사할 수 있는 사람은 수신기가 읽는 내용을 읽을 수 있어요. 이 폴더는 백업, 동기화 클라이언트, 공유 드라이브에서 제외하고 서비스 계정만 읽을 수 있게 하세요(모드 0700). 수신기를 다른 컴퓨터로 옮기려면 새 수신기를 페어링하세요. whispshare-receiver --help에도 같은 내용이 있어요.

상대가 보는 것

수신기가 켜져 있는 동안 고객에게는 비즈니스가 “지금 수신 중”으로 보여요. 고객은 요청 카드 한 장으로 초인종을 누르고, 사람이나 근무 중인 기기가 확정한 뒤에야 파일을 실시간으로 보낼 수 있어요. 수신기 자체는 누구도 룸에 들이지 않고 룸 허용도 보내지 않아요. 저장만 해요. “수신 일시중지”를 쓰면 초인종, 룸, 개인 페어링이 한꺼번에 닫혀요. 이미 진행 중인 전송은 끝까지 가고, 새 제안은 다시 시작할 때까지 기다려요.

문제가 생기면

꺼진 수신기는 받지 않아요. 링크 페이지에도 그렇게 보이고, 기다릴 수 있는 것은 요청 카드 한 장뿐이에요. 현장 모드에서는 손님의 브라우저에 로컬 주소에 대한 인증서 경고가 떠요. 인터넷이 없는 네트워크에서는 그 경고가 정상이니, 그렇다고 솔직하게 알려 주고 손님에게 장소 카드를 보여 주어 서로 비교하게 하세요. 저장 폴더가 가득 차거나 옮겨지면 새 폴더를 고르고 다시 받으세요. 남은 공간보다 큰 전송은 시작되기 전에 거절돼요. 휴대폰에서 현장 주소에 닿지 않으면 현장 패널을 여세요. 패널에는 Windows가 이 컴퓨터를 둔 네트워크가 보이고, 방화벽 규칙이 없거나 그 네트워크를 포함하지 않으면 그렇다고 알려 줘요(Windows 프롬프트에서 “공용 네트워크”를 선택하거나, 모든 사용자용으로 다시 설치하세요). 컴퓨터에 주소가 여러 개일 때(Wi-Fi, VPN, WSL 또는 Docker)는 거기서 QR 코드에 쓸 Wi-Fi 주소를 고르세요. 문제를 알리려면 설정, 정보, 진단 정보 복사 순서로 열어 그 텍스트를 메시지에 붙여 넣으세요. 버전, 상태, 개수만 담겨 있고 파일 이름, 키, 주소는 들어 있지 않아요. 수신기는 같은 종류의 작은 순환 로그도 운영 체제의 로그 폴더에 남겨요.

한도

수신기는 실시간 전송의 크기 상한을 높여요. 개인 모드는 2 GiB, Away는 20 GiB, Business는 50 GiB이고, 브라우저는 2 GiB, iPhone은 1 GiB 그대로예요. 확정된 세션에는 템플릿 상한이 계속 적용돼요. 문서는 파일 10개와 50 MB까지, 확인은 파일 하나와 500 MB까지예요. 링크가 자체 상한을 정한 경우는 예외예요. 수신기는 하루에 한 번 새 버전을 확인하고 배너를 보여 줘요. 다운로드 페이지에서 직접 내려받아 설치하세요. 헤드리스 수신기(whispshare-receiver)는 받은 파일마다 로컬 웹훅으로 POST를 보낼 수 있어요. 이 컴퓨터나 사무실 네트워크에서만 쓰세요. POST에는 저장된 경로, 파일, 보낸 사람이 들어 있어요. 시크릿(--webhook-secret)을 설정하면 POST에 HMAC 서명이 붙고, 실패한 POST는 세 번 다시 시도돼요.

관련 항목

• Business: 공유 수신함
• 다운로드
• 인터넷 없이 공유하기