Wire — 내 기기들을 잇는 망
무엇인가
Wire 는 내 기기들(노트북·휴대폰·서버·NAS)을 어디에 있든 한 집 안에 있는 것처럼 이어 주는 나만의 망입니다. 비유하면 기기마다 같은 건물의 호수가 하나씩 붙은 것과 같습니다. 카페에 있든 집에 있든 「거실 컴퓨터」라고 이름만 부르면 그 방 문이 열립니다. 다른 사람은 이 건물에 들어올 수 없습니다. 내가(또는 망을 운영하는 사람이) 허락한 기기만 들어옵니다.
지금 할 일: 이미 망이 있으면 Wire 앱의 「이미 있는 내 망에 들어가기」를 누르세요. 아직 없으면 지금은 안 해도 됩니다 — 나눔OS 는 Wire 없이도 다 쓸 수 있습니다.
기초 — 사설망, 와이어가드, 세 가지 역할
사설망이란. 인터넷은 큰 도시이고, 기기는 저마다 다른 동네의 집입니다. 사설망은 그 집들 사이에 나만 쓰는 지하 통로를 놓아서, 멀리 있어도 옆집처럼 문을 두드릴 수 있게 하는 것입니다. 통로 안의 말은 모두 잠겨 있어서 길 중간에서는 읽을 수 없습니다.
와이어가드(WireGuard)란. 그 통로를 잠그는 요즘의 표준 방식입니다. 기기마다 열쇠 한 쌍(공개 열쇠·비공개 열쇠)을 만들고, 서로 공개 열쇠만 바꾸면 둘 사이에 암호 통로가 열립니다. 규칙이 적고 코드가 작아서 빠르고 점검하기 쉽습니다. 나눔OS 의 Wire 는 이 와이어가드를 그대로 말합니다 — 다른 기기의 와이어가드와 악수·전송 시험으로 맞춰 봅니다. 열쇠를 서로 바꾸는 일을 사람이 손으로 하면 기기가 늘수록 힘들기 때문에, 그 일을 맡는 안내소가 따로 있습니다.
세 가지 역할과, 각각이 왜 있는가.
- 안내소(조정 서버). 「누가 어느 이름이고, 열쇠가 무엇이고, 지금 어디 있나」를 아는 전화번호부이자 접수창구입니다. 새 기기가 들어올 때 허락을 확인하고, 기기마다 이름·주소·공개 열쇠를 알려 줍니다. 모든 기기가 찾아올 수 있어야 하므로 늘 켜져 있고 어디서나 닿는 컴퓨터(예: 작은 임대 서버 VPS)가 필요합니다. 안내소는 이름·공개 열쇠·허락 기록만 알고 내 자료는 보지도, 지나가지도 않습니다.
- 중계(릴레이). 두 기기가 모두 집 공유기(NAT) 뒤에 있으면 서로 상대 문을 찾지 못할 때가 있습니다. 그때만 공인 주소가 있는 기기가 우체국처럼 이미 잠긴 덩어리를 그대로 전달해 줍니다. 열 수 없으므로 내용은 모릅니다.
- 직접 연결. 기본은 기기끼리 바로 이어지는 것입니다. 안내소가 서로의 바깥 주소를 알려 주고 양쪽이 동시에 문을 두드려 공유기에 길을 뚫습니다(구멍 뚫기). 되면 가장 빠르고, 안 될 때만 중계를 탑니다.
널리 쓰이는 같은 꼴의 서비스
쓰는 법
우리 Wire 는 서비스가 아니라 도구입니다. 누구에게도 맡기지 않고, 각자 늘 켜 둔 리눅스 컴퓨터(또는 임대 서버) 한 대에서 wire init 한 줄로 자기 안내소를 만듭니다. 주인(만든 사람)의 안내소는 주인과 초대받은 사람을 위한 것입니다. 호스팅 서비스는 없습니다.
화면은 두 곳에서 같은 모습입니다 — Wire 앱, 그리고 설정 › Wire. 화면 위 메뉴줄의 Wire 아이콘에서는 켜고 끄기와 내 기기 목록을 바로 봅니다.
- 맨 위 — 큰 「연결 / 끊기」 스위치와 「연결됨 · 10.98.x.x」. 끊어도 망에서 나가는 것이 아니라 잠시 빠지는 것이고, 다시 켜면 그대로 돌아옵니다.
- 내 기기 — 기기마다 상태 점(켜짐·꺼짐)과 「n분 전」, 이름, 운영체제 그림, 주소(누르면 복사), 「이 기기」 표시, 「직접 / 중계」 배지가 보입니다. 기기를 누르면 화면 보기(원격 화면) · 터미널(ssh) · 파일 보내기 · 주소 복사가 나옵니다.
- 이미 있는 내 망에 들어가기 — 안내소 주소를 넣고(이 이미지에 기본값이 있으면 미리 채워져 있음) 누르면 QR 그림과 8글자 코드, 남은 시간이 나옵니다. 망 주인이 자기 휴대폰에서 QR 로 열어 패스키로 허락하면 「들어왔어요 — 10.98.x.x」로 바뀝니다. 초대 열쇠를 붙여 넣을 필요가 없고, 코드가 휴대폰 화면과 같은지 눈으로 맞춰 보면 됩니다. 터미널이면
wire join http://주소:포트. - 새 망 만들기 — 안내소가 없는 사람을 위한 설명입니다. 늘 켜 둘 리눅스 컴퓨터에서
wire init한 줄(복사 버튼)을 실행하면 됩니다. - 기기 추가 — 이 기기가 이미 망에 들어와 있을 때, 다른 기기가 들어오는 방법(
wire up --server …한 줄과 그 QR)을 보여 줍니다. - 이 기기를 망에서 빼기 — 확인 창이 먼저 뜹니다(취소가 기본). 빼면 이 기기는 열쇠를 잊고, 다시 들어오려면 허락을 새로 받아야 합니다.
- 비서에게 말하기 — 「Wire 켜졌어?」(상태), 「내 망에 들어가게 해 줘」(QR 카드를 보여 줌; 허락은 주인이 휴대폰에서 합니다), 「망에서 나가」(확인 카드가 뜸).
- 근처로 보내기 — 같은 망의 기기로 파일을 보내는 길입니다. 아직 이 판에는 없고, 그때까지는 Wire 가 이어 준 이름으로
scp를 쓰면 됩니다.
점검 화면(os_check)의 「Wire 망」 칸이 켜짐·내 주소·안내소 상태·기기 수를 보여 줍니다.
작동 원리
한 기기가 들어오는 순서.
- 이 기기가 열쇠 한 쌍을 만듭니다(비공개 열쇠는 기기를 떠나지 않음).
- 안내소에 「들어가고 싶어요」를 보냅니다. 안내소는 QR 주소와 8글자 코드를 돌려줍니다.
- 주인이 휴대폰으로 QR 을 열고 코드가 같은지 확인한 뒤 패스키로 허락합니다.
- 안내소가 이 기기의 이름·주소·공개 열쇠를 등록하고, 이 기기는 다른 기기들의 목록을 받습니다.
- 두 기기가 바로 이어지는 길을 시도하고, 안 되면 중계를 거칩니다. 30초마다 목록을 다시 받습니다.
왜 이렇게 만들었나.
- 안내소는 길만 알려 줍니다. 길 안내인이 여행자의 짐을 들지 않는 것과 같습니다. 내 자료는 기기와 기기 사이로만 다니고 안내소를 지나가지 않으므로, 안내소가 해킹되어도 내용은 새지 않고 안내소가 느려도 전송이 느려지지 않습니다.
- 한 번 이어 두면 상대 주소와 열쇠를 기기가 기억하므로 안내소가 잠깐 꺼져도 이미 이어진 기기끼리는 계속 됩니다. 새 기기 들이기와 바뀐 주소 알아내기만 멈춥니다. 이 말은 시험으로 잽니다 —
tests/wire_coorddown.py가 안내소 프로그램만 끄고 기기 사이 핑이 60초마다 2/3 이상 답하는지, 꺼진 동안 새 가입은 분명한 말로 실패하고 아무것도 바꾸지 않는지, 안내소를 같은 자료 폴더로 다시 켜면 오류 표시가 사라지는지 잽니다. - 각자 자기 안내소를 운영하므로 남의 서비스에 계정이 없어도 되고, 서비스가 사라져도 내 망은 남습니다.
- 와이어가드는 짧은 규칙이라 나눔OS 커널 안에서 직접 말합니다. 안내소와 말하는 규약은 Go 로 만든 Wire 본체의 일부(부분집합)만 나눔OS 가 지원합니다 — 오늘 되는 것은 아래 「기술 자세히」에 적었습니다.
더 알아볼 것. 같은 와이어가드 기기끼리라도 안내소가 없으면 열쇠를 손으로 바꿔야 합니다(wg·wg-quick 으로 직접 할 수도 있음). 안내소는 그 번거로움을 대신 맡을 뿐 더 안전하게 만들지는 않습니다.
안내소·우회로·열쇠 — 한눈에
- 조정 서버(안내소): 「누가 어디에 있나」를 아는 곳입니다. 새 기기가 들어올 때 허락을 확인하고, 기기마다 이름·주소·열쇠(공개 열쇠)를 알려 줍니다. 30초마다 목록을 갱신합니다. 내 데이터는 지나가지 않습니다. 꺼져도 이미 이어진 기기끼리는 계속 됩니다 — 못 하는 것은 새 가입과 바뀐 주소 알아내기뿐입니다.
- 중계 서버(우회로): 두 기기가 서로 바로 닿는 길이 안 뚫릴 때만 거치는 길입니다. 공인 주소가 있는 기기가 맡습니다. 중계가 꺼지면 그 길로 가던 기기만 끊기고, 바로 이어진 기기끼리는 영향이 없습니다.
- 직접 연결이 기본, 중계는 마지막 수단. 집 공유기 뒤의 두 기기는 안내소가 서로의 바깥 주소를 알려 주고 동시에 문을 두드려 길을 뚫습니다(구멍 뚫기). 통신사 공유 주소나 주소를 매번 바꾸는 공유기(대칭형)는 어려워서 우회로를 탑니다. 가까운 곳에 중계를 두면 빠릅니다(멀면 왕복이 길어짐).
- 열쇠와 개인 정보. 비공개 열쇠는 기기를 떠나지 않습니다(
/etc/wire/config, 관리자만 읽음). 안내소는 공개 열쇠와 이름·주소만 압니다. 중계 서버는 이미 암호화된 덩어리만 전달하므로 내용을 읽을 수 없습니다. 비서도 열쇠나 상대의 바깥 주소는 보지 못하고 연결 방식(직접/중계)과 시간만 봅니다. - 기기마다 「직접」, 「중계(어느 기기 경유)」, 「길 없음」 중 하나입니다. 길 없음이면 그 기기가 꺼져 있거나 공인 주소·열린 포트가 없어 닿을 중계가 없는 것입니다.
직접 해 보기
- Wire 앱을 열고 기기 두 대 이상이 「켜짐」인 망에 들어가 봅니다(위 3번).
- 「내 기기」에서 기기마다 직접 / 중계 배지를 봅니다. 같은 집 와이파이의 기기는 직접으로 뜹니다.
- 한 기기를 휴대폰 데이터(집 밖)로 바꾸면 얼마 뒤 배지가 바뀌는지 봅니다. 중계로 바뀌면 왕복 시간이 조금 늘 수 있습니다.
- 기기를 눌러 「터미널」을 고르고, 나온 창에서
ping 이름을 쳐 봅니다.
기술 자세히
- 프로토콜: WireGuard 호환(Noise_IKpsk2, X25519·ChaCha20-Poly1305·BLAKE2s). 나눔OS 는 커널 안에
wire0로 가집니다(다른 WireGuard 구현과 악수·전송 시험으로 맞춰 봄). 망 주소는 사설 주소 대역의 하나(wire status에 보임), MSS 1380, 연결 유지 25초. - 포트: 안내소 TCP 8790(기본, 설정으로 바뀜, 지금 판은 일반 HTTP 만) · 노드·중계 UDP 51820(기본; 나눔OS 노드는 가입 때 받은 포트).
- 안내소 규약(나눔OS 가 지원하는 부분): 쉬운 가입
/join/start·/join/poll(패스키 허락, 10분 만료), 서명된/register(Ed25519),/peers30초마다(실패하면 10초 뒤), 이름 등록. 기기마다 끝점(바깥·같은 공유기·열어 둔 포트)을 보고 직접/중계를 고름. 아직 없는 것: 구멍 뚫기를 나눔OS 쪽에서 먼저 하기, 포트 자동 열기, 접근 규칙(ACL), 경로 알리기, 출구 노드, 열쇠 갈이 명령, TLS. 휴대폰·리눅스 노드는 구멍을 뚫습니다. - 파일·명령:
/etc/wire/config(root 0600),/etc/hosts의# wire-managed블록(이름 → 주소),wire status|join|up|down|leave|ssh-config,wg·wg-quick(안내소 없이 손으로 WireGuard),/proc/wire(상태·숫자, 열쇠 없음; 망 모드는coord=,sync_age_s=,sync_error=,peer.N=이름 주소 direct|relay|none 경유 마지막연결초 왕복ms; 가입 중에는join=,join_url,join_code,join_left_s,join_error, 꺼졌을 때joined=,default_server). - 비서 도구:
wire_status(읽기 전용) ·wire_join(QR 카드, 승인 카드 없음) ·wire_leave(확인 카드) · os_check 「Wire 망」 칸 · 설명은 os_help. - 한계: 한 번에 한 터널(
wire와wg-quick은 동시에 못 켬), 한 번에 한 망. 부팅 때 자동 켜기는/etc/wire/config의auto 1.
NanumOS 0.1.8349 · 2026-11-16