@lobehub/lobehub 2.1.1 → 2.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (201) hide show
  1. package/.env.example +4 -3
  2. package/.github/workflows/release-desktop-stable.yml +1 -1
  3. package/CHANGELOG.md +50 -0
  4. package/Dockerfile +6 -4
  5. package/README.md +3 -4
  6. package/README.zh-CN.md +3 -4
  7. package/apps/desktop/src/main/controllers/McpInstallCtr.ts +10 -10
  8. package/apps/desktop/src/main/controllers/NetworkProxyCtr.ts +6 -6
  9. package/apps/desktop/src/main/controllers/RemoteServerSyncCtr.ts +2 -2
  10. package/changelog/v2.json +14 -0
  11. package/docs/changelog/2025-03-02-new-models.mdx +1 -1
  12. package/docs/changelog/2025-03-02-new-models.zh-CN.mdx +1 -1
  13. package/docs/changelog/2025-04-06-exports.mdx +1 -1
  14. package/docs/changelog/2025-04-06-exports.zh-CN.mdx +1 -1
  15. package/docs/changelog/2025-05-08-desktop-app.mdx +2 -2
  16. package/docs/changelog/2025-05-08-desktop-app.zh-CN.mdx +2 -2
  17. package/docs/changelog/2025-06-08-claude-4.mdx +1 -1
  18. package/docs/changelog/2025-06-08-claude-4.zh-CN.mdx +1 -1
  19. package/docs/changelog/2025-07-08-mcp-market.mdx +1 -1
  20. package/docs/changelog/2025-07-08-mcp-market.zh-CN.mdx +1 -1
  21. package/docs/changelog/2025-08-08-image-generation.mdx +1 -1
  22. package/docs/changelog/2025-08-08-image-generation.zh-CN.mdx +1 -1
  23. package/docs/changelog/2025-09-08-gemini.mdx +1 -1
  24. package/docs/changelog/2025-09-08-gemini.zh-CN.mdx +1 -1
  25. package/docs/changelog/2025-10-08-python.mdx +1 -1
  26. package/docs/changelog/2025-10-08-python.zh-CN.mdx +1 -1
  27. package/docs/changelog/2025-11-08-comfy-ui.mdx +1 -1
  28. package/docs/changelog/2025-11-08-comfy-ui.zh-CN.mdx +1 -1
  29. package/docs/changelog/2025-12-20-mcp.mdx +1 -1
  30. package/docs/changelog/2025-12-20-mcp.zh-CN.mdx +1 -1
  31. package/docs/development/basic/add-new-authentication-providers.zh-CN.mdx +1 -1
  32. package/docs/development/basic/add-new-image-model.mdx +3 -3
  33. package/docs/development/basic/add-new-image-model.zh-CN.mdx +3 -3
  34. package/docs/development/basic/chat-api.mdx +10 -10
  35. package/docs/development/basic/chat-api.zh-CN.mdx +10 -10
  36. package/docs/development/basic/feature-development.mdx +4 -4
  37. package/docs/development/basic/feature-development.zh-CN.mdx +4 -4
  38. package/docs/development/basic/setup-development.mdx +4 -4
  39. package/docs/development/basic/setup-development.zh-CN.mdx +4 -4
  40. package/docs/development/internationalization/add-new-locale.mdx +1 -1
  41. package/docs/development/internationalization/add-new-locale.zh-CN.mdx +1 -1
  42. package/docs/development/internationalization/internationalization-implementation.mdx +5 -5
  43. package/docs/development/internationalization/internationalization-implementation.zh-CN.mdx +5 -5
  44. package/docs/development/others/lighthouse.mdx +8 -8
  45. package/docs/development/others/lighthouse.zh-CN.mdx +8 -8
  46. package/docs/development/start.mdx +3 -3
  47. package/docs/development/start.zh-CN.mdx +3 -3
  48. package/docs/self-hosting/advanced/feature-flags.mdx +1 -1
  49. package/docs/self-hosting/advanced/feature-flags.zh-CN.mdx +1 -1
  50. package/docs/self-hosting/advanced/knowledge-base.mdx +2 -2
  51. package/docs/self-hosting/advanced/knowledge-base.zh-CN.mdx +2 -2
  52. package/docs/self-hosting/advanced/online-search.mdx +1 -1
  53. package/docs/self-hosting/advanced/online-search.zh-CN.mdx +1 -1
  54. package/docs/self-hosting/advanced/redis/upstash.mdx +3 -3
  55. package/docs/self-hosting/advanced/redis/upstash.zh-CN.mdx +3 -3
  56. package/docs/self-hosting/advanced/redis.mdx +6 -6
  57. package/docs/self-hosting/advanced/redis.zh-CN.mdx +6 -6
  58. package/docs/self-hosting/advanced/s3/rustfs.mdx +116 -116
  59. package/docs/self-hosting/advanced/s3/rustfs.zh-CN.mdx +116 -117
  60. package/docs/self-hosting/advanced/upstream-sync.zh-CN.mdx +5 -5
  61. package/docs/self-hosting/auth/email.mdx +70 -0
  62. package/docs/self-hosting/auth/email.zh-CN.mdx +70 -0
  63. package/docs/self-hosting/{advanced/auth → auth}/legacy.mdx +10 -10
  64. package/docs/self-hosting/{advanced/auth → auth}/legacy.zh-CN.mdx +5 -5
  65. package/docs/self-hosting/{advanced/auth → auth}/next-auth/casdoor.zh-CN.mdx +3 -3
  66. package/docs/self-hosting/{advanced/auth → auth}/next-auth/keycloak.zh-CN.mdx +2 -2
  67. package/docs/self-hosting/{advanced/auth → auth}/next-auth/logto.zh-CN.mdx +2 -2
  68. package/docs/self-hosting/{advanced/auth → auth}/providers/apple.mdx +6 -6
  69. package/docs/self-hosting/{advanced/auth → auth}/providers/apple.zh-CN.mdx +6 -6
  70. package/docs/self-hosting/{advanced/auth → auth}/providers/auth0.mdx +12 -12
  71. package/docs/self-hosting/{advanced/auth → auth}/providers/auth0.zh-CN.mdx +12 -12
  72. package/docs/self-hosting/{advanced/auth → auth}/providers/authelia.mdx +13 -13
  73. package/docs/self-hosting/{advanced/auth → auth}/providers/authelia.zh-CN.mdx +13 -13
  74. package/docs/self-hosting/{advanced/auth → auth}/providers/authentik.mdx +13 -13
  75. package/docs/self-hosting/{advanced/auth → auth}/providers/authentik.zh-CN.mdx +13 -13
  76. package/docs/self-hosting/{advanced/auth → auth}/providers/casdoor.mdx +8 -8
  77. package/docs/self-hosting/{advanced/auth → auth}/providers/casdoor.zh-CN.mdx +7 -7
  78. package/docs/self-hosting/{advanced/auth → auth}/providers/cloudflare-zero-trust.mdx +7 -7
  79. package/docs/self-hosting/{advanced/auth → auth}/providers/cloudflare-zero-trust.zh-CN.mdx +6 -6
  80. package/docs/self-hosting/{advanced/auth → auth}/providers/cognito.mdx +13 -13
  81. package/docs/self-hosting/{advanced/auth → auth}/providers/cognito.zh-CN.mdx +13 -13
  82. package/docs/self-hosting/{advanced/auth → auth}/providers/feishu.mdx +10 -10
  83. package/docs/self-hosting/{advanced/auth → auth}/providers/feishu.zh-CN.mdx +10 -10
  84. package/docs/self-hosting/{advanced/auth → auth}/providers/generic-oidc.mdx +12 -12
  85. package/docs/self-hosting/{advanced/auth → auth}/providers/generic-oidc.zh-CN.mdx +12 -12
  86. package/docs/self-hosting/{advanced/auth → auth}/providers/github.mdx +10 -10
  87. package/docs/self-hosting/{advanced/auth → auth}/providers/github.zh-CN.mdx +10 -10
  88. package/docs/self-hosting/{advanced/auth → auth}/providers/google.mdx +10 -10
  89. package/docs/self-hosting/{advanced/auth → auth}/providers/google.zh-CN.mdx +10 -10
  90. package/docs/self-hosting/{advanced/auth → auth}/providers/keycloak.mdx +11 -11
  91. package/docs/self-hosting/{advanced/auth → auth}/providers/keycloak.zh-CN.mdx +11 -11
  92. package/docs/self-hosting/{advanced/auth → auth}/providers/logto.mdx +8 -8
  93. package/docs/self-hosting/{advanced/auth → auth}/providers/logto.zh-CN.mdx +7 -7
  94. package/docs/self-hosting/{advanced/auth → auth}/providers/microsoft.mdx +11 -11
  95. package/docs/self-hosting/{advanced/auth → auth}/providers/microsoft.zh-CN.mdx +11 -11
  96. package/docs/self-hosting/{advanced/auth → auth}/providers/okta.mdx +13 -13
  97. package/docs/self-hosting/{advanced/auth → auth}/providers/okta.zh-CN.mdx +13 -13
  98. package/docs/self-hosting/auth/providers/password.mdx +112 -0
  99. package/docs/self-hosting/auth/providers/password.zh-CN.mdx +103 -0
  100. package/docs/self-hosting/{advanced/auth → auth}/providers/wechat.mdx +10 -10
  101. package/docs/self-hosting/{advanced/auth → auth}/providers/wechat.zh-CN.mdx +10 -10
  102. package/docs/self-hosting/{advanced/auth → auth}/providers/zitadel.mdx +13 -13
  103. package/docs/self-hosting/{advanced/auth → auth}/providers/zitadel.zh-CN.mdx +13 -13
  104. package/docs/self-hosting/{advanced/auth.mdx → auth.mdx} +24 -81
  105. package/docs/self-hosting/{advanced/auth.zh-CN.mdx → auth.zh-CN.mdx} +23 -80
  106. package/docs/self-hosting/environment-variables/auth.mdx +7 -0
  107. package/docs/self-hosting/environment-variables/auth.zh-CN.mdx +7 -0
  108. package/docs/self-hosting/environment-variables/basic.mdx +0 -7
  109. package/docs/self-hosting/environment-variables/basic.zh-CN.mdx +0 -7
  110. package/docs/self-hosting/environment-variables/redis.mdx +1 -1
  111. package/docs/self-hosting/environment-variables/redis.zh-CN.mdx +1 -1
  112. package/docs/self-hosting/environment-variables.mdx +1 -1
  113. package/docs/self-hosting/examples/azure-openai.mdx +0 -1
  114. package/docs/self-hosting/examples/azure-openai.zh-CN.mdx +0 -1
  115. package/docs/self-hosting/faq/no-v1-suffix.mdx +3 -3
  116. package/docs/self-hosting/faq/no-v1-suffix.zh-CN.mdx +3 -3
  117. package/docs/self-hosting/{advanced → migration/v2}/auth/clerk-to-betterauth.mdx +7 -7
  118. package/docs/self-hosting/{advanced → migration/v2}/auth/clerk-to-betterauth.zh-CN.mdx +7 -7
  119. package/docs/self-hosting/{advanced → migration/v2}/auth/migration-internals.mdx +2 -2
  120. package/docs/self-hosting/{advanced → migration/v2}/auth/migration-internals.zh-CN.mdx +2 -2
  121. package/docs/self-hosting/{advanced → migration/v2}/auth/nextauth-to-betterauth.mdx +11 -11
  122. package/docs/self-hosting/{advanced → migration/v2}/auth/nextauth-to-betterauth.zh-CN.mdx +11 -11
  123. package/docs/self-hosting/migration/v2/breaking-changes.mdx +1 -1
  124. package/docs/self-hosting/migration/v2/breaking-changes.zh-CN.mdx +1 -1
  125. package/docs/self-hosting/platform/docker-compose.zh-CN.mdx +4 -4
  126. package/docs/self-hosting/platform/docker.mdx +5 -5
  127. package/docs/self-hosting/platform/docker.zh-CN.mdx +10 -10
  128. package/docs/self-hosting/platform/dokploy.mdx +1 -1
  129. package/docs/self-hosting/platform/dokploy.zh-CN.mdx +5 -5
  130. package/docs/self-hosting/platform/sealos.mdx +12 -12
  131. package/docs/self-hosting/platform/sealos.zh-CN.mdx +17 -17
  132. package/docs/self-hosting/platform/vercel.zh-CN.mdx +4 -4
  133. package/docs/self-hosting/start.mdx +3 -3
  134. package/docs/self-hosting/start.zh-CN.mdx +4 -4
  135. package/locales/en-US/auth.json +2 -1
  136. package/locales/en-US/authError.json +1 -0
  137. package/locales/en-US/metadata.json +1 -1
  138. package/locales/zh-CN/auth.json +1 -0
  139. package/locales/zh-CN/authError.json +1 -0
  140. package/netlify.toml +0 -1
  141. package/package.json +1 -1
  142. package/packages/types/src/serverConfig.ts +1 -0
  143. package/src/app/[variants]/(auth)/auth-error/page.tsx +4 -2
  144. package/src/app/[variants]/(auth)/signin/SignInEmailStep.tsx +57 -50
  145. package/src/app/[variants]/(auth)/signin/SignInPasswordStep.tsx +1 -1
  146. package/src/app/[variants]/(auth)/signin/page.tsx +2 -0
  147. package/src/app/[variants]/(auth)/signin/useSignIn.ts +2 -0
  148. package/src/app/[variants]/(auth)/signup/[[...signup]]/page.tsx +7 -0
  149. package/src/envs/app.ts +0 -2
  150. package/src/envs/auth.ts +3 -0
  151. package/src/libs/better-auth/define-config.ts +1 -1
  152. package/src/libs/better-auth/sso/providers/feishu.ts +15 -14
  153. package/src/libs/better-auth/sso/providers/wechat.ts +6 -3
  154. package/src/libs/next/proxy/define-config.ts +1 -1
  155. package/src/locales/default/auth.ts +3 -1
  156. package/src/locales/default/authError.ts +2 -0
  157. package/src/locales/default/metadata.ts +1 -1
  158. package/src/server/globalConfig/index.ts +1 -0
  159. package/src/server/ld.ts +1 -1
  160. package/src/store/chat/slices/topic/action.ts +1 -1
  161. package/src/store/electron/actions/settings.ts +7 -7
  162. package/src/store/electron/actions/sync.ts +11 -11
  163. package/src/store/global/actions/general.ts +12 -12
  164. package/src/store/global/initialState.ts +11 -11
  165. package/src/store/global/selectors/clientDB.ts +1 -1
  166. package/src/store/global/selectors/systemStatus.ts +1 -1
  167. package/src/store/image/slices/generationConfig/action.ts +12 -12
  168. package/src/store/image/utils/size.ts +11 -11
  169. package/src/store/library/slices/ragEval/actions/dataset.ts +1 -1
  170. package/src/store/serverConfig/selectors.ts +1 -0
  171. package/src/store/session/slices/session/initialState.ts +6 -6
  172. package/src/store/session/slices/session/reducers.ts +1 -1
  173. package/src/store/session/slices/sessionGroup/initialState.ts +2 -2
  174. package/src/store/tool/slices/customPlugin/action.ts +2 -2
  175. package/src/store/tool/slices/oldStore/action.ts +5 -5
  176. package/src/store/userMemory/slices/preference/action.ts +6 -6
  177. /package/docs/self-hosting/{advanced/auth → auth}/clerk.mdx +0 -0
  178. /package/docs/self-hosting/{advanced/auth → auth}/clerk.zh-CN.mdx +0 -0
  179. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/auth0.mdx +0 -0
  180. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/auth0.zh-CN.mdx +0 -0
  181. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/authelia.mdx +0 -0
  182. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/authelia.zh-CN.mdx +0 -0
  183. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/authentik.mdx +0 -0
  184. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/authentik.zh-CN.mdx +0 -0
  185. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/casdoor.mdx +0 -0
  186. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/cloudflare-zero-trust.mdx +0 -0
  187. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/cloudflare-zero-trust.zh-CN.mdx +0 -0
  188. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/github.mdx +0 -0
  189. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/github.zh-CN.mdx +0 -0
  190. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/google.mdx +0 -0
  191. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/google.zh-CN.mdx +0 -0
  192. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/keycloak.mdx +0 -0
  193. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/logto.mdx +0 -0
  194. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/microsoft-entra-id.mdx +0 -0
  195. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/microsoft-entra-id.zh-CN.mdx +0 -0
  196. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/okta.mdx +0 -0
  197. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/okta.zh-CN.mdx +0 -0
  198. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/wechat.mdx +0 -0
  199. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/wechat.zh-CN.mdx +0 -0
  200. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/zitadel.mdx +0 -0
  201. /package/docs/self-hosting/{advanced/auth → auth}/next-auth/zitadel.zh-CN.mdx +0 -0
