Bedrud 是一个 monorepo，包含 Go 服务器、三个客户端应用、Python 机器人代理和共享包。本页描述各组件之间的关系。

架构总览

flowchart TB
    subgraph Clients ["Clients"]
        Web["Web<br/>React"]
        Android["Android<br/>Compose"]
        iOS["iOS<br/>SwiftUI"]
        Desktop["Desktop<br/>Rust + Slint"]
    end
 
    subgraph Server ["Bedrud Server"]
        Router["Fiber HTTP Router<br/>/api/auth/* /api/room/* /api/admin/*"]
        DB["GORM / SQLite<br/>(or PostgreSQL)"]
        LKSDK["LiveKit Protocol SDK<br/>(token generation, room management)"]
        LiveKit["Embedded LiveKit<br/>Media Server (WebRTC)"]
    end
 
    Clients -->|"REST API + WebSocket"| Router
    Router --> DB
    Router --> LKSDK
    LKSDK --> LiveKit

组件

服务器 (server/)

Go 后端是 Bedrud 的核心。它负责处理：

• REST API - 认证、房间管理、管理操作
• 静态文件服务 - 编译后的 Web 前端通过 //go:embed 嵌入
• LiveKit 集成 - 通过 LiveKit Protocol SDK 生成令牌并管理房间
• 嵌入式 LiveKit 服务器 - 媒体服务器二进制文件作为子进程运行

服务器使用 Fiber Web 框架（类似于 Node.js 的 Express.js）和 GORM 作为 ORM 层。开发环境支持 SQLite，生产环境支持 PostgreSQL。

详情请参阅服务器架构。

Web 前端 (apps/web/)

一个基于 TanStack Start、TailwindCSS v4 和 shadcn/ui 构建的 React 应用。在生产环境中，它在服务器端预渲染，客户端资源被嵌入到 Go 二进制文件中。

主要功能：

• 基于 LiveKit Client SDK 的视频会议界面
• 基于 JWT 的认证，支持自动令牌刷新
• 用户和房间管理的管理后台
• 具有一致组件库的设计系统

详情请参阅 Web 前端。

Android 应用 (apps/android/)

使用 Jetpack Compose 和 Kotlin 构建的原生 Android 应用。使用 Koin 进行依赖注入，使用 Retrofit 进行 HTTP 请求。

主要功能：

• 基于 LiveKit Android SDK 的完整视频会议体验
• 画中画模式
• 深度链接处理（bedrud.com/m/* 和 bedrud.com/c/*）
• 通过 Android ConnectionService 进行通话管理
• 多实例支持（连接到多个服务器）

详情请参阅 Android 应用。

iOS 应用 (apps/ios/)

使用 SwiftUI 构建的原生 iOS 应用。使用 KeychainAccess 进行安全凭证存储，使用 LiveKit Swift SDK 处理媒体。

主要功能：

• 完整的视频会议体验
• 多实例支持
• 深度链接处理
• 基于 Keychain 的安全存储

详情请参阅 iOS 应用。

桌面应用 (apps/desktop/)

使用 Rust 和 Slint UI 工具包构建的原生 Windows 和 Linux 桌面应用。编译为单个二进制文件，无运行时依赖。

主要功能：

• 通过 LiveKit Rust SDK 提供完整的视频会议体验
• 原生 Windows（Direct3D 11）和 Linux（OpenGL/Vulkan）渲染
• 多实例支持（连接到多个 Bedrud 服务器）
• 操作系统密钥环集成，用于安全凭证存储

详情请参阅桌面应用。

机器人代理 (agents/)

以机器人身份加入会议室并流式传输媒体内容的 Python 脚本：

• 音乐代理 - 播放音频文件
• 广播代理 - 流式传输网络广播电台
• 视频流代理 - 共享视频内容（HLS、MP4）

详情请参阅机器人代理。

认证流程

sequenceDiagram
    participant Client
    participant Server
    participant Database
 
    Client->>Server: POST /api/auth/login
    Server->>Database: verify credentials
    Database-->>Server: credentials valid
    Server-->>Client: access + refresh JWT
 
    Client->>Server: GET /api/room/list
    Note right of Server: "Authorization: Bearer <access_token>"
    Server-->>Client: room list

所有认证请求在 Authorization 请求头中使用 JWT 令牌。Web 前端的 authFetch 封装器负责令牌附加和自动刷新。

支持的认证方式：

会议连接流程

sequenceDiagram
    participant C as Client
    participant S as Bedrud Server
    participant LK as LiveKit SFU
 
    C->>S: POST /api/room/join
    S->>S: Validate permissions
    S->>C: LiveKit JWT token
    C->>LK: WebSocket connect (with token)
    LK->>C: SDP offer + join response
 
    Note over C,LK: ICE connectivity check
    C->>LK: Host + STUN + TURN candidates
 
    alt Direct path (UDP)
        C-->>LK: Media via UDP 50000-60000
    else TURN relay
        C-->>LK: Media via TURN relay
    end
 
    Note over C,LK: Audio/video tracks flow through SFU

1. 客户端通过 REST API 请求加入房间
2. 服务器验证权限并生成签名的 LiveKit 令牌
3. 客户端使用令牌通过 WebSocket 直接连接到 LiveKit
4. ICE 收集候选者（host、STUN、TURN）并选择最佳路径
5. 音视频轨道通过 LiveKit 的 SFU 传输

完整的连接堆栈请参阅 WebRTC 连接。

数据模型

用户

房间

Passkey

RefreshToken

部署架构

在生产环境中，Bedrud 以两个 systemd 服务运行：

两者由同一个二进制文件管理。Traefik 或其他反向代理负责 TLS 终止和流量路由。

设置说明请参阅部署指南。

关键术语

以下术语出现在整个架构文档中：

另请参阅

• WebRTC 连接 - 完整的 STUN/ICE/TURN/SFU 连接堆栈
• TURN 服务器指南 - TURN 中继架构和配置
• LiveKit 集成 - Bedrud 如何嵌入 LiveKit