import { ToGitHub } from '@components/ToGitHub';
import { Callout, Steps } from "nextra/components";
由于 Kami 主题已不再维护并 Achieved ,该部分文档将会保持最小程度的更新;值得注意的是,使用 Kami 要求服务器的 Linux 内核版本不小于 4.19。下一个代替项目将会是 Shiro,当它完成之时,我便不再投入任何精力到 Kami 中。迎接未来总需要舍弃一些东西,非常感谢大家三年来使用 Kami,不管你是谁,都需要对你说声谢谢。—— Innei
由于 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.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.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