@lobehub/lobehub 2.0.2 → 2.0.4

package/docs/self-hosting/platform/vercel.zh-CN.mdx

@@ -1,43 +1,337 @@
 ---
-title: 在 Vercel 上部署 LobeHub
-description: 学习如何在 Vercel 上一键部署 LobeHub，准备 OpenAI API Key，点击按钮进行部署，绑定自定义域名，自动同步更新等。
+title: 在 Vercel 上部署 LobeHub 的服务端数据库版本
+description: 本文详细介绍如何在 Vercel 中部署服务端数据库版 LobeHub，包括数据库配置、身份验证服务配置和 S3 存储服务的设置步骤。
 tags:
-  - Vercel
-  - 部署指引
-  - LobeHub
-  - OpenAI API Key
-  - 自定义域名
-  - 自动同步更新
+  - 服务端数据库
+  - Postgres
+  - Better Auth
+  - S3存储服务
+  - Vercel部署
+  - 数据库配置
+  - 身份验证服务
+  - 环境变量配置
 ---
 
-# Vercel 部署指引
+# 在 Vercel 上部署服务端数据库版
 
-如果想在 Vercel 上部署 LobeHub，可以按照以下步骤进行操作：
+本文将详细介绍如何在 Vercel 中部署服务端数据库版 LobeHub，包括： 1）数据库配置；2）身份验证服务配置；3） S3 存储服务的设置步骤。
 
-## Vercel 部署流程
+<Callout type={'warning'}>
+  进行后续操作前，请务必确认以下事项：
+
+  - 导出所有数据，部署服务端数据库后，原有用户数据无法自动迁移，只能提前备份后进行手动导入！
+  - 配置服务端数据库所需要的环境变量时，需全部填入后再进行部署，否则可能遭遇数据库迁移问题！
+</Callout>
+
+## 一、 配置数据库
 
 <Steps>
-  ### 点击下方按钮进行部署
+  ### 准备服务端数据库实例，获取连接 URL
+
+  在部署之前，请确保你已经准备好 Postgres 数据库实例，你可以选择以下任一方式：
+
+  - `A.` 使用 Vercel / Neon 等 Serverless Postgres 实例；
+  - `B.` 使用 Docker 等自部署 Postgres 实例。
+
+  两者的配置方式略有不同，在下一步会有所区分。
+
+  ### 在 Vercel 中添加环境变量
+
+  在 Vercel 的部署环境变量中，添加 `DATABASE_URL` 等环境变量，将上一步准备好的 Postgres 数据库连接 URL 填入其中。数据库连接 URL 的通常格式为 `postgres://username:password@host:port/database`。
+
+  <Tabs items={['Serverless Postgres', 'Node Postgres']}>
+    <Tab>
+      <Callout type={'warning'}>
+        请确认您的供应商所提供的 `Postgres` 类型，若为 `Node Postgres`，请切换到 `Node Postgres` Tab 。
+      </Callout>
+
+      Serverless Postgres 需要填写的变量如下：
+
+      ```shell
+      # Serverless Postgres DB Url
+      DATABASE_URL=
+      ```
+
+      在 Vercel 中填写的示例如下：
+
+      <Image alt={'添加 Serverless Postgres DATABASE_URL'} src={'/blog/assets28616219/d4a710cd-6404-4196-90d0-cd08ca385074.webp'} />
+    </Tab>
+
+    <Tab>
+      Node Postgres 需要填写的变量如下：
+
+      ```shell
+      # Node Postgres DB Url
+      DATABASE_URL=
 
-  [![][deploy-button-image]][deploy-link]
+      # 指定 Postgres database driver 为 node
+      DATABASE_DRIVER=node
+      ```
 
-  直接使用 GitHub 账号登录即可完成部署。
+      在 Vercel 中填写的示例如下：
 
-  ### 部署完毕后，即可开始使用
+      <Image alt={'添加 Node Postgres DATABASE_URL'} src={'/blog/assets28616219/1c689738-809b-4199-b305-ba5770d39da7.webp'} />
+    </Tab>
+  </Tabs>
 
