> 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：安装语言

![安装向导步骤 1 — 语言选择](https://3615721887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD8EdNB0gaLktMFCBV5bf%2Fuploads%2Fgit-blob-3bb63d9477d7c1c7f6f53c60b1e4a05f9f7ff4b3%2Finstall-step1-language.png?alt=media)

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

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

## 步骤 2：要求检查

![安装向导步骤 2 — 要求检查显示 PHP 版本、扩展和目录权限](https://3615721887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD8EdNB0gaLktMFCBV5bf%2Fuploads%2Fgit-blob-2538f869c74fe5bde35450d30ea2b1482ba8e59e%2Finstall-step2-requirements.png?alt=media)

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

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

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

## 步骤 3：许可证

![安装向导步骤 3 — 许可证接受](https://3615721887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD8EdNB0gaLktMFCBV5bf%2Fuploads%2Fgit-blob-f094fb2fe7a74f43c4e25f4efb0c63049641b5ff%2Finstall-step3-license.png?alt=media)

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

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

## 步骤 4：数据库设置

![安装向导步骤 4 — 数据库连接配置](https://3615721887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD8EdNB0gaLktMFCBV5bf%2Fuploads%2Fgit-blob-2137cbc14608b72e73c11e47e3da98c8129193e9%2Finstall-step4-database.png?alt=media)

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

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

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

## 步骤 5：配置设置

![安装向导步骤 5 — 管理员账户、门户设置和电子邮件配置](https://3615721887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD8EdNB0gaLktMFCBV5bf%2Fuploads%2Fgit-blob-fb38c8506af225df9cd3154cc64d2c3c823c8bc0%2Finstall-step5-config.png?alt=media)

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

### 管理员账户

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

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

### 门户设置

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

### 电子邮件配置

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

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

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

![安装向导第6步 — 安装前审查所有设置](https://3615721887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD8EdNB0gaLktMFCBV5bf%2Fuploads%2Fgit-blob-53ef3d6ea7c9ab712af17be93542eeb95fab548a%2Finstall-step6-review.png?alt=media)

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

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

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

## 第7步：安装完成

![安装向导第7步 — 完成并提供安全建议和门户链接](https://3615721887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD8EdNB0gaLktMFCBV5bf%2Fuploads%2Fgit-blob-6905f8077e5f60547b2147a6a44de47122a8350a%2Finstall-step7-complete.png?alt=media)

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

* **入门建议** — 建议创建您的第一个课程以探索平台（作为管理员，您需要从管理面板中执行此操作）
* **安全建议**：
  * 将 `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` 以编译前端资源。                |