快速开始

本机环境

• Node 22.22.1（仓库根目录 .nvmrc）
• pnpm 10.15.0
• MySQL 8（本地或测试机）

cp jy-site/.env.example jy-site/.env
cp jy-admin/.env.example jy-admin/.env
# 两个 .env 的 DATABASE_* 指向同一库
# jy-admin 还需 SESSION_SECRET（至少 32 字符）

cd jy-site && pnpm install && pnpm dev      # 常见端口 5175
cd jy-admin && pnpm install && pnpm dev     # 5174

初始化库

mysql -u root -p < jy-site/blog_site.sql

blog_site.sql 里的 users.password_hash 是占位值，不能登录。部署管理端时需要写入真实 bcrypt 哈希。

构建命令

命令	用途
cd jy-site && pnpm build	只跑 Vite，缺搜索索引和 sitemap 修补
cd jy-site && pnpm build:static	线上静态包，应使用这个
cd jy-admin && pnpm build	Next.js standalone 产物在 .next/standalone

密码里如果有 #，.env 必须加引号，否则会被当成注释：

DATABASE_PASSWORD="your#password"