在安装 AI-CMS 之前，请确保您的服务器满足以下基本环境要求。

服务器环境

项目	最低要求	推荐配置
PHP 版本	= 8.0	>= 8.1
MySQL	>= 5.7 或 MariaDB >= 10.3	>= 8.0
Nginx / Apache	任意稳定版	Nginx 1.22+
磁盘空间	>= 500MB	>= 2GB
内存	>= 256MB	>= 512MB

必需 PHP 扩展

以下 PHP 扩展为运行 AI-CMS 所必需：

• mbstring — 多字节字符串处理（核心依赖）
• PDO + pdo_mysql — 数据库连接
• cURL — HTTP 请求（调用 AI 接口）
• JSON — JSON 数据处理
• GD 或 Imagick — 图片处理
• OpenSSL — HTTPS 安全通信

浏览器兼容性

AI-CMS 后台管理系统支持以下浏览器：

• Chrome >= 80
• Firefox >= 80
• Safari >= 14
• Edge >= 80
• 微信内置浏览器（移动端）

确认环境满足要求后，请继续阅读 安装部署 文档。

AI-CMS 提供多种安装方式，您可以根据自身情况选择最适合的方案。

安装方式概览

方式	难度	耗时	适用场景
Docker 一键部署	简单	~3 分钟	推荐，适合大多数场景
手动部署	中等	~10 分钟	需要自定义环境时
Composer 安装	简单	~5 分钟	开发者使用

Docker 一键部署（推荐）

使用 Docker Compose 可以在 3 分钟内完成全部环境的搭建：

# 1. 克隆代码仓库
git clone https://gitee.com/bajieai/ai-cms.git
cd ai-cms

# 2. 复制环境配置文件
cp .env.example .env

# 3. 启动所有服务
docker-compose up -d

# 4. 访问安装向导
# 打开浏览器访问 http://localhost:8080

手动部署步骤

1. 从 Gitee 下载最新源码包并解压到 Web 根目录
2. 创建 MySQL 数据库和专用用户账号
3. 导入数据库结构文件 sql/aicms.sql
4. 修改 .env 配置文件中的数据库连接参数
5. 设置 runtime/ 和 uploads/ 目录权限为可写
6. 配置 Web 服务器的伪静态规则
7. 访问域名进入安装向导完成初始化

Nginx 伪静态配置

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/ai-cms/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass php:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

安装完成后，建议立即修改默认管理员密码并启用两步验证。