安装后的第一步

查看初始化清单、接入邮件,然后决定接下来打开哪一篇定制指南。

项目已经运行,你也以管理员身份登录了。本页完成用户注册前需要的配置:查看初始化清单、接入邮件,然后开始把模板改成你自己的产品。

准备工作

  • 一个按快速开始运行起来的项目。
  • 已用管理员账号在 /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 相关的现象与修复方法。

下一步