Kami 主题
下一个代替项目将会是 Shiro,当它完成之时,我便不再投入任何精力到 Kami 中。迎接未来总需要舍弃一些东西,非常感谢大家三年来使用 Kami,不管你是谁,都需要对你说声谢谢。—— Innei
⚠️
由于 Kami 主题已不再维护并 Achieved ,该部分文档将会保持最小程度的更新;值得注意的是,使用 Kami 要求服务器的 Linux 内核版本不小于 4.19。
检查内核版本
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
- 复制 .env.example 为 .env
- 编辑 .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
中的 .env
和 public
文件夹复制到 kami
,将你的修改的部分依次修改替换完成。
安装依赖、构建、启动前端:
pnpm i
pnpm build
pm2 start