👋 欢迎来到 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 运维后台时必须使用安装结果中的同一组密钥。