安装后的第一步
查看初始化清单、接入邮件,然后决定接下来打开哪一篇定制指南。
项目已经运行,你也以管理员身份登录了。本页完成用户注册前需要的配置:查看初始化清单、接入邮件,然后开始把模板改成你自己的产品。
准备工作
- 一个按快速开始运行起来的项目。
- 已用管理员账号在
/auth/sign-in登录。 - 一个邮件服务商的凭据:Resend、Cloudflare Email 或阿里云邮件推送。
查看初始化清单
打开 /setup
页面读取实时配置,所以显示的是这套部署当前能做什么。每一项显示已就绪或未就绪,点击去配置会打开修复该项的页面。
检查必需项
有四项是必需的。其余标记为可选,只在产品需要时再配置。
| 项目 | 必需 | 在哪里配置 |
|---|---|---|
| 会话密钥 | 是 | .env 中的 BETTER_AUTH_SECRET;在快速开始里已经设置 |
| 登录方式 | 是 | 设置 → 认证配置;邮箱密码登录默认开启 |
| 邮件投递 | 是 | 设置 → 邮件配置 |
| 定时任务 | 是 | 本地不需要操作:pnpm dev 每分钟执行一轮。生产环境取决于部署平台,见排查项目问题 |
| 支付供应商 | 可选 | 设置 → 支付配置 |
| 对象存储 | 可选 | 设置 → 存储配置 |
| AI 渠道 | 可选 | 设置 → AI 配置 |
| 订阅供应商 | 可选 | 等待名单的服务商设置标签页,需要 newsletter 模块 |
| 分析供应商 | 可选 | 设置 → 分析配置 |
全新项目通常只缺邮件投递。定时任务会在服务启动后一分钟内变为已就绪。
接入邮件
在启用服务商之前,验证邮件和重置密码邮件都无法发送,所以先做这一步。
打开邮件配置
在 /setup 中点击邮件投递旁的去配置,或进入设置 → 邮件配置。
填写一个服务商
填写服务商凭据:Resend 填 API key;Cloudflare 填 Account ID 和 API token;阿里云填 AccessKey ID、AccessKey Secret 和发信地址。再设置邮件使用的发件人地址。
设为启用并保存
勾选设为当前邮件 provider,点击保存 provider。页面提示邮件 provider 配置已保存。
各服务商的细节、邮件模板和投递日志见发送事务邮件。
让项目成为你自己的
项目已经能用,但外观和文字仍然是模板的样子。下面每一项都有单独的指南。按这个顺序做,暂时用不到的可以跳过。
| 你想要 | 打开 |
|---|---|
| 换上自己的名称、域名、图标和分享图 | 换成自己的品牌 |
替换示例首页,并了解 /pricing | 替换落地页和定价页 |
| 修改配色和字体,或改造某个页面 | 使用设计系统 |
| 重写中英文文案 | 新增与修改文案 |
在 /app 或 /admin 下新增第一个产品页面 | 新增后台或工作台页面 |
见效最快的是第一项:编辑 src/config/site.ts,它保存站点名称、规范 URL、描述和社交分享图。
验证
回到 /setup。邮件投递现在显示已就绪,页面显示必需项已齐备。在隐私窗口中用另一个邮箱注册:验证邮件会从你设置的发件人地址发出。
常见问题
/setup 跳转到登录页
你还没有登录。用管理员账号在 /auth/sign-in 登录,然后重新打开 /setup。
/setup 显示无权限页面
你登录的账号不是管理员。请使用 pnpm db:bootstrap-super-admin 创建的账号登录。
保存后邮件投递仍显示未就绪
服务商保存了但没有设为启用,或者缺少必需的凭据。勾选设为当前邮件 provider,填写该服务商的全部凭据后再保存一次。
遇到了其他问题
排查项目问题列出了会话密钥、生成的类型、迁移、定时任务和 agent 相关的现象与修复方法。