需先安装node.js和pm2并配置反向代理:一、宝塔软件商店装node.js 16.x lts,终端验证node/npm版本;二、添加纯静态网站并上传解压workbuddy源码;三、pm2管理器添加项目,指定server.js启动;四、网站设置中配反向代理至127.0.0.1:3000;五、编辑.env设host=0.0.0.0、port=3000,重启pm2生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在服务器上快速部署 WorkBuddy,但尚未安装 Node.js 运行环境或 Web 服务管理工具,则需先构建基础执行环境。宝塔面板可简化后端服务配置与进程托管,而 WorkBuddy 依赖 Node.js 运行时。以下是零基础完成部署的完整路径:
一、安装并验证 Node.js 运行环境
WorkBuddy 是基于 Node.js 开发的应用,必须确保系统已安装兼容版本的 Node.js,并正确写入环境变量,否则启动会失败。
1、登录宝塔面板,在左侧菜单中点击【软件商店】。
2、在搜索框输入 Node.js项目,找到官方提供的 Node.js 环境(推荐选择 16.x LTS 版本)并点击【安装】。
3、安装完成后,进入【终端】,执行命令:node -v && npm -v,确认输出类似 v16.20.2 和 8.19.4 的版本号。
4、若提示 command not found,说明环境变量未生效,需重启服务器或手动执行 source /etc/profile。
二、创建网站并上传 WorkBuddy 源码
宝塔通过“网站”模块管理域名与根目录,需新建一个站点作为 WorkBuddy 的运行容器,避免与其它服务冲突。
1、在宝塔面板左侧点击【网站】→【添加站点】。
2、域名处填写您计划使用的访问地址(如 workbuddy.local 或直接留空用于内网测试),根目录保持默认自动生成路径(如 /www/wwwroot/workbuddy.local)。
3、点击【PHP版本】下拉框,选择 纯静态(WorkBuddy 后端为 Node.js,无需 PHP)。
4、进入该站点根目录,点击【远程下载】,粘贴 WorkBuddy 官方发布包地址(若无则需提前下载至本地,再使用【上传】功能导入压缩包)。
5、解压后确认目录内含 package.json 与 server.js(或 index.js)等核心文件。
三、使用 PM2 管理 WorkBuddy 进程
Node.js 应用需常驻后台运行,PM2 是宝塔内置支持的进程守护工具,可自动重启崩溃进程并记录日志。
1、在宝塔【软件商店】中搜索并安装 PM2管理器(若未预装)。
2、进入【PM2管理器】页面,点击【添加项目】。
使用 draw.io(.drawio 格式)和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发: - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
3、项目路径填写 WorkBuddy 所在根目录(如 /www/wwwroot/workbuddy.local)。
4、启动文件填写 server.js(或实际入口文件名),运行用户选择 www,环境选择 production。
5、点击【提交】,状态变为 online 即表示服务已成功启动。
四、配置反向代理以支持域名访问
WorkBuddy 默认监听本地端口(如 3000),无法直接通过域名访问;需借助 Nginx 反向代理将 HTTP 请求转发至 Node.js 服务。
1、返回【网站】列表,点击已创建站点右侧的【设置】。
2、切换至【反向代理】选项卡,点击【添加反向代理】。
3、目标URL填写 http://127.0.0.1:3000(请与 WorkBuddy 实际监听端口一致)。
4、代理名称可填 workbuddy-api,启用代理后保存。
5、若需 HTTPS 访问,返回【SSL】选项卡,申请免费证书并强制 HTTPS 跳转。
五、调整 WorkBuddy 配置文件并启动
WorkBuddy 需要明确服务监听地址与端口,且部分功能依赖环境变量控制;错误配置将导致无法响应请求。
1、进入 WorkBuddy 根目录,使用【文件】→【编辑】打开 .env 文件(若不存在则新建)。
2、写入以下内容(根据实际修改):
HOST=0.0.0.0
PORT=3000
NODE_ENV=production
3、若 WorkBuddy 使用数据库,还需补充 DB_HOST、DB_NAME 等字段,并确保 MySQL 已在宝塔中安装且对应数据库已创建。
4、返回【PM2管理器】,对该项目点击【重启】,使新配置生效。










