@lobehub/lobehub 2.0.0-next.332 → 2.0.0-next.334

package/docs/self-hosting/advanced/desktop.zh-CN.mdx

@@ -42,11 +42,17 @@ LobeChat 桌面端可以与您自托管的 LobeChat 实例连接，以便您可
 
 #### OIDC 环境变量配置
 
-您需要在自托管实例中添加以下`ENABLE_OIDC` 和 `JWKS_KEY` 这两个环境变量，你可以点击下方按钮一键生成：
+您需要在自托管实例中添加以下`ENABLE_OIDC` 和 `JWKS_KEY` 这两个环境变量：
 
-<OIDCJWKs />
+```bash
+ENABLE_OIDC=1
+```
+
+点击下方按钮一键生成 `JWKS_KEY`：
+
+<GenerateJWKSKey />
 
-将生成的 JWK 密钥添加到您的环境变量中。
+将生成的环境变量添加到您的部署配置中。
 
 <Callout>如果您之前已配置 `OIDC_JWKS_KEY`，无需修改。系统会自动回退使用 `OIDC_JWKS_KEY`（向后兼容）。</Callout>
 

package/docs/self-hosting/advanced/feature-flags.mdx

@@ -1,8 +1,9 @@
 ---
 title: LobeChat Feature Flags Environment Variables Configuration Guide
 description: >-
-  Learn how to use environment variables to customize LobeChat's feature flags, including controlling whether a feature is enabled or disabled, or enabling or disabling features for specific user groups or environments as needed.
-
+  Learn how to use environment variables to customize LobeChat's feature flags,
+  including controlling whether a feature is enabled or disabled, or enabling or
+  disabling features for specific user groups or environments as needed.
 tags:
   - LobeChat
   - Environment Variables

package/docs/self-hosting/advanced/knowledge-base.mdx

@@ -1,8 +1,8 @@
 ---
 title: LobeChat Knowledge Base / File Upload
 description: >-
-  Explore LobeChat's file upload and knowledge base management features with core components.
-
+  Explore LobeChat's file upload and knowledge base management features with
+  core components.
 tags:
   - LobeChat
   - File Upload

package/docs/self-hosting/advanced/model-list.mdx

@@ -1,8 +1,8 @@
 ---
 title: Customizing Provider Model List in LobeChat for Deployment
 description: >-
-  Learn how to customize the model list in LobeChat for deployment with the syntax and extension capabilities
-
+  Learn how to customize the model list in LobeChat for deployment with the
+  syntax and extension capabilities
 tags:
   - LobeChat
   - model customization

package/docs/self-hosting/advanced/observability/grafana.mdx

@@ -1,7 +1,9 @@
 ---
-title: Observability with Grafana, Prometheus, and Tempo
+title: 'Observability with Grafana, Prometheus, and Tempo'
 description: >-
-  Monitor and analyze your LobeChat instance using Grafana dashboards, Prometheus metrics, and Tempo traces. This guide covers setup, configuration for self-hosted deployments.
+  Monitor and analyze your LobeChat instance using Grafana dashboards,
+  Prometheus metrics, and Tempo traces. This guide covers setup, configuration
+  for self-hosted deployments.
 tags:
   - Observability
   - Grafana

package/docs/self-hosting/advanced/observability/grafana.zh-CN.mdx

@@ -1,7 +1,8 @@
 ---
 title: 使用 Grafana、Prometheus 和 Tempo 进行可观测性监控
 description: >-
-  使用 Grafana、Prometheus 指标和 Tempo 链路追踪，监控和分析你的 LobeChat 实例。本指南涵盖自托管部署的搭建、配置和示例仪表盘。
+  使用 Grafana、Prometheus 指标和 Tempo 链路追踪，监控和分析你的 LobeChat
+  实例。本指南涵盖自托管部署的搭建、配置和示例仪表盘。
 tags:
   - 可观测性
   - Grafana

package/docs/self-hosting/advanced/observability/langfuse.mdx

