Seal

피어 투 피어, 종단 간 암호화 채팅.
받은 편지함 없음. 복구할 계정 없음. 아무도 듣지 않습니다 — 우리조차도.

메시지는 libp2p를 통해 피어 간에 직접 전송되며, 기기를 떠나기 전에 Signal 스타일의 Olm/Megolm 프로토콜(vodozemac을 통해)로 암호화됩니다. 관여하는 유일한 서버는 피어가 서로의 현재 주소를 찾도록 도와주는 작은 디렉터리입니다. 이 서버는 메시지 내용을 절대 볼 수 없으며, 한 번의 명령으로 제거할 수 있습니다.

실제로 무엇으로부터 보호되는지와 그 방법은 docs/THREAT_MODEL.md 및 docs/SECURITY.md를 참조하세요.

스크린샷
기능
작동 방식
프로젝트 구조
1. 사전 요구 사항
2. 빌드
3. 개발 모드로 실행
4. 테스트
5. 백엔드(디렉터리 서버) 설정
6. 앱 사용

스크린샷

첫 실행 — 이름을 정하세요. 설정할 것은 그것뿐입니다.

Seal의 첫 실행 화면: 암호화 모델 설명 옆에 표시 이름 입력 폼과 로그인 시 실행 토글이 있습니다.

대화 — 그룹 레일, 연락처 목록, 종단 간 암호화된 채팅 창.

Seal의 1:1 대화 화면으로, 그룹 레일, 연락처 목록, 종단 간 암호화된 채팅 창을 보여줍니다.

설정 — 마이크 감도, 푸시 투 토크, 로그인 시 실행, 네트워크 연결 가능 여부.

Seal의 설정 패널: 마이크 감도, 푸시 투 토크, 로그인 시 실행, 네트워크 연결 가능 여부.

기능

항상 종단 간 암호화 — 모든 메시지는 기기를 떠나기 전에 Olm(1:1) 또는 Megolm(그룹)으로 봉인되며, vodozemac의 Double-Ratchet 방식 체계를 사용합니다. 모든 메시지는 고유한 키를 갖습니다.
받은 편지함 없음 — 메시지는 직접적인 피어 투 피어 연결(libp2p: QUIC/TCP + Noise, NAT용 릴레이 및 홀 펀칭 포함)을 통해 전송됩니다. 수신자가 오프라인이면 메시지는 로컬에서 대기하고 재시도됩니다. 다른 사람의 인프라에 큐에 쌓이지 않습니다.
데이터베이스가 아닌 디렉터리 — 관여하는 유일한 서버(crates/directory-server)는 사용자 ID를 현재 네트워크 주소에 매핑할 뿐 그 이상은 하지 않습니다. 구조적으로 메시지 내용을 읽을 수 없습니다. Cargo.toml은 그 방법을 아는 크레이트조차 의존하지 않습니다.
하나의 기기, 여러 계정 — 재시작 없이 전환할 수 있는 완전히 분리된 신원(키, 연락처, 메시지)을 지원합니다.
실제 멤버십 변경이 있는 그룹 — 그룹별 텍스트 및 음성 채널. 누군가를 제거하면 그룹의 키가 순환되어 이후 전송되는 어떤 내용도 읽을 수 없습니다.
내장 음성 기능 — 시스템 전체 단축키로 푸시 투 토크(Seal뿐 아니라 모든 앱에서 작동), 조절 가능한 마이크 감도, 선택적 음성 변조기.
메타데이터 없는 첨부 파일 — EXIF 데이터(GPS 위치, 카메라/기기 정보)는 이미지가 전송되기 전에 제거되며 기본적으로 활성화되어 있습니다.
진짜 패닉 버튼 — 설정 → 데이터 및 개인정보 보호에서 이 기기의 모든 키, 연락처, 메시지를 즉시 그리고 되돌릴 수 없게 삭제하며, 대화 상대에게는 전혀 영향을 주지 않습니다.
원한다면 로그인 시 실행 — 기본적으로 켜져 있으며 설정에서 한 번의 토글로 끌 수 있습니다.
하나의 코드베이스, 세 플랫폼 — Tauri를 통해 macOS, Windows, Linux에서 네이티브 창을 제공합니다.

작동 방식

이 앱에는 두 종류의 신원이 있으며, 의도적으로 분리되어 있습니다:

