근처로 보내기
무엇인가
같은 와이파이(같은 공유기)에 있는 다른 나눔OS 컴퓨터나 휴대폰으로 파일을 바로 건네는 기능입니다. 옆 사람에게 종이를 손으로 건네는 것과 같습니다 — 우리 서버나 인터넷을 거치지 않고, 같은 집·같은 사무실 안에서만 오갑니다. 받는 쪽은 늘 무엇을·얼마나 보내려는지 먼저 보고 [받기] 를 눌러야 받습니다. 받은 파일은 다운로드 폴더에만 들어갑니다.
지금 할 일: 받을 컴퓨터에서 받기를 켜고(10분), 보낼 컴퓨터에서 그 기기를 고르세요.
어떻게 쓰나
나눔OS 끼리
- 받는 쪽: 터미널에서
nearby on— 10분 동안 「모두에게서 받기」가 켜집니다. 10분이 지나면 저절로 꺼집니다. - 보내는 쪽:
nearby scan으로 받기를 켠 기기를 찾고,nearby send 그기기이름 파일이나폴더…(네 개까지, 폴더째 됩니다). - 두 화면에 같은 여섯 자리 숫자가 보입니다. 숫자가 같으면 받는 쪽에서
nearby accept 번호, 아니면nearby reject 번호. - 보내는 쪽에 10% 마다 진행이 보이고, 끝나면 받는 쪽 다운로드에 같은 이름으로 들어갑니다. 이름이 겹치면 「이름 2.txt」처럼 됩니다.
휴대폰·아무 브라우저로 (QR 로 보내기)
nearby qr send 파일— 화면에 QR 코드와 짧은 주소가 나옵니다.- 같은 와이파이의 휴대폰 카메라로 QR 을 비추고 열면 받기 단추가 있습니다. 폴더나 여러 개는 zip 하나로 받습니다.
- 링크는 한 번 받으면 끝나고, 받지 않아도 10분 뒤 끝납니다.
휴대폰에서 나눔OS 로 (QR 로 받기)
nearby qr recv— QR 이 나옵니다. 휴대폰으로 열면 「파일 고르기 · 보내기」 화면입니다.- 휴대폰에서 사진을 고르고 보내면 나눔OS 에 크기와 이름이 먼저 보입니다.
nearby accept 번호를 해야 다운로드에 들어갑니다.
맥·리눅스 컴퓨터와
따로 설치할 것은 없습니다. 맥·리눅스의 브라우저로 같은 QR 주소를 열면 됩니다(위 두 가지와 같습니다). 나눔OS 가 그 컴퓨터에 먼저 접속하지는 않습니다 — 늘 그쪽이 링크를 엽니다.
설정
nearby— 지금 상태(이 기기 이름, 받기 끔/켬, 남은 시간).nearby name 이름— 다른 기기에 보이는 이름(기본은 컴퓨터 이름).nearby mode known— 전에 한 번 받아 준 기기만, 늘 받기 대기. 그래도 매번 [받기]를 눌러야 합니다.nearby mode off가 기본.nearby off— 바로 끄기.nearby qr stop— 띄운 QR 링크를 모두 끝내기.
아직 안 되는 것: 데스크톱 화면(파일 앱의 「근처로 보내기…」, 받기 카드, 설정 › 공유)과 비서의 「근처로 보내 줘」는 다음 판입니다. 다른 와이파이에 있는 내 기기로 보내기(Wire 를 거쳐)도 다음입니다. 끊기면 처음부터 다시 보냅니다(이어 보내기 없음).
기술 자세히
- 보내기: TCP 47761. 매번 새 X25519 열쇠를 주고받고, HKDF-SHA256 으로 방향별 열쇠 둘과 여섯 자리 숫자를 만듭니다(두 화면이 같으면 가운데 끼어든 이가 없음). 모든 자료는 ChaCha20-Poly1305 로 봉인된 32 KiB 토막이며, 파일마다 SHA-256 을 끝에 맞춰 봅니다. 하나라도 어긋나면 받은 것을 모두 지웁니다.
- QR: HTTP 47762, 10글자 1회용 표(base32), 10분. 틀린 표·끝난 표는 403, 한 주소에서 틀린 표 8번이면 1분 동안 429. 올리기는 Content-Length 가 남은 자리보다 크면 413.
- 사설 주소(10/8, 172.16/12, 192.168/16, 169.254/16, 100.64/10)에서 온 것만 받습니다. 받은 이름은 마지막 조각만 쓰고
..·/·제어 글자는 걸러, 다운로드 밖으로 나갈 수 없습니다. - 기록:
/var/log/messages에 이름·크기·주소만, 파일 내용은 남기지 않습니다. 파일 하나 256 MiB 까지(RAM 파일 한도). - 계약:
docs/contracts/NEARBY.md, 시험:tests/nearby.py(두 손님 VM),tests/test_nearby_core.py.
NanumOS 0.1.8349 · 2026-11-16