GeChiUI以其易于安装而闻名。在大多数情况下，安装GeChiUI是一个非常简单的过程，只需不到五分钟即可完成。许多网络主机现在提供工具（例如 Fantastico）来为您自动安装GeChiUI。但是，如果您想自己安装GeChiUI，以下指南会有所帮助。
安装GeChiUI前须知
在开始安装之前，您需要做一些事情。请参阅安装之前的文章。
如果您需要多个GeChiUI实例，请参阅安装多个GeChiUI实例。
基本说明
这是针对那些已经习惯于执行此类安装的用户的快速版本说明。更详细的说明如下。
- 如果您还没有，请下载并解压缩GeChiUI包。
- 在您的 Web 服务器上为GeChiUI创建一个数据库，以及一个拥有访问和修改它的所有权限的MySQL （或 MariaDB）用户。
- （可选）查找gc-config-sample.php并将其重命名为gc-config.php，然后编辑该文件（请参阅编辑 gc-config.php）并添加您的数据库信息。
注意：如果您不习惯重命名文件，第 3 步是可选的，您可以跳过它，因为安装程序会为您创建gc-config.php文件。 - 将GeChiUI文件上传到您的 Web 服务器上的所需位置：
- 如果您想将GeChiUI集成到您的域的根目录中（例如http://example.com/），请将解压后的GeChiUI目录（不包括GeChiUI目录本身）的所有内容迁移或上传到您的 Web 服务器的根目录中。
- 如果您想将GeChiUI安装在您网站上自己的子目录中（例如http://example.com/blog/），请在您的服务器上创建文章目录并通过 FTP 将解压缩的GeChiUI包的内容上传到该目录.
- 注意：如果您的 FTP 客户端有将文件名转换为小写的选项，请确保它已禁用。
- 通过在 Web 浏览器中访问 URL 来运行GeChiUI安装脚本。这应该是您上传GeChiUI文件的 URL。
- 如果你在根目录下安装了GeChiUI，你应该访问：http ://example.com/
- 例如，如果您将GeChiUI安装在其名为blog的子目录中，您应该访问：http ://example.com/blog/
而已！现在应该安装GeChiUI。
详细说明
第 1 步：下载并解压
从https://www.gechiui.com/download/下载并解压缩GeChiUI包。
- 如果您要将GeChiUI上传到远程 Web 服务器，请使用 Web 浏览器将GeChiUI包下载到您的计算机并解压缩包。
- 如果您将使用 FTP，请跳至下一步 – 稍后将介绍上传文件。
- 如果您可以通过shell访问您的 Web 服务器，并且习惯于使用基于控制台的工具，那么您可能希望使用wget（或lynx或其他基于控制台的 Web 浏览器）将GeChiUI直接下载到您的Web 服务器，如果您想避免FTP传输：
- wget https://www.gechiui.com/latest.tar.gz
- 然后使用以下命令解压缩包：
tar -xzvf latest.tar.gz GeChiUI包将解压到您下载latest.tar.gz的同一目录中名为gechiui的文件夹中。
第 2 步：创建数据库和用户
如果您使用的是托管服务提供商，您可能已经为您设置了一个GeChiUI数据库，或者可能有一个自动设置解决方案可以这样做。检查您的托管服务提供商的支持页面或您的控制面板，了解您是否需要手动创建一个。
如果您确定需要手动创建一个，请按照以下使用 phpMyAdmin 的说明创建您的GeChiUI用户名和数据库。有关 Plesk、cPanel 和使用 MySQL 客户端等其他工具，请参阅文章为GeChiUI创建数据库。
如果您只有一个数据库并且它已经在使用中，您可以在其中安装GeChiUI——只需确保您的表有一个独特的前缀，以避免覆盖任何现有的数据库表。
使用 phpMyAdmin
如果您的网络服务器安装了phpMyAdmin，您可以按照这些说明创建您的GeChiUI用户名和数据库。如果您在自己的计算机上工作，在大多数 Linux 发行版上，您可以自动安装 PhpMyAdmin。
注意：这些说明是为 phpMyAdmin 4.4 编写的；phpMyAdmin 用户界面在版本之间可能略有不同。
- 如果左侧 的“数据库”下拉列表中尚不存在与GeChiUI相关的数据库，请创建一个：
- 为您的GeChiUI数据库选择一个名称：“ gechiui ”或“文章”都不错，但大多数托管服务（尤其是共享托管）都需要以您的用户名和下划线开头的名称，因此，即使您在自己的计算机上工作，我们建议您检查您的托管服务要求，以便您可以在自己的服务器上关注它们，并能够在不修改的情况下传输您的数据库。在创建数据库字段中输入所选数据库名称，然后为您的语言和编码选择最佳排序规则。在大多数情况下，最好选择“utf8_”系列，如果您找不到您的语言，请选择“utf8mb4_general_ci”（请参阅本文）。
- 为您的GeChiUI数据库选择一个名称：“ gechiui ”或“文章”都不错，但大多数托管服务（尤其是共享托管）都需要以您的用户名和下划线开头的名称，因此，即使您在自己的计算机上工作，我们建议您检查您的托管服务要求，以便您可以在自己的服务器上关注它们，并能够在不修改的情况下传输您的数据库。在创建数据库字段中输入所选数据库名称，然后为您的语言和编码选择最佳排序规则。在大多数情况下，最好选择“utf8_”系列，如果您找不到您的语言，请选择“utf8mb4_general_ci”（请参阅本文）。
- 单击左上角的phpMyAdmin图标返回主页面，然后单击“用户”选项卡。如果用户列表中不存在与GeChiUI相关的用户，请创建一个：
- 单击添加用户。
- 为GeChiUI选择一个用户名（’ gechiui ‘ 很好）并在用户名字段中输入它。（确保使用文本字段：从下拉列表中选择。）
- 选择一个安全密码（最好包含大小写字母、数字和符号的组合），然后在密码字段中输入。（确保从下拉列表中选择使用文本字段： 。）在重新输入字段中重新输入密码。
- 记下您选择的用户名和密码。
- 将全局权限下的所有选项保留为默认值。
- 点击前往。
- # 返回用户界面并单击您刚刚为GeChiUI创建的用户上的编辑权限图标。
- # 在Database-specificprivileges部分，在Add permissions to the following database下拉菜单中选择您刚刚为GeChiUI创建的数据库，然后单击Go。
- # 页面将以该数据库的权限刷新。单击Check All以选择所有权限，然后单击Go。
- # 在结果页面上，记下页面顶部Server:之后列出的主机名。（这通常是localhost。）
第 3 步：设置 gc-config.php
您可以自己创建和编辑gc-config.php文件，也可以跳过此步骤，让GeChiUI在您运行安装脚本时自行尝试执行此操作（第 5 步）。（您仍然需要告诉GeChiUI您的数据库信息）。
（有关更多详细信息，以及创建配置文件和密码安全密钥的分步说明，请参阅编辑 gc-config.php。）
返回到您在步骤 1 中提取GeChiUI包的位置，将文件gc-config-sample.php重命名为gc-config.php，然后在文本编辑器中打开它。
在标记为的部分下输入您的数据库信息
// ** MySQL 设置 - 您可以从您的虚拟主机获取此信息 ** //
DB_NAME 您在步骤 2 中为GeChiUI创建的数据库的名称。DB_USER 您在第 2 步中为GeChiUI创建的用户名。DB_PASSWORD 您在步骤 2 中为GeChiUI用户名选择的密码。数据库主机 您在第 2 步中确定的主机名（通常为localhost，但并非总是如此；请参阅一些可能的 DB_HOST 值）。如果需要端口、套接字或管道，请将冒号 (:) 和相关信息附加到主机名。DB_CHARSET The database character set, normally should not be changed (see Editing gc-config.php).DB_COLLATE The database collation should normally be left blank (see Editing gc-config.php).
Enter your secret key values under the section labeled
* Authentication Unique Keys and Salts.
Save the gc-config.php file.
Step 4: Upload the files
Now you will need to decide where on your domain you’d like yourGeChiUI-powered site to appear:
- In the root directory of your website. (For example, http://example.com/)
- In a subdirectory of your website. (For example, http://example.com/blog/)
Note: The location of your root web directory in the filesystem on your web server will vary across hosting providers and operating systems. Check with your hosting provider or system administrator if you do not know where this is.
In the Root Directory
- If you need to upload your files to your web server, use an FTP client to upload all the contents of the gechiui directory (but not the directory itself) into the root directory of your website.
- If your files are already on your web server, and you are using shell access to installGeChiUI, move all of the contents of the gechiui directory (but not the directory itself) into the root directory of your website.
In a Subdirectory
- If you need to upload your files to your web server, rename the gechiui directory to your desired name, then use an FTP client to upload the directory to your desired location within the root directory of your website.
- If your files are already on your web server, and you are using shell access to installGeChiUI, move the gechiui directory to your desired location within the root directory of your website, and rename the directory to your desired name.
Step 5: Run the Install Script
Point a web browser to start the installation script.
- If you placed theGeChiUIfiles in the root directory, you should visit: http://example.com/gc-admin/install.php
- If you placed theGeChiUIfiles in a subdirectory called blog, for example, you should visit: http://example.com/blog/gc-admin/install.php
Setup configuration file
如果GeChiUI找不到gc-config.php文件，它会告诉您并提供尝试创建和编辑文件本身。（您也可以通过在 Web 浏览器中加载gc-admin/setup-config.php来直接执行此操作。）GeChiUI会询问您数据库的详细信息并将它们写入新的gc-config.php文件。如果可行，您可以继续安装；否则，返回并自己创建、编辑和上传gc-config.php文件（步骤 3）。
完成安装
以下界面截图显示了安装的进度。请注意，在进入详细信息界面时，您输入了站点标题、所需的用户名、您选择的密码（两次）以及您的电子邮件地址。还会显示一个复选框，询问您是否希望您的文章出现在 Google 和 DuckDuckGo 等搜索引擎中。如果您希望所有人（包括搜索引擎）都可以看到您的文章，请不要选中该框，如果您想阻止搜索引擎但允许普通访问者，请选中该框。请注意，所有这些信息可以稍后在您的管理界面中更改。
如果您成功安装了GeChiUI，将显示登录提示。
安装脚本疑难解答
- 如果在运行安装脚本时收到有关数据库的错误：
常见安装问题
以下是一些最常见的安装问题。有关GeChiUI安装问题的更多信息和疑难解答，请查看常见问题解答安装和常见问题解答疑难解答。
我看到的是目录列表而不是网页。
需要告诉 Web 服务器默认查看index.php。在 Apache 中，使用DirectoryIndex index.php指令。最简单的选择是在安装目录中创建一个名为.htaccess的文件并将指令放在那里。另一种选择是将指令添加到 Web 服务器的配置文件中。
我看到很多标头已经发送错误。我该如何解决？
您可能在编辑gc-config.php时引入了语法错误。
- 下载gc-config.php（如果您没有shell访问权限）。
- 在文本编辑器中打开它。
- 检查第一行是否只包含<?php，并且它之前没有文本（甚至没有空格）。
- 检查最后一行是否只包含?>，并且它后面没有文本（甚至没有空格）。
- 如果您的文本编辑器保存为 Unicode，请确保它不添加字节顺序标记 (BOM)。大多数支持 Unicode 的文本编辑器不会通知用户是否将 BOM 添加到文件中。如果是这样，请尝试使用其他文本编辑器。
- 保存文件，如有必要再次上传，然后在浏览器中重新加载页面。
我的页面出现乱码。当我查看源代码时，我看到很多“ <?php ?> ”标签。
如果<?php ?>标记被发送到浏览器，这意味着您的PHP工作不正常。所有 PHP 代码都应该在服务器将生成的HTML发送到您的 Web 浏览器之前执行。（这就是它被称为预处理器的原因。）确保您的 Web 服务器满足运行GeChiUI的要求，正确安装和配置 PHP，或者联系您的托管服务提供商或系统管理员寻求帮助。
我不断收到错误连接到数据库消息，但我确定我的配置是正确的。
尝试手动重置您的 MySQL 密码。如果您可以通过 shell 访问 MySQL，请尝试发出：
SET PASSWORD FOR ' gechiuiusername '@'主机名' = OLD_PASSWORD('密码');
如果您没有 shell 访问权限，您应该能够简单地将上述内容输入到 phpMyAdmin 中的 SQL 查询中。否则，您可能需要使用主机的控制面板来重置数据库用户的密码。
我不断收到您的 PHP 安装似乎缺少GeChiUI消息所需的 MySQL 扩展，但我确定我的配置是正确的。
检查以确保您的 Web 服务器配置正确，并且您的 Web 服务器程序正确加载了 MySQL 插件。有时，此问题需要检查并验证从 Web 服务器到 MySQL 安装的所有路径中的所有内容都可以完全运行。不正确的配置文件或设置通常是导致此问题的原因。
我的图像/MP3 上传不起作用。
如果您在安装在子目录中的文章上使用富文本编辑器，并将新上传的图像拖到编辑器字段中，则该图像可能会在几秒钟后消失。这是由于 TinyMCE（富文本编辑器）在拖动操作期间没有获得足够的信息来正确构建图像或其他文件的路径的问题。解决方案是不要将上传的图像拖到编辑器中。相反，单击并按住图像并选择发送到编辑器。