-  ### 绑定自定义域名（可选）
+  <Callout type={'info'}>
+    如果希望连接数据库时启用 SSL
+    ，请自行参考[链接](https://stackoverflow.com/questions/14021998/using-psql-to-connect-to-postgresql-in-ssl-mode)进行设置
+  </Callout>
 
-  Vercel 分配的域名 DNS 在某些区域被污染了，绑定自定义域名即可直连。
+  ### 添加 `KEY_VAULTS_SECRET` 环境变量
+
+  在完成数据库 `DATABASE_URL` 环境变量添加后，需要添加一个 `KEY_VAULTS_SECRET` 环境变量。该变量用于加密用户存储的 apikey 等敏感信息。点击下方按钮一键生成：
+
+  <GenerateSecret envName="KEY_VAULTS_SECRET" />
+
+  同样需要将其添加到 Vercel 环境变量中。
+
+  ### 添加 `APP_URL` 环境变量
+
+  该部分最后需要添加 `APP_URL` 环境变量，用于指定 LobeHub 应用的 URL 地址。
 </Steps>
 
-## 自动同步更新
+## 二、 配置身份验证服务
+
+服务端数据库需要搭配用户身份验证服务才可以正常使用。因此需要配置对应的身份验证服务。
+
+<Steps>
+  ### 添加身份验证环境变量
+
+  在 Vercel 的部署环境变量中，添加以下环境变量以启用身份验证（基于 [Better Auth](https://www.better-auth.com)）：
+
+  点击下方按钮一键生成 `AUTH_SECRET`（会话加密密钥）：
+
+  <GenerateSecret envName="AUTH_SECRET" />
+
+  同时需要配置 `JWKS_KEY` 环境变量，用于签名和验证 JWT。点击下方按钮一键生成：
+
+  <GenerateJWKSKey />
+
+  配置这些变量后，用户即可使用邮箱和密码注册登录。
 
-如果你根据上述中的一键部署步骤部署了自己的项目，你可能会发现总是被提示 “有可用更新”。这是因为 Vercel 默认为你创建新项目而非 fork 本项目，这将导致无法准确检测更新。
+  <Callout type={'info'}>
+    如需 SSO 登录、魔法链接登录、邮箱验证等高级功能，请参阅 [身份验证服务](/zh/docs/self-hosting/advanced/auth)。
+  </Callout>
 
-<Callout>
-  我们建议按照 [📘 LobeHub 自部署保持更新](/zh/docs/self-hosting/advanced/upstream-sync)
-  步骤重新部署。
+  ### 在 Vercel 中添加公、私钥环境变量
+
+  在 Vercel 的部署环境变量中，添加 `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` 和 `CLERK_SECRET_KEY` 环境变量。你可以在菜单中点击「API Keys」，然后复制对应的值填入 Vercel 的环境变量中。
+
+  <Image alt={'在 Clerk 中找到对应的公私钥环境变量'} src={'/blog/assets28616219/89883703-7a1a-4a11-b944-5d804544e57c.webp'} />
+
+  此步骤所需的环境变量如下：
+
+  ```shell
+  NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_live_xxxxxxxxxxx
+  CLERK_SECRET_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxx
+  ```
+
+  添加上述变量到 Vercel 中：
+
+  <Image alt={'在 Vercel 中添加 Clerk 公私钥环境变量'} src={'/blog/assets28616219/2bfa13df-6e20-4768-97c0-4dad06c85a2f.webp'} />
+
+  ### 在 Clerk 中创建并配置 Webhook
+
+  由于我们让 Clerk 完全接管用户鉴权与管理，因此我们需要在 Clerk 用户生命周期变更时（创建、更新、删除）中通知我们的应用并存储落库。我们通过 Clerk 提供的 Webhook 来实现这一诉求。
+
+  我们需要在 Clerk 的 Webhooks 中添加一个端点（Endpoint），告诉 Clerk 当用户发生变更时，向这个端点发送通知。
+
+  <Image alt={'Clerk 添加 Webhooks 端点'} src={'/blog/assets28616219/f50f47fb-5e8e-4930-bf4e-8cf6f5b8afb9.webp'} />
+
+  在 endpoint 中填写你的 Vercel 项目的 URL，如 `https://your-project.vercel.app/api/webhooks/clerk`。然后在订阅事件（Subscribe to events）中，勾选 user 的三个事件（`user.created` 、`user.deleted`、`user.updated`），然后点击创建。
+
+  <Callout type={'warning'}>URL 的`https://`不可缺失，须保持 URL 的完整性</Callout>
+
+  <Image alt={'添加 Clerk Webhooks 时，配置 URL 和用户事件'} src={'/blog/assets28616219/0249ea56-ab17-4aa9-a56c-9ebd556c2645.webp'} />
+
+  ### 将 Webhook 秘钥添加到 Vercel 环境变量
+
+  创建完毕后，可以在右下角找到该 Webhook 的秘钥：
+
+  <Image alt={'查看 Clerk Webhooks 秘钥'} src={'/blog/assets28616219/fab4abb2-584b-49de-9340-813382951635.webp'} />
+
+  这个秘钥所对应的环境变量名为 `CLERK_WEBHOOK_SECRET`：
+
+  ```shell
+  CLERK_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxxxxxxxxxxx
+  ```
+
+  将其添加到 Vercel 的环境变量中：
+
+  <Image alt={'在 Vercel 中 添加 Clerk Webhooks 秘钥'} src={'/blog/assets28616219/5fdc9479-007f-46ab-9d6e-a9603e949116.webp'} />
+</Steps>
+
+这样，你已经成功配置了身份验证服务。接下来我们将配置 S3 存储服务。
+
+## 三、 配置 S3 存储服务
+
+在服务端数据库中我们需要配置 S3 存储服务来存储文件。
+
+<Callout type={'info'}>
+  在本文，S3 所指代的是指兼容 S3 存储方案，即支持 Amazon S3 API 的对象存储系统，常见例如 Cloudflare
+  R2 、阿里云 OSS 等均支持 S3 兼容 API。
 </Callout>
 
-[deploy-button-image]: https://vercel.com/button
-[deploy-link]: https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Flobehub%2Flobe-chat&project-name=lobe-chat&repository-name=lobe-chat
+<Steps>
+  ### 配置并获取 S3 存储桶
+
+  你需要前往你的 S3 服务提供商（如 AWS S3、Cloudflare R2 等）并创建一个新的存储桶（Bucket）。接下来以 Cloudflare R2 为例，介绍创建流程。
+
+  下图是 Cloudflare R2 的界面：
+
+  <Image alt={'Cloudflare R2 存储界面'} src={'/blog/assets28616219/41f7f677-0153-4a96-b849-5ac9b7ebefee.webp'} />
+
+  创建存储桶时将指定其名称，然后点击创建。
+
+  <Image alt={'R2 创建存储桶'} src={'/blog/assets28616219/9c0d184c-3169-40fa-9115-011cfffb9ca7.webp'} />
+
+  ### 获取存储桶相关环境变量
+
+  在 R2 存储桶的设置中，可以看到桶配置的信息：
+
+  <Image alt={'查看存储桶的相关信息'} src={'/blog/assets28616219/2ceb210c-eca0-4439-ba27-8734d4ebb3ee.webp'} />
+
+  其对应的环境变量为：
+
+  ```shell
+  # 存储桶的名称
+  S3_BUCKET=LobeHub
+  # 存储桶的请求端点(注意此处链接的路径带存储桶名称，必须删除该路径，或使用申请 S3 API token 页面所提供的链接)
+  S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
+  # 存储桶对外的访问域名
+  S3_PUBLIC_DOMAIN=https://s3-for-LobeHub.your-domain.com
+  ```
+
+  <Callout type={'warning'}>`S3_ENDPOINT`必须删除其路径，否则会无法访问所上传文件</Callout>
+
+  ### 获取 S3 密钥环境变量
+
+  你需要获取 S3 的访问密钥，以便 LobeHub 的服务端有权限访问 S3 存储服务。在 R2 中，你可以在账户详情中配置访问密钥：
+
+  <Image alt={'查看存储桶的访问秘钥'} src={'/blog/assets28616219/be0c95c0-6693-44ee-a490-7e8dfaa8b34d.webp'} />
+
+  点击右上角按钮创建 API token，进入创建 API Token 页面
+
+  <Image alt={'创建对应 API token'} src={'/blog/assets28616219/7b0ea46c-5157-40a8-888f-f47664a4884f.webp'} />
+
+  鉴于我们的服务端数据库需要读写 S3 存储服务，因此权限需要选择`对象读与写`，然后点击创建。
+
+  <Image alt={'配置 API token 权限'} src={'/blog/assets28616219/d6f5a918-7b50-4d6e-83a6-3894ab930ddf.webp'} />
+
+  创建完成后，就可以看到对应的 S3 API token
+
+  <Image alt={'复制 API token'} src={'/blog/assets28616219/763b18f9-2b5f-44bb-a479-9b56d46f7397.webp'} />
+
+  其对应的环境变量为：
+
+  ```shell
+  S3_ACCESS_KEY_ID=9998d6757e276cf9f1edbd325b7083a6
+  S3_SECRET_ACCESS_KEY=55af75d8eb6b99f189f6a35f855336ea62cd9c4751a5cf4337c53c1d3f497ac2
+  ```
+
+  ### 在 Vercel 中添加对应的环境变量
+
+  不同 S3 服务商获取所需环境变量的步骤可能有所不同，但最终获得到的环境变量应该都是一致的：
+
+  <Callout type={'warning'}>URL 的`https://`不可缺失，须保持 URL 的完整性</Callout>
+
+  ```shell
+  # S3 秘钥
+  S3_ACCESS_KEY_ID=9998d6757e276cf9f1edbd325b7083a6
+  S3_SECRET_ACCESS_KEY=55af75d8eb6b99f189f6a35f855336ea62cd9c4751a5cf4337c53c1d3f497ac2
+
+  # 存储桶的名称
+  S3_BUCKET=LobeHub
+  # 存储桶的请求端点
+  S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
+  # 存储桶对外的访问域名
+  S3_PUBLIC_DOMAIN=https://s3-dev.your-domain.com
+
+  # 桶的区域，如 us-west-1，一般来说不需要添加，但某些服务商则需要配置
+  # S3_REGION=us-west-1
+  ```
+
+  然后将上述环境变量填入 Vercel 的环境变量中：
+
+  <Image alt={'在  Vercel 中添加 S3 的环境变量'} src={'/blog/assets28616219/cd74152d-0ae8-44fd-b815-3307c56a3c18.webp'} />
+
+  ### 配置跨域
+
+  由于 S3 存储服务往往是一个独立的网址，因此需要配置跨域访问。
+
+  在 R2 中，你可以在存储桶的设置中找到跨域配置：
+
+  <Image alt={'Cloudflare R2 的跨域设置'} src={'/blog/assets28616219/ab008be7-26b2-4b78-8bd9-24301bf34d23.webp'} />
+
+  添加跨域规则，允许你的域名（在上文是 `https://your-project.vercel.app`）来源的请求：
+
+  <Image alt={'配置允许你的站点域名'} src={'/blog/assets28616219/dfcc2cb3-2958-4498-a8a4-51bec584fe7d.webp'} />
+
+  示例配置如下：
+
+  ```json
+  [
+    {
+      "AllowedOrigins": ["https://your-project.vercel.app"],
+      "AllowedMethods": ["GET", "PUT", "HEAD", "POST", "DELETE"],
+      "AllowedHeaders": ["*"]
+    }
+  ]
+  ```
+
+  配置后点击保存即可。
+</Steps>
+
+## 四、部署并验证
+
+通过上述步骤之后，我们应该就完成了服务端数据库的配置。接下来我们可以将 LobeHub 部署到 Vercel 上，然后访问你的 Vercel 链接，验证服务端数据库是否正常工作。
+
+<Steps>
+  ### 重新部署最新的 commit
+
+  配置好环境变量后，你需要重新部署最新的 commit，并等待部署完成。
+
+  <Image alt={'重新部署最新的 commit'} src={'/blog/assets28616219/b3a78112-adc8-4837-b4e3-48f67058f16e.webp'} />
+
+  ### 检查功能是否正常
+
+  如果你点击左上角登录，可以正常显示登录弹窗，那么说明你已经配置成功了，尽情享用吧～
+
+  <Image alt={'用户登录弹窗'} src={'/blog/assets28616219/da84edc3-46f7-4e2b-a0cd-dc33a98bf5cb.webp'} />
+
+  <Image alt={'登录成功状态'} src={'/blog/assets28616219/9cb5150d-6e1e-4c59-9a18-4e418dce1a5d.webp'} />
+</Steps>
+
+## 附录
+
+### 服务端数据库环境变量一览
+
+为方便一键复制，在此汇总配置服务端数据库所需要的环境变量：
+
+```shell
+APP_URL=https://your-project.com
+
+# Postgres 数据库 URL
+DATABASE_URL=
+KEY_VAULTS_SECRET=jgwsK28dspyVQoIf8/M3IIHl1h6LYYceSYNXeLpy6uk=
+
+# 身份验证
+AUTH_SECRET=jgwsK28dspyVQoIf8/M3IIHl1h6LYYceSYNXeLpy6uk=
+JWKS_KEY='{"keys":[...]}'
+
+# S3 相关配置
+# S3 秘钥
+S3_ACCESS_KEY_ID=9998d6757e276cf9f1edbd325b7083a6
+S3_SECRET_ACCESS_KEY=55af75d8eb6b99f189f6a35f855336ea62cd9c4751a5cf4337c53c1d3f497ac2
+
+# 存储桶的名称
+S3_BUCKET=LobeHub
+# 存储桶的请求端点
+S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
+# 存储桶对外的访问域名
+S3_PUBLIC_DOMAIN=https://s3-for-LobeHub.your-domain.com
+# 桶的区域，如 us-west-1，一般来说不需要添加，但某些服务商则需要配置
+# S3_REGION=us-west-1
+```

package/docs/self-hosting/platform/zeabur.mdx

@@ -1,72 +1,76 @@
 ---
-title: Deploy LobeHub on Zeabur
+title: Deploying LobeHub Database on Zeabur
 description: >-
   Learn how to deploy LobeHub on Zeabur with ease. Follow the provided steps to
   set up your chat application seamlessly.
 tags:
   - Deploy LobeHub
   - Zeabur Deployment
+  - OpenAI API Key
   - Custom Domain Binding
 ---
 
-# Deploy LobeHub with Zeabur
+# Deploying LobeHub Database on Zeabur
 
-If you want to deploy LobeHub on Zeabur, you can follow the steps below:
+<Callout type="info">
+  This article assumes that you are familiar with the basic principles and processes of deploying
+  the LobeHub server database version, so it only includes content related to core environment
+  variable configuration. If you are not familiar with the deployment principles of the LobeHub
+  server database version, please refer to [Deploying Server
+  Database](/docs/self-hosting/server-database) first.
+</Callout>
 
-## Zeabur Deployment Process
+The template on Zeabur includes 4 services:
 
-<Steps>
-  ### Click the button below to deploy
+- Logto for authrization.
+- PostgreSQL with Vector plugin for data storage and indexing.
+- MinIO for image storage.
+- LobeHub database version.
 
-  [![][deploy-button-image]][deploy-link]
+## Deploying on Zeabur
 
-  ### Once deployed, you can start using it
+Here is the process for deploying the LobeHub server database version on Zeabur:
 
-  ### Bind a custom domain (optional)
+<Steps>
+  ### Go to the template page on Zeabur
 
-  You can use the subdomain provided by Zeabur, or choose to bind a custom domain. Currently, the domains provided by Zeabur have not been contaminated, and most regions can connect directly.
-</Steps>
+  Go to the [LobeHub Database template page](https://zeabur.com/templates/RRSPSD) on Zeabur and click on the "Deploy" button.
 
-# Deploy LobeHub with Zeabur as serverless function
+  ### Fill in the required environment variables
 
-> Note: There are still issues with [middlewares and rewrites of next.js on Zeabur](https://github.com/lobehub/lobe-chat/pull/2775?notification_referrer_id=NT_kwDOAdi2DrQxMDkyODQ4MDc2NTozMDk3OTU5OA#issuecomment-2146713899), use at your own risk!
+  After you click on the "Deploy" button, you will see a modal pop-up where you can fill in the required environment variables.
 
-Since Zeabur does NOT officially support FREE users deploy containerized service, you may wish to deploy LobeHub as a serverless function service. To deploy LobeHub as a serverless function service on Zeabur, you can follow the steps below:
+  Here are the environment variables you need to fill in:
 
-## Zeabur Deployment Process
+  - OpenAI API key: Your OpenAI API key to get responses from OpenAI.
 
-<Steps>
-  ### Fork LobeHub
+  - LobeHub Domain: A free subdomain with `.zeabur.app` suffix.
 
-  ### Add Zeabur pack config file
+  - MinIO Public Domain: A free subdomain with `.zeabur.app` suffix for yout MinIO web port to enable public access for the uploaded files.
 
-  Add a `zbpack.json` configuration file with the following content to the root dir of your fork:
+  - Logto Console Domain: A free subdomain with `.zeabur.app` suffix for your Logto console.
 
-  ```json
-  {
-    "ignore_dockerfile": true,
-    "serverless": true
-  }
-  ```
+  - Logto API Domain: A free subdomain with `.zeabur.app` suffix for your Logto api.
 
-  ### Login to your [Zeabur dashboard](https://dash.zeabur.com)
+  ### Select a region and deploy
 
-  If you do not already have an account, you will need to register one.
+  After you fill all the required environment variables, select a region where you want to deploy your LobeHub Database and click on the "Deploy" button.
 
-  ### Create a project and service
+  You will see another modal pop-up where you can see the deployment progress.
 
-  Create a project, then create a service under this project.
+  ### Configure Logto
 
-  ### Link your fork of LobeHub to the just created Zeabur service.
+  After the deployment is done, you need to configure your Logto service to enable authrization.
 
-  When adding service, choose github. This may triger a oAuth depend on varies factors like how you login to Zeabur and if you have already authorized Zeabur to access all your repos
+  Access your Logto console with the console domain you just binded, and then create a `Next.js 14(App router)` application to get the client ID and client secret, and fill in the cors and callback URLs. You can check [this document](../advanced/auth.mdx) for a more detailed guide.
 
-  ### Bind a custom domain (optional)
+  Fill in those variables into your LobeHub service on Zeabur, here is a more detailed guide for [editing environment variables on Zeabur](https://zeabur.com/docs/deploy/variables).
 
-  You can create a subdomain provided by Zeabur, or choose to bind a custom domain. Currently, the domains provided by Zeabur have not been contaminated, and most regions can connect directly.
+  For detailed configuration of Logto, refer to [this document](/docs/self-hosting/advanced/auth/providers/logto).
 
-  ### Zeabur shall start auto build and you should be able to access it by the domain of your choice after a while.
-</Steps>
+  ### Access your LobeHub Instance
+
+  Press on the `LobeHub-Database` and you can see the public domain you just created, click on it to access your LobeHub Database.
 
-[deploy-button-image]: https://zeabur.com/button.svg
-[deploy-link]: https://zeabur.com/templates/VZGGTI
+  You can also bind a custom domain for your services if you want, here is a guide on how to [bind a custom domain on Zeabur](https://zeabur.com/docs/deploy/domain-binding).
+</Steps>

package/docs/self-hosting/platform/zeabur.zh-CN.mdx

@@ -9,64 +9,59 @@ tags:
   - 自定义域名
 ---
 
-# 使用 Zeabur 部署
+# 使用 Zeabur 部署 LobeHub 数据库版
 
-如果想在 Zeabur 上部署 LobeHub，可以按照以下步骤进行操作：
+<Callout type="info">
+  本文假设你已经熟悉 LobeHub
+  服务器数据库版的部署基本原理和流程，因此只包含与核心环境变量配置相关的内容。如果你对 LobeHub
+  服务器数据库版的部署原理不熟悉，请先参考[部署服务器数据库](/zh/docs/self-hosting/server-database)。
+</Callout>
 
-## Zeabur 部署流程
+在 Zeabur 的模板中总共包含有以下四个服务：
 
-<Steps>
-  ### 点击下方按钮进行部署
-
-  [![][deploy-button-image]][deploy-link]
-
-  ### 部署完毕后，即可开始使用
-
-  ### 绑定自定义域名（可选）
+- Logto 提供身份校验
+- 带有 Vector 插件的 PostgreSQL 来做数据存储和向量化
+- MinIO 作为对象存储
+- LobeHub Database 的实例
 
-  你可以使用 Zeabur 提供的子域名，也可以选择绑定自定义域名。目前 Zeabur 提供的域名还未被污染，大多数地区都可以直连。
-</Steps>
+## 在 Zeabur 上部署
 
-# 使用 Zeabur 将 LobeHub 部署为无服务器函数
+这里是在 Zeabur 上部署 LobeHub 服务器数据库版的流程：
 
-> **注意：** 仍然存在关于 [Zeabur 上 next.js 的中间件和重写问题](https://github.com/lobehub/lobe-chat/pull/2775?notification_referrer_id=NT_kwDOAdi2DrQxMDkyODQ4MDc2NTozMDk3OTU5OA#issuecomment-2146713899)，请自担风险！
+<Steps>
+  ### 前往 Zeabur 上的模板页面
 
-由于 Zeabur 并未官方支持免费用户部署容器化服务，您可能希望将 LobeHub 部署为无服务器函数服务。要在 Zeabur 上将 LobeHub 部署为无服务器函数服务，您可以按照以下步骤操作：
+  前往 [Zeabur 上的 LobeHub 数据库模板页面](https://zeabur.com/templates/RRSPSD) 并点击 "Deploy" 按钮。
 
-## Zeabur 部署流程
+  ### 填写必要的环境变量
 
-<Steps>
-  ### Fork LobeHub
+  在你点击 “部署 “按钮后，你会看到一个模态弹窗，你可以在这里填写必要的环境变量。
 
-  ### 添加 Zeabur 打包配置文件
+  以下是你需要填写的环境变量：
 
-  在您的分支的根目录下添加一个 `zbpack.json` 配置文件，内容如下：
+  - OpenAI API key: 你的 OpenAI API key 用于获取模型的访问权限。
+  - LobeHub Domain: 一个免费的 `.zeabur.app` 后缀的域名。
+  - MinIO Public Domain: 一个免费的 `.zeabur.app` 后缀的域名为了暴露 MinIO 服务以公开访问资源。
+  - Logto Console Domain: 一个免费的 `.zeabur.app` 后缀的域名来访问 Logto 的控制台。
+  - Logto API Domain: 一个免费的 `.zeabur.app` 后缀的域名来访问 Logto 的 API。
 
-  ```json
-  {
-    "ignore_dockerfile": true,
-    "serverless": true
-  }
-  ```
+  ### 选择一个区域并部署
 
-  ### 登录到您的 [Zeabur 仪表板](https://dash.zeabur.com)
+  在你填写完所有必要的环境变量后，选择一个你想要部署 LobeHub 数据库的区域并点击 “部署” 按钮。
 
-  如果您尚未拥有一个账号，您需要注册一个。
+  你会看到另一个模态弹窗，你可以在这里看到部署的进度。
 
-  ### 创建项目与服务。
+  ### 配置 Logto
 
-  创建一个项目，并再这个项目下新建一个服务。
+  当部署完成后，你会被自动导航到你在 Zeabur 控制台上刚刚创建的项目。你需要再进一步配置你的 Logto 服务。
 
-  ### 将您的 LobeHub 分支链接到刚创建的 Zeabur 服务。
+  使用你刚绑定的域名来访问你的 Logto 控制台，创建一个新项目以获得对应的客户端 ID 与密钥，将它们填入你的 LobeHub 服务的变量中。关于如何填入变量，可以参照 [Zeabur 的官方文档](https://zeabur.com/docs/deploy/variables)。
 
-  在添加服务时，选择 github。这可能会触发一个 oAuth，取决于诸如您如何登录到 Zeabur 以及您是否已经授权 Zeabur 访问所有您的存储库等各种因素。
+  Logto 的详细配置可以参考[这篇文档](/zh/docs/self-hosting/advanced/auth/providers/logto)。
 
-  ### 绑定自定义域名（可选）
+  ### 访问你的 LobeHub
 
-  您可以创建 Zeabur 提供的子域名，或选择绑定自定义域名。目前，Zeabur 提供的域名尚未受到污染，大多数地区可以直接连接。
+  按下 `LobeHub-Database` 你会看到你刚刚创建的公共域名，点击它以访问你的 LobeHub 数据库。
 
-  ### Zeabur 将开始自动构建，您应该可以在一段时间后通过您选择的域名访问它。
+  你可以选择绑定一个自定义域名，这里有一个关于如何在 Zeabur 上[绑定自定义域名](https://zeabur.com/docs/deploy/domain-binding)的指南。
 </Steps>
-
-[deploy-button-image]: https://zeabur.com/button.svg
-[deploy-link]: https://zeabur.com/templates/VZGGTI

package/docs/self-hosting/server-database.mdx

@@ -23,7 +23,7 @@ This guide will introduce the process and principles of deploying the server-sid
 
 If you are already familiar with the complete principles, you can quickly get started by checking the deployment guides for each platform:
 
-<PlatformCards urlPrefix={'server-database'} />
+<PlatformCards urlPrefix={'platform'} />
 
 ---
 
@@ -54,7 +54,7 @@ Since we support file-based conversations/knowledge base conversations, we need
   For server-side database deployment scenarios, you need to set `NEXT_PUBLIC_SERVICE_MODE` to `server`.
 
   <Callout type={'info'}>
-    In the official `lobe-chat-database` Docker image, this environment variable is already set to
+    In the official `lobehub` Docker image, this environment variable is already set to
     `server` by default. Therefore, if you deploy using the Docker image, you do not need to configure
     this environment variable again.
   </Callout>
@@ -82,7 +82,7 @@ Since we support file-based conversations/knowledge base conversations, we need
   To streamline deployment, we have set default values based on the characteristics of different platforms:
 
   - On the Vercel platform, `DATABASE_DRIVER` defaults to `neon`;
-  - In our provided Docker image `lobe-chat-database`, `DATABASE_DRIVER` defaults to `node`.
+  - In our provided Docker image `lobehub`, `DATABASE_DRIVER` defaults to `node`.
 
   Therefore, if you follow the standard deployment methods below, you do not need to manually configure the `DATABASE_DRIVER` environment variable:
 
@@ -95,7 +95,7 @@ Since we support file-based conversations/knowledge base conversations, we need
 
   <Callout type={'info'}>
     You can generate a random 32-character string as the value of `KEY_VAULTS_SECRET` using `openssl
-                                                                                                                                                                                              rand -base64 32`.
+                                                                                                                                                                                                  rand -base64 32`.
   </Callout>
 </Steps>
 
@@ -132,7 +132,7 @@ NextAuth is an open-source authentication library that supports multiple identit
 For information on configuring NextAuth, you can refer to the [Authentication](/docs/self-hosting/advanced/authentication) documentation.
 
 <Callout type={'tip'}>
-  In the official Docker image `lobe-chat-database`, we recommend using NextAuth as the
+  In the official Docker image `lobehub`, we recommend using NextAuth as the
   authentication service.
 </Callout>
 
@@ -154,4 +154,4 @@ For detailed configuration guidelines on S3, please refer to [S3 Object Storage]
 
 The above is a detailed explanation of configuring LobeHub with a server-side database. You can configure it according to your actual situation and then choose a deployment platform that suits you to start deployment:
 
-<PlatformCards urlPrefix={'server-database'} />
+<PlatformCards urlPrefix={'platform'} />