99AI/DEPLOYMENT.md

部署指南

请参考完整的 部署文档 了解详细信息。

部署文档可能不是非常详细，但绝对够用。如果在安装或配置中遇到任何问题，可询问 AI、通过 issue 反馈或交流群内提问题。

Node.js 部署

1. 安装 Node.js 环境

推荐使用 nvm (Node Version Manager) 来安装 Node.js。

• 首先，安装 nvm，你可以从 nvm GitHub 仓库 找到安装指南。

• 按照仓库中的安装说明进行操作，安装完成后，可能需要添加环境变量或重启终端。

• 安装 Node.js 版本 18 或更高版本:

  nvm install 18
  nvm use 18
  

• 验证 Node.js 是否安装成功:

  node -v
  

2. 安装 PM2 / PNPM（YARN）

• 使用 npm 安装 PM2：

  npm install pm2 -g
  

• 使用 npm 安装 pnpm：

  npm install -g pnpm
  

• 确认 PM2 和 pnpm 都已正确安装并且可以运行：

  pm2 -v
  pnpm -v
  

3. 其他配置

• 需配置 Redis 数据库以及新建一个 MySQL 数据库。
• 配置环境变量：
  • 复制 .env.example 文件为 .env。
  • 根据需要修改 .env 文件中的配置项。

完成配置并启动后，项目会自动在指定的 MySQL 数据库中创建所需的表结构和初始数据，无需手动导入 SQL 文件。确保 .env 文件中的数据库连接信息正确即可。

4. 安装启动

• 安装依赖：(若安装缓慢可尝试使用国内源)

  pnpm install
  

• 启动进程：（默认使用 PM2 后台运行）

  pnpm start
  

• 查看运行日志：

  pnpm logs
  

• 项目默认在 9520 端口运行，也可在环境变量中自行修改。成功运行后可通过 IP:端口 访问，或者配置 Nginx 反向代理，通过域名访问。

脚本部署

功能支持

• Node.js 全新部署
  自动安装环境、生成配置、安装依赖并启动服务。
• Node.js 升级
  拉取最新代码，更新依赖并重启服务。
• Docker-compose 部署
  创建 MySQL、Redis 容器及 99AI 服务，支持自定义端口。
• Docker-compose 升级
  停止旧版本容器，重新构建镜像并启动。

请在项目的根目录下执行以下命令：

./deploy.sh

Docker 部署

1. 安装 Docker 及 Docker-compose

• 使用 Docker 官网 提供的一键安装链接安装 Docker 及 Docker-compose。

curl -fsSL https://get.docker.com | bash -s docker

• 也可以使用其他方式自行安装 Docker 及 Docker-compose。

2. 服务管理

• 后台启动服务

  docker-compose up -d
  

• 查看日志

  docker-compose logs
  

• 停止服务

  docker-compose down
  

• 重新构建并启动服务

  docker-compose up -d --build