> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/2.x/zh/guan-li-zhi-nan/admin-guide/installation/installation-wizard.md).

# 安装向导

Chamilo 2.0 包含一个基于网页的安装向导，指导您完成初始设置。首次访问平台时，向导会自动运行。

## 开始之前

请确保满足以下前提条件：

1. 您的服务器满足所有[服务器要求](/2.x/zh/guan-li-zhi-nan/admin-guide/installation/server-requirements.md)。
2. 您已下载 Chamilo 的打包版本（zip 或 tar.gz）。
3. 您的 Web 服务器已配置将 `public/` 目录作为文档根目录。
4. 您的 `.env` 文件存在且为空（向导将指导数据库设置）。

## 步骤 1：安装语言

第一步允许您选择安装过程的语言。从下拉菜单中选择您偏好的语言。

如果 Chamilo 检测到现有安装（用于升级），它将显示迁移状态并提供升级路径，而不是全新安装。

## 步骤 2：要求检查

向导会检查您的服务器环境：

* **PHP 版本** 为 8.2 或更高版本
* **必需的 PHP 扩展** 已安装（intl, gd, curl, zip, mbstring, xml 等）
* **推荐的 PHP 设置** — `date.timezone` 已配置，上传/内存限制充足
* **目录和文件权限** — `var/`, `config/` 和 `public/upload/` 可被 Web 服务器写入

如果有任何要求未满足，向导会显示警告或错误。在继续之前解决这些问题。

## 步骤 3：许可证

此步骤显示 GNU/GPLv3 许可证。您必须勾选 **"我接受"** 复选框才能继续。

您可以选择展开 **联系信息** 部分，提供有关您组织的信息（名称、电子邮件、公司、国家）。这是自愿的，有助于 Chamilo 社区了解谁在使用该平台，但也允许我们 *极少情况下* 就您附近的活动与您联系。

## 步骤 4：数据库设置

输入您的数据库连接详细信息：

| 字段        | 描述                                           |
| --------- | -------------------------------------------- |
| **数据库主机** | 数据库服务器的主机名或 IP（例如，`localhost` 或 `127.0.0.1`） |
| **数据库端口** | 默认值：MySQL/MariaDB 为 3306                     |
| **数据库名称** | 要使用的数据库名称（仅限字母数字和下划线）                        |
| **数据库用户** | 对指定数据库具有完全权限的数据库用户                           |
| **数据库密码** | 数据库用户的密码                                     |

点击 **检查数据库连接** 进行测试。在连接成功之前，向导不会让您继续。如果数据库已存在，将显示警告。

## 步骤 5：配置设置

此步骤包括管理员账户创建、门户设置和电子邮件配置。

### 管理员账户

| 字段       | 描述                      |
| -------- | ----------------------- |
| **登录名**  | 管理员用户名                  |
| **密码**   | 选择一个强密码 — 此账户拥有平台完整访问权限 |
| **名字**   | 管理员的名字                  |
| **姓氏**   | 管理员的姓氏                  |
| **电子邮件** | 用于系统通知和密码重置             |
| **电话**   | 可选的联系电话                 |

这些管理员详细信息也将被 Chamilo 用于填充支持联系方式，因此请确保在安装完成后在设置中重新配置。

### 门户设置

| 字段            | 描述                       |
| ------------- | ------------------------ |
| **语言**        | 默认界面语言                   |
| **门户名称**      | 您的平台名称（例如，“我的组织 LMS”）    |
| **公司简称**      | 您组织的简称                   |
| **公司网址**      | 您组织的网站                   |
| **加密方法**      | 密码哈希算法 — 推荐使用 **bcrypt** |
| **允许自注册**     | 是 / 否 / 需审批后             |
| **允许自注册为培训师** | 是 / 否                    |

### 电子邮件配置

电子邮件设置部分允许您配置邮件传输（SMTP, Amazon SES, Mailjet 等）并测试邮件发送。详细信息请参见[电子邮件配置](/2.x/zh/guan-li-zhi-nan/admin-guide/installation/email-configuration.md)。

所有这些设置稍后都可以在管理面板中更改。

## 第6步：安装前的最后检查

此步骤显示您输入的所有内容的摘要，供您审查：

* 管理员凭据（密码默认隐藏 — 点击眼睛图标以显示）
* 门户设置
* 数据库连接详细信息

请仔细审查，然后点击 **安装Chamilo** 执行安装。向导将创建所有数据库表，填充初始数据，并配置平台。

## 第7步：安装完成

安装成功完成后，向导将显示：

* **入门建议** — 建议创建您的第一个课程以探索平台（作为管理员，您需要从管理面板中执行此操作）
* **安全建议**：
  * 将 `config/` 目录设置为只读（`chmod 0555`）
  * 删除 `public/main/install/` 目录
* 一个 **指向您的门户的链接**，使用您刚刚创建的管理员凭据登录

## 安装后操作

完成向导后：

* **移除或限制对安装程序的访问** —— 安装后不应能访问向导。Chamilo 通常会自动锁定，但请验证重新访问安装 URL 是否会重定向到登录页面。
* **配置电子邮件发送** —— 参见 [电子邮件配置](/2.x/zh/guan-li-zhi-nan/admin-guide/installation/email-configuration.md)。
* **设置备份** —— 在添加内容之前，配置自动化的数据库和文件备份（Chamilo 没有提供解决方案，但复制 var/ 文件夹和数据库是两个最重要的元素）。
* **审查安全设置** —— 参见 [安全设置](/2.x/zh/guan-li-zhi-nan/admin-guide/platform-settings/security-settings.md)。

## 故障排除

| 问题              | 解决方案                                                    |
| --------------- | ------------------------------------------------------- |
| 安装 URL 处显示空白页面  | 检查 PHP 错误日志。临时将 .env 中的 `APP_ENV` 更改为 `dev` 以在浏览器中查看错误。 |
| 数据库连接失败         | 验证凭据，确认数据库存在，检查数据库服务器是否允许来自 Web 服务器主机的连接。               |
| 权限被拒绝错误         | 确保 `var/` 目录对 Web 服务器用户具有写入权限。                          |
| 资源未加载（无 CSS/JS） | 运行 `yarn install && yarn build` 以编译前端资源。                |