99AI/docs/DEPLOYMENT.md

部署指南

目录说明

首先，请确保您已经进入 AIWebQuickDeploy 目录：

cd AIWebQuickDeploy

Node.js 部署

1. 安装 Node.js 环境

推荐使用 nvm (Node Version Manager) 来安装 Node.js，这样可以方便地管理多个 Node.js 版本。

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

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

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

  nvm install 18
  nvm use 18
  

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

  node -v
  npm -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：

    cp .env.example .env
    

  • 根据需要修改 .env 文件中的配置项，主要包括：
    • 数据库连接信息
    • Redis 连接信息
    • 服务端口配置

完成配置并启动后，项目会自动在指定的 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
  

项目管理

普通管理员，可以预览后台非敏感信息，默认不激活。请使用超级管理员账号登入后台，并及时修改密码。

• 管理端地址：项目链接/admin

• 普通管理员账号：admin（默认不激活）

• 超级管理员账号：super

• 密码：123456