@lobehub/chat 1.0.7 → 1.0.9

package/docs/self-hosting/advanced/server-database.zh-CN.mdx

@@ -0,0 +1,389 @@
+---
+title: 使用服务端数据库部署 - 配置 Postgres、Clerk 和 S3 存储服务
+description: 本文详细介绍如何在 Vercel 中部署服务端数据库版 LobeChat，包括数据库配置、身份验证服务配置和 S3 存储服务的设置步骤。
+tags:
+  - 服务端数据库
+  - Postgres
+  - Clerk
+  - S3存储服务
+  - Vercel部署
+  - 数据库配置
+  - 身份验证服务
+  - 环境变量配置
+---
+# 使用服务端数据库部署
+
+LobeChat 默认使用客户端数据库（IndexedDB），同时也支持使用服务端数据库。LobeChat 采用了 Postgres 作为后端存储数据库。PostgreSQL是一种强大的开源关系型数据库管理系统，具备高度扩展性和标准SQL支持。它提供了丰富的数据类型、并发处理、数据完整性、安全性及可编程性，适用于复杂应用和大规模数据管理。
+
+本文将详细介绍如何在 Vercel 中部署服务端数据库版 LobeChat，包括： 1）数据库配置；2）身份验证服务配置；3） S3 存储服务的设置步骤。
+
+<Callout type={'info'}>
+  限于工作量原因，目前仅支持在 Vercel 中部署使用服务端数据库版本，Docker 版本将会在后续迭代中支持。
+</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>
+
+      Serverless Postgres 需要填写的变量如下：
+
+      ```shell
+      # Serverless Postgres DB Url
+      DATABASE_URL=
+
+      # 指定 service mode 为 server，否则不会进入服务端数据库
+      NEXT_PUBLIC_SERVICE_MODE=server
+      ```
+
+      在 Vercel 中填写的示例如下：
+
+      <Image alt={'添加 Serverless Postgres DATABASE_URL'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/d4a710cd-6404-4196-90d0-cd08ca385074'}></Image>
+
+</Tab>
+
+    <Tab>
+      Node Postgres 需要填写的变量如下：
+
+      ```shell
+      # Node Postgres DB Url
+      DATABASE_URL=
+
+      # 指定 Postgres database driver 为 node
+      DATABASE_DRIVER=node
+
+      # 指定 service mode 为 server，否则不会进入服务端数据库
+      NEXT_PUBLIC_SERVICE_MODE=server
+      ```
+
+      在 Vercel 中填写的示例如下：
+
+      <Image alt={'添加 Node Postgres DATABASE_URL'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/1c689738-809b-4199-b305-ba5770d39da7'}></Image>
+
+</Tab>
+
+</Tabs>
+
+### 添加 `KEY_VAULTS_SECRET` 环境变量
+
+在完成数据库 DATABASE_URL 环境变量添加后，需要添加一个 `KEY_VAULTS_SECRET` 环境变量。该变量用于加密用户存储的 apikey 等敏感信息。你可以使用 `openssl rand -base64 32` 生成一个随机的 32 位字符串作为密钥。
+
+```shell
+KEY_VAULTS_SECRET=jgwsK28dspyVQoIf8/M3IIHl1h6LYYceSYNXeLpy6uk=
+```
+
+同样需要将其添加到 Vercel 环境变量中。
+
+</Steps>
+
+## 二、 配置身份验证服务
+
+服务端数据库需要搭配用户身份验证服务才可以正常使用。因此需要配置对应的身份验证服务。
+
+<Callout type={'warning'}>
+  同样由于工作量原因，目前仅支持 Clerk 作为身份验证服务方案， Next-Auth 的服务端数据库集成有待开发
+</Callout>
+
+<Steps>
+
+### 准备 Clerk 身份验证服务
+
+前往 [Clerk](https://clerk.com?utm_source=lobehub&utm_medium=docs) 注册并创建应用，获取相应的 Public Key 和 Secret Key。
+
+<Callout type={'info'}>
+  如果对 Clerk 不太了解，可以查阅
+  [身份验证服务-Clerk](/zh/docs/self-hosting/advanced/authentication#clerk) 了解 Clerk 的使用详情。
+</Callout>
+
+### 在 Vercel 中添加公、私钥环境变量
+
+在 Vercel 的部署环境变量中，添加 `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` 和 `CLERK_SECRET_KEY` 环境变量。你可以在菜单中点击「API Keys」，然后复制对应的值填入 Vercel 的环境变量中。
+
+<Image
+  alt={'在 Clerk 中找到对应的公私钥环境变量'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/89883703-7a1a-4a11-b944-5d804544e57c'}
+></Image>
+
+此步骤所需的环境变量如下：
+
+```shell
+NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_live_xxxxxxxxxxx
+CLERK_SECRET_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxx
+```
+
+添加上述变量到 Vercel 中：
+
+<Image
+  alt={'在 Vercel 中添加 Clerk 公私钥环境变量'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/2bfa13df-6e20-4768-97c0-4dad06c85a2f'}
+></Image>
+
+### 在 Clerk 中创建并配置 Webhook
+
+由于我们让 Clerk 完全接管用户鉴权与管理，因此我们需要在 Clerk 用户生命周期变更时（创建、更新、删除）中通知我们的应用并存储落库。我们通过 Clerk 提供的 Webhook 来实现这一诉求。
+
+我们需要在 Clerk 的 Webhooks 中添加一个端点（Endpoint），告诉 Clerk 当用户发生变更时，向这个端点发送通知。
+
+<Image
+  alt={'Clerk 添加 Webhooks 端点'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/f50f47fb-5e8e-4930-bf4e-8cf6f5b8afb9'}
+></Image>
+
+在 endppint 中填写你的 Vercel 项目的 URL，如 `https://your-project.vercel.app/api/webhooks/clerk`。然后在订阅事件（Subscribe to events）中，勾选 user 的三个事件（`user.created` 、`user.deleted`、`user.updated`），然后点击创建。
+
+<Image
+  alt={'添加 Clerk Webhooks 时，配置 URL 和用户事件'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/0249ea56-ab17-4aa9-a56c-9ebd556c2645'}
+></Image>
+
+### 将 Webhook 秘钥添加到 Vercel 环境变量
+
+创建完毕后，可以在右下角找到该 Webhook 的秘钥：
+
+<Image
+  alt={'查看 Clerk Webhooks 秘钥'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/fab4abb2-584b-49de-9340-813382951635'}
+></Image>
+
+这个秘钥所对应的环境变量名为 `CLERK_WEBHOOK_SECRET`：
+
+```shell
+CLERK_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxxxxxxxxxxx
+```
+
+将其添加到 Vercel 的环境变量中：
+
+<Image
+  alt={'在 Vercel 中 添加 Clerk Webhooks 秘钥'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/5fdc9479-007f-46ab-9d6e-a9603e949116'}
+></Image>
+
+</Steps>
+
+这样，你已经成功配置了 Clerk 身份验证服务。接下来我们将配置 S3 存储服务。
+
+## 三、 配置 S3 存储服务
+
+LobeChat 在很早以前就支持了多模态 的 AI 会话，其中涉及到图片上传给 AI 的功能。在客户端数据库方案中，图片文件直接以二进制数据存储在浏览器 indexedDB 数据库，但在服务端数据库中这个方案并不可行。我们需要配置 S3 存储服务来存储大量的图片文件，同时 S3 也可以作为文件上传的存储方案。
+
+<Callout type={'info'}>
+  在本文，S3所指代的是指兼容 S3 存储方案，即支持 Amazon S3 API 的对象存储系统，常见例如 Cloudflare
+  R2 、阿里云 OSS 等均支持 S3 兼容 API。
+</Callout>
+
+  <Steps>
+
+    ### 配置并获取 S3 存储桶
+
+    你需要前往你的 S3 服务提供商（如 AWS S3、Cloudflare R2 等）并创建一个新的存储桶（Bucket）。接下来以 Cloudflare R2 为例，介绍创建流程。
+
+    下图是 Cloudflare R2 的界面：
+
+    <Image
+      alt={'Cloudflare R2 存储界面'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/41f7f677-0153-4a96-b849-5ac9b7ebefee'}
+    ></Image>
+
+    创建存储桶时将指定其名称，然后点击创建。
+    <Image
+      alt={'R2 创建存储桶'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/9c0d184c-3169-40fa-9115-011cfffb9ca7'}
+    ></Image>
+
+    ### 获取存储桶相关环境变量
+
+    在 R2 存储桶的设置中，可以看到桶配置的信息：
+
+    <Image
+      alt={'查看存储桶的相关信息'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/2ceb210c-eca0-4439-ba27-8734d4ebb3ee'}
+    ></Image>
+
+其对应的环境变量为：
+
+```shell
+# 存储桶的名称
+S3_BUCKET=lobechat
+# 存储桶的请求端点
+S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
+# 存储桶对外的访问域名
+NEXT_PUBLIC_S3_DOMAIN=https://s3-for-lobechat.your-domain.com
+```
+
+    ### 获取 S3 密钥环境变量
+
+    你需要获取 S3 的访问密钥，以便 LobeChat 的服务端有权限访问 S3 存储服务。在 R2 中，你可以在账户详情中配置访问密钥：
+
+    <Image
+      alt={'查看存储桶的访问秘钥'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/be0c95c0-6693-44ee-a490-7e8dfaa8b34d'}
+    ></Image>
+
+    点击右上角按钮创建 API token，进入创建 API Token 页面
+
+    <Image
+      alt={'创建对应 API token'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/7b0ea46c-5157-40a8-888f-f47664a4884f'}
+    ></Image>
+
+    鉴于我们的服务端数据库需要读写 S3 存储服务，因此权限需要选择读与写，并只选择我们所创建的存储桶，然后点击创建。
+
+    <Image
+      alt={'配置 API token 权限'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/d6f5a918-7b50-4d6e-83a6-3894ab930ddf'}
+    ></Image>
+
+    创建完成后，就可以看到对应的 S3 API token
+
+    <Image
+      alt={'复制 API token'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/763b18f9-2b5f-44bb-a479-9b56d46f7397'}
+    ></Image>
+
+    其对应的环境变量为：
+
+```shell
+S3_ACCESS_KEY_ID=9998d6757e276cf9f1edbd325b7083a6
+S3_SECRET_ACCESS_KEY=55af75d8eb6b99f189f6a35f855336ea62cd9c4751a5cf4337c53c1d3f497ac2
+```
+
+### 在 Vercel 中添加对应的环境变量
+
+    不同 S3 服务商获取所需环境变量的步骤可能有所不同，但最终获得到的环境变量应该都是一致的：
+
+```shell
+# S3 秘钥
+S3_ACCESS_KEY_ID=9998d6757e276cf9f1edbd325b7083a6
+S3_SECRET_ACCESS_KEY=55af75d8eb6b99f189f6a35f855336ea62cd9c4751a5cf4337c53c1d3f497ac2
+
+# 存储桶的名称
+S3_BUCKET=lobechat
+# 存储桶的请求端点
+S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
+# 存储桶对外的访问域名
+NEXT_PUBLIC_S3_DOMAIN=https://s3-dev.your-domain.com
+
+# 桶的区域，如 us-west-1，一般来说不需要添加，但某些服务商则需要配置
+# S3_REGION=us-west-1
+```
+
+然后将上述环境变量填入 Vercel 的环境变量中：
+
+    <Image
+      alt={'在  Vercel 中添加 S3 的环境变量'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/cd74152d-0ae8-44fd-b815-3307c56a3c18'}
+    ></Image>
+
+    ### 配置跨域
+
+    由于 S3 存储服务往往是一个独立的网址，因此需要配置跨域访问。
+
+    在 R2 中，你可以在存储桶的设置中找到跨域配置：
+
+    <Image
+      alt={'Cloudflare R2 的跨域设置'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/ab008be7-26b2-4b78-8bd9-24301bf34d23'}
+    ></Image>
+
+    添加跨域规则，允许你的域名（在上文是 `https://your-project.vercel.app`）来源的请求：
+
+    <Image
+      alt={'配置允许你的站点域名'}
+      src={'https://github.com/lobehub/lobe-chat/assets/28616219/dfcc2cb3-2958-4498-a8a4-51bec584fe7d'}
+    ></Image>
+
+示例配置如下：
+
+```json
+[
+  {
+    "AllowedOrigins": ["https://your-project.vercel.app"],
+    "AllowedMethods": ["GET", "PUT", "HEAD", "POST", "DELETE"],
+    "AllowedHeaders": ["*"]
+  }
+]
+```
+
+配置后点击保存即可。
+
+</Steps>
+
+## 四、部署并验证
+
+通过上述步骤之后，我们应该就完成了服务端数据库的配置。接下来我们可以将 LobeChat 部署到 Vercel 上，然后访问你的 Vercel 链接，验证服务端数据库是否正常工作。
+
+<Steps>
+  ### 重新部署最新的 commit
+
+配置好环境变量后，你需要重新部署最新的 commit，并等待部署完成。
+
+<Image
+  alt={'重新部署最新的 commit'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/b3a78112-adc8-4837-b4e3-48f67058f16e'}
+></Image>
+
+### 检查功能是否正常
+
+如果你点击左上角登录，可以正常显示登录弹窗，那么说明你已经配置成功了，尽情享用吧~
+
+<Image
+  alt={'用户登录弹窗'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/da84edc3-46f7-4e2b-a0cd-dc33a98bf5cb'}
+></Image>
+
+<Image
+  alt={'登录成功状态'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/9cb5150d-6e1e-4c59-9a18-4e418dce1a5d'}
+></Image>
+
+</Steps>
+
+## 附录
+
+### 服务端数据库环境变量一览
+
+为方便一键复制，在此汇总配置服务端数据所需要的环境变量：
+
+```shell
+# 指定服务模式为 server
+NEXT_PUBLIC_SERVICE_MODE=server
+
+# Postgres 数据库 URL
+DATABASE_URL=
+KEY_VAULTS_SECRET=jgwsK28dspyVQoIf8/M3IIHl1h6LYYceSYNXeLpy6uk=
+
+# Clerk 相关配置
+NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_live_xxxxxxxxxxx
+CLERK_SECRET_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxx
+CLERK_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxxxxxxxxxxx
+
+# S3 相关配置
+# S3 秘钥
+S3_ACCESS_KEY_ID=9998d6757e276cf9f1edbd325b7083a6
+S3_SECRET_ACCESS_KEY=55af75d8eb6b99f189f6a35f855336ea62cd9c4751a5cf4337c53c1d3f497ac2
+
+# 存储桶的名称
+S3_BUCKET=lobechat
+# 存储桶的请求端点
+S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
+# 存储桶对外的访问域名
+NEXT_PUBLIC_S3_DOMAIN=https://s3-for-lobechat.your-domain.com
+# 桶的区域，如 us-west-1，一般来说不需要添加，但某些服务商则需要配置
+# S3_REGION=us-west-1
+```

package/docs/self-hosting/advanced/settings-url-share.mdx

@@ -1,3 +1,17 @@
+---
+title: Share Settings via URL - Import and Export Configuration Settings
+description: >-
+  Learn how to import and export configuration settings for LobeChat via URL.
+  Understand the supported settings, URL format, and parameter schema for
+  keyVaults and languageModel.
+tags:
+  - Share Settings
+  - URL Import
+  - URL Export
+  - Configuration Settings
+  - LobeChat
+  - Parameter Schema
+---
 # Share settings via URL
 
 LobeChat support import settings from external URL to quickly set up LobeChat configuration.

package/docs/self-hosting/advanced/settings-url-share.zh-CN.mdx

@@ -1,3 +1,16 @@
+---
+title: URL 分享设置参数 - LobeChat 配置快速设置
+description: 了解如何从外部 URL 导入和导出 LobeChat 的设置参数，包括 keyVaults 和 languageModel，以及参数格式和类型。
+tags:
+  - URL 分享
+  - 设置参数
+  - LobeChat
+  - keyVaults
+  - languageModel
+  - JSON 格式
+  - URL 导入
+  - URL 导出
+---
 # URL 分享设置参数
 
 LobeChat 支持从外部 URL 导入设置参数，以便于快速设置 LobeChat 的配置。

package/docs/self-hosting/advanced/upstream-sync.zh-CN.mdx

@@ -101,38 +101,38 @@ OPENAI_MODEL_LIST=-gpt-4,-gpt-4-32k,-gpt-3.5-turbo-16k,gpt-3.5-turbo-1106=gpt-3.
 ```bash
 #!/bin/bash
 # auto-update-lobe-chat.sh
-
+ 
 # 设置代理（可选）
-export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890
-
+# export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890
+ 
 # 拉取最新的镜像并将输出存储在变量中
 output=$(docker pull lobehub/lobe-chat:latest 2>&1)
-
+ 
 # 检查拉取命令是否成功执行
 if [ $? -ne 0 ]; then
   exit 1
 fi
-
+ 
 # 检查输出中是否包含特定的字符串
 echo "$output" | grep -q "Image is up to date for lobehub/lobe-chat:latest"
-
+ 
 # 如果镜像已经是最新的，则不执行任何操作
 if [ $? -eq 0 ]; then
   exit 0
 fi
-
-echo "Detected Lobe-Chat update"
-
+ 
+echo "Detected lobe-chat update"
+ 
 # 删除旧的容器
-echo "Removed: $(docker rm -f Lobe-Chat)"
-
-# 运行新的容器
-echo "Started: $(docker run -d --network=host --env-file /path/to/lobe.env --name=Lobe-Chat --restart=always lobehub/lobe-chat)"
-
+echo "Removed: $(docker rm -f lobe-chat)"
+ 
+# 运行新的容器(请将env配置文件地址改为你的实际地址)
+echo "Started: $(docker run -d --network=host --env-file path/to/lobe.env --name=lobe-chat --restart=always lobehub/lobe-chat)"
+ 
 # 打印更新的时间和版本
 echo "Update time: $(date)"
 echo "Version: $(docker inspect lobehub/lobe-chat:latest | grep 'org.opencontainers.image.version' | awk -F'"' '{print $4}')"
-
+ 
 # 清理不再使用的镜像
 docker images | grep 'lobehub/lobe-chat' | grep -v 'latest' | awk '{print $3}' | xargs -r docker rmi > /dev/null 2>&1
 echo "Removed old images."

package/docs/usage/features/auth.mdx

@@ -0,0 +1,60 @@
+---
+title: Support Multi-User Management - Identity Verification Solutions
+description: >-
+  Explore LobeChat's user authentication solutions with next-auth and Clerk for
+  flexible and secure user management. Learn about features like user
+  registration, session management, multi-factor authentication, and more.
+tags:
+  - Multi-User Management
+  - Identity Verification
+  - next-auth
+  - Clerk
+  - User Authentication
+  - Session Management
+  - Multi-Factor Authentication
+  - User Management
+---
+# Support Multi-User Management
+
+<Image
+alt={'Identity Verification System'}
+cover
+src={'https://github.com/lobehub/lobe-chat/assets/17870709/8ce70e15-40df-451e-b700-66090fe5b8c2'}
+/>
+
+In modern applications, user management and identity verification are essential functions. To meet the diverse needs of different users, LobeChat provides two main user authentication and management solutions: `next-auth` and `Clerk`. Whether you are looking for simple user registration and login or need advanced multi-factor authentication and user management, LobeChat can flexibly accommodate your requirements.
+
+## next-auth: Flexible and Powerful Identity Verification Library
+
+LobeChat integrates `next-auth`, a flexible and powerful identity verification library that supports various authentication methods, including OAuth, email login, and credential login. With `next-auth`, you can easily achieve the following functions:
+
+- **User Registration and Login**: Support various authentication methods to meet different user needs.
+- **Session Management**: Efficiently manage user sessions to ensure security.
+- **Social Login**: Support quick login via various social platforms.
+- **Data Security**: Ensure the security and privacy of user data.
+
+<Callout type={'warning'}>
+Due to workload constraints, integration of next-auth with a server-side database has not been implemented yet. If you need to use a server-side database, please use Clerk.
+</Callout>
+
+<Callout type={'info'}>
+For information on using Next-Auth, you can refer to [Authentication Services - Next Auth](/docs/self-hosting/advanced/authentication#next-auth).
+</Callout>
+
+## Clerk: Modern User Management Platform
+
+For users requiring advanced user management features, LobeChat also supports [Clerk](https://clerk.com), a modern user management platform. Clerk offers richer functionality to help you achieve higher security and flexibility:
+
+- **Multi-Factor Authentication (MFA)**: Provides higher security protection.
+- **User Profile Management**: Conveniently manage user information and configurations.
+- **Login Activity Monitoring**: Real-time monitoring of user login activities to ensure account security.
+- **Scalability**: Supports complex user management requirements.
+
+<Callout type={'info'}>
+For information on using Clerk, you can refer to [Authentication Services - Clerk](/docs/self-hosting/advanced/authentication#clerk) .
+</Callout>
+
+<Callout type={'tip'}>
+If you need to use Clerk in conjunction with a server-side database, you can refer to the "Configuring Authentication Services" section in [Deploying with a Server-Side Database](/docs/self-hosting/advanced/server-database).
+</Callout>
+

package/docs/usage/features/auth.zh-CN.mdx

@@ -0,0 +1,58 @@
+---
+title: 多用户管理支持
+description: LobeChat 提供了多种用户认证和管理方案，以满足不同用户的需求。
+tags:
+  - LobeChat
+  - 用户管理
+  - next-auth
+  - Clerk
+  - 身份验证
+  - 多因素认证
+---
+
+# 身份验证系统 / 多用户管理支持
+
+<Image
+  alt={'身份验证系统'}
+  cover
+  src={'https://github.com/lobehub/lobe-chat/assets/17870709/8ce70e15-40df-451e-b700-66090fe5b8c2'}
+/>
+
+在现代应用中，用户管理和身份验证是至关重要的功能。为满足不同用户的多样化需求，LobeChat 提供了两种主要的用户认证和管理方案：`next-auth` 和 `Clerk`。无论您是追求简便的用户注册登录，还是需要更高级的多因素认证和用户管理，LobeChat 都可以灵活实现。
+
+## next-auth：灵活且强大的身份验证库
+
+LobeChat 集成了 `next-auth`，一个灵活且强大的身份验证库，支持多种身份验证方式，包括 OAuth、邮件登录、凭证登录等。通过 `next-auth`，您可以轻松实现以下功能：
+
+- **用户注册和登录**：支持多种认证方式，满足不同用户的需求。
+- **会话管理**：高效管理用户会话，确保安全性。
+- **社交登录**：支持多种社交平台的快捷登录。
+- **数据安全**：保障用户数据的安全性和隐私性。
+
+<Callout type={'warning'}>
+  由于工作量原因，目前还没有实现 next-auth 与服务端数据库的集成，如果需要使用服务端数据库，请使用
+  Clerk 。
+</Callout>
+
+<Callout type={'info'}>
+  关于 Next-Auth 的使用，可以查阅 [身份验证服务 - Next
+  Auth](/zh/docs/self-hosting/advanced/authentication#next-auth)。
+</Callout>
+
+## Clerk：现代化用户管理平台
+
+对于需要更高级用户管理功能的用户，LobeChat 还支持 [Clerk](https://clerk.com) ，一个现代化的用户管理平台。Clerk 提供了更丰富的功能，帮助您实现更高的安全性和灵活性：
+
+- **多因素认证 (MFA)**：提供更高的安全保障。
+- **用户配置文件管理**：便捷管理用户信息和配置。
+- **登录活动监控**：实时监控用户登录活动，确保账户安全。
+- **扩展性**：支持复杂的用户管理需求。
+
+<Callout type={'info'}>
+  关于 Clerk 的使用，可以查阅 [身份验证服务 - Clerk](/zh/docs/self-hosting/advanced/authentication#clerk)。
+</Callout>
+
+<Callout type={'tip'}>
+  如果需要在服务端数据库中搭配使用 Clerk 的使用，可以查阅 [使用服务端数据库部署](/zh/docs/self-hosting/advanced/server-database) 中的「配置身份验证服务」部分。
+</Callout>
+

package/docs/usage/features/database.mdx

@@ -0,0 +1,54 @@
+---
+title: LobeChat 支持本地 / 云端数据库存储
+description: LobeChat 支持本地 / 云端数据存储，既能实现 Local First，同时支持数据云同步。
+tags:
+  - LobeChat
+  - IndexedDB
+  - Postgres
+  - Local First
+  - 数据云同步
+  - 数据库
+---
+# Local / Cloud Data Storage
+
+<Image
+alt={'Local / Cloud Data Storage'}
+cover
+src={'https://github.com/lobehub/lobe-chat/assets/17870709/acf39ea2-74b3-46ae-8eb8-54a51f7f1d36'}
+/>
+
+In modern application development, the choice of data storage solution is crucial. To meet the needs of different users, LobeChat offers flexible configurations that support both local and server-side databases. Whether you prioritize data privacy and control or seek a convenient user experience, LobeChat can provide excellent solutions for you.
+
+## Local Database: Data Control and Privacy Protection
+
+For users who prefer more control over their data and value privacy protection, LobeChat offers support for local databases. By using IndexedDB as the storage solution and combining it with dexie as an Object-Relational Mapping (ORM) tool, LobeChat achieves efficient data management.
+
+Additionally, we have introduced Conflict-Free Replicated Data Type (CRDT) technology to ensure a seamless multi-device synchronization experience. This experimental feature aims to provide users with greater autonomy and data security.
+
+<Callout type={'info'}>LobeChat defaults to the local database solution to reduce the onboarding cost for new users.</Callout>
+
+Furthermore, we have attempted to introduce CRDT technology to achieve cross-device synchronization based on the local database. This experimental feature aims to provide users with greater autonomy and data security.
+
+## Server-Side Database: Convenient and Efficient User Experience
+
+For users who seek a convenient user experience, LobeChat supports PostgreSQL as the server-side database. By managing data with Dirzzle ORM and combining it with Clerk for authentication, LobeChat can offer users an efficient and reliable server-side data management solution.
+
+### Server-Side Database Technology Stack
+
+- **DB**: PostgreSQL (Neon is the default)
+- **ORM**: Dirzzle ORM
+- **Auth**: Clerk
+- **Server Router**: tRPC
+
+## Deployment Solution Selection Guide
+
+### 1. Local Database
+
+The local database solution is suitable for users who wish to have strict control over their data. With LobeChat's support for local databases, you can securely store and manage data without relying on external servers. This solution is particularly suitable for users with high requirements for data privacy.
+
+### 2. Server-Side Database
+
+The server-side database solution is ideal for users who want to simplify data management processes and enjoy a convenient user experience. Through server-side databases and user authentication, LobeChat can ensure the security and efficiency of data. If you want to learn how to configure a server-side database, please refer to our [detailed documentation](/docs/self-hosting/advanced/server-database).
+
+Whether you choose a local database or a server-side database, LobeChat can provide you with an excellent user experience.
+