index.mdx

import { Card, Cards, Callout } from 'nextra/components'

Shiro 主题

import { ToGitHub } from '@components/ToGitHub'

Demo

} /> } />

前提要求

• 你已安装 Mix Space 后端并且已启动
• 你已注册 Clerk 账号
• （选择 Vercel 部署）已注册 Vercel 和 GitHub 账号

请注意，Shiro 主题的部署教程与初版有所不同，如果你已经部署过 Shiro 主题，请重新阅读本文档（尤其是填入配置文件环节，配置有所变化），并阅读 [「移除 Edge Config」](#移除-edge-config) 部分。

准备步骤

import { Steps } from 'nextra/components' import Video from '@components/Video'

打开 Clerk 创建项目

打开 Clerk 仪表盘 点击 Add application 按钮，填入你的博客名称，并配置信息，点击 Create application 按钮，即可完成配置。

请你务必记住你的 Clerk 页面的公钥和私钥，稍后将会用到。

通过 Vercel 部署

克隆仓库

登陆 GitHub 账号，打开 Innei/Shiro，点击右上角的 Fork 按钮，将仓库克隆到你的账号下。

通过预构建运行 & Docker Compose

参见 README 相关部分 完成对应操作，随后配置反向代理。

Clerk 登录与 Mix Space 后端绑定

如果你遇到在 Shiro 登录之后，无法评论遇到 "和主人重名" 的报错，是因为 Clerk 的用户名和 Mix Space 后端的用户名重复了，你需要绑定本系统和 Clerk 的用户。让某个 Clerk 用户具有管理员权限。

具体操作方法：

1. 升级 Mix Space Core 到 4.7.0 以上版本。

2. 打开 Clerk 对于此项目的控制台：

PEM 的获取方式：

https://clerk.com/docs/backend-requests/handling/manual-jwt

Key:

3. 在 Shiro 用 clerk 登录后，通过 console 抓取请求：

你的 clerk User Id 获取方式：

Refer: Innei/Shiro#137

完成！

至此，你已完成了 Shiro 主题的部署，你可以访问你的博客了。

移除 Edge Config

在后续的 Shiro 更新中，Edge Config 将不再被使用。你可能需要移除 Edge Config，以防止不必要的资源使用。

进入 Vercel 部署此项目的仪表盘，点击上方的 Storage，进入设置页面，点击左侧的 Projects，将链接的项目取消链接，接着点击左侧的 Settings，点击右侧的 Delete Edge Config 按钮，即可完成删除。

更新

Vercel 托管

使用 Vercel 托管的话，只需要在自己 Fork 的项目上 Sync Fork 即可（如图）。如果自己有魔改某些内容的话不要点击 Discard Changes，会把自己的魔改搞没了。

通过预构建运行 & Docker Compose

预构建：重复对应步骤。

Docker Compose：docker compose pull && docker compose up -d

<style global jsx>{` .nextra-cards img { border-radius: 50%; } .nextra-content pre { max-height: 50vh; } `}</style>