채팅 신원은 앱을 처음 열 때 vodozemac이 로컬에서 생성하는 Ed25519/Curve25519 키 쌍입니다(identity::Identity). 공개 "사용자 ID"는 그 키의 지문일 뿐입니다(wire_proto::user_id_from_ed25519). 생성에 서버가 관여하지 않기 때문에 어떤 서버도 이를 발급하거나 취소할 수 없습니다.
네트워크 신원은 전송 계층에서만 사용되는 별도의 libp2p 키 쌍(PeerId)입니다. 재시작 후에도 변경될 수 있으며 채팅 신원에는 전혀 영향을 주지 않습니다. 둘은 사용자가 직접 서명한 프레즌스 레코드로만 묶여 있습니다.

누군가를 찾는 것과 실제로 대화하는 것은 서로 다른 두 단계입니다:``` ┌────────────────────────┐ │ directory server │ │ (axum + one SQLite │ │ file: users, │ │ presence, group │ │ rosters. Never │ │ message content.) │ └─────────┬───────────────┘ 1. "where is bob │ 2. "here's my current right now?" │ address" (signed, │ expires in minutes) ┌─────────┴───────────────┐ ▼ ▼ ┌───────┐ 3. direct libp2p ┌───────┐ │ alice │◄──── connection ────►│ bob │ └───────┘ (Noise + Olm/ └───────┘ Megolm encrypted)

1. Alice는 디렉터리에서 Bob의 사용자 ID로 그를 찾는다. 그러면 Bob의
   공개 키와 마지막으로 알린 네트워크 주소가 반환된다. 디렉터리가
   보관하는 것은 그것이 전부다: 공개 키, 표시 이름, 그룹
   멤버십 목록, 그리고 수명이 짧은 주소 알림
   (`crates/directory-server`).
2. Alice는 libp2p(QUIC 또는 TCP+Noise, NAT 뒤에 있는 피어를 위한 릴레이 +
   홀 펀칭 지원; `crates/net` 참조)를 통해 Bob에게 직접 연결한다.
   디렉터리는 이 시점부터 완전히 관여하지 않는다.
3. 실제 메시지는 libp2p 연결에 올려지기 전에 1:1 채팅용 **Olm** 또는
   그룹용 **Megolm**(`crates/crypto-session`)으로 암호화된다. 이는
   모든 메시지가 고유한 키를 갖는 Double-Ratchet 방식의 기법이다.
   서버 측 받은편지함은 없다: Bob이 오프라인이면 메시지는 로컬에서
   대기하고 재시도되며, 다른 누군가의 인프라에 저장되지 않는다.

위의 모든 것은 Tauri 앱의 Rust 백엔드(`apps/desktop/src-tauri`)가 실제로
호출하는 `crates/core`의 `AppService`에 의해 조율된다. UI는
네트워크와 직접 통신하지 않는다.

## 프로젝트 구조```
crates/
  wire-proto        shared signed-request types for the directory API
  identity          vodozemac identity, OS-keychain key management
  storage           local encrypted store (contacts, messages, groups)
  net               libp2p transport + directory HTTP client
  crypto-session    Olm (1:1) / Megolm (group) session management
  core              orchestrates the above into `AppService` / `ChatNode`
  directory-server  the one server component (axum + SQLite)
apps/desktop         the Tauri + React app
scripts/             build + backend-deployment scripts (§2, §5)

1. 사전 요구 사항

모든 플랫폼에서 Rust와 Node.js가 필요하며, Tauri가 네이티브 창을 빌드하는 데 필요한 플랫폼별 툴체인도 필요합니다. storage와 directory-server는 또한 SQLite를 소스에서 번들 컴파일하므로 일반 C 컴파일러가 필요합니다(이 프로젝트의 어디에서도 OpenSSL이나 다른 네이티브 암호화 라이브러리는 필요하지 않습니다).

모든 플랫폼 공통:

Rust (stable 채널; OS 패키지 관리자가 아닌 rustup으로 설치)
Node.js 20+ 및 npm

macOS

```sh xcode-select --install ``` That's it. Xcode Command Line Tools는 C 컴파일러와 Tauri의 macOS 백엔드(WKWebView 기반)에 필요한 프레임워크를 모두 제공합니다.

Linux

C 컴파일러, pkg-config, 그리고 Tauri의 Linux 백엔드가 링크하는 WebKitGTK/AppIndicator 개발 패키지를 설치합니다.

Debian/Ubuntu:```sh sudo apt update sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev pkg-config

Fedora:```sh
sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file \
  libappindicator-gtk3-devel librsvg2-devel pkgconf-pkg-config