@@ -1,8 +1,9 @@
 ---
 title: Observability and Tracing for LobeChat
 description: >-
-  Enhance your LobeChat applications with open-source observability and tracing using Langfuse. Automatically capture detailed traces and metrics for every request to optimize and debug your chats.
-
+  Enhance your LobeChat applications with open-source observability and tracing
+  using Langfuse. Automatically capture detailed traces and metrics for every
+  request to optimize and debug your chats.
 tags:
   - Observability
   - Tracing

package/docs/self-hosting/advanced/online-search.mdx

@@ -1,12 +1,10 @@
 ---
 title: >-
-  Configuring Online Search Functionality - Enhancing AI's Ability to Access Web Information
-
-
+  Configuring Online Search Functionality - Enhancing AI's Ability to Access Web
+  Information
 description: >-
-  Learn how to configure the SearXNG online search functionality for LobeChat, enabling AI to access the latest web information.
-
-
+  Learn how to configure the SearXNG online search functionality for LobeChat,
+  enabling AI to access the latest web information.
 tags:
   - Online Search
   - SearXNG

package/docs/self-hosting/advanced/s3/tencent-cloud.mdx

@@ -1,8 +1,8 @@
 ---
 title: Configuring Tencent Cloud COS Storage Service
 description: >-
-  Detailed steps to configure Tencent Cloud COS storage service for smooth file storage.
-
+  Detailed steps to configure Tencent Cloud COS storage service for smooth file
+  storage.
 tags:
   - Tencent Cloud COS
   - S3 Storage

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

@@ -1,8 +1,9 @@
 ---
 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.
-
+  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

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

@@ -1,8 +1,9 @@
 ---
 title: LobeChat Upstream Sync and Docker Deployment Guide
 description: >-
-  Learn how to enable automatic updates for LobeChat Vercel deployments and upgrade Docker deployment versions easily. Follow step-by-step instructions for a seamless deployment process.
-
+  Learn how to enable automatic updates for LobeChat Vercel deployments and
+  upgrade Docker deployment versions easily. Follow step-by-step instructions
+  for a seamless deployment process.
 tags:
   - Upstream Sync
   - Vercel Deployment
@@ -69,7 +70,6 @@ Upgrading the Docker deployment version is very simple, you just need to redeplo
   docker run -d -p 3210:3210 \
     -e OPENAI_API_KEY=sk-xxxx \
     -e OPENAI_PROXY_URL=https://api-proxy.com/v1 \
-    -e ACCESS_CODE=lobe66 \
     --name lobe-chat \
     lobehub/lobe-chat
   ```
@@ -93,7 +93,6 @@ If you wish to automate the above steps, you can follow the method below and use
   ```env
   OPENAI_API_KEY=sk-xxxx
   OPENAI_PROXY_URL=https://api-proxy.com/v1
-  ACCESS_CODE=arthals2333
   OPENAI_MODEL_LIST=-gpt-4,-gpt-4-32k,-gpt-3.5-turbo-16k,gpt-3.5-turbo-1106=gpt-3.5-turbo-16k,gpt-4-0125-preview=gpt-4-turbo,gpt-4-vision-preview=gpt-4-vision
   ```
 

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

@@ -65,7 +65,6 @@ Docker 部署版本的升级非常简单，只需要重新部署 LobeChat 的最
   docker run -d -p 3210:3210 \
     -e OPENAI_API_KEY=sk-xxxx \
     -e OPENAI_PROXY_URL=https://api-proxy.com/v1 \
-    -e ACCESS_CODE=lobe66 \
     --name lobe-chat \
     lobehub/lobe-chat
   ```
@@ -89,7 +88,6 @@ Docker 部署版本的升级非常简单，只需要重新部署 LobeChat 的最
   ```env
   OPENAI_API_KEY=sk-xxxx
   OPENAI_PROXY_URL=https://api-proxy.com/v1
-  ACCESS_CODE=arthals2333
   OPENAI_MODEL_LIST=-gpt-4,-gpt-4-32k,-gpt-3.5-turbo-16k,gpt-3.5-turbo-1106=gpt-3.5-turbo-16k,gpt-4-0125-preview=gpt-4-turbo,gpt-4-vision-preview=gpt-4-vision
   ```
 