@@ -1,10 +1,10 @@
1
1
  ---
2
- title: 在 LobeChat 中配置 Google 身份验证
3
- description: 学习如何在 LobeChat 中配置 Google SSO,包括在 Google Cloud Console 创建 OAuth 凭证和设置环境变量。
2
+ title: 在 LobeHub 中配置 Google 身份验证
3
+ description: 学习如何在 LobeHub 中配置 Google SSO,包括在 Google Cloud Console 创建 OAuth 凭证和设置环境变量。
4
4
  tags:
5
5
  - Google
6
6
  - 身份验证
7
- - LobeChat
7
+ - LobeHub
8
8
  - 单点登录
9
9
  ---
10
10
 
@@ -44,12 +44,12 @@ tags:
44
44
 
45
45
  ### 配置环境变量
46
46
 
47
- | 环境变量 | 类型 | 描述 |
48
- | -------------------------------- | -- | -------------------------------------- |
49
- | `AUTH_SECRET` | 必选 | 会话加密密钥,使用 `openssl rand -base64 32` 生成 |
50
- | `AUTH_SSO_PROVIDERS` | 必选 | 填写 `google` |
51
- | `AUTH_GOOGLE_ID` | 必选 | Google Cloud Console 中的 Client ID |
52
- | `AUTH_GOOGLE_SECRET` | 必选 | Google Cloud Console 中的 Client Secret |
47
+ | 环境变量 | 类型 | 描述 |
48
+ | -------------------- | -- | -------------------------------------- |
49
+ | `AUTH_SECRET` | 必选 | 会话加密密钥,使用 `openssl rand -base64 32` 生成 |
50
+ | `AUTH_SSO_PROVIDERS` | 必选 | 填写 `google` |
51
+ | `AUTH_GOOGLE_ID` | 必选 | Google Cloud Console 中的 Client ID |
52
+ | `AUTH_GOOGLE_SECRET` | 必选 | Google Cloud Console 中的 Client Secret |
53
53
 
