mirror of
https://github.com/vastxie/99AI.git
synced 2025-09-18 09:46:37 +08:00
161 lines
3.4 KiB
Markdown
161 lines
3.4 KiB
Markdown
# 部署指南
|
||
|
||
## 目录说明
|
||
|
||
首先，请确保您已经进入 `AIWebQuickDeploy` 目录：
|
||
|
||
```bash
|
||
cd AIWebQuickDeploy
|
||
```
|
||
|
||
## Node.js 部署
|
||
|
||
### 1. 安装 Node.js 环境
|
||
|
||
推荐使用 `nvm` (Node Version Manager) 来安装 Node.js，这样可以方便地管理多个 Node.js 版本。
|
||
|
||
- 首先，安装 `nvm`，你可以从 [nvm GitHub 仓库](https://github.com/nvm-sh/nvm) 找到安装指南。
|
||
|
||
- 按照仓库中的安装说明进行操作，安装完成后，可能需要添加环境变量或重启终端。
|
||
|
||
- 安装 Node.js 版本 18 或更高版本:
|
||
|
||
```shell
|
||
nvm install 22
|
||
nvm use 22
|
||
```
|
||
|
||
- 验证 Node.js 是否安装成功:
|
||
|
||
```shell
|
||
node -v
|
||
npm -v
|
||
```
|
||
|
||
### 2. 安装 PM2 / PNPM（YARN）
|
||
|
||
- 使用 npm 安装 PM2（用于进程管理和自动重启）：
|
||
|
||
```shell
|
||
npm install pm2 -g
|
||
```
|
||
|
||
- 使用 npm 安装 pnpm（更快的包管理器）：
|
||
|
||
```shell
|
||
npm install -g pnpm
|
||
```
|
||
|
||
- 确认 `PM2` 和 `pnpm` 都已正确安装并且可以运行：
|
||
|
||
```shell
|
||
pm2 -v
|
||
pnpm -v
|
||
```
|
||
|
||
### 3. 其他配置
|
||
|
||
- 需配置 Redis 数据库以及新建一个 MySQL 数据库。
|
||
- 配置环境变量：
|
||
- 复制 `.env.example` 文件为 `.env`：
|
||
```shell
|
||
cp .env.example .env
|
||
```
|
||
- 根据需要修改 `.env` 文件中的配置项，主要包括：
|
||
- 数据库连接信息
|
||
- Redis 连接信息
|
||
- 服务端口配置
|
||
|
||
完成配置并启动后，项目会自动在指定的 MySQL 数据库中创建所需的表结构和初始数据，无需手动导入 SQL 文件。确保 `.env` 文件中的数据库连接信息正确即可。
|
||
|
||
### 4. 安装启动
|
||
|
||
- 安装依赖：(若安装缓慢可尝试使用国内源)
|
||
|
||
```shell
|
||
pnpm install
|
||
```
|
||
|
||
- 启动进程：（默认使用 PM2 后台运行）
|
||
|
||
```shell
|
||
pnpm start
|
||
```
|
||
|
||
- 查看运行日志：
|
||
|
||
```shell
|
||
pnpm logs
|
||
```
|
||
|
||
- 项目默认在 `9520` 端口运行，也可在环境变量中自行修改。成功运行后可通过 `IP:端口` 访问，或者配置 Nginx 反向代理，通过域名访问。
|
||
|
||
## 脚本部署
|
||
|
||
### 功能支持
|
||
|
||
- **Node.js 全新部署**
|
||
自动安装环境、生成配置、安装依赖并启动服务。
|
||
- **Node.js 升级**
|
||
拉取最新代码，更新依赖并重启服务。
|
||
- **Docker-compose 部署**
|
||
创建 MySQL、Redis 容器及 99AI 服务，支持自定义端口。
|
||
- **Docker-compose 升级**
|
||
停止旧版本容器，重新构建镜像并启动。
|
||
|
||
请在项目的根目录下执行以下命令：
|
||
|
||
```bash
|
||
./deploy.sh
|
||
```
|
||
|
||
## Docker 部署
|
||
|
||
### 1. 安装 Docker 及 Docker-compose
|
||
|
||
- 使用 [Docker 官网](https://www.docker.com/) 提供的一键安装链接安装 Docker 及 Docker-compose。
|
||
|
||
```bash
|
||
curl -fsSL https://get.docker.com | bash -s docker
|
||
```
|
||
|
||
- 也可以使用其他方式自行安装 Docker 及 Docker-compose。
|
||
|
||
### 2. 服务管理
|
||
|
||
- **后台启动服务**
|
||
|
||
```shell
|
||
docker-compose up -d
|
||
```
|
||
|
||
- **查看日志**
|
||
|
||
```shell
|
||
docker-compose logs
|
||
```
|
||
|
||
- **停止服务**
|
||
|
||
```shell
|
||
docker-compose down
|
||
```
|
||
|
||
- **重新构建并启动服务**
|
||
|
||
```shell
|
||
docker-compose up -d --build
|
||
```
|
||
|
||
## 项目管理
|
||
|
||
普通管理员，可以预览后台非敏感信息，默认不激活。请使用超级管理员账号登入后台，并及时修改密码。
|
||
|
||
- **管理端地址**：`项目链接/admin`
|
||
|
||
- **普通管理员账号**：`admin`（默认不激活）
|
||
|
||
- **超级管理员账号**：`super`
|
||
|
||
- **密码**：`123456`
|