package/docs/self-hosting/environment-variables/analytics.mdx

@@ -1,8 +1,9 @@
 ---
 title: Integrating Analytics in LobeChat
 description: >-
-  Learn how to configure environment variables for Vercel Analytics, Google Analytics, PostHog Analytics, and Umami Analytics in LobeChat for data collection and analysis.
-
+  Learn how to configure environment variables for Vercel Analytics, Google
+  Analytics, PostHog Analytics, and Umami Analytics in LobeChat for data
+  collection and analysis.
 tags:
   - Data Analytics
   - LobeChat

package/docs/self-hosting/environment-variables/auth.mdx

@@ -1,9 +1,9 @@
 ---
 title: LobeChat Authentication Service Environment Variables
 description: >-
-  Explore the essential environment variables for configuring authentication services in LobeChat, including Better Auth, OAuth SSO, NextAuth settings, and provider-specific details.
-
-
+  Explore the essential environment variables for configuring authentication
+  services in LobeChat, including Better Auth, OAuth SSO, NextAuth settings, and
+  provider-specific details.
 tags:
   - Authentication Service
   - Better Auth
@@ -20,13 +20,6 @@ LobeChat provides a complete authentication service capability when deployed. Th
 
 ### General Settings
 
-#### `NEXT_PUBLIC_ENABLE_BETTER_AUTH`
-
-- Type: Required
-- Description: Set to `1` to enable Better Auth service. When enabled, Better Auth will be used for authentication instead of Next Auth or Clerk.
-- Default: `-`
-- Example: `1`
-
 #### `AUTH_SECRET`
 
 - Type: Required
@@ -51,10 +44,10 @@ LobeChat provides a complete authentication service capability when deployed. Th
 #### `JWKS_KEY`
 
 - Type: Required
-- Description: Generic JWKS (JSON Web Key Set) key for signing and verifying JWTs. Used for internal service authentication and other cryptographic operations. Must be a JWKS JSON string containing an RS256 RSA key pair. Falls back to `OIDC_JWKS_KEY` if not set (for backward compatibility).
+- Description: JWKS (JSON Web Key Set) key for signing and verifying JWTs. Used for OIDC JWT token signing and internal service call authentication tokens. Must be a JWKS JSON string containing an RS256 RSA key pair.
 - Default: `-`
 
-<OIDCJWKs />
+<GenerateJWKSKey />
 
 #### `INTERNAL_JWT_EXPIRATION`
 

package/docs/self-hosting/environment-variables/auth.zh-CN.mdx

@@ -18,13 +18,6 @@ LobeChat 在部署时提供了完善的身份验证服务能力，以下是相
 
 ### 通用设置
 
-#### `NEXT_PUBLIC_ENABLE_BETTER_AUTH`
-
-- 类型：必选
-- 描述：设置为 `1` 以启用 Better Auth 服务。启用后，将使用 Better Auth 进行身份验证，而非 Next Auth 或 Clerk。
-- 默认值：`-`
-- 示例：`1`
-
 #### `AUTH_SECRET`
 
 - 类型：必选
@@ -49,10 +42,10 @@ LobeChat 在部署时提供了完善的身份验证服务能力，以下是相
 #### `JWKS_KEY`
 
 - 类型：必选
-- 描述：用于签名和验证 JWT 的通用 JWKS（JSON Web Key Set）密钥。用于内部服务认证和其他加密操作。必须是包含 RS256 RSA 密钥对的 JWKS JSON 字符串。如果未设置，将回退到 `OIDC_JWKS_KEY`（向后兼容）。
+- 描述：用于签名和验证 JWT 的 JWKS（JSON Web Key Set）密钥。用于 OIDC JWT token 签名和内部服务调用认证 token。必须是包含 RS256 RSA 密钥对的 JWKS JSON 字符串。
 - 默认值：`-`
 
