本项目是一个基于NestJS和Vue3开发的个人博客系统，包含前台展示和后台管理两部分。项目采用前后端分离开发模式，使用TypeScript作为主要开发语言。
blog-nest: 后端API服务，基于NestJS框架blog-vue/conder-blog: 博客前台，基于Vue3blog-vue/conder-admin: 博客管理后台，基于Vue3 + Element Plus
# 安装后端依赖
cd blog-nest
pnpm install
# 安装前台依赖
cd ../blog-vue/conder-blog
pnpm install
# 安装后台依赖
cd ../conder-admin
pnpm install# 运行后端服务
cd blog-nest
pnpm run start:dev
# 运行前台
cd ../blog-vue/conder-blog
pnpm run dev
# 运行后台
cd ../blog-vue/conder-admin
pnpm run dev项目使用TypeORM进行数据库迁移和初始化，提供了几种方式来初始化数据库：
# 运行数据库初始化和迁移脚本
npm run db:init这个命令会执行以下操作：
- 修复访问日志表结构
- 初始化基础数据（创建管理员角色和管理员用户）
- 初始化菜单数据和角色菜单关联
在Docker环境中，数据库初始化会在容器启动时自动执行。Docker入口脚本（docker-entrypoint.sh）会：
- 等待MySQL数据库启动并可用
- 执行数据库初始化程序
- 启动应用程序
如果您需要手动初始化数据库，可以在应用容器中运行：
docker-compose exec app node dist/database-init.js# 同步数据库表结构（根据实体定义）
npm run db:sync
# 构建并初始化数据库（用于Docker环境）
npm run db:docker-init
# 使用TypeORM迁移命令
npm run migration:run
npm run migration:revert初始化数据库后，将创建以下默认管理员账户：
- 用户名: admin@blog.com
- 密码: admin123
出于安全考虑，请在首次登录后修改默认密码。
本项目使用以下主要数据表：
users- 用户表roles- 角色表user_roles- 用户角色关联表menus- 菜单表role_menus- 角色菜单关联表articles- 文章表categories- 分类表tags- 标签表article_tags- 文章标签关联表comments- 评论表site_config- 站点配置表visit_logs- 访问日志表
本项目提供多种部署方式，包括传统服务器部署、Docker容器部署和云服务部署。选择符合您需求的方式进行部署。
首先需要对新创建的CentOS 8.2服务器进行基本配置：
# 更新系统包
sudo dnf update -y
# 安装常用工具
sudo dnf install -y wget curl vim git unzip net-tools
# 配置防火墙，开放必要端口
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --permanent --add-port=3300/tcp # NestJS应用端口
sudo firewall-cmd --reload
# 检查防火墙状态
sudo firewall-cmd --list-allCentOS 8.2上安装Node.js v20：
# 添加NodeSource源
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
# 安装Node.js
sudo dnf install -y nodejs
# 确认安装版本
node -v # 应显示v20.x.x
npm -v # 确认npm已安装
# 安装pnpm
sudo npm install -g pnpm
# 确认pnpm安装成功
pnpm -vCentOS 8.2上安装MySQL数据库：
# 添加MySQL源
sudo dnf install -y https://dev.mysql.com/get/mysql80-community-release-el8-1.noarch.rpm
# 启用MySQL 8.0仓库
sudo dnf module disable mysql -y
sudo dnf config-manager --enable mysql80-community
# 安装MySQL服务器
sudo dnf install -y mysql-community-server
# 启动MySQL服务
sudo systemctl start mysqld
sudo systemctl enable mysqld
# 检查MySQL状态
sudo systemctl status mysqld
# 获取MySQL临时密码
sudo grep 'temporary password' /var/log/mysqld.log
# 执行MySQL安全配置向导
sudo mysql_secure_installation
# 按提示操作：
# 1. 输入临时密码
# 2. 设置新密码
# 3. 移除匿名用户
# 4. 禁止root远程登录
# 5. 移除测试数据库
# 6. 重新加载权限表为博客创建专用数据库和用户：
# 登录MySQL
mysql -u root -p
# 创建数据库和用户
mysql> CREATE DATABASE blog CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
mysql> CREATE USER 'bloguser'@'localhost' IDENTIFIED BY 'your_secure_password';
mysql> GRANT ALL PRIVILEGES ON blog.* TO 'bloguser'@'localhost';
mysql> FLUSH PRIVILEGES;
mysql> EXIT;# 启用Redis模块
sudo dnf module enable redis:6 -y
# 安装Redis
sudo dnf install -y redis
# 启动Redis并设置开机自启
sudo systemctl start redis
sudo systemctl enable redis
# 检查Redis状态
sudo systemctl status redis# 创建应用目录
sudo mkdir -p /var/www/blog
sudo chown -R $USER:$USER /var/www/blog
# 安装Git
sudo dnf install git -y
# 克隆代码仓库
cd /var/www/blog
git clone <repository-url> .
cd blog-nest
# 安装依赖
pnpm install
# 配置环境变量
cp .env.example .env
vim .env
# 编辑.env文件，配置关键信息
# PORT=3300
# NODE_ENV=production
# DB_HOST=localhost
# DB_PORT=3306
# DB_USERNAME=bloguser
# DB_PASSWORD=your_secure_password
# DB_DATABASE=blog
# JWT_SECRET=your_strong_random_jwt_secret
# REDIS_HOST=localhost
# REDIS_PORT=6379
# 编译项目
pnpm build
# 初始化数据库
pnpm db:init
# 安装PM2进程管理器
sudo npm install -g pm2
# 使用PM2启动应用
pm2 start dist/src/main.js --name blog-nest
# 设置PM2开机自启
pm2 startup
sudo env PATH=$PATH:/usr/bin pm2 startup systemd -u $USER --hp $HOME
pm2 save# 进入前端目录
cd /var/www/blog/blog-vue
# 配置前台应用
cd conder-blog
pnpm install
# 修改环境变量配置
vim .env.production
# 设置API地址，例如：VITE_APP_BASE_API=http://your_server_ip:3300/api
# 构建前台应用
pnpm build
# 配置管理后台
cd ../conder-admin
pnpm install
# 修改环境变量配置
vim .env.production
# 设置API地址，例如：VITE_APP_BASE_API=http://your_server_ip:3300/admin-api
# 构建管理后台
pnpm build# 安装Nginx
sudo dnf install -y nginx
# 启动Nginx并设置开机自启
sudo systemctl start nginx
sudo systemctl enable nginx
# 创建博客站点配置
sudo vim /etc/nginx/conf.d/blog.conf在blog.conf文件中添加以下配置：
server {
listen 80;
server_name your_domain.com; # 替换为您的域名或服务器IP
# 博客前台
location / {
root /var/www/blog/blog-vue/conder-blog/dist;
index index.html;
try_files $uri $uri/ /index.html;
}
# 管理后台
location /admin {
alias /var/www/blog/blog-vue/conder-admin/dist;
index index.html;
try_files $uri $uri/ /admin/index.html;
}
# API反向代理 - 前台
location /api/ {
proxy_pass http://localhost:3300/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_cache_bypass $http_upgrade;
}
# API反向代理 - 后台
location /admin-api/ {
proxy_pass http://localhost:3300/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_cache_bypass $http_upgrade;
}
}# 检查Nginx配置
sudo nginx -t
# 如果配置正确，重新加载Nginx
sudo systemctl reload nginx如果您有域名并想启用HTTPS，可以使用Let's Encrypt的Certbot：
# 安装EPEL仓库
sudo dnf install -y epel-release
# 安装Certbot和Nginx插件
sudo dnf install -y certbot python3-certbot-nginx
# 获取并安装SSL证书
sudo certbot --nginx -d your_domain.com
# 证书自动续期设置
sudo certbot renew --dry-run创建上传文件的目录并设置权限：
# 创建上传目录
sudo mkdir -p /var/www/blog/public/uploads
sudo chown -R nginx:nginx /var/www/blog/public
# 在Nginx配置中添加上传文件的访问路径
sudo vim /etc/nginx/conf.d/blog.conf在Nginx配置中添加：
# 上传文件访问
location /uploads/ {
alias /var/www/blog/public/uploads/;
}# 重新加载Nginx配置
sudo nginx -t
sudo systemctl reload nginx# 查看应用日志
pm2 logs blog-nest
# 查看Nginx访问日志
sudo tail -f /var/log/nginx/access.log
# 查看Nginx错误日志
sudo tail -f /var/log/nginx/error.log
# 设置PM2日志轮转
pm2 install pm2-logrotate定期更新和备份：
# 备份数据库
mysqldump -u root -p blog > /var/backups/blog_$(date +%Y%m%d).sql
# 定期更新系统
sudo dnf update -y
# 重启服务
sudo systemctl restart mysqld
sudo systemctl restart nginx
pm2 restart blog-nest如果遇到问题，检查以下几点：
-
检查服务状态：
sudo systemctl status mysqld sudo systemctl status nginx sudo systemctl status redis pm2 status
-
检查依赖模块问题：
如果遇到 "Cannot find module 'xxx'" 类型的错误，通常是因为依赖没有正确安装。解决方法：
# 确保在项目根目录 cd /var/www/blog/blog-nest # 清除npm缓存 npm cache clean --force # 重新安装依赖 npm install # 或使用pnpm pnpm install # 针对特定模块问题（如bull队列模块） npm install bull @nestjs/bull --save # 重新构建项目 npm run build # 重启应用 pm2 restart blog-nest
特别注意：如果使用pnpm安装后仍然报模块找不到错误，可以尝试使用npm安装，因为有时pnpm的符号链接可能在某些环境中无法正确解析。
-
检查防火墙：
sudo firewall-cmd --list-all
-
检查日志：
pm2 logs blog-nest sudo tail -f /var/log/nginx/error.log sudo journalctl -u mysqld
-
检查SELinux：
# 如果遇到权限问题，可能需要调整SELinux sudo sestatus # 临时禁用SELinux sudo setenforce 0 # 永久禁用SELinux（需重启） sudo sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
-
网络连接测试：
# 检查端口是否开放 sudo ss -tulpn | grep LISTEN # 测试数据库连接 mysql -u bloguser -p -h localhost blog
-
内存和磁盘空间检查：
free -h df -h
本项目支持 GitHub、Gitee 和 QQ 第三方登录，使用前需要在环境变量中配置相关参数：
在项目根目录创建 .env 文件，添加以下配置：
# GitHub登录配置
OAUTH_GITHUB_CLIENT_ID=your_github_client_id
OAUTH_GITHUB_CLIENT_SECRET=your_github_client_secret
OAUTH_GITHUB_REDIRECT_URL=http://localhost:3300/oauth/github/callback
# Gitee登录配置
OAUTH_GITEE_CLIENT_ID=your_gitee_client_id
OAUTH_GITEE_CLIENT_SECRET=your_gitee_client_secret
OAUTH_GITEE_REDIRECT_URL=http://localhost:3300/oauth/gitee/callback
# QQ登录配置
OAUTH_QQ_APP_ID=your_qq_app_id
OAUTH_QQ_APP_KEY=your_qq_app_key
OAUTH_QQ_REDIRECT_URL=http://localhost:3300/oauth/qq/callback-
GitHub：
- 访问 GitHub Developer Settings
- 创建一个新的 OAuth App
- 填写应用名称、首页 URL 和授权回调 URL（如：
http://localhost:3300/oauth/github/callback）
-
Gitee：
- 访问 Gitee 第三方应用管理
- 创建一个新的应用
- 填写应用名称、首页 URL 和授权回调 URL（如：
http://localhost:3300/oauth/gitee/callback）
-
QQ：
- 访问 QQ互联管理中心
- 创建一个新的网站应用
- 填写应用名称、首页 URL 和授权回调 URL（如：
http://localhost:3300/oauth/qq/callback）
在线用户管理功能使用 Redis 存储用户会话信息，确保 Redis 服务已启动且配置正确：
# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=- 在线用户列表：可通过
/monitor/online接口获取当前在线用户列表 - 强制下线：管理员可通过
/monitor/online/:tokenId接口强制指定用户下线 - 用户会话管理：可查看特定用户的所有会话
- 自动清理过期会话：系统会自动清理长时间未活动的会话
GET /monitor/online- 获取在线用户列表GET /monitor/online/count- 获取在线用户数量GET /monitor/online/user/:userId- 获取指定用户的所有会话DELETE /monitor/online/:tokenId- 强制用户下线DELETE /monitor/online/expired- 清除过期会话