3.9 KiB
3.9 KiB
梦回高句丽 - 宝塔面板部署指南
项目概述
- 项目名称: 梦回高句丽视频网站
- 域名: ggl.xi.plus
- 技术栈: Vue.js + Node.js + Express + SQLite
- 部署方式: 宝塔面板 NODE 项目
部署步骤
1. 宝塔面板 NODE 项目配置
基本设置
- 项目名称:
梦回高句丽 - 项目路径:
/www/wwwroot/ggl - 启动文件:
start-production.cjs - 运行端口:
4001(API) +4002(前端) - Node.js 版本:
18.x或更高
启动命令配置
# 在宝塔面板 NODE 项目中设置
启动命令: node start-production.cjs
或者使用 npm 脚本: npm run start:bt
2. 环境准备
安装依赖
cd /www/wwwroot/ggl
npm install
构建前端项目
npm run build
检查必要文件
确保以下文件存在:
dist/目录 (前端构建产物)database.db或database/goguryeo_video.db.env.production配置文件logs/目录 (自动创建)
3. 域名和 SSL 配置
域名绑定
- 在宝塔面板中添加站点
ggl.xi.plus - 设置网站目录为
/www/wwwroot/ggl/dist - 申请并配置 SSL 证书
Nginx 配置
使用提供的 nginx-ggl-xi-plus.conf 配置文件:
# 复制配置到宝塔 Nginx 配置目录
cp nginx-ggl-xi-plus.conf /www/server/panel/vhost/nginx/ggl.xi.plus.conf
# 重载 Nginx 配置
nginx -s reload
4. 启动项目
方式一:宝塔面板 NODE 项目 (推荐)
- 在宝塔面板 → 软件商店 → Node.js 项目管理
- 添加项目:
- 项目名称:
梦回高句丽 - 项目路径:
/www/wwwroot/ggl - 启动文件:
start-production.cjs - 端口:
4001
- 项目名称:
- 点击启动项目
方式二:PM2 管理 (备选)
# 使用 PM2 启动
npm run pm2:start
# 查看状态
pm2 status
# 查看日志
pm2 logs ggl-xi-plus-production
5. 验证部署
检查服务状态
# 检查端口占用
netstat -tlnp | grep :4001
netstat -tlnp | grep :4002
# 检查进程
ps aux | grep node
访问测试
- 前端页面:
https://ggl.xi.plus - API 接口:
https://ggl.xi.plus/api/health - 上传文件:
https://ggl.xi.plus/uploads/
6. 监控和维护
日志文件位置
logs/
├── production.log # 应用日志
├── error.log # 错误日志
├── pm2-combined.log # PM2 综合日志
├── pm2-out.log # PM2 输出日志
└── pm2-error.log # PM2 错误日志
常用维护命令
# 重启服务 (宝塔面板)
# 在 NODE 项目管理中点击重启
# 重启服务 (PM2)
npm run pm2:restart
# 查看实时日志
tail -f logs/production.log
# 清理日志
truncate -s 0 logs/*.log
7. 性能优化配置
系统配置
- 内存限制: 1GB (可根据实际情况调整)
- 文件上传限制: 100MB
- 并发连接: 根据服务器配置调整
- 缓存策略: 静态资源 1 年,API 响应适当缓存
安全配置
- SSL/TLS 加密传输
- CORS 跨域限制
- 请求频率限制
- 敏感文件访问禁止
- 安全响应头设置
故障排除
常见问题
-
端口冲突
# 检查端口占用 lsof -i :4001 lsof -i :4002 -
权限问题
# 设置正确的文件权限 chown -R www:www /www/wwwroot/ggl chmod -R 755 /www/wwwroot/ggl -
数据库连接失败
# 检查数据库文件权限 ls -la database/ chmod 664 database/*.db -
前端资源 404
# 重新构建前端 npm run build
联系支持
如遇到部署问题,请检查:
- Node.js 版本是否符合要求
- 依赖包是否完整安装
- 端口是否被占用
- 文件权限是否正确
- Nginx 配置是否生效
部署完成后,项目将在 https://ggl.xi.plus 上运行
最后更新: 2024年1月 维护者: 系统管理员