-<OIDCJWKs />
+<GenerateJWKSKey />
 
 #### `INTERNAL_JWT_EXPIRATION`
 

package/docs/self-hosting/environment-variables/basic.mdx

@@ -1,13 +1,13 @@
 ---
 title: Customize LobeChat Deployment with Environment Variables
 description: >-
-  Learn about the common environment variables used to customize LobeChat deployment, including access code, OAuth SSO, base path, and default agent configuration.
-
+  Learn about the common environment variables used to customize LobeChat
+  deployment, including OAuth SSO, base path, and default agent
+  configuration.
 tags:
   - LobeChat
   - environment variables
   - deployment
-  - access code
   - OAuth SSO
   - base path
   - default agent configuration
@@ -19,13 +19,6 @@ LobeChat provides some additional configuration options during deployment, which
 
 ## Common Variables
 
-### `ACCESS_CODE`
-
-- Type: Optional
-- Description: Add a password to access the LobeChat service. You can set a long password to prevent brute force attacks.
-- Default: -
-- Example: `awCTe)re_r74` or `rtrt_ewee3@09!`
-
 ### `API_KEY_SELECT_MODE`
 
 - Type：Optional

package/docs/self-hosting/environment-variables/basic.zh-CN.mdx

@@ -16,13 +16,6 @@ LobeChat 在部署时提供了一些额外的配置项，你可以使用环境
 
 ## 通用变量
 
-### `ACCESS_CODE`
-
-- 类型：可选
-- 描述：添加访问 LobeChat 服务的密码，你可以设置一个长密码以防被爆破
-- 默认值：-
-- 示例：`awCTe)re_r74` or `rtrt_ewee3@09!`
-
 ### `API_KEY_SELECT_MODE`
 
 - 类型：可选

package/docs/self-hosting/environment-variables/model-provider.mdx

@@ -1,9 +1,9 @@
 ---
 title: LobeChat Model Service Providers - Environment Variables and Configuration
 description: >-
-  Learn about the environment variables and configuration settings for various model service providers like OpenAI, Google AI, AWS Bedrock, Ollama, Perplexity AI, Anthropic AI, Mistral AI, Groq AI, OpenRouter AI, and 01.AI.
-
-
+  Learn about the environment variables and configuration settings for various
+  model service providers like OpenAI, Google AI, AWS Bedrock, Ollama,
+  Perplexity AI, Anthropic AI, Mistral AI, Groq AI, OpenRouter AI, and 01.AI.
 tags:
   - Model Service Providers
   - Environment Variables
@@ -144,7 +144,6 @@ If you need to use Azure OpenAI to provide model services, you can refer to the
 - Default: `global`
 - Example: `us-central1`
 
-
 ### `VERTEXAI_MODEL_LIST`
 
 - Type: Optional

package/docs/self-hosting/environment-variables/s3.mdx

@@ -1,8 +1,8 @@
 ---
 title: Configuring S3 Storage Service
 description: >-
-  Learn how to configure S3 storage service to support multimodal AI sessions and image uploads.
-
+  Learn how to configure S3 storage service to support multimodal AI sessions
+  and image uploads.
 tags:
   - S3 Storage
   - Multimodal AI

package/docs/self-hosting/environment-variables.mdx

@@ -1,8 +1,8 @@
 ---
 title: LobeChat Environment Variables - Customizing Guide
 description: >-
-  Learn how to customize LobeChat configuration using environment variables for additional features and options.
-
+  Learn how to customize LobeChat configuration using environment variables for
+  additional features and options.
 tags:
   - LobeChat
   - Environment Variables
@@ -83,7 +83,6 @@ jobs:
           # List all variables you need to overwrite
           build-args: |
             NEXT_PUBLIC_BASE_PATH=${{ secrets.NEXT_PUBLIC_BASE_PATH }}
