---
title: 在 Netlify 上部署 LobeChat
description: >-
  学习如何在 Netlify 上部署 LobeChat，包括 Fork 仓库、准备 OpenAI API Key、导入到 Netlify
  工作台、配置站点名称与环境变量等步骤。
tags:
  - Netlify
  - LobeChat
  - 部署教程
  - OpenAI API Key
  - 环境配置
---

# 使用 Netlify 部署

如果想在 Netlify 上部署 LobeChat，可以按照以下步骤进行操作：

## Netlify 部署 LobeChat

<Steps>
  ### Fork LobeChat 仓库

  点击 Fork 按钮，将 LobeChat 仓库 Fork 到你的 GitHub 账号下。

  ### 准备好你的 OpenAI API Key

  前往 [OpenAI API Key](https://platform.openai.com/account/api-keys) 获取你的 OpenAI API Key

  ### 在 Netlify 工作台导入

  <Callout>经过测试，暂不支持类似 Vercel/Zeabur 的一键部署按钮，原因未知。因此需要手动导入</Callout>

  点击 「Import from git」

  <Image alt={'在 Netflix 工作台点击 「Import from git」'} height={362} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/31b999e5-2a74-45fc-935b-f036e72a684d'} />

  然后点击 「Deploy with Github」，并授权 Netlify 访问你的 GitHub 账号

  <Image alt={'授权 Netlify 访问你的 GitHub 账号'} height={273} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/c9c58141-5ec6-43f1-8d97-0a84a04dcdba'} />

  然后选择 LobeChat 项目：

  <Image alt={'选择 LobeChat github 项目'} height={228} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/6c3968a8-fbbb-4268-a587-edaced2d96af'} />

  ### 配置站点名称与环境变量

  在这一步，你需要配置你的站点，包括站点名称、构建命令、发布目录等。在「Site Name」字段填写上你的站点名称。其余配置如果没有特殊要求，无需修改，我们已经设定好了默认配置。

  <Image alt={'配置 LobeChat 站点名称'} height={712} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/f3885537-6d43-422f-b1b8-e70732401025'} />

  点击 「Add environment variables」按钮，添加站点环境变量：

  <Image alt={'添加 LobeChat 站点环境变量'} height={537} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/3b607482-4d99-455a-bc10-3090dd4fe3c5'} />

  以配置 OpenAI 为例，你需要添加的环境变量如下：

  | 环境变量               | 类型 | 描述                                                      | 示例                                                         |
  | ------------------ | -- | ------------------------------------------------------- | ---------------------------------------------------------- |
  | `OPENAI_API_KEY`   | 必选 | 这是你在 OpenAI 账户页面申请的 API 密钥                              | `sk-xxxxxx...xxxxxx`                                       |
  | `ACCESS_CODE`      | 必选 | 添加访问此服务的密码，你可以设置一个长密码以防被爆破，该值用逗号分隔时为密码数组                | `awCT74` 或 `e3@09!` or `code1,code2,code3`                 |
  | `OPENAI_PROXY_URL` | 可选 | 如果你手动配置了 OpenAI 接口代理，可以使用此配置项来覆盖默认的 OpenAI API 请求基础 URL | `https://aihubmix.com/v1` ，默认值：`https://api.openai.com/v1` |

  <Callout type={'tip'}>
    LobeChat 支持的完整环境变量列表请参考 [📘 环境变量](/zh/docs/self-hosting/environment-variables)
    部分
  </Callout>

  添加完成后，最后点击「Deploy lobe-chat」 进入部署阶段。

  <Image alt={'环境变量添加完成'} height={600} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/c9f74ec4-ce63-4ce9-b9e2-34bda6fda10b'} />

  ### 等待部署完成

  点击部署后，会进入站点详情页面，你可以点击青色字样的「Deploying your site」或者 「Building」 黄色标签查看部署进度。

  <Image alt={'Netlify 站点详情页'} height={396} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/a7fd85d5-fd32-4756-814e-ff7ab7567fe1'} />

  进入部署详情，你会看到下述界面，这意味着你的 LobeChat 正在部署中，只需等待部署完成即可。

  <Image alt={'LobeChat 部署构建中'} height={325} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/1ed8b13d-046e-47c8-bd61-116ffdf5d01b'} />

  部署构建过程中：

  <Image alt={'部署构建中'} height={558} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/1c82d707-cb6f-4924-b246-a5235a919864'} />

  ### 部署成功，开始使用

  如果你的界面中的 Deploy Log 如下所示，意味着你的 LobeChat 部署成功了。

  <Image alt={'部署成功'} height={558} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/c1f945d1-f3e2-4100-b6bb-24d4cb13c438'} />

  此时，你可以点击「Open production deploy」，即可访问你的 LobeChat 站点

  <Image alt={'访问你的 LobeChat 站点'} height={527} inStep src={'https://github.com/lobehub/lobe-chat/assets/28616219/b04723eb-64ad-4028-a901-dc4e4ee2d0c1'} />
</Steps>

## 绑定自定义域名（可选）

你可以使用 Netlify 提供的子域名，也可以选择绑定自定义域名。目前 Netlify 提供的域名还未被污染，大多数地区都可以直连。