sudo dnf group install "C Development Tools and Libraries"

아키텍처:```sh sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl
appmenu-gtk-module libappindicator-gtk3 librsvg pkgconf

(Tauri 릴리스마다 패키지 이름이 달라질 수 있습니다. 빌드 중 누락된 `.pc` 파일을 찾지 못해 실패한다면, 사용 중인 배포판의 [현재 Tauri Linux 사전 요구 사항](https://v2.tauri.app/start/prerequisites/)을 확인하세요.)

</details>

<details>
<summary><strong>Windows</strong></summary>

1. **Microsoft C++ Build Tools**를 설치합니다(Visual Studio 설치 관리자 →
   "Desktop development with C++" 워크로드). Tauri의 네이티브 셸과 번들된 SQLite를 컴파일하는 데 모두 필요합니다.
2. **MSVC** Rust 툴체인을 설치합니다: `rustup default stable-msvc`.
3. **WebView2**: Windows 11 및 대부분의 최신 Windows 10 설치에는 이미 포함되어 있습니다. 없는 경우, Tauri 빌드에서 Evergreen 런타임 설치를 안내합니다.

</details>

---

## 2. 빌드

저장소 루트에서:```sh
# Rust workspace (backend crates + the directory server)
cargo build --workspace --release

# Frontend + the actual desktop app bundle (installer/.app/.exe)
cd apps/desktop
npm install
npm run tauri build

npm run tauri build 는 저장소 루트의 아래에 플랫폼 네이티브 설치 프로그램을 생성합니다 (이것은 Cargo 워크스페이스이므로 Tauri 앱을 포함한 모든 크레이트가 하나의 최상위 디렉터리를 공유합니다). 크로스 컴파일(예: macOS에서 Windows 설치 프로그램 빌드)은 설정되어 있지 않습니다: 각 대상 플랫폼에서 빌드하거나, CI 기반 릴리스를 원하면 Tauri의 GitHub Actions 워크플로우를 사용하세요.

Sandboxing: this process needs almost nothing

ProtectSystem=strict ProtectHome=true PrivateTmp=true NoNewPrivileges=true ReadWritePaths=/var/lib/seal-directory

[Install] WantedBy=multi-user.target

참고:

- `DIRECTORY_PUBLIC_ADDR`는 여기서는 의도적으로 **루프백**에 바인딩됩니다. TLS를 위해
  axum을 인터넷에 직접 노출하는 대신 아래와 같이 리버스 프록시를 앞에
  두세요.
- `seal-directory` 시스템 사용자/그룹을 생성하고,
  `/var/lib/seal-directory`를 먼저 생성하세요 (`useradd --system --no-create-home
  seal-directory && install -d -o seal-directory -g seal-directory
  /var/lib/seal-directory`), 그리고 빌드된 `directory-server` 바이너리를
  (`target/release/`에서) `/usr/local/bin/`으로 복사하세요.
- 관리자 토큰은 root만 읽을 수 있는 `EnvironmentFile`에 넣고, 직접
  유닛 파일에 넣지 마세요 (유닛 파일은 종종 모든 사용자가 읽을 수 있습니다).

</details>

### 리버스 프록시를 통한 TLS

<details>
<summary>Caddy / nginx 구성 보기</summary>

