Skip to main content
大多数用户应通过快速开始中的脚本、Docker,或 GitHub Releases 中的二进制文件进行安装。 如果您要为某个发行版打包 GoModel,或需要自定义构建,请从源码构建。 管理控制台是一个 Svelte 应用,在编译时嵌入到二进制文件中。它的构建产物不在代码仓库中,因此在源码检出目录中直接执行 go build,得到的二进制文件会禁用 UI。网关和 Admin API 仍可正常工作,日志会提示 UI 已禁用。请在执行 go build 之前,通过以下两种方式之一加入控制台。

方式 1:使用预构建的控制台(无需 Node)

每个 Release 都包含 gomodel_<version>_dashboard.tar.gz,并列在该 Release 的 checksums.txt 中。它包含的控制台与该 Release 的二进制文件和 Docker 镜像中嵌入的完全一致。压缩包中的路径相对于仓库根目录,因此请在根目录下解压:
打包配方可以在源码校验和旁边固定该压缩包的 SHA-256。

方式 2:使用 Node 构建控制台

请使用 22.x 系列中 22.12 或更高版本的 Node,或 Node 24 及以上版本。控制台的构建工具不支持 Node 23。
控制台构建下载的每个文件都在 web/dashboard/package-lock.json 中通过完整性哈希固定,因此只要按 lockfile 获取了 npm 依赖,构建即可离线运行:

版本标记

如上所示,通过 -ldflags 设置 internal/version.Version。如果不设置,二进制文件会报告版本为 dev,且更新检查永远不会提示有更新的 Release。
最后修改于 2026年10月24日