在Next.js站点上自托管设置

如果你想自托管TinaCMS后端,并且不想使用我们的预配置入门,你可以按照以下步骤进行。

我们提供了一个CLI初始化来快速设置后端,但它仅支持Next.js。在任何其他框架上,包括Astro,tinacms init backend会停止并报错,并指向此页面。如果你不使用Next.js,请遵循手动设置方法

更喜欢视频演示?查看这个视频:

设置

如果你已经在项目中设置了TinaCMS,请确保所有tina包都是最新版本。

在终端中运行:

这将设置TinaCMS(如果尚未安装)并添加自托管所需的后端部分。

这将提示你回答一些问题:

GitHub个人访问令牌

可以在GitHub账户设置中创建GitHub个人访问令牌。

确保为你的新仓库分配repo访问权限,并具有对内容的读/写访问权限。

选择数据库适配器

TinaCMS在初始化工作流中提供了两个数据库适配器:“Redis”(VercelKV)和“MongoDB”。了解更多关于数据库适配器的信息。

初始化命令的作用

初始化命令执行以下操作:

  • 设置页面/tina/[...routes].{ts, js}以处理TinaCMS GraphQL和身份验证请求
  • 设置tina/database.{ts, js}以处理数据库
    • 配置GitHub Git提供者
    • 配置数据库适配器
  • 配置TinaCMS Auth.js身份验证提供者
  • 安装所选Git提供者、数据库适配器和身份验证提供者所需的任何依赖项

初始化命令之后

初始化命令完成后,确保复制在终端中打印的环境变量。你还需要将这些添加到你的托管提供者中。

更新所有后端数据获取以使用新的数据库客户端

查看此页面以获取更多信息。

完成这些步骤后,devbuild命令应该可以使用了

下一步

  • 如果你想更改Git提供者、数据库适配器或身份验证提供者,请查看参考
  • 有问题吗?欢迎在我们的Discord中询问
Last Edited: September 18, 2025