# 安装向导

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

## 开始之前

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

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

## 步骤 1：安装语言

![安装向导步骤 1 — 语言选择](/files/31wX3kurqKPeGo8QeM57)

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

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

## 步骤 2：要求检查

![安装向导步骤 2 — 要求检查显示 PHP 版本、扩展和目录权限](/files/jYonAOWwPcQNrI6VzbhH)

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

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

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

## 步骤 3：许可证

![安装向导步骤 3 — 许可证接受](/files/RV1wG6Z7GCfd4ueItRHr)

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

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

## 步骤 4：数据库设置

![安装向导步骤 4 — 数据库连接配置](/files/Q5yPiE3SJxc73p1YN1z4)

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

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

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

## 步骤 5：配置设置

![安装向导步骤 5 — 管理员账户、门户设置和电子邮件配置](/files/Gknyf4cx5IRtUfxH8cOS)

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

### 管理员账户

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

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

### 门户设置

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

### 电子邮件配置

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

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

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

![安装向导第6步 — 安装前审查所有设置](/files/mgRyREeZ9og9dE3CEZTx)

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

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

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

## 第7步：安装完成

![安装向导第7步 — 完成并提供安全建议和门户链接](/files/cI8Vq6nQdihTHZq5pAzD)

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

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

## 安装后操作

完成向导后：

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-zh-cn/guan-li-zhi-nan/admin-guide/installation/installation-wizard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.