👋 歡迎來到 Link 幫助中心
在這裏可以找到你想要的答案～
幫助中心 / 音視頻部署與使用 / 部署前準備
部署前準備
1. 準備音影片域名
準備一個獨立域名，例如：
livekit.example.com在域名服務商控制檯新增 A 記錄，將域名解析到 LiveKit 伺服器的公網 IP：
記錄型別：A
主機記錄：livekit
記錄值：203.0.113.10192.168.x.x、10.x.x.x 和 172.16.x.x-172.31.x.x 屬於私網地址，不能作為公網客戶端訪問 LiveKit 的 DNS 解析目標。僅在完全封閉且客戶端可直達該私網的部署環境中，才可以使用私網地址。
部署前可執行以下命令檢查解析結果：
host livekit.example.com
返回地址必須與當前 LiveKit 伺服器的公網 IP 一致。DNS 尚未生效時不要啟動自動簽發證書流程。
2. 準備證書聯絡郵箱
準備一個長期有效且有人維護的郵箱地址，例如：
ops@example.com
安裝指令碼會將該郵箱寫入 LiveKit 專用 Caddy 配置，用於向 Let's Encrypt 註冊 ACME 賬戶、申請 TLS 證書、自動續期以及接收證書相關通知。
建議使用運維團隊公共郵箱，不要使用即將離職人員的個人郵箱、臨時郵箱或無法接收外部郵件的地址。郵箱輸入後應檢查拼寫是否正確。
3. 準備 Link Webhook 地址
準備 LiveKit 可訪問的 Link 音影片通知回撥地址：
http://<gateway-ip>:<gateway-port>/live/v1/webhook
示例：
http://192.168.1.20:19080/live/v1/webhook
注意事項：
• 該地址必須能從 LiveKit 伺服器主動訪問。
• LiveKit 與 Link 部署在同一內網時，優先使用 Link Gateway 的內網地址，避免 Webhook 繞行公網。
• Webhook 請求方法為
POST，請求體型別為 application/webhook+json。• LiveKit 會透過
Authorization 請求頭攜帶簽名 JWT；Link 使用相同的 AccessKeyID 和 AccessKeySecret 驗證請求來源及請求體完整性。• Webhook 可能因臨時網路故障而重試，業務處理必須保持冪等；Webhook 不保證永久投遞，最終狀態仍應以業務資料對賬為準。
4. 準備訪問金鑰
準備一組供 LiveKit 和 Link 共同使用的憑證：
•
AccessKeyID：LiveKit API Key。•
AccessKeySecret：LiveKit API Secret。可以提前準備金鑰，也可以在安裝指令碼詢問時直接按回車，由指令碼自動生成。自行設定時，建議使用密碼生成器生成隨機憑證，不要使用域名、手機號、公司名或簡單遞增字串。金鑰會由安裝指令碼寫入以下位置或供後續 Link 配置使用：
1. LiveKit
config.yaml 的 keys。2. LiveKit
config.yaml 的 webhook.api_key。3. Link 運維後臺的音影片服務配置。
無論金鑰由使用者提供還是由安裝指令碼生成，都必須在安裝完成後妥善儲存。後續配置 Link 運維後臺時必須使用安裝結果中的同一組金鑰。