准备工作

准备概览

在开始使用 NuxtBase 之前，你需要进行一些准备工作，确保你具备所需的环境变量和相关账号。打开更目录下的.env.example文件，将其修改为.env。

点开.env你会看到相关的相关的环境变量，其中 supabse 相关的环境变量为启动项目时必填的环境变量。

# Supabase 配置（必填）
SUPABASE_URL=
SUPABASE_KEY=
SUPABASE_PRIVATE_KEY=

# OpenAI配置
OPENAI_API_KEY=
OPENAI_BASE_URL=

# 支付相关配置
ZPAY_NOTIFY_URL=http://localhost:3000/api/payment/zpay/notify
ZPAY_PAY_KEY=
ZPAY_PAY_PID=
ZPAY_PAY_TYPE=

# 百度统计配置
BAIDU_TONGJI_URL=

环境变量说明

1. 获取 Supabase 相关环境变量

# Supabase 配置（必填）
SUPABASE_URL=
SUPABASE_KEY=
SUPABASE_PRIVATE_KEY=

Supabase 相关的配置是必填的环境变量，不填入会导致项目无法正常启动！其余的配置你可以在开发对应功能的时候再进行配置。这里我将介绍分别从Supabase 官方和MemfireDB获取对应的变量。

Supabase：Supabase 官方服务商，提供全球范围内的数据库和后端服务。生态和文档都最为完备。
MemfireDB：国内 Supabase 服务商，兼容国内开发生态，中文开发者友好，内置 supabase 服务。

两者都属于 supabase 的服务商，提供的服务也基本相同，都有两个项目的免费额度。如果有不清楚如何选择的用户，我的选择建议是：

如果你的服务需要支持 Google OAuth 登录，且需要服务于海外用户，建议选择Supabase 官方
如果你的服务只是服务于国内用户，无需 Google OAuth 登录，建议选择MemfireDB

1.1 从 supabase 官网获取

进入【Project Settings】 - 【API】，获取到对应的 3 个环境变量

1.2 从 MemfireDB 获取

进入【应用设置】 - 【API】，获取到对应的 3 个环境变量

🎉 恭喜你！接入了 Supabase，你就完成了 NuxtBase 的所有后端能力接入（Auth、数据库、对象存储、OSS 等等）！接下来我们来给 NuxtBase 添加上 💳 支付能力吧。

2. 获取支付相关环境变量

ZPay 是支付宝及微信支付备案 ISV 服务商，资金安全有保障，无需营业执照就能解决个人收款痛点。
Nuxtbase 和 ZPay 无利益关系，只是目前个人认为该平台是国内独立开发者最好的收款服务商。

2.1 注册 ZPay 账号

为了集成个人支付功能，你需要注册 ZPay 账号。

2.2 增加支付渠道

注册成功后，你需要新增一个支付渠道（建议开通支付宝）才可以实现支付。

开通支付渠道有渠道开户费 88 元，开户失败 ZPay 是会全额退款的，这点你放心。这一步可能需要耗时 2-3 天，因为有审核环节，而且还需要开通银联结算渠道，因为 ZPay 会通过银联渠道直接结算到你的银行卡（✅ 建议：当然我这边还是建议使用一张你不常用的卡并定时转出，为了 100%的资金安全）。

相信我，当你走完开户流程后，你就知道 ZPay 是一个值得独立开发者信赖的国内支付服务商了。

个人建议作为独立开发者前期不用全部开通，开通支付宝渠道。因为目前 NuxtBase 默认支持的是支付宝支付，当然你想更改为微信也很简单，只需更改代码中的type:alipay为type:wxpay即可。

2.3 获取环境变量

当你开通完成支付渠道后，你就可以获取到对应的 ZPay 相关的环境变量了。具体如下图：

KEY：对应我们的.env中的ZPAY_PAY_KEY
PID：对应我们的.env中的ZPAY_PAY_PID
TYPE：对应我们的.env中的ZPAY_PAY_TYPE，alipay 或 wxpay
ZPAY_NOTIFY_URL：修改成自己的后端域名，并添加/api/payment/zpay/notify，作为 Zpay 支付成功后通知的回调地址

2.4 关注 ZPay 公众号

最后这一步虽然和 NuxtBase 无关，但是这边建议你关注一下 ZPay 的公众号并绑定你的账户，这样用户支付成功后你就能及时收到通知了！希望你也能我一样体验第一次收到支付通知的激动心情！

🎉 恭喜你，完成这一步，你就完成了 NuxtBase 支付能力的接入。我先在这里预祝你的产品能够大卖收款多多。接下来我们来最令人激动的 AI 能力的接入吧！

3. 选择一个你的 AI 服务商，获取 AI 服务商相关环境变量

根据你的需求选择一个兼容 OpenAI 的 AI 服务商，例如 DeepSeek、智谱清言或通义千问。每个服务商都差不多，你需要获取的是一个对应的API_KEY和BASE_URL。

国内的 AI 服务商很多，而且大部分人都赠送了非常慷慨的免费额度，你前期开发阶段完全不用担心 AI 的费用的问题。例如：

我们这里已 DeepSeek 为例：

OPENAI_API_KEY=your_api_key
OPENAI_BASE_URL=https://api.deepseek.com

🎉 恭喜你，你给你的应用接入了 AI 的能力！现在万事具备，你只需要你发挥你的创意开始编程，让我们来开启你的 AI 应用的开发吧！

NuxtBase