feat: 添加文档链接和 Bash 自动脚本部署指南

Author: PaloMiku

app/layout.config.tsx

@@ -60,6 +60,7 @@ export const baseOptions: BaseLayoutProps = {
     {
       type: 'menu',
       text: '文档',
+      url: '/docs',
       items: [
         {
           icon: <BookMarked />,

content/docs/core/bash.mdx

@@ -0,0 +1,77 @@
+---
+title: Bash 自动脚本
+description: 一种自动部署 MixSpace 前后端的 Bash 脚本
+icon: SquareTerminal
+---
+
+<Callout type="warn">
+本脚本由社区用户“[Mikuの鬆](https://github.com/PaloMiku)”维护，如遇问题请前往对应的 Github 仓库提出Issue。
+</Callout>
+
+
+import { ToGithub } from 'app/components/ToGithub'
+
+<ToGithub repo="PaloMiku/MxShell" />
+
+## 介绍
+
+这是一种在服务器自动安装 Docker 和进行 MixSpace 前后端部署的 Bash 脚本，它可以帮助你交互式快速部署 MixSpace。
+
+注意脚本会自动根据是否为中国大陆网络环境按需修改服务器 Docker 安装源和镜像源。
+
+脚本支持交互式安装方式和预配置文件的自动安装方式。
+
+## 使用
+
+在服务器终端运行以下指令，即可自动进入交互式安装。
+
+### 海外服务器
+
+```bash
+curl -sSL https://raw.githubusercontent.com/PaloMiku/MxShell/refs/heads/main/install.sh -o install.sh && bash install.sh
+```
+
+### 国内服务器
+
+使用 Moeyy 的 GitHub 加速源。
+
+```bash
+curl -sSL https://github.moeyy.xyz/https://raw.githubusercontent.com/PaloMiku/MxShell/refs/heads/main/install.sh -o install.sh && bash install.sh
+```
+
+## 预配置文件
+
+不建议新手使用，参考下方示例修改并粘贴到 mxconfig.yml 文件，并将其与脚本置于同一目录后运行脚本，脚本会根据配置文件内容自动完成前后端部署。
+
+### 配置文件示例
+
+```yaml
+# 后端配置
+
+# JWT 密钥，用于加密用户的 JWT，长度需为 16 到 32 个字符
+JWT_SECRET: "your_jwt_secret_here"
+
+# 允许访问的域名，多个域名用英文逗号分隔
+ALLOWED_ORIGINS: "example.com,api.example.com"
+
+# MixSpace 容器文件存储目录
+TARGET_DIR: "/opt/mxspace"
+
+# 前端配置
+FRONTEND:
+  INSTALL: true
+  VERSION: "Shiro" # 可选值: Shiro 或 Shiroi
+  NEXT_PUBLIC_API_URL: "http://127.0.0.1:2333/api/v2"
+  NEXT_PUBLIC_GATEWAY_URL: "http://127.0.0.1:2333/"
+  SHIRO_IMAGE: "your-dockerhub-username/shiroi:tag" # 仅在 Shiroi 版本时需要
+
+```
+
+- **`JWT 密钥`**：需要填写长度不小于 16 个字符，不大于 32 个字符的字符串，用于加密用户的 JWT，务必保存好自己的密钥，不要泄露给他人。
+- **`被允许的域名`**：需要填写被允许访问容器的域名，通常是前端的域名，如果允许多个域名访问，用英文逗号，分隔。
+- **`MixSpace 容器文件存储目录`**：指定文件存储路径，通常是 `/opt/mxspace`。
+- **`前端安装`**：是否安装前端，true 为安装，false 为跳过，默认为 true。
+- **`前端版本`**：可选值为 Shiro 或 Shiroi（闭源）。
+- **`前端 API 地址`**：指定后端 API 的 URL，通常为后端加 `/api/v2`。
+- **`前端网关地址`**：指定后端网关的 URL，通常为你后端的域名。
+- **`Shiro 镜像`**：仅在前端版本选择为 Shiroi 版本时需要，填写你自构建的 shiroi docker 镜像信息。

content/docs/core/index.mdx

@@ -24,14 +24,15 @@ import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
 ## 快速开始
 
 <Callout type="info">
-我们提供了两种部署方式，并且社区也提供了更多的部署方式，你可以根据自己的喜好选择一种部署方式。
+我们提供了两种部署方式，社区贡献了一种自动脚本模式，同时社区用户也分享了更多的部署方式，你可以根据自己的喜好选择一种部署方式。
 </Callout>
 
-import { Container, Pickaxe, Share2, Ellipsis, Paintbrush } from 'lucide-react';
+import { Container, SquareTerminal, Pickaxe, Share2, Ellipsis, Paintbrush } from 'lucide-react';
 
 <Cards>
-  <Card title="Docker 部署" href="/docs/core/docker" icon={<Container />}>使用Docker部署后端</Card>
+  <Card title="Docker 部署" href="/docs/core/docker" icon={<Container />}>使用 Docker 部署后端</Card>
   <Card title="进阶部署" href="/docs/core/advanced" icon={<Pickaxe />}>使用传统方式部署后端</Card>
+  <Card title="Bash 脚本部署" href="/docs/core/bash" icon={<SquareTerminal />}>使用 Bash 自动脚本一键部署前后端</Card>
   <Card title="拓展内容" href="/docs/core/extra" icon={<Ellipsis />}>部署常见问题与拓展内容</Card>
   <Card title="社区分享" href="/docs/core/community" icon={<Share2 />}>了解社区用户们分享的部署方式</Card>
 </Cards>

content/docs/core/meta.json

@@ -10,6 +10,7 @@
     "---部署---",
     "docker",
     "advanced",
+    "bash",
     "extra",
     "community"
   ]