本地开发指南

Komari 使用了 Go + React 技术栈进行开发。如果您想在本地进行二次开发或调试，可以参考以下步骤：

环境准备

0. 安装 Git。

1. 安装 Go（建议版本 1.24 及以上）。

2. 安装 Node.js（建议版本 20 及以上）。

克隆源码

使用 Git 克隆 Komari 源码仓库：

1. 后端

git clone https://github.com/komari-monitor/komari

2. 前端

git clone https://github.com/komari-monitor/komari-web

3. Agent

git clone https://github.com/komari-monitor/komari-agent

构建前端静态文件

Komari 的后端使用 go-embed 将 dist.tar.zst 打包进二进制文件，并在启动时解压到内存。因此，在启动后端服务之前，必须先构建前端并生成归档。

cd komari-web
npm install
npm run build

生成的静态文件位于 dist 目录下，将其打包到后端源码的 web/public/defaultTheme/dist.tar.zst；同时复制 komari-theme.json，用于后台读取默认主题元数据和可管理配置：

mkdir -p ../komari/web/public/defaultTheme
tar -cf /tmp/komari-dist.tar -C dist .
zstd -19 -T0 -f /tmp/komari-dist.tar -o ../komari/web/public/defaultTheme/dist.tar.zst
rm -f /tmp/komari-dist.tar
cp komari-theme.json ../komari/web/public/defaultTheme/

启动后端服务

cd ../komari
go run main.go server -l localhost:25774

启动 Agent 服务

cd ../komari-agent
go run main.go --disable-auto-update -e http://localhost:25774 -t <Your Token>