前端主题
部署 Kami 主题

Kami 主题

下一个代替项目将会是 Shiro,当它完成之时,我便不再投入任何精力到 Kami 中。迎接未来总需要舍弃一些东西,非常感谢大家三年来使用 Kami,不管你是谁,都需要对你说声谢谢。—— Innei

⚠️

由于 Kami 主题已不再维护并 Achieved ,该部分文档将会保持最小程度的更新;值得注意的是,使用 Kami 要求服务器的 Linux 内核版本不小于 4.19。

目前发现的与新版 Core 的冲突

由于 Kami 已不再维护,如果你想继续使用,你需要自行解决 Core 版本更新带来的 BREAKING CHANGE 导致的 kami 功能丢失问题。

检查内核版本

uname -r

如果你的内核版本小于 4.19,请升级内核。或者使用最新的 Ubuntu / Debian 。

克隆项目

git clone https://github.com/mx-space/kami.git --depth=1
cd kami && git fetch --tags && git checkout $(git rev-list --tags --max-count=1)

安装依赖

git lfs fetch --all
git lfs pull
pnpm i

配置 ENV

  1. 复制 .env.example 为 .env
  2. 编辑 .env 文件,它看起来应该是这个样子的
# API 地址
NEXT_PUBLIC_API_URL=https://server.test.cn/api/v2
# GATEWAY 地址
NEXT_PUBLIC_GATEWAY_URL=https://server.test.cn
#前端使用的配置项名字
NEXT_PUBLIC_SNIPPET_NAME=kami
# 如果使用 CDN, 修改产物前缀;一般留空
ASSETPREFIX=

开始构建

pnpm build

启动前端

pnpm prod:pm2

更新

分为对 Kami 进行魔改和未魔改两种情况。

未魔改

💡

该方法适合于对 Kami 源代码没有做改动的用户。

直接在 kami 文件夹下执行 git pull origin master

cd ~/mx-space/kami
git pull origin master

安装依赖、构建、启动前端:

pnpm i
pnpm build
pm2 start
⚠️

你应该理解的是,即便是你没有对 Kami 进行任何魔改,仍有可能出现代码不能自动合并的问题,对于这种情况,建议参考下面的已魔改部分完成升级。

已魔改

💡

此方法适用于对前端魔改后的升级,我们认为你修改了 'kami/src' 里面的源代码,这样的话,容易出现合并冲突,建议手动替换。

kami 文件夹改为任意名字,例如修改为 kami.d,然后拉取 kami 前端仓库,更新到稳定版本:

cd ~/mx-space
git clone https://github.com/mx-space/kami.git --depth=1
cd kami && git fetch --tags && git checkout $(git rev-list --tags --max-count=1)

然后将更新前之前配置时修改过的文件,如在 kami.d 中的 .envpublic 文件夹复制到 kami,将你的修改的部分依次修改替换完成。

安装依赖、构建、启动前端:

pnpm i
pnpm build
pm2 start