安装
如何安装和启动 Sistine Starter
安装
本指南将帮助你在本地环境中安装和运行 Sistine Starter。
系统要求
在开始之前,请确保你的系统满足以下要求:
- Node.js: >= 18.17.0
- pnpm: >= 8.0.0 (推荐) 或 npm/yarn/bun
- PostgreSQL: >= 14.0
- Git: 最新版本
安装步骤
1. 获取项目访问权限
访问 Sistine 项目申请 填写你的 GitHub 用户名，自动获得项目仓库权限。
2. 克隆仓库
git clone https://github.com/your-org/sistine-starter.git
cd sistine-starter3. 安装依赖
你可以使用以下任一包管理器:
pnpm install推荐使用 pnpm,它更快且更节省磁盘空间。
4. 配置环境变量
环境变量配置指南:
- 查看 图文配置手册 - 完整的环境变量配置教程
5. 设置数据库
确保你已经安装并运行了 PostgreSQL。推荐使用云服务 Neon(无服务器 PostgreSQL,按需付费)。
详细的数据库配置请参考 图文配置手册。
6. 运行数据库迁移
首次运行时,需要创建数据库表:
pnpm db:push提示:
db:push会直接同步 schema 到数据库,适合开发环境。生产环境建议使用db:migrate。
7. 启动开发服务器
pnpm dev开发服务器将在 http://localhost:3000 启动。
验证安装
打开浏览器访问 http://localhost:3000,你应该能看到 Sistine Starter 的首页。
尝试以下操作验证安装:
- 注册账户: 访问
/sign-up创建新账户 - 查看积分: 注册后应自动获得 300 积分
- 访问仪表板: 登录后访问
/dashboard
常见问题
安装依赖时出错
如果使用 pnpm 时遇到问题,尝试清理缓存:
pnpm store prune
rm -rf node_modules
pnpm install数据库连接失败
检查以下内容:
- PostgreSQL 服务是否正在运行
- 数据库连接配置是否正确
- 数据库用户是否有足够权限
- 防火墙是否阻止了连接
详细的数据库配置请参考 图文配置手册。
端口 3000 已被占用
修改启动端口:
PORT=3001 pnpm dev