人生K线宝塔搭建教程

一. 环境准备

在宝塔面板中安装以下软件：

Node.js ( v20.19.6)

PM2管理器

二. 上传项目文件

将项目文件夹上传到服务器（建议放在 /www/wwwroot/ 目录下）

解压并确保文件结构完整

三.安装依赖

在项目根目录执行：

npm install

如果出现

npm error code E404
npm error 404 Not Found - GET https://cdn.npmmirror.com/binaries/npm/yallist/-/yallist-3.1.1.tgz
npm error 404
npm error 404  'yallist@https://npmmirror.com/mirrors/npm/yallist/-/yallist-3.1.1.tgz' is not in this registry.
npm error 404
npm error 404 Note that you can also install from a
npm error 404 tarball, folder, http url, or git url.
npm error A complete log of this run can be found in: /root/.npm/_logs/2026-01-08T22_10_27_109Z-debug-0.log

首先把 npm 源切回官方源，避免镜像源的资源缺失问题

1. 清除当前的镜像源配置

npm config delete registry
npm config delete disturl

2. 设置为 npm 官方源（最稳定，避免镜像源问题）

npm config set registry https://registry.npmjs.org/

3. 清除 npm 缓存（重点！缓存里可能残留失效的包地址）

npm cache clean --force

4. 重新安装依赖

npm install

四. 配置 PM2

项目已经提供了 ecosystem.config.cjs 配置文件，你可以通过以下命令启动：

• 开发环境启动

npm run pm2:dev

• 生产环境启动

npm run pm2:prod

出现这个图就成功了

• 查看状态

npm run pm2:status

• 查看日志

npm run pm2:logs

• 开发环境启动

npm run pm2:dev

• 生产环境启动

npm run pm2:prod

• 查看状态

npm run pm2:status

• 查看日志

npm run pm2:logs

五. 宝塔面板配置

5.1 创建网站

1. 在宝塔面板点击 网站 → 添加站点
2. 填写域名和选择根目录
3. PHP版本选择 纯静态

5.2 配置反向代理

由于这是前端项目，需要配置反向代理到 Node.js 服务：

1. 点击网站设置 → 反向代理
2. 添加反向代理：

– 代理名称： life-k-line
– 目标URL： http://127.0.0.1:3003
– 发送域名： $host 5.3 域名SSL配置（可选）
在网站设置中配置SSL证书以启用HTTPS

六. 防火墙设置确保服务器防火墙开放以下端口：

3003 (Node.js应用端口)
80/443 (HTTP/HTTPS端口)

七. 项目构建（生产环境）

如果需要构建生产版本：

• 构建项目

npm run build

• 使用预览模式启动

npm run preview

八. 监控和维护

• 使用宝塔面板的 PM2管理器 监控应用状态
  定期查看日志排查问题
  设置定时任务备份项目文件

九. 常见问题解决

1. 端口冲突 ：检查 3003 端口是否被占用
2. 权限问题 ：确保项目文件权限正确
3. 依赖安装失败 ：尝试清除 npm 缓存后重新安装

十. 项目特殊配置

温馨提示
– OpenAI API 和 Google Generative AI ，需要配置相应的API密钥（大陆和香港的服务器不能使用）
– PM2 进行进程管理，建议使用生产环境配置
这样配置后，你的”人生K线”应用就可以在宝塔面板上正常运行了！