[Caddy](https://caddyserver.com)는 가장 적은 설정으로 자동 HTTPS를 제공합니다.
설정:```
# /etc/caddy/Caddyfile
directory.example.com {
    reverse_proxy 127.0.0.1:8080
}

caddy run (또는 systemctl enable --now caddy)은 인증서 발급/갱신을 자체적으로 처리합니다. nginx를 사용하고 싶다면 TLS를 nginx에서 종료하고 proxy_pass http://127.0.0.1:8080;를 사용하세요. 앱은 프록시 관점에서 일반 HTTP만 필요하기 때문입니다.

방화벽 측면에서: 외부에서 접근 가능해야 하는 것은 공용 포트뿐입니다 (위 예시의 8080, 프록시를 통해 443이 앞에 있음). 관리자 포트는 절대 외부에서 접근 가능하면 안 됩니다. SSH 포트 포워딩 (ssh -L 8090:127.0.0.1:8090 your-server)을 사용해 원격으로 purge를 실행해야 할 때 접근하세요.

이것은 SQLite 파일을 삭제하고 빈 스키마를 다시 생성합니다. `DELETE` 문도 없고, 부분적인 상태도 없습니다. 먼저 누구에게 알리지 않고 실행해도 안전합니다. 그 안의 모든 레코드는 각 클라이언트가 이미 로컬에 보유한 데이터(자체 등록 정보, 현재 상태, 자신이 속한 그룹 명단)의 캐시일 뿐이므로, 클라이언트는 다음 작업을 수행하는 순간 몇 분 안에 다시 채웁니다. 이 데이터베이스에는 의도적으로 백업 정책이 없습니다. 백업을 유지하는 것이 전체 목적을 훼손하는 이유는 [`docs/SECURITY.md`](https://github.com/emn4tor/seal/blob/HEAD/docs/SECURITY.md)를 참조하세요. --- ## 6. 앱 사용하기 1. **첫 실행, 첫 질문**: 사용할 디렉터리 서버를 선택합니다(§3). 기본값은 실행 중인 빌드에 내장된 값입니다(그것을 빌드한 사람이 공식 서버를 구성하지 않았다면 로컬 테스트 서버). 직접 또는 신뢰하는 누군가가 호스팅하는 서버를 지정하려면 "사용자 지정 서버"를 선택하세요. 2. **표시 이름을 선택합니다.** 이렇게 하면 기기에 개인 키 쌍이 생성되고(기억할 것이 없으며, 분실 시 복구할 수도 없습니다. 의도적인 설계입니다) 암호화가 실제로 어떻게 작동하는지에 대한 짧은 인앱 설명이 진행됩니다. 언제든지 설정에서 다시 볼 수 있습니다. 이후 모든 실행에서는 프롬프트 없이 바로 다시 들어갑니다. 이 작업은 계정당 한 번만 발생합니다. 이 기기의 설정 → 계정에서 추가 계정(완전히 분리된 ID)을 추가하고 다시 시작하지 않고 전환할 수 있습니다. 3. **사람 추가**: "다이렉트 메시지" 옆의 **+**를 클릭하고 해당 ID(상대방의 설정 → 내 ID에서 찾을 수 있음)를 입력합니다. 설계상 탐색할 디렉터리가 없습니다. 전화번호를 공유하는 것과 같은 방식으로 연결합니다. 4. **메시지 보내기**: 목록에서 이름을 선택하고 입력합니다. 누군가에게 보내는 첫 메시지는 자동으로 암호화된 세션을 설정합니다. 5. **그룹 시작**: 아이콘 레일에서 **+**를 클릭하고 이름을 지정한 다음 같은 방법으로 ID로 사람들을 초대합니다. 누군가를 제거하면 그룹의 키가 회전되어 이후에 전송된 내용을 읽을 수 없습니다. 6. **모두 삭제**: 설정 → 데이터 및 개인정보 보호. 즉시, 로컬 전용이며 되돌릴 수 없습니다. *이 기기*의 키, 연락처 및 기록을 파괴하며 대화한 상대방에게는 아무 영향도 미치지 않습니다.

Script	생성물
`scripts/build-mac-dmg.sh`	macOS `.dmg` 설치 프로그램
`scripts/build-mac-app.sh`	원시 macOS `.app` 번들, 설치 프로그램 없음
`scripts/build-linux.sh`	Linux `.AppImage` + `.deb`
`scripts/build-windows.ps1`	Windows `.msi` + `.exe` (NSIS)

Seal

인기

또는 스크립트 사용

나만의 "Seal" 네트워크 구워 넣기

서버 선택 (첫 실행)

실제 빌드를 대상으로 한 테스트(dev 모드 아님)```sh

5. 백엔드(디렉터리 서버) 설정

가장 빠른 방법: 설정 스크립트```sh

빠른 로컬 실행```sh

실제 서비스로 실행하기 (systemd)

Sandboxing: this process needs almost nothing

Purge하기```sh

Seal

인기

Seal

Contents

스크린샷

기능

작동 방식

1. 사전 요구 사항

또는 스크립트 사용

나만의 "Seal" 네트워크 구워 넣기

서버 선택 (첫 실행)

실제 빌드를 대상으로 한 테스트(dev 모드 아님)```sh

5. 백엔드(디렉터리 서버) 설정

가장 빠른 방법: 설정 스크립트```sh

빠른 로컬 실행```sh

실제 서비스로 실행하기 (systemd)

Sandboxing: this process needs almost nothing

Purge하기```sh