Intro
请使用 1C1G 以上的系统,1G 内存可能会在前端编译时出现问题。
推荐使用 Ubuntu 等现代 Linux 操作系统,使用 CentOS 7 等操作系统因无法安装足够高版本的 Node.js 从而导致部署失败。
后端部署
参考:https://mx-space.js.org/docs/docker
安装 Docker
如果你的服务器在国内,建议使用阿里云的镜像加速,安装命令如下:
CodeBlock Loading...
在国外,可以直接使用官方脚本安装:
CodeBlock Loading...
如果您成功安装了 Docker 和 Docker-Compose,可以通过以下命令查看版本:
CodeBlock Loading...
部署
- 拉取配置文件
CodeBlock Loading...
- 创建环境变量
CodeBlock Loading...
- 填入以下内容后,按
ESC键,输入:wq保存退出
CodeBlock Loading...
启动后端
CodeBlock Loading...
前端部署
参考:https://mx-space.js.org/themes/shiro
前期准备
- 部署好后端并启动
- 注册 Clerk 账号,并获取公钥私钥:参考
- 安装 node.js、pnpm
部署
- 拉取仓库(以 Shiro 为例)
CodeBlock Loading...
- 生成环境变量
CodeBlock Loading...
填入以下内容后,按 ESC 键,输入 :wq 保存退出
NEXT_PUBLIC_API_URL=https://yourdomain/api/v2
NEXT_PUBLIC_GATEWAY_URL=https://yourdomain
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_XXXX
CLERK_SECRET_KEY=sk_test_XXXX
- 安装依赖并启动
CodeBlock Loading...
- 如果以上能够正常启动前端,则可以使用 pm2 进行部署
CodeBlock Loading...
Nginx 反向代理
将域名解析至服务器。
根据 该文 的方法申请证书。
设置反向代理:
CodeBlock Loading...修改下面示例中的域名及证书路径,添加到配置文件中:
更新
后端更新(Doker 部署)
进入 core 所在文件夹,然后
CodeBlock Loading...
前端更新
CodeBlock Loading...
TroubleShooting
解决评论用户冲突问题
- 获取PEM:https://clerk.com/docs/backend-requests/handling/manual-jwt
- 获取id:在 Shiro 用 clerk 登录后,通过 console 抓取请求

获取 id
添加搜索
参考:https://mx-space.js.org/usage/search
- 注册:https://dashboard.algolia.com/users/sign_up
- New Application -> Create Application -> Create Index,需要记住 Create Index
- API Keys -> Application ID & Admin API Key
- 在后台输入 Index & Application ID & Admin API Key