LogoMkSaaS文档
LogoMkSaaS文档
首页模板介绍入门文档环境配置
网站配置

功能集成

数据库身份验证邮件邮件订阅存储支付积分定时任务AI 功能统计分析通知验证码聊天框联盟营销

自定义

元数据字体主题图片国际化博客文档组件页面落地页用户管理

代码库

代码库IDE 设置项目结构格式化和代码检查更新代码库
X (Twitter)

入门文档

学习如何在几分钟内设置和运行您的目录网站

本文档将引导您完成 MkSaaS 的设置。我们将介绍克隆项目、安装依赖项、设置数据库和运行本地开发服务器的过程。

前提条件

在开始之前,请确保您已安装以下软件:

Node.js

Node.js 是一个允许您运行 JavaScript 代码的运行时环境。

如果您没有安装 Node.js,请从 Node.js 官方网站 下载。

# 检查是否安装了 Node.js
node --version

Git

Git 是一个版本控制系统,用于跟踪任何文件的更改。

如果未安装 Git,请从 Git 官方网站 下载。

# 检查是否安装了 Git
git --version

包管理器

包管理器是用于管理项目中依赖项的工具。

我们推荐使用 pnpm,但您也可以使用 npm、yarn 或 bun。

# 如果您还没有安装 pnpm,请安装它
npm install -g pnpm

# 检查 pnpm 版本
pnpm --version

快速安装

设置您的项目

您有多种方式可以下载 MkSaaS 的源代码,我们将介绍一些最常见的方式,您可以选择最适合您的方式。

我们建议从 Fork GitHub 仓库开始。

当您访问 GitHub 仓库 时,您会在右上角看到一个"Fork"按钮。点击它将在您的 GitHub 账户中创建 MkSaaS 仓库的副本,请保持此仓库为私有。

一旦您 fork 了仓库,您就可以将您的 fork 克隆到电脑本地:

git clone https://github.com/your-username/mksaas-template.git your-project-name

cd your-project-name

您也可以直接从 GitHub 克隆仓库。

git clone https://github.com/MkSaaSHQ/mksaas-template.git your-project-name

cd your-project-name

git remote remove origin

如果您愿意,可以从 GitHub 下载源代码的 ZIP 文件。 访问仓库页面,点击 Code 按钮,然后点击 Download ZIP。 下载后,将 ZIP 文件解压到您想要的位置,并在终端中导航到解压的目录。

关于 fork 仓库

  • 完整历史记录: 您保留项目的完整提交历史记录。
  • 轻松更新: 您可以使用拉取请求轻松从原始仓库拉取更新。
  • 支持贡献: 如果您想要贡献您的代码到模板库,您的 fork 已经为此设置好了。
  • 只有一个 Fork: 您只能有一个仓库的 fork,但您可以多次克隆仓库,因此您可以基于模板构建多个网站。

如果您希望能够从 MkSaaS 模板仓库拉取更新,您可以添加上游远程,这将允许从 MkSaaS 仓库进行更简单的更新过程。

git remote add upstream https://github.com/MkSaaSHQ/mksaas-template.git

安装依赖项

通过运行以下命令安装依赖项:

pnpm install
npm install
yarn install
bun install

设置环境变量

MkSaaS 使用环境变量来配置项目。您可以在 .env 文件中设置它们,因此首先将 env.example 文件复制到 .env 作为起点。

cp env.example .env

然后,打开 .env 文件并将变量设置为您想要的值。您可以在环境配置文档中找到有关环境变量的更多信息。

启动开发服务器

现在您已经设置好数据库,可以通过运行以下命令启动开发服务器:

pnpm run dev
npm run dev
yarn dev
bun run dev

这将在 http://localhost:3000 上访问模板网站。

视频教程

下一步

现在您已经运行了 MkSaaS,以下是一些后续步骤:

环境配置

配置环境变量

开发环境

配置开发环境

项目结构

了解项目代码库的组织

网站配置

配置网站核心设置

模板介绍

介绍 MkSaaS,一个用于构建 AI SaaS 网站的完整 Next.js 模板

环境配置

为您的 MkSaaS 应用程序配置环境变量

目录

前提条件
Node.js
Git
包管理器
快速安装
设置您的项目
安装依赖项
设置环境变量
启动开发服务器
视频教程
下一步