Linux/Ubuntu 一键启动

start.sh 脚本用于服务器一键安装启动EasyAI应用

首次安装部署步骤，并使用服务器公网IP进行访问

1. 克隆脚本和相关文件到服务器

git clone https://git.51easyai.com/wangbo/easyai.git
# 进入easyai目录
cd easyai

2. 修改env中环境变量，将下面两个环境变量修改为你的服务器的公网ip，本地局域网方式使用局域网IP

NUXT_PUBLIC_BASE_APIURL=http://<你的服务器公网IP或者局域网地址>:3001
NUXT_PUBLIC_BASE_SOCKETURL=ws://<你的服务器公网IP或者局域网地址>:3002

3. 开放服务器的3001、3002和3010端口
4. [首次执行，后续无需重复执行]添加脚本的执行权限，命令：

chmod +x start.sh

5. 执行start.sh脚本，即可自动安装依赖和启动EasyAI应用

./start.sh

6. 脚本运行完成无错误，并且提示EasyAI应用启动成功表示应用启动成功，打开浏览器输入服务器的公网ip：3010或者局域网IP：3010，即可访问EasyAI应用

启用HTTPS

1. [更改为你的域名]修改easyai-proxy.conf中域名51easyai.com为你的域名[可以使用Ctrl+F批量替换51easyai.com为你的域名]
2. [修改.env文件]修改如下两个环境变量为如下的对应的值

NUXT_PUBLIC_BASE_APIURL=/api
NUXT_PUBLIC_BASE_SOCKETURL=wss://<你的域名>/socket.io

3. [首次执行，后续无需重复执行]添加执行权限，命令：

chmod +x https.sh

4. 启用HTTPS

./https.sh

更新升级

update.sh 脚本用于自动更新 EasyAI 应用，包含以下功能：

• 自动检查和更新 docker-compose.yml 文件（从远程仓库获取最新版本）
• 兼容 docker compose 和 docker-compose 两种命令格式
• 自动拉取最新镜像并重启服务

使用步骤

1. [首次执行，后续无需重复执行]添加执行权限，命令：

chmod +x update.sh

2. 执行更新（默认会检查并更新 docker-compose.yml）

./update.sh

参数选项

• 跳过 docker-compose.yml 更新：如果你已经手动修改了 docker-compose.yml 文件，可以使用 -s 或 --skip-compose-update 参数跳过更新

# 跳过 docker-compose.yml 更新，仅更新容器镜像
./update.sh -s
# 或
./update.sh --skip-compose-update

• 查看帮助信息：

./update.sh -h
# 或
./update.sh --help

更新说明

• 脚本会自动从远程仓库下载最新的 docker-compose.yml 文件
• 如果本地文件与远程文件不同，会将原文件备份为 docker-compose.yml.bak
• 如果本地文件已是最新版本，则跳过更新
• 更新完成后会自动执行 docker-compose pull 和 docker-compose up -d 来重启服务

重要更新记录：

2025.12.27

1. 修复挂载报错问题

2025.12.26

1. 增加临时文件目录挂载，解决只读文件系统问题
2. 增加后端日志目录挂载，便于日志管理和查看

2025.12.05

1. 更新新的视频编辑容器，支持更多视频处理功能

2025.11.12

1. 删除redis内存限制配置

2025.11.11

1. 增加redis内存限制配置

2025.09.22

1. 更新配置文件中的密钥设置，用于平台对接
2. 优化docker环境变量配置，直接在docker中引入env file，避免每次都需要手动增加环境变量

2025.09.20

1. 优化redis和MQ的云端配置

2025.08.31

1. 优化nginx配置，支持插件功能

2025.08.19

1. 更新部署相关文件

2025.08.08

1. 优化部署方式为pm2，提升应用稳定性

2025.07.28

1. 增加缓存目录挂载，让nodeJS执行子进程有操作缓存的权限

2025.07.12

1. 优化docker重启策略
2. 增加minio相关配置说明

2025.07.05

1. 优化安装docker-compose的脚本，增加本地docker-compose的兜底方案
2. 兼容 docker compose 和 docker-compose 两种命令格式

2025.07.04

1. 适配新的文件上传功能
2. 增加后端文件上传目录的挂载
3. 增加二级域名的取消域名重定向注释说明

2025.06.24

1. 增加禁用文档的环境变量和配置选项

2025.06.12

1. 增加CentOS系统兼容性支持

2025.06.06

1. 删除MCP server的配置

2025.06.04

1. 删除newAPI相关配置

2025.05.26

1. 删除旧websocket MCP环境变量配置

2025.05.15

1. 优化MCP消息转发Nginx配置文件

2025.05.14

1. 删除原MCP旧配置，增加新的MCP配置
2. 修改easyai-proxy文件，删除原来旧的MCP转发，新增新的标准SSE的代理优化
3. 更新README文档

2025.05.13

1. 增加docker-compose文件

2025.03.11

1. 增加了redis的配置文件，提升了生产环境的稳定性

早期版本

1. 升级了mongoDB的数据挂载方式，使用volume挂载，避免跨平台的一些数据挂载问题
2. .env增加了版本、日志和token参数的配置

常见问题

1. 某个服务无法运行 解决方案：重启docker（可以解决99%的问题）

# 
cd easyai && docker compose down && docker compose up -d 
#如果提示docker "compose" is not a docker command,则使用下面的命令
cd easyai && docker-compose down && docker-compose up -d 

2. 启动时提示Error: listen EADDRINUSE: address already in use :::3000 端口占用，请检查端口3000是否被其他程序占用
3. invalid interpolation format for services.mongo.ports.[]. You may need to escape any with another 等关于docker-compose文件格式的报错 解决方案：docker-compose 版本太低，一般为服务器之前自己使用apt安装低版本的docker-compose，需要卸载重新安装

# 卸载docker-compose
apt remove docker-compose
#重新安装
./start.sh