一个可播放的频道需要两项配置：[[upstreams]] 指定上游位置，[[channels]] 指定要读取的路径和格式。按照以下步骤即可完成配置并验证播放。
配置到播放
定义上游
上游只需要一个 id 和一个基地址。频道用 upstream 引用它，用 path 拼出实际地址，所以换机器或换端口时只改这一处。
[[upstreams]]
id = "origin"
base_url = "https://origin.example.com:8000"
[upstreams.headers]
X-Custom = "value"[upstreams.headers] 可选，用于上游要求固定请求头的场景，会附加到该上游的所有出站请求上。
定义一个 HLS 频道
最短的一个频道定义如下。id 会出现在播放地址里，title 与 group 决定播放列表里的显示名和分组。
[[channels]]
id = "demo-hls"
title = "Demo HLS"
group = "Demo"
upstream = "origin"
path = "/live/demo-hls"
ingress = "hls"
on_demand = trueingress 只接受 hls 和 dash，留空时默认按 hls 处理。使用 upstream 时 path 必填，缺失会在启动时报错。字段全表见 频道模型。
加一个 DASH 频道
DASH 频道的定义结构一样，区别只在 ingress 和密钥。
[packager]
keys_file = "kiln.keys"
[[channels]]
id = "demo-dash"
title = "Demo DASH"
group = "Demo"
upstream = "origin"
path = "/live/demo-dash"
ingress = "dash"
on_demand = truekeys_file 是全局的 kid:key 目录，所有 DASH 频道共用。只要存在一个启用的 DASH 频道而没有配置它，启动时就会直接失败。多轨道与清晰度选择见 精确选择轨道。
写好密钥文件
每行一对 kid:key，十六进制，# 开头的行和空行会被忽略。
# kid:key（hex）。替换成真实密钥，不要提交到版本库。
000102030405060708090a0b0c0d0e0f:0f0e0d0c0b0a09080706050403020100kid 与 key 都必须是 32 个十六进制字符。kid 允许写成带连字符的 UUID 形式，解析时会去掉连字符；key 不允许出现连字符。同一个 kid 重复出现时，如果对应的 key 不同会报错，完全相同则去重。文件里一对都没有同样视为错误。
重启并验证
密钥文件在启动时一次性完整校验，改动之后必须重启进程才会生效，密钥也不会出现在任何管理接口的返回里。重启后先用 curl 确认播放列表和播放地址：
TOKEN=$(curl -s http://127.0.0.1:8080/v1/auth/login \
-H 'content-type: application/json' \
-d '{"username":"admin","password":"admin"}' | jq -r .token)
curl -s http://127.0.0.1:8080/v1/playlist.m3u -H "authorization: Bearer $TOKEN"
curl -s "http://127.0.0.1:8080/v1/play/demo-hls/index.m3u8?token=$TOKEN"播放列表里应当出现刚定义的两个频道。把其中的播放地址粘进任意支持 HLS 的播放器，或者把整份播放列表交给 IPTV 客户端，就能看到画面。分发方式与播放密钥见 播放与分发。
on_demand 与 autostart
这两个开关决定上游连接什么时候建立、什么时候释放，可以单独用也可以一起用。
| 开关 | 行为 |
|---|---|
on_demand |
有人取用时才拉起上游；空闲超过 idle_timeout_sec 后停掉会话，释放上游连接 |
autostart |
进程启动后立即拉起，失败按指数退避重试，直到成功或进程退出 |
两个都不填时，on_demand 会被自动置为 true，也就是默认按需拉流。
Kiln 每 5 秒检查一次闲置频道。频道在 idle_timeout_sec（默认 90 秒）内无人观看，就会停止会话并释放上游连接；下一次播放请求会重新启动。启动时需要先从上游取得足够的分片，才能生成第一份播放列表，因此按需频道的首帧会比常驻频道稍慢。这段延迟由 [packager] 的 start_segments 与 inflight_bytes 决定，调节方法见 媒体引擎。
没有开 on_demand 的频道不参与空闲回收，一旦拉起就会一直挂着。上游断流后的重启逻辑也受它影响：on_demand 频道在失败时若已经超过空闲时长，会直接结束会话而不是继续重启。
也可以在控制台里做
上面这些字段在管理控制台里都有对应的表单。控制台还提供频道预热、预览、连通性探测和 M3U 批量导入导出，改完立即生效，不需要手工编辑文件。见 管理控制台。
密钥文件是唯一的例外：它只从磁盘读取，改动之后必须重启。