安装向导

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

开始之前

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

1. 您的服务器满足所有服务器要求。

2. 您已下载 Chamilo 的打包版本（zip 或 tar.gz）。

3. 您的 Web 服务器已配置将 public/ 目录作为文档根目录。

4. 您的 .env 文件存在且为空（向导将指导数据库设置）。

步骤 1：安装语言

安装向导步骤 1 — 语言选择

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

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

步骤 2：要求检查

安装向导步骤 2 — 要求检查显示 PHP 版本、扩展和目录权限

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

• PHP 版本 为 8.2 或更高版本

• 必需的 PHP 扩展 已安装（intl, gd, curl, zip, mbstring, xml 等）

• 推荐的 PHP 设置 — date.timezone 已配置，上传/内存限制充足

• 目录和文件权限 — var/, config/ 和 public/upload/ 可被 Web 服务器写入

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

步骤 3：许可证

安装向导步骤 3 — 许可证接受

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

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

步骤 4：数据库设置

安装向导步骤 4 — 数据库连接配置

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

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

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

步骤 5：配置设置

安装向导步骤 5 — 管理员账户、门户设置和电子邮件配置

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

管理员账户

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

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

门户设置

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

电子邮件配置

电子邮件设置部分允许您配置邮件传输（SMTP, Amazon SES, Mailjet 等）并测试邮件发送。详细信息请参见电子邮件配置。

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

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

安装向导第6步 — 安装前审查所有设置

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

• 管理员凭据（密码默认隐藏 — 点击眼睛图标以显示）

• 门户设置

• 数据库连接详细信息

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

第7步：安装完成

安装向导第7步 — 完成并提供安全建议和门户链接

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

• 入门建议 — 建议创建您的第一个课程以探索平台（作为管理员，您需要从管理面板中执行此操作）

• 安全建议：

  • 将 config/ 目录设置为只读（chmod 0555）

  • 删除 public/main/install/ 目录

• 一个 指向您的门户的链接，使用您刚刚创建的管理员凭据登录

安装后操作

完成向导后：

• 移除或限制对安装程序的访问 —— 安装后不应能访问向导。Chamilo 通常会自动锁定，但请验证重新访问安装 URL 是否会重定向到登录页面。

• 配置电子邮件发送 —— 参见 电子邮件配置。

• 设置备份 —— 在添加内容之前，配置自动化的数据库和文件备份（Chamilo 没有提供解决方案，但复制 var/ 文件夹和数据库是两个最重要的元素）。

• 审查安全设置 —— 参见 安全设置。

故障排除

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