前端部署:

安装pm2管理器

点击设置

选择v16.19.1版本-切换版本

再新建一个网站

点击设置

添加反向代理-代理名称随便填-目标url(http://127.0.0.1:3000)-提交

进入网站目录

解压client.zip压缩包

打开.env文件

修改VITE_SERVER_NAME里的域名改为自己的后端域名(/api不要动)

 

接着返回到上级目录

打开终端

执行npm install -g pnpm

运行pnpm install

运行pnpm run build后

运行pm2 startecosystem.config.js

如果运行pm2 startecosystem.config.js报错 先运行pm2 update

搭建结束 ps:数据库自己别忘记上传

 

 

以下是打包后build_client.zip的前端教程 无需install build等操作

找到该目录的runtime.mjs文件 搜索127.0.0.99替换成自己的域名即可 修改后无需重新启动 无需build

回到前端根目录 打开终端执行pm2 start即可


Docker本地部署

 Nice Agent 客户端 - 部署指南

 快速部署 (3步完成)

1. 配置环境变量

  • ounter(line
  • ounter(line
# 确保 .env 文件存在并配置正确VITE_SERVER_NAME=http://127.0.0.1:8080/api

2. 一键启动

  • ounter(line
  • ounter(line
  • ounter(line
# Linux 环境chmod +x docker-start.sh./docker-start.sh start

3. 访问应用

  • 本地访问: http://localhost:3000
  • 局域网访问: http://[服务器IP]:3000

系统要求

  • Linux (Ubuntu 18.04+, CentOS 7+)
  • Docker 20.10.0+
  • Docker Compose 1.29.0+
  • 内存 1GB+ (推荐 2GB+)

管理命令

命令 说明
./docker-start.sh start 启动服务
./docker-start.sh stop 停止服务
./docker-start.sh logs 查看日志
./docker-start.sh status 查看状态
./docker-start.sh clean 清理环境

 环境变量

必需配置 (.env 文件):

  • ounter(line
  • ounter(line
# 后端API服务地址 (必须配置)VITE_SERVER_NAME=http://127.0.0.1:8080/api

可选配置:

  • NODE_ENV=production - 运行环境
  • NITRO_PORT=3000 - 应用端口

 常见问题

问题 解决方案
端口被占用 修改 docker-compose.yml 中的端口: "3001:3000"
环境变量未生效 检查 .env 文件格式,重新构建: ./docker-start.sh clean && ./docker-start.sh start
服务启动失败 查看日志: ./docker-start.sh logs
内存不足 降低资源限制或增加服务器内存

 更新应用

  • ounter(line
  • ounter(line
  • ounter(line
git pull                    # 拉取最新代码./docker-start.sh clean     # 清理旧环境./docker-start.sh start     # 重新部署

 生产环境建议

  1. 使用 Nginx 反向代理
  2. 配置 HTTPS 证书
  3. 设置防火墙规则
  4. 定期备份数据