快速开始
环境要求
- Node.js 18.x 或更高版本
- MySQL 8.0 或更高版本
- Redis 5.0 或更高版本
- pnpm 8.x 或更高版本
安装步骤
方式一：Docker 一键部署（推荐）
使用 Docker Compose 可以快速部署应用，包含内置的 Redis 服务，需要连接外部 MySQL 服务：
bash
# 1. 克隆项目
git clone https://gitee.com/shuai_dd/kevi_blog-v2.git
cd kevi_blog-v2
# 2. 准备环境变量文件
cp .env.example .env
# 3. 编辑 .env 文件，配置数据库连接信息
# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=nuxt_blog
# Redis配置
REDIS_URL=redis://localhost:6379
REDIS_PASSWORD=redispassword
# JWT配置
JWT_SECRET=your_jwt_secret_key_here
JWT_EXPIRES_IN=7d
# 4. 构建并启动服务
docker-compose up --build -d
# 5. 访问应用
# 前端应用: http://localhost:3000
# 管理后台: http://localhost:3000/admin
<!-- markdownlint-disable-line URL -->方式二：本地开发环境
1. 安装依赖
bash
# 使用 pnpm 安装
pnpm install2. 配置环境变量
创建并编辑 .env 文件，配置数据库连接信息：
bash
# 复制环境变量模板
cp .env.example .env
# 编辑 .env 文件，配置数据库连接信息环境变量说明：
| 变量名 | 说明 | 默认值 |
|---|---|---|
DB_HOST | 数据库主机地址 | localhost |
DB_PORT | 数据库端口 | 3306 |
DB_USER | 数据库用户名 | root |
DB_PASSWORD | 数据库密码 | - |
DB_NAME | 数据库名称 | nuxt_blog |
REDIS_URL | Redis 连接地址 | redis://localhost:6379 |
REDIS_PASSWORD | Redis 密码 | - |
CACHE_STORAGE | 缓存存储方式 (redis 或 file) | redis |
JWT_SECRET | JWT 密钥 | - |
JWT_EXPIRES_IN | JWT 过期时间 | 7d |
3. 配置数据库
确保 MySQL 服务运行，并创建数据库：
bash
# 初始化数据库和表结构
mysql -u root -p < server/database/schema.sql或者使用 Node 脚本初始化：
bash
pnpm run db:init4. 启动开发服务器
bash
# 开发模式
pnpm run dev
# 构建和预览
pnpm run build
pnpm run preview5. 访问应用
- 前端应用:
http://localhost:3000 - 管理后台:
http://localhost:3000/admin - API 接口:
http://localhost:3000/api
默认账号
系统初始化后，会创建一个默认管理员账号：
| 字段 | 值 |
|---|---|
| 用户名 | admin |
| 密码 | 123456 |
| 邮箱 | admin@demo.com |
⚠️ 重要提示：部署到生产环境后，请立即修改默认密码！
验证安装
访问以下地址验证安装是否成功：
- 访问前端：
http://localhost:3000 - 访问后台：
http://localhost:3000/admin - 使用默认账号登录后台
- 检查数据统计是否正常显示
常见问题
1. 数据库连接失败
检查 .env 文件中的数据库配置是否正确，确保 MySQL 服务正在运行。
2. Redis 连接失败
检查 Redis 服务是否正在运行，确保 Redis 地址和密码配置正确。
3. 端口被占用
如果 3000 端口被占用，可以修改环境变量 PORT 或在 nuxt.config.ts 中修改端口配置。
4. 权限问题
确保应用对上传目录有写入权限（本地存储时）。