自架開源視訊會議：La Suite Meet + VoidAuth 完整部署教學

公司不想繼續付 Microsoft Teams 或 Webex 的帳號訂閱費？其實只要有一台能跑 Docker 的主機和一個網域，就可以自架一套功能對標 Google Meet 的開源視訊會議系統。這篇文章記錄從零到上線的完整過程，包含踩過的坑和解法。

為什麼選這套

這次用到兩個開源專案的組合：

• La Suite Meet：法國政府（DINUM）官方開源的視訊會議系統，底層用 LiveKit 做 WebRTC，前後端是 React + Django，MIT 授權，法國公務體系正式在用。
• VoidAuth：輕量的自架 SSO / OIDC 身分驗證服務。Meet 本身不管帳號密碼，把登入委派給 OIDC 提供者，VoidAuth 就是扮演這個角色。

成本上，除了電費跟網域費，其他都是免費的。

架構概覽

這篇用的架構：

• 一台 Docker 主機（192.168.1.102）：跑 Meet、LiveKit、VoidAuth、資料庫等所有容器
• 一台 Caddy 反向代理主機：對外提供 HTTPS，自動申請 Let's Encrypt 憑證
• 三個對外網域（以 sao-x.com 為例，換成你自己的）

前置作業：DNS 設定

先把這三個子網域指到你的公網 IP：

meet.sao-x.com      A    你的公網IP
auth.sao-x.com      A    你的公網IP
livekit.sao-x.com   A    你的公網IP

安裝流程

Stage 1：先跑起 VoidAuth

下載安裝腳本後執行：

chmod +x install-meet-voidauth.sh
./install-meet-voidauth.sh stage1

腳本會問你幾個問題，有預設值的直接 Enter 就好：

auth.sao-x.com {
    reverse_proxy 192.168.1.102:3000
}

在 VoidAuth 建立 OIDC Client

登入後台後，建立一個給 Meet 用的 OIDC Client：

Stage 2：部署 Meet 全家桶

./install-meet-voidauth.sh stage2

這次會問你 OIDC Client ID/Secret（貼上 Stage 1 拿到的）、資料庫密碼、SMTP（沒有就全 Enter 跳過）、管理員帳密。

腳本會自動：啟動所有容器 → 跑 DB migrate → 建立管理員帳號。

完成後把 Meet 和 LiveKit 加到 Caddy：

meet.sao-x.com {
    reverse_proxy 192.168.1.102:8083
}

livekit.sao-x.com {
    reverse_proxy 192.168.1.102:7880
}

最關鍵的最後一步

用 canyouseeme.org 測試 7881 有沒有真的對外開放，確認沒問題就完成了。

踩過的坑（排錯速查）

這是整個過程踩過的坑，整理成一個速查表：

DB_PASSWORD=你的密碼
POSTGRES_PASSWORD=你的密碼

sed -i '/<.*>/d' env.d/common
sed -i '/<.*>/d' env.d/postgresql

sed -i 's#OIDC_OP_JWKS_ENDPOINT=.*#OIDC_OP_JWKS_ENDPOINT=https://auth.sao-x.com/oidc/jwks#' env.d/common

BACKEND_INTERNAL_HOST=backend
FRONTEND_INTERNAL_HOST=localhost

port: 7880
redis:
  address: redis:6379
keys:
  meetkey: 你的LIVEKIT_API_SECRET
rtc:
  udp_port: 7882
  tcp_port: 7881
  use_external_ip: true

開放 API 給 Bot / 第三方整合

Meet 有自己的 Application JWT 系統，讓外部程式能以特定使用者身分呼叫 API，不需要走瀏覽器登入。

啟用 External API

echo "EXTERNAL_API_ENABLED=true" >> env.d/common
echo "APPLICATION_JWT_SECRET_KEY=$(openssl rand -hex 32)" >> env.d/common

重啟 backend 後，去 Admin 後台 → Applications → 新增，填入名稱、選擇允許的 scopes 和使用者網域。

用 Application 換 JWT Token

curl -X POST https://meet.sao-x.com/api/v1.0/resource-server/token/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "你的ClientID",
    "client_secret": "你的ClientSecret",
    "email": "代理的使用者email",
    "scope": "rooms:create rooms:list"
  }'

拿到 token 後，用 Authorization: Bearer <token> header 呼叫 /api/v1.0/resource-server/rooms/ 等端點。

對外 Port 總整理

真正暴露在公網的只有 Caddy 的 80/443，以及 Docker 主機的 7881/7882（需路由器 Port Forwarding）。其餘 port 用 ufw 限制只對 Caddy 主機的內網 IP 開放。

維護

升級到新版本：

cd ~/meet-stack
# 先看官方 CHANGELOG 有無特殊步驟
docker compose -f docker-compose.meet.yaml -f docker-compose.meet.override.yaml pull
docker compose -f docker-compose.meet.yaml -f docker-compose.meet.override.yaml up -d
docker compose -f docker-compose.meet.yaml -f docker-compose.meet.override.yaml \
  run --rm backend python manage.py migrate

新增使用者：在 VoidAuth 後台的 Invitations 頁面建立邀請連結，發給對方自助註冊。管理員則從 https://meet.sao-x.com/admin 直接操作。