如果不使用安装脚本,或需要在 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,覆盖 amd64、arm64、armv7、armv6 四种架构,包内的可执行文件名同样是 kiln-lite。变体差异见 Lite、Core 与 Full。
每个包内含可执行文件(kiln,Windows 上为 kiln.exe)以及 LICENSE、NOTICE、README.md、README.en.md。同一个 Release 里还有一份 SHA256SUMS,覆盖当次发布的全部压缩包。
Linux 与 macOS
下载产物与校验和
从 Releases 页面取对应平台的压缩包,连同 SHA256SUMS 一起下载到同一目录。
核对校验和
校验不通过就不要继续,重新下载或换个下载源。
sha256sum --ignore-missing -c SHA256SUMSgrep '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/bin 在 PATH 中。
确认可执行
kiln -version输出包含版本号、提交号、构建时间与变体。启动不了通常是架构不匹配,或者目标目录挂了 noexec。
在 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 uninstalluninstall 也可以写作 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 会直接报错退出,不会覆盖既有注册。start 与 stop 最多等待 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].engine 为 auto 时会自动走原生引擎,日常使用没有影响;确实需要兼容回退时,自行安装 ffmpeg 并加入 PATH。详见媒体引擎。
卸载
kiln.exe service uninstall 只移除服务注册,data_dir 下的数据、kiln.log 与配置文件都会留在原地,需要清理请自行删除。