54
54
  <Callout type={'tip'}>
55
55
  前往 [📘 环境变量](/zh/docs/self-hosting/environment-variables/auth#google)
@@ -58,7 +58,7 @@ tags:
58
58
  </Steps>
59
59
 
60
60
  <Callout type={'info'}>
61
- 部署成功后,用户将可以通过 Google 身份认证并使用 LobeChat
61
+ 部署成功后,用户将可以通过 Google 身份认证并使用 LobeHub
62
62
  </Callout>
63
63
 
64
64
  ## 常见问题
@@ -1,12 +1,12 @@
1
1
  ---
2
- title: Configuring Keycloak Authentication for LobeChat
2
+ title: Configuring Keycloak Authentication for LobeHub
3
3
  description: >-
4
- Learn how to configure Keycloak SSO for LobeChat, including creating a client
4
+ Learn how to configure Keycloak SSO for LobeHub, including creating a client
5
5
  and setting up environment variables.
6
6
  tags:
7
7
  - Keycloak
8
8
  - Authentication
9
- - LobeChat
9
+ - LobeHub
10
10
  - Single Sign-On
11
11
  ---
12
12
 
@@ -52,13 +52,13 @@ tags:
52
52
 
53
53
  ### Configure Environment Variables
54
54
 
55
- | Environment Variable | Type | Description |
56
- | -------------------------------- | -------- | --------------------------------------------------------------- |
57
- | `AUTH_SECRET` | Required | Session encryption key, generate with `openssl rand -base64 32` |
58
- | `AUTH_SSO_PROVIDERS` | Required | Set to `keycloak` |
59
- | `AUTH_KEYCLOAK_ID` | Required | Client ID |
60
- | `AUTH_KEYCLOAK_SECRET` | Required | Client Secret |
61
- | `AUTH_KEYCLOAK_ISSUER` | Required | `https://your-keycloak-domain/realms/your-realm` |
55
+ | Environment Variable | Type | Description |
56
+ | ---------------------- | -------- | --------------------------------------------------------------- |
57
+ | `AUTH_SECRET` | Required | Session encryption key, generate with `openssl rand -base64 32` |
58
+ | `AUTH_SSO_PROVIDERS` | Required | Set to `keycloak` |
59
+ | `AUTH_KEYCLOAK_ID` | Required | Client ID |
60
+ | `AUTH_KEYCLOAK_SECRET` | Required | Client Secret |
61
+ | `AUTH_KEYCLOAK_ISSUER` | Required | `https://your-keycloak-domain/realms/your-realm` |
62
62
 
63
63
  <Callout type={'tip'}>
64
64
  Go to [📘 Environment Variables](/docs/self-hosting/environment-variables/auth#keycloak)
@@ -68,7 +68,7 @@ tags:
68
68
 
69
69
  <Callout type={'info'}>
70
70
  After successful deployment, users will be able to authenticate with Keycloak
71
- and use LobeChat.
71
+ and use LobeHub.
72
72
  </Callout>
73
73
 
74
74
  ## Related Resources
@@ -1,10 +1,10 @@
1
1
  ---
2
- title: 在 LobeChat 中配置 Keycloak 身份验证
3
- description: 学习如何在 LobeChat 中配置 Keycloak SSO,包括创建客户端和设置环境变量。
2
+ title: 在 LobeHub 中配置 Keycloak 身份验证
3
+ description: 学习如何在 LobeHub 中配置 Keycloak SSO,包括创建客户端和设置环境变量。
4
4
  tags:
5
5
  - Keycloak
6
6
  - 身份验证
7
- - LobeChat
7
+ - LobeHub
8
8
  - 单点登录
9
9
  ---
10
10
 
@@ -50,13 +50,13 @@ tags:
50
50
 
51
51
  ### 配置环境变量
52
52
 
53
- | 环境变量 | 类型 | 描述 |
54
- | -------------------------------- | -- | ------------------------------------------------ |
55
- | `AUTH_SECRET` | 必选 | 会话加密密钥,使用 `openssl rand -base64 32` 生成 |
56
- | `AUTH_SSO_PROVIDERS` | 必选 | 填写 `keycloak` |
57
- | `AUTH_KEYCLOAK_ID` | 必选 | Client ID |
58
- | `AUTH_KEYCLOAK_SECRET` | 必选 | Client Secret |
59
- | `AUTH_KEYCLOAK_ISSUER` | 必选 | `https://your-keycloak-domain/realms/your-realm` |
53
+ | 环境变量 | 类型 | 描述 |
54
+ | ---------------------- | -- | ------------------------------------------------ |
55
+ | `AUTH_SECRET` | 必选 | 会话加密密钥,使用 `openssl rand -base64 32` 生成 |
56
+ | `AUTH_SSO_PROVIDERS` | 必选 | 填写 `keycloak` |
57
+ | `AUTH_KEYCLOAK_ID` | 必选 | Client ID |
58
+ | `AUTH_KEYCLOAK_SECRET` | 必选 | Client Secret |
59
+ | `AUTH_KEYCLOAK_ISSUER` | 必选 | `https://your-keycloak-domain/realms/your-realm` |
60
60
 
61
61
  <Callout type={'tip'}>
62
62
  前往 [📘 环境变量](/zh/docs/self-hosting/environment-variables/auth#keycloak)
@@ -65,7 +65,7 @@ tags:
65
65
  </Steps>
66
66
 
67
67
  <Callout type={'info'}>
68
- 部署成功后,用户将可以通过 Keycloak 身份认证并使用 LobeChat
68
+ 部署成功后,用户将可以通过 Keycloak 身份认证并使用 LobeHub
69
69
  </Callout>
70
70
 
71
71
  ## 相关资源
@@ -1,12 +1,12 @@
1
1
  ---
2
- title: Configuring Logto Authentication for LobeChat
2
+ title: Configuring Logto Authentication for LobeHub
3
3
  description: >-
4
- Learn how to configure Logto SSO for LobeChat, including creating an
4
+ Learn how to configure Logto SSO for LobeHub, including creating an
5
5
  application and setting up environment variables.
6
6
  tags:
7
7
  - Logto
8
8
  - Authentication
9
- - LobeChat
9
+ - LobeHub
10
10
  - Single Sign-On
11
11
  - OIDC
12
12
  ---
@@ -21,7 +21,7 @@ tags:
21
21
  1. Log in to your Logto Console
22
22
  2. Go to **Applications** and click **Create application**
23
23
  3. Select **Traditional web** as the application type
24
- 4. Fill in the application name: `LobeChat`
24
+ 4. Fill in the application name: `LobeHub`
25
25
  5. Configure redirect URIs:
26
26
 
27
27
  <Callout type={'info'}>
@@ -39,12 +39,12 @@ tags:
39
39
 
40
40
  ### Configure Environment Variables
41
41
 
42
- When deploying LobeChat, you need to configure the following environment variables:
42
+ When deploying LobeHub, you need to configure the following environment variables:
43
43
 
44
44
  | Environment Variable | Type | Description |
45
45
  | --------------------------- | -------- | ----------------------------------------------------------------------------- |
46
46
  | `AUTH_SECRET` | Required | Key used to encrypt session tokens. Generate using: `openssl rand -base64 32` |
47
- | `AUTH_SSO_PROVIDERS` | Required | SSO provider for LobeChat. Use `logto` for Logto |
47
+ | `AUTH_SSO_PROVIDERS` | Required | SSO provider for LobeHub. Use `logto` for Logto |
48
48
  | `AUTH_LOGTO_ID` | Required | App ID from Logto application |
49
49
  | `AUTH_LOGTO_SECRET` | Required | App Secret from Logto application |
50
50
  | `AUTH_LOGTO_ISSUER` | Required | Logto issuer URL (e.g., `https://your-tenant.logto.app/oidc`) |
@@ -56,7 +56,7 @@ tags:
56
56
 
57
57
  ### Configure Webhook (Optional)
58
58
 
59
- Configure Logto [Webhook](https://docs.logto.io/developers/webhooks/configure-webhooks) to sync user data updates to LobeChat.
59
+ Configure Logto [Webhook](https://docs.logto.io/developers/webhooks/configure-webhooks) to sync user data updates to LobeHub.
60
60
 
61
61
  1. Go to **Webhooks** in Logto Console and create a Webhook
62
62
  2. Fill in the following fields:
@@ -68,7 +68,7 @@ tags:
68
68
  </Steps>
69
69
 
70
70
  <Callout type={'info'}>
71
- After successful deployment, users will be able to authenticate with Logto and use LobeChat.
71
+ After successful deployment, users will be able to authenticate with Logto and use LobeHub.
72
72
  </Callout>
73
73
 
74
74
  ## Related Resources
@@ -1,10 +1,10 @@
1
1
  ---
2
- title: 在 LobeChat 中配置 Logto 身份验证
3
- description: 学习如何在 LobeChat 中配置 Logto SSO,包括创建应用和设置环境变量。
2
+ title: 在 LobeHub 中配置 Logto 身份验证
3
+ description: 学习如何在 LobeHub 中配置 Logto SSO,包括创建应用和设置环境变量。
4
4
  tags:
5
5
  - Logto
6
6
  - 身份验证
7
- - LobeChat
7
+ - LobeHub
8
8
  - 单点登录
9
9
  - OIDC
10
10
  ---
@@ -19,7 +19,7 @@ tags:
19
19
  1. 登录 Logto 控制台
20
20
  2. 前往 **Applications**,点击 **Create application**
21
21
  3. 选择 **Traditional web** 作为应用类型
22
- 4. 填写应用名称:`LobeChat`
22
+ 4. 填写应用名称:`LobeHub`
23
23
  5. 配置重定向 URI:
24
24
 
25
25
  <Callout type={'info'}>
@@ -37,7 +37,7 @@ tags:
37
37
 
38
38
  ### 配置环境变量
39
39
 
40
- 在部署 LobeChat 时,你需要配置以下环境变量:
40
+ 在部署 LobeHub 时,你需要配置以下环境变量:
41
41
 
42
42
  | 环境变量 | 类型 | 描述 |
43
43
  | --------------------------- | -- | --------------------------------------------------------- |
@@ -54,7 +54,7 @@ tags:
54
54
 
55
55
  ### 配置 Webhook(可选)
56
56
 
57
- 配置 Logto 的 [Webhook](https://docs.logto.io/developers/webhooks/configure-webhooks),以便在用户信息更新时 LobeChat 可以接收到通知并同步数据。
57
+ 配置 Logto 的 [Webhook](https://docs.logto.io/developers/webhooks/configure-webhooks),以便在用户信息更新时 LobeHub 可以接收到通知并同步数据。
58
58
 
59
59
  1. 前往 Logto 控制台的 `Webhooks`,创建一个 Webhook
60
60
  2. 填写以下字段:
@@ -65,7 +65,7 @@ tags:
65
65
  3. 创建后,复制 `签名密钥` 填写到环境变量 `LOGTO_WEBHOOK_SIGNING_KEY`
66
66
  </Steps>
67
67
 
68
- <Callout type={'info'}>部署成功后,用户将可以通过 Logto 身份认证并使用 LobeChat。</Callout>
68
+ <Callout type={'info'}>部署成功后,用户将可以通过 Logto 身份认证并使用 LobeHub。</Callout>
69
69
 
70
70
  ## 相关资源
71
71
 
@@ -1,14 +1,14 @@
1
1
  ---
2
- title: Configuring Microsoft Authentication for LobeChat
2
+ title: Configuring Microsoft Authentication for LobeHub
3
3
  description: >-
4
- Learn how to configure Microsoft (Entra ID / Azure AD) SSO for LobeChat,
4
+ Learn how to configure Microsoft (Entra ID / Azure AD) SSO for LobeHub,
5
5
  including creating applications in Azure Portal and setting up environment
6
6
  variables.
7
7
  tags:
8
8
  - Microsoft
9
9
  - Authentication
10
10
  - Azure AD
11
- - LobeChat
11
+ - LobeHub
12
12
  - Single Sign-On
13
13
  ---
14
14
 
@@ -70,12 +70,12 @@ tags:
70
70
 
71
71
  ### Configure Environment Variables
72
72
 
73
- | Environment Variable | Type | Description |
74
- | -------------------------------- | -------- | --------------------------------------------------------------- |
75
- | `AUTH_SECRET` | Required | Session encryption key, generate with `openssl rand -base64 32` |
76
- | `AUTH_SSO_PROVIDERS` | Required | Set to `microsoft` |
77
- | `AUTH_MICROSOFT_ID` | Required | Application (client) ID |
78
- | `AUTH_MICROSOFT_SECRET` | Required | Client secret value |
73
+ | Environment Variable | Type | Description |
74
+ | ----------------------- | -------- | --------------------------------------------------------------- |
75
+ | `AUTH_SECRET` | Required | Session encryption key, generate with `openssl rand -base64 32` |
76
+ | `AUTH_SSO_PROVIDERS` | Required | Set to `microsoft` |
77
+ | `AUTH_MICROSOFT_ID` | Required | Application (client) ID |
78
+ | `AUTH_MICROSOFT_SECRET` | Required | Client secret value |
79
79
 
80
80
  <Callout type={'info'}>
81
81
  **Alternative Environment Variables**: For backward compatibility, these
@@ -94,14 +94,14 @@ tags:
94
94
 
95
95
  <Callout type={'info'}>
96
96
  After successful deployment, users will be able to authenticate with Microsoft
97
- and use LobeChat.
97
+ and use LobeHub.
98
98
  </Callout>
99
99
 
100
100
  ## Common Issues
101
101
 
102
102
  ### Tenant Configuration
103
103
 
104
- By default, LobeChat uses `common` tenant which allows both organizational and personal Microsoft accounts. If you need single-tenant configuration, you may need to customize the tenant settings.
104
+ By default, LobeHub uses `common` tenant which allows both organizational and personal Microsoft accounts. If you need single-tenant configuration, you may need to customize the tenant settings.
105
105
 
106
106
  ### Client Secret Expiration
107
107
 
@@ -1,13 +1,13 @@
1
1
  ---
2
- title: 在 LobeChat 中配置 Microsoft 身份验证
2
+ title: 在 LobeHub 中配置 Microsoft 身份验证
3
3
  description: >-
4
- 学习如何在 LobeChat 中配置 Microsoft (Entra ID / Azure AD) SSO,包括在 Azure Portal
4
+ 学习如何在 LobeHub 中配置 Microsoft (Entra ID / Azure AD) SSO,包括在 Azure Portal
5
5
  创建应用和设置环境变量。
6
6
  tags:
7
7
  - Microsoft
8
8
  - 身份验证
9
9
  - Azure AD
10
- - LobeChat
10
+ - LobeHub
11
11
  - 单点登录
12
12
  ---
13
13
 
@@ -68,12 +68,12 @@ tags:
68
68
 
69
69
  ### 配置环境变量
70
70
 
71
- | 环境变量 | 类型 | 描述 |
72
- | -------------------------------- | -- | -------------------------------------- |
73
- | `AUTH_SECRET` | 必选 | 会话加密密钥,使用 `openssl rand -base64 32` 生成 |
74
- | `AUTH_SSO_PROVIDERS` | 必选 | 填写 `microsoft` |
75
- | `AUTH_MICROSOFT_ID` | 必选 | Application (client) ID |
76
- | `AUTH_MICROSOFT_SECRET` | 必选 | 客户端密钥值 |
71
+ | 环境变量 | 类型 | 描述 |
72
+ | ----------------------- | -- | -------------------------------------- |
73
+ | `AUTH_SECRET` | 必选 | 会话加密密钥,使用 `openssl rand -base64 32` 生成 |
74
+ | `AUTH_SSO_PROVIDERS` | 必选 | 填写 `microsoft` |
75
+ | `AUTH_MICROSOFT_ID` | 必选 | Application (client) ID |
76
+ | `AUTH_MICROSOFT_SECRET` | 必选 | 客户端密钥值 |
77
77
 
78
78
  <Callout type={'info'}>
79
79
  **兼容的环境变量**:为了向后兼容,以下别名也支持:
@@ -90,14 +90,14 @@ tags:
90
90
  </Steps>
91
91
 
92
92
  <Callout type={'info'}>
93
- 部署成功后,用户将可以通过 Microsoft 身份认证并使用 LobeChat
93
+ 部署成功后,用户将可以通过 Microsoft 身份认证并使用 LobeHub
94
94
  </Callout>
95
95
 
96
96
  ## 常见问题
97
97
 
98
98
  ### 租户配置
99
99
 
100
- 默认情况下,LobeChat 使用 `common` 租户,允许组织帐户和个人 Microsoft 帐户登录。如果需要单租户配置,可能需要自定义租户设置。
100
+ 默认情况下,LobeHub 使用 `common` 租户,允许组织帐户和个人 Microsoft 帐户登录。如果需要单租户配置,可能需要自定义租户设置。
101
101
 
102
102
  ### 客户端密钥过期
103
103
 
@@ -1,12 +1,12 @@
1
1
  ---
2
- title: Configuring Okta Authentication for LobeChat
2
+ title: Configuring Okta Authentication for LobeHub
3
3
  description: >-
4
- Learn how to configure Okta SSO for LobeChat, including creating an
4
+ Learn how to configure Okta SSO for LobeHub, including creating an
5
5
  application and setting up environment variables.
6
6
  tags:
7
7
  - Okta
8
8
  - Authentication
9
- - LobeChat
9
+ - LobeHub
10
10
  - Single Sign-On
11
11
  - OIDC
12
12
  ---
@@ -25,7 +25,7 @@ tags:
25
25
  - Sign-in method: **OIDC - OpenID Connect**
26
26
  - Application type: **Web Application**
27
27
  5. Configure the application:
28
- - App integration name: `LobeChat`
28
+ - App integration name: `LobeHub`
29
29
  - Sign-in redirect URIs: Add your callback URL
30
30
 
31
31
  <Callout type={'info'}>
@@ -42,15 +42,15 @@ tags:
42
42
 
43
43
  ### Configure Environment Variables
44
44
 
45
- When deploying LobeChat, you need to configure the following environment variables:
45
+ When deploying LobeHub, you need to configure the following environment variables:
46
46
 
47
- | Environment Variable | Type | Description |
48
- | -------------------------------- | -------- | ----------------------------------------------------------------------------- |
49
- | `AUTH_SECRET` | Required | Key used to encrypt session tokens. Generate using: `openssl rand -base64 32` |
50
- | `AUTH_SSO_PROVIDERS` | Required | SSO provider for LobeChat. Use `okta` for Okta |
51
- | `AUTH_OKTA_ID` | Required | Client ID from Okta application |
52
- | `AUTH_OKTA_SECRET` | Required | Client Secret from Okta application |
53
- | `AUTH_OKTA_ISSUER` | Required | Okta issuer URL (e.g., `https://your-okta-domain.okta.com`) |
47
+ | Environment Variable | Type | Description |
48
+ | -------------------- | -------- | ----------------------------------------------------------------------------- |
49
+ | `AUTH_SECRET` | Required | Key used to encrypt session tokens. Generate using: `openssl rand -base64 32` |
50
+ | `AUTH_SSO_PROVIDERS` | Required | SSO provider for LobeHub. Use `okta` for Okta |
51
+ | `AUTH_OKTA_ID` | Required | Client ID from Okta application |
52
+ | `AUTH_OKTA_SECRET` | Required | Client Secret from Okta application |
53
+ | `AUTH_OKTA_ISSUER` | Required | Okta issuer URL (e.g., `https://your-okta-domain.okta.com`) |
54
54
 
55
55
  <Callout type={'tip'}>
56
56
  Go to [📘 Environment Variables](/docs/self-hosting/environment-variables/auth#okta) for detailed information on these variables.
@@ -58,7 +58,7 @@ tags:
58
58
  </Steps>
59
59
 
60
60
  <Callout type={'info'}>
61
- After successful deployment, users will be able to authenticate with Okta and use LobeChat.
61
+ After successful deployment, users will be able to authenticate with Okta and use LobeHub.
62
62
  </Callout>
63
63
 
64
64
  ## Related Resources
@@ -1,10 +1,10 @@
1
1
  ---
2
- title: 在 LobeChat 中配置 Okta 身份验证
3
- description: 学习如何在 LobeChat 中配置 Okta SSO,包括创建应用和设置环境变量。
2
+ title: 在 LobeHub 中配置 Okta 身份验证
3
+ description: 学习如何在 LobeHub 中配置 Okta SSO,包括创建应用和设置环境变量。
4
4
  tags:
5
5
  - Okta
6
6
  - 身份验证
7
- - LobeChat
7
+ - LobeHub
8
8
  - 单点登录
9
9
  - OIDC
10
10
  ---
@@ -23,7 +23,7 @@ tags:
23
23
  - Sign-in method: **OIDC - OpenID Connect**
24
24
  - Application type: **Web Application**
25
25
  5. 配置应用:
26
- - App integration name: `LobeChat`
26
+ - App integration name: `LobeHub`
27
27
  - Sign-in redirect URIs: 添加回调 URL
28
28
 
29
29
  <Callout type={'info'}>
@@ -40,22 +40,22 @@ tags:
40
40
 
41
41
  ### 配置环境变量
42
42
 
43
- 在部署 LobeChat 时,你需要配置以下环境变量:
43
+ 在部署 LobeHub 时,你需要配置以下环境变量:
44
44
 
45
- | 环境变量 | 类型 | 描述 |
46
- | -------------------------------- | -- | ------------------------------------------------------- |
47
- | `AUTH_SECRET` | 必选 | 用于加密会话令牌的密钥。使用以下命令生成:`openssl rand -base64 32` |
48
- | `AUTH_SSO_PROVIDERS` | 必选 | SSO 提供商。使用 Okta 请填写 `okta` |
49
- | `AUTH_OKTA_ID` | 必选 | Okta 应用的 Client ID |
50
- | `AUTH_OKTA_SECRET` | 必选 | Okta 应用的 Client Secret |
51
- | `AUTH_OKTA_ISSUER` | 必选 | Okta Issuer URL(例如 `https://your-okta-domain.okta.com`) |
45
+ | 环境变量 | 类型 | 描述 |
46
+ | -------------------- | -- | ------------------------------------------------------- |
47
+ | `AUTH_SECRET` | 必选 | 用于加密会话令牌的密钥。使用以下命令生成:`openssl rand -base64 32` |
48
+ | `AUTH_SSO_PROVIDERS` | 必选 | SSO 提供商。使用 Okta 请填写 `okta` |
49
+ | `AUTH_OKTA_ID` | 必选 | Okta 应用的 Client ID |
50
+ | `AUTH_OKTA_SECRET` | 必选 | Okta 应用的 Client Secret |
51
+ | `AUTH_OKTA_ISSUER` | 必选 | Okta Issuer URL(例如 `https://your-okta-domain.okta.com`) |
52
52
 
53
53
  <Callout type={'tip'}>
54
54
  前往 [📘 环境变量](/zh/docs/self-hosting/environment-variables/auth#okta) 可查阅相关变量详情。
55
55
  </Callout>
56
56
  </Steps>
57
57
 
58
- <Callout type={'info'}>部署成功后,用户将可以通过 Okta 身份认证并使用 LobeChat。</Callout>
58
+ <Callout type={'info'}>部署成功后,用户将可以通过 Okta 身份认证并使用 LobeHub。</Callout>
59
59
 
60
60
  ## 相关资源
61
61
 
@@ -0,0 +1,112 @@
1
+ ---
2
+ title: Configuring Email/Password Authentication for LobeHub
3
+ description: >-
4
+ Learn how to configure email and password authentication for LobeHub,
5
+ including enabling/disabling options and SSO-only mode.
6
+ tags:
7
+ - Email
8
+ - Password
9
+ - Authentication
10
+ - LobeHub
11
+ ---
12
+
13
+ # Configuring Email/Password Authentication
14
+
15
+ LobeHub supports traditional email and password authentication out of the box.
16
+ This guide covers the available configuration options.
17
+
18
+ ## Default Behavior
19
+
20
+ By default, email/password authentication is enabled.
21
+ Users can register with their email address and set a password.
22
+
23
+ ## Configuration Options
24
+
25
+ ### Disable Email/Password Authentication (SSO-Only Mode)
26
+
27
+ If you want to force users to authenticate via SSO providers only,
28
+ set the following environment variable:
29
+
30
+ | Environment Variable | Type | Description |
31
+ | ----------------------------- | -------- | ------------------------------------------ |
32
+ | `AUTH_DISABLE_EMAIL_PASSWORD` | Optional | Set to `1` to disable email/password login |
33
+
34
+ When enabled:
35
+
36
+ - The email input field is hidden on the login page
37
+ - Only SSO provider buttons are displayed
38
+ - The signup page redirects to the login page
39
+ - Users must authenticate through configured SSO providers
40
+
41
+ <Callout type={'warning'}>
42
+ Before enabling SSO-only mode, ensure you have configured at least one SSO
43
+ provider via `AUTH_SSO_PROVIDERS`. Otherwise, users will have no way to log
44
+ in.
45
+ </Callout>
46
+
47
+ ### Enable Email Verification
48
+
49
+ To require users to verify their email address before signing in:
50
+
51
+ | Environment Variable | Type | Description |
52
+ | ------------------------- | -------- | ---------------------------------------- |
53
+ | `AUTH_EMAIL_VERIFICATION` | Optional | Set to `1` to require email verification |
54
+
55
+ This requires configuring an email service (SMTP).
56
+ See [Email Service Configuration](/docs/self-hosting/auth/email) for details.
57
+
58
+ ### Enable Magic Link Login
59
+
60
+ To allow passwordless login via email magic links:
61
+
62
+ | Environment Variable | Type | Description |
63
+ | ------------------------ | -------- | ------------------------------------- |
64
+ | `AUTH_ENABLE_MAGIC_LINK` | Optional | Set to `1` to enable magic link login |
65
+
66
+ This also requires configuring an email service (SMTP).
67
+
68
+ ## Change Password
69
+
70
+ Users can change their password in two ways:
71
+
72
+ 1. **Profile Settings**: Go to Settings > Profile to change password
73
+ 2. **Forgot Password**: On the login page, enter email, proceed to the password step, then click "Forgot Password" below the password input
74
+
75
+ <Callout type={'info'}>
76
+ Both methods require email service (SMTP) to be configured for sending
77
+ password reset emails.
78
+ </Callout>
79
+
80
+ ## Example Configurations
81
+
82
+ ### SSO-Only (Disable Email/Password)
83
+
84
+ ```bash
85
+ AUTH_DISABLE_EMAIL_PASSWORD=1
86
+ AUTH_SSO_PROVIDERS=google,github
87
+ ```
88
+
89
+ ### Email/Password with Verification
90
+
91
+ ```bash
92
+ AUTH_EMAIL_VERIFICATION=1
93
+ SMTP_HOST=smtp.example.com
94
+ SMTP_PORT=587
95
+ SMTP_USER=noreply@example.com
96
+ SMTP_PASS=your-password
97
+ ```
98
+
99
+ ### Email/Password with Magic Link
100
+
101
+ ```bash
102
+ AUTH_ENABLE_MAGIC_LINK=1
103
+ SMTP_HOST=smtp.example.com
104
+ SMTP_PORT=587
105
+ SMTP_USER=noreply@example.com
106
+ SMTP_PASS=your-password
107
+ ```
108
+
109
+ <Callout type={'tip'}>
110
+ Go to [Environment Variables](/docs/self-hosting/environment-variables/auth)
111
+ for detailed information on all authentication variables.
112
+ </Callout>