go build,得到的二进制文件会禁用 UI。网关和 Admin API 仍可正常工作,日志会提示 UI 已禁用。请在执行 go build 之前,通过以下两种方式之一加入控制台。
方式 1:使用预构建的控制台(无需 Node)
每个 Release 都包含gomodel_<version>_dashboard.tar.gz,并列在该 Release 的 checksums.txt 中。它包含的控制台与该 Release 的二进制文件和 Docker 镜像中嵌入的完全一致。压缩包中的路径相对于仓库根目录,因此请在根目录下解压:
方式 2:使用 Node 构建控制台
请使用 22.x 系列中 22.12 或更高版本的 Node,或 Node 24 及以上版本。控制台的构建工具不支持 Node 23。web/dashboard/package-lock.json 中通过完整性哈希固定,因此只要按 lockfile 获取了 npm 依赖,构建即可离线运行:
版本标记
如上所示,通过-ldflags 设置 internal/version.Version。如果不设置,二进制文件会报告版本为 dev,且更新检查永远不会提示有更新的 Release。