跳到正文

手动安装与 Windows 服务

下载并校验 Kiln 发行包,在 Linux、macOS 或 Windows 上手动安装,并注册 Windows 服务。

更新于 Markdown 版本

如果不使用安装脚本,或需要在 Windows 上部署,可以直接从 GitHub Releases 下载发行包。每个包都包含一个静态二进制以及许可和说明文件,解压后即可运行,无需安装运行时。

发行产物

产物命名遵循固定规则:<name>_<version>_<os>_<arch>,Linux 与 macOS 打 .tar.gz,Windows 打 .zip

系统 架构 文件名
Linux amd64 kiln_<version>_linux_amd64.tar.gz
Linux arm64 kiln_<version>_linux_arm64.tar.gz
Linux armv7 kiln_<version>_linux_armv7.tar.gz
Linux armv6 kiln_<version>_linux_armv6.tar.gz
macOS amd64 kiln_<version>_darwin_amd64.tar.gz
macOS arm64 kiln_<version>_darwin_arm64.tar.gz
Windows amd64 kiln_<version>_windows_amd64.zip
Windows arm64 kiln_<version>_windows_arm64.zip

lite 变体只构建 Linux,文件名前缀换成 kiln-lite,覆盖 amd64arm64armv7armv6 四种架构,包内的可执行文件名同样是 kiln-lite。变体差异见 Lite、Core 与 Full

每个包内含可执行文件(kiln,Windows 上为 kiln.exe)以及 LICENSENOTICEREADME.mdREADME.en.md。同一个 Release 里还有一份 SHA256SUMS,覆盖当次发布的全部压缩包。

Linux 与 macOS

下载产物与校验和

Releases 页面取对应平台的压缩包,连同 SHA256SUMS 一起下载到同一目录。

核对校验和

校验不通过就不要继续,重新下载或换个下载源。

sha256sum --ignore-missing -c SHA256SUMS
grep 'kiln_1.0.0_darwin_arm64.tar.gz' SHA256SUMS | shasum -a 256 -c -

解压并放进 PATH

tar -xzf kiln_1.0.0_linux_amd64.tar.gz
sudo install -m 0755 kiln /usr/local/bin/kiln

没有 sudo 时改用用户目录:install -m 0755 kiln ~/.local/bin/kiln,并确认 ~/.local/binPATH 中。

确认可执行

kiln -version

输出包含版本号、提交号、构建时间与变体。启动不了通常是架构不匹配,或者目标目录挂了 noexec

运行

kiln -config kiln.toml

配置写法见配置参考,命令行参数见 CLI 参考

在 macOS 上,Apple Silicon 机器请选 darwin_arm64。若终端跑在 Rosetta 下,uname -m 会返回 x86_64,据此选包会装成转译执行的版本。

想让它开机自启并常驻,Linux 上用安装脚本的 --service 注册 systemd 服务最省事。

Windows

Windows 版自带服务子命令,不需要额外的守护工具或包装器。

解压到固定目录

下载 kiln_<version>_windows_amd64.zip 并解压,例如放到 C:\kiln。用 Get-FileHash 核对 SHA256SUMS 里对应的那一行。

Get-FileHash kiln_1.0.0_windows_amd64.zip -Algorithm SHA256

准备配置

在同一目录放好 kiln.toml,例如 C:\kiln\kiln.toml

注册并启动服务

在管理员终端里执行。

kiln.exe service install -config C:\kiln\kiln.toml
kiln.exe service start
kiln.exe service status

停止与移除同样是两条命令:

kiln.exe service stop
kiln.exe service uninstall

uninstall 也可以写作 remove,两者等价。

子命令与参数

参数 适用 说明 默认
-config install 配置文件路径,必填;安装前会转成绝对路径并确认可读
-name 全部子命令 服务名,同一台机器跑多个实例时用它区分 Kiln
-display install 服务在管理界面里的显示名 Kiln Streaming Gateway

跑多个实例时,每个实例都要在所有子命令上带同一个 -name

kiln.exe service install -config C:\kiln\edge.toml -name KilnEdge -display "Kiln Edge"
kiln.exe service start -name KilnEdge

同名服务已存在时 install 会直接报错退出,不会覆盖既有注册。startstop 最多等待 30 秒确认状态到位;uninstall 遇到仍在运行的服务会先请求停止,最多等 20 秒再删除注册。status 输出 running、stopped、starting、stopping、paused 或 unknown。

自动启动与失败重启

安装出来的服务启动类型是「自动」,随系统启动。同时注册了三级失败重启策略:第一次失败后 5 秒重启,第二次 15 秒,第三次 60 秒,失败计数在 24 小时后重置。

服务收到标准的停止或关机请求后,会先完成清理再正常退出,不会被直接终止。

工作目录与相对路径

服务控制管理器会在 system32 下启动进程。Kiln 检测到自己以服务身份运行时,会把 -config 转成绝对路径,并把工作目录切到配置文件所在目录。因此配置里的相对路径,例如 data_dir = "./data",仍然相对配置文件解析,而不是相对 system32

安装时记录的是配置文件的绝对路径,之后移动二进制或配置文件都需要重新注册服务。服务模式下没有拿到 -config 时,进程会以 2 退出。

日志

服务模式下标准输出会被服务控制管理器丢弃,所以 Kiln 把标准输出与标准错误重定向到配置文件所在目录下的 kiln.log

每次启动时,若已存在的 kiln.log 超过 16 MB,会先重命名为 kiln.log.1 再写新文件。轮转只保留这一份历史,需要长期留存请自行归档。日志内容与格式见运维

防火墙

对外提供服务要放行入站端口,Windows 防火墙默认拦截:

New-NetFirewallRule -DisplayName "Kiln" -Direction Inbound -LocalPort 8080 -Protocol TCP -Action Allow

关于 ffmpeg

Windows 发行版不含 ffmpeg。[packager].engineauto 时会自动走原生引擎,日常使用没有影响;确实需要兼容回退时,自行安装 ffmpeg 并加入 PATH。详见媒体引擎

卸载

kiln.exe service uninstall 只移除服务注册,data_dir 下的数据、kiln.log 与配置文件都会留在原地,需要清理请自行删除。

下一步

导航

输入以搜索…

↑↓ 移动↵ 打开Esc 关闭