-            NEXT_PUBLIC_SERVICE_MODE=${{ secrets.NEXT_PUBLIC_SERVICE_MODE }}
 ```
 
 4. In your GitHub Repository settings > Secrets and variables > Actions > Repository secrets, add any `NEXT_PUBLIC` variables you want to override

package/docs/self-hosting/examples/azure-openai.mdx

@@ -1,8 +1,8 @@
 ---
 title: Configuring Azure OpenAI for LobeChat
 description: >-
-  Learn how to configure Azure OpenAI for LobeChat, including interface configuration, and deployment settings.
-
+  Learn how to configure Azure OpenAI for LobeChat, including interface
+  configuration, and deployment settings.
 tags:
   - Azure OpenAI
   - LobeChat
@@ -40,4 +40,3 @@ If you want the deployed version to be pre-configured with Azure OpenAI for end
 | `AZURE_ENDPOINT`     | Required | Azure API address, can be found in the "Keys and Endpoints" section when checking resources in the Azure portal                                                                                                                                                      | -                  | `https://docs-test-001.openai.azure.com`                                                                         |
 | `AZURE_API_VERSION`  | Required | Azure API version, following the format YYYY-MM-DD                                                                                                                                                                                                                   | 2023-08-01-preview | `-`, see [latest version](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference#chat-completions) |
 | `AZURE_MODEL_LIST`   | Required | Used to control the model list, use `+` to add a model, use `-` to hide a model, use `id->deplymentName=displayName` to customize the display name of a model, separated by commas. Definition syntax rules see [Model List](/docs/self-hosting/advanced/model-list) | -                  | `gpt-35-turbo->my-deploy=GPT 3.5 Turbo` or `gpt-4-turbo->my-gpt4=GPT 4 Turbo<128000:vision:fc>`                  |
-| `ACCESS_CODE`        | Optional | Add a password to access LobeChat. You can set a long password to prevent brute force attacks. When this value is separated by commas, it becomes an array of passwords                                                                                              | -                  | `awCT74` or `e3@09!` or `code1,code2,code3`                                                                      |

package/docs/self-hosting/examples/azure-openai.zh-CN.mdx

@@ -42,4 +42,3 @@ LobeChat 支持使用 [Azure OpenAI](https://learn.microsoft.com/zh-cn/azure/ai-
 | `AZURE_ENDPOINT`    | 必选 | Azure API 地址，从 Azure 门户检查资源时，可在 “密钥和终结点” 部分中找到此值                                                                | -                  | `https://docs-test-001.openai.azure.com`                                                            |
 | `AZURE_API_VERSION` | 必选 | Azure 的 API 版本，遵循 YYYY-MM-DD 格式                                                                                 | 2023-08-01-preview | `-`，查阅[最新版本](https://learn.microsoft.com/zh-cn/azure/ai-services/openai/reference#chat-completions) |
 | `AZURE_MODEL_LIST`  | 必选 | 用来控制模型列表，使用 `模型名->部署名=展示名` 来自定义模型的展示名，用英文逗号隔开。支持扩展能力，其余语法规则详见 [模型列表](/zh/docs/self-hosting/advanced/model-list) | -                  | `gpt-35-turbo->my-deploy=GPT 3.5 Turbo` 或 `gpt-4-turbo->my-gpt4=GPT 4 Turbo<128000:vision:fc>`      |
-| `ACCESS_CODE`       | 可选 | 添加访问 LobeChat 的密码，你可以设置一个长密码以防被爆破，该值用逗号分隔时为密码数组                                                                 | -                  | `awCT74` 或 `e3@09!` or `code1,code2,code3`                                                          |

package/docs/self-hosting/examples/ollama.mdx

@@ -1,8 +1,9 @@
 ---
 title: Integrating LobeChat with Ollama for Enhanced Language Models
 description: >-
-  Learn how to configure and deploy LobeChat to leverage Ollama's powerful language models locally. Follow the guide to run Ollama and LobeChat on your system.
-
+  Learn how to configure and deploy LobeChat to leverage Ollama's powerful
+  language models locally. Follow the guide to run Ollama and LobeChat on your
+  system.
 tags:
   - Ollama integration
   - LobeChat configuration

package/docs/self-hosting/faq/no-v1-suffix.mdx

@@ -1,10 +1,10 @@
 ---
 title: >-
-  Troubleshooting `OPENAI_PROXY_URL` in LobeChat Configuration for Empty Response
-
+  Troubleshooting `OPENAI_PROXY_URL` in LobeChat Configuration for Empty
+  Response
 description: >-
-  Learn how to troubleshoot and resolve the issue of receiving an empty response after configuring the LobeChat `OPENAI_PROXY_URL` environment variable.
-
+  Learn how to troubleshoot and resolve the issue of receiving an empty response
+  after configuring the LobeChat `OPENAI_PROXY_URL` environment variable.
 tags:
   - OPENAI_PROXY_URL
   - environment variable

package/docs/self-hosting/faq/proxy-with-unable-to-verify-leaf-signature.mdx

@@ -1,8 +1,9 @@
 ---
 title: Resolving `UNABLE_TO_VERIFY_LEAF_SIGNATURE` Error in LobeChat When Using Proxy
 description: >-
-  Learn how to bypass Node.js certificate validation to resolve certificate verification errors in LobeChat when using a proxy with self-signed or untrusted certificates.
-
+  Learn how to bypass Node.js certificate validation to resolve certificate
+  verification errors in LobeChat when using a proxy with self-signed or
+  untrusted certificates.
 tags:
   - Node.js
   - certificate validation

package/docs/self-hosting/faq/vercel-ai-image-timeout.mdx

@@ -1,8 +1,8 @@
 ---
 title: Resolving AI Image Generation Timeout on Vercel
 description: >-
-  Learn how to resolve timeout issues when using AI image generation models like gpt-image-1 on Vercel by enabling Fluid Compute for extended execution time.
-
+  Learn how to resolve timeout issues when using AI image generation models like
+  gpt-image-1 on Vercel by enabling Fluid Compute for extended execution time.
 tags:
   - Vercel
   - AI Image Generation

package/docs/self-hosting/migration/v2/breaking-changes.mdx

@@ -0,0 +1,73 @@
+---
+title: LobeHub 2.0 Breaking Changes
+description: >-
+  A comprehensive guide to breaking changes in LobeHub 2.0 and how to migrate
+  from version 1.x.
+tags:
+  - LobeHub 2.0
+  - Migration
+  - Breaking Changes
+  - Authentication
+---
+
+# LobeHub 2.0 Breaking Changes
+
+This document outlines the breaking changes introduced in LobeHub 2.0 and provides migration guidance for users upgrading from version 1.x.
+
+## Removed Environment Variables
+
+The following environment variables have been removed in LobeHub 2.0:
+
+| Environment Variable                | Removal Reason                                                    |
+| ----------------------------------- | ----------------------------------------------------------------- |
+| `ACCESS_CODE`                       | No longer supported, use Better Auth authentication system        |
+| `NEXT_PUBLIC_SERVICE_MODE`          | 2.0 only supports Server DB mode, Client DB (PGlite) removed      |
+| `NEXT_PUBLIC_ENABLE_BETTER_AUTH`    | Automatically detected via `AUTH_SECRET` presence                 |
+| `NEXT_PUBLIC_AUTH_URL` / `AUTH_URL` | Automatically detected from request headers                       |
+| `NEXT_PUBLIC_ENABLE_NEXT_AUTH`      | NextAuth removed                                                  |
+| `NEXT_AUTH_SECRET`                  | NextAuth removed                                                  |
+| `NEXT_AUTH_SSO_PROVIDERS`           | NextAuth removed                                                  |
+| `NEXTAUTH_URL`                      | NextAuth removed                                                  |
+| `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` | Clerk removed                                                     |
+| `CLERK_SECRET_KEY`                  | Clerk removed                                                     |
+
+## New Required Environment Variables
+
+LobeHub 2.0 only supports Better Auth authentication system. The following environment variables are now required:
+
+- `AUTH_SECRET`: Used to encrypt session tokens
+- `JWKS_KEY`: Used to sign and verify JWTs, including OIDC JWT tokens and internal service call authentication tokens
+
+## New Optional Environment Variables
+
+| Environment Variable               | Description                                                      |
+| ---------------------------------- | ---------------------------------------------------------------- |
+| `AUTH_SSO_PROVIDERS`               | Comma-separated list of enabled SSO providers                    |
+| `INTERNAL_JWT_EXPIRATION`          | Internal JWT token expiration time (default: `30s`)              |
+| `NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION` | Set to `1` to require email verification                      |
+| `SMTP_HOST`                        | SMTP server hostname for email features                          |
+| `SMTP_PORT`                        | SMTP server port                                                 |
+| `SMTP_USER`                        | SMTP authentication username                                     |
+| `SMTP_PASS`                        | SMTP authentication password                                     |
+
+For detailed configuration, see [Authentication Environment Variables](/docs/self-hosting/environment-variables/auth).
+
+## Authentication System Changes
+
+LobeHub 2.0 only supports Better Auth authentication system. NextAuth and Clerk are no longer supported.
+
+## Migration Guide
+
+### Migrating from NextAuth
+
+Detailed migration guide coming soon.
+
+### Migrating from Clerk
+
+Detailed migration guide coming soon.
+
+## Database Mode Changes
+
+LobeHub 2.0 only supports Server DB mode. Client DB (PGlite) is no longer supported. If you were using `NEXT_PUBLIC_SERVICE_MODE=client`, you need to migrate to Server DB deployment.
+
+For deployment guides, see [Server Database Deployment](/docs/self-hosting/server-database).

package/docs/self-hosting/migration/v2/breaking-changes.zh-CN.mdx

@@ -0,0 +1,71 @@
+---
+title: LobeHub 2.0 破坏性变更
+description: LobeHub 2.0 破坏性变更完整指南，帮助用户从 1.x 版本升级到 2.0 版本。
+tags:
+  - LobeHub 2.0
+  - 迁移指南
+  - 破坏性变更
+  - 身份验证
+---
+
+# LobeHub 2.0 破坏性变更
+
+本文档概述了 LobeHub 2.0 中引入的破坏性变更，并为从 1.x 版本升级的用户提供迁移指南。
+
+## 移除的环境变量
+
+以下环境变量在 LobeHub 2.0 中已被移除：
+
+| 环境变量                             | 移除原因                                                 |
+| ----------------------------------- | ------------------------------------------------------- |
+| `ACCESS_CODE`                       | 不再支持，请使用 Better Auth 认证系统                      |
+| `NEXT_PUBLIC_SERVICE_MODE`          | 2.0 仅支持 Server DB 模式，不再支持 Client DB (PGlite)    |
+| `NEXT_PUBLIC_ENABLE_BETTER_AUTH`    | 通过 `AUTH_SECRET` 是否存在自动检测                       |
+| `NEXT_PUBLIC_AUTH_URL` / `AUTH_URL` | 从请求头中自动检测                                        |
+| `NEXT_PUBLIC_ENABLE_NEXT_AUTH`      | NextAuth 已移除                                          |
+| `NEXT_AUTH_SECRET`                  | NextAuth 已移除                                          |
+| `NEXT_AUTH_SSO_PROVIDERS`           | NextAuth 已移除                                          |
+| `NEXTAUTH_URL`                      | NextAuth 已移除                                          |
+| `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` | Clerk 已移除                                             |
+| `CLERK_SECRET_KEY`                  | Clerk 已移除                                             |
+
+## 新增的必需环境变量
+
+LobeHub 2.0 仅支持 Better Auth 认证系统。以下环境变量现在是必需的：
+
+- `AUTH_SECRET`：用于加密会话令牌
+- `JWKS_KEY`：用于签名和验证 JWT，包括 OIDC JWT token 和内部服务调用认证 token
+
+## 新增的可选环境变量
+
+| 环境变量                               | 说明                                    |
+| ------------------------------------- | -------------------------------------- |
+| `AUTH_SSO_PROVIDERS`                  | 启用的 SSO 提供商列表，以逗号分隔          |
+| `INTERNAL_JWT_EXPIRATION`             | 内部 JWT 令牌过期时间（默认：`30s`）       |
+| `NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION` | 设置为 `1` 以要求邮箱验证                 |
+| `SMTP_HOST`                           | 邮件功能的 SMTP 服务器主机名              |
+| `SMTP_PORT`                           | SMTP 服务器端口                          |
+| `SMTP_USER`                           | SMTP 认证用户名                          |
+| `SMTP_PASS`                           | SMTP 认证密码                            |
+
+详细配置请参阅[身份验证环境变量](/docs/self-hosting/environment-variables/auth)。
+
+## 认证系统变更
+
+LobeHub 2.0 仅支持 Better Auth 认证系统，不再支持 NextAuth 和 Clerk。
+
+## 迁移指南
+
+### 从 NextAuth 迁移
+
+详细迁移指南即将推出。
+
+### 从 Clerk 迁移
+
+详细迁移指南即将推出。
+
+## 数据库模式变更
+
+LobeHub 2.0 仅支持 Server DB 模式，不再支持 Client DB (PGlite)。如果您之前使用 `NEXT_PUBLIC_SERVICE_MODE=client`，需要迁移到 Server DB 部署方式。
+
+详细部署指南请参阅[服务端数据库部署](/docs/self-hosting/server-database)。

package/docs/self-hosting/platform/alibaba-cloud.mdx

@@ -1,13 +1,12 @@
 ---
 title: Deploy LobeChat on Alibaba Cloud
 description: >-
-  Learn how to deploy the LobeChat application on Alibaba Cloud, including preparing the large model API Key, clicking the deploy button, and other operations.
-
+  Learn how to deploy the LobeChat application on Alibaba Cloud, including
+  clicking the deploy button and other operations.
 tags:
   - Alibaba Cloud
   - LobeChat
   - Alibaba Cloud Compute Nest
-  - API Key
 ---
 
 # Deploy LobeChat with Alibaba Cloud
@@ -17,10 +16,6 @@ If you want to deploy LobeChat on Alibaba Cloud, you can follow the steps below:
 ## Alibaba Cloud Deployment Process
 
 <Steps>
-  ### Prepare your API Key
-
-  Go to [OpenAI API Key](https://platform.openai.com/account/api-keys) to get your OpenAI API Key. Or go to [Tongyi Qianwen API Key](https://bailian.console.aliyun.com/?apiKey=1#/api-key) to get your API Key.
-
   ### One-click to deploy
 
   [![][deploy-button-image]][deploy-link]

package/docs/self-hosting/platform/alibaba-cloud.zh-CN.mdx

@@ -1,11 +1,10 @@
 ---
 title: 在 阿里云 上部署 LobeChat
-description: 学习如何在阿里云上部署LobeChat应用，包括准备大模型 API Key、点击部署按钮等操作。
+description: 学习如何在阿里云上部署 LobeChat 应用，包括点击部署按钮等操作。
 tags:
   - 阿里云
   - LobeChat
   - 部署流程
-  - 大模型 API Key
 ---
 
 # 使用 阿里云计算巢 部署
@@ -15,10 +14,6 @@ tags:
 ## 阿里云 部署流程
 
 <Steps>
-  ### 准备好你的 API Key
-
-  前往 [OpenAI API Key](https://platform.openai.com/account/api-keys) 获取你的 OpenAI API Key 或 前往 [通义千问 API Key](https://bailian.console.aliyun.com/?apiKey=1#/api-key) 获取你的通义千问 API Key
-
   ### 点击下方按钮进行部署
 
   [![][deploy-button-image]][deploy-link]