本教程适用于以下操作系统版本

• Ubuntu 24.04（Noble Numbat）
• Ubuntu 18.04（Bionic Beaver）

本页内容

• 准备工作
• 安装依赖项
• 配置 PHP
• 配置 MariaDB 服务器
• 下载 vTiger 源代码
• 添加 Apache 虚拟主机
• 使用 HTTPS 保护 vTiger
• 安装 vTiger CRM
• 结论

vTiger 是一套面向企业的一体化 CRM（客户关系管理）解决方案，适用于中小型企业。vTiger CRM 为客户和用户提供了多种工具，可提升企业的运营效率。

vTiger CRM 提供两种方案：vTiger CRM 云端方案（支付费用即可使用全部管理与附加功能），以及 vTiger CRM 开源版本（可在你自己的服务器上自行托管）。

在本指南中，我们将逐步指导你在 Ubuntu 24.04 服务器上安装 vTiger CRM。你将使用 LAMP 技术栈（Linux、Apache、MySQL/MariaDB 和 PHP）来安装并运行 vTiger，随后使用 HTTPS 保护 vTiger。

准备工作

在开始之前，请确保你具备以下条件：

一台 Ubuntu 24.04 服务器。一个具有管理员权限的非 root 用户。一个已解析到服务器 IP 地址的域名。

安装依赖项

vTiger 是一款基于 PHP 和 MySQL/MariaDB 的开源 CRM 软件。你需要在系统上安装 LAMP 或 LEMP 技术栈才能安装它。在本示例中，你将在 Ubuntu 系统上使用 LAMP 技术栈运行 vTiger。

首先，运行以下命令更新 Ubuntu 软件包索引。

sudo apt update

现在使用以下命令安装 LAMP 技术栈（Linux、Apache2、MySQL/MariaDB 和 PHP）相关软件包。输入 Y 确认安装。

sudo apt install apache2 mariadb-server php libapache2-mod-php php-common php-sqlite3 php-json php-curl php-intl php-mbstring php-xmlrpc php-mysql php-gd php-xml php-cli php-zip php-soap php-imap php-bcmath wget unzip -y

安装完成后，使用以下命令检查 Apache Web 服务器状态：

sudo systemctl is-enabled apache2 sudo systemctl status apache2

你可以看到 Apache Web 服务器已启用且处于 active（运行中）状态。

使用以下命令检查 MariaDB 服务状态：

sudo systemctl is-enabled mariadb sudo systemctl status mariadb

你将看到 MariaDB 服务器状态为 active（运行中）且已启用。

最后，使用以下命令检查 PHP 版本。你的 Ubuntu 系统上应已安装 PHP 8.3。

sudo php -v

配置 PHP

安装完依赖项后，你将通过编辑配置文件 php.ini 来完成 PHP 的设置。

使用以下 nano 编辑器命令打开默认的 PHP 配置文件 /etc/php/8.3/apache2/php.ini。

sudo nano /etc/php/8.3/apache2/php.ini

按如下方式修改默认设置——请按需调整 memory_limit 和 date.timezone 选项。

memory_limit = 512M
upload_max_file_size = 100M
log_errors = Off
max_execution_time = 100
date.timezone = Europe/Amsterdam

完成后，保存文件并退出编辑器。

现在运行以下命令重启 Apache Web 服务器以使 PHP 配置生效。

sudo systemctl restart apache2

配置 MariaDB 服务器

在本节中，你将加固 MariaDB 服务器的安装。随后，将创建一个 vTiger CRM 要使用的新数据库和用户。你将使用 mariadb-secure-installation 来加固 MariaDB，并使用 mariadb 客户端创建新的数据库和用户。

要配置 MariaDB 服务器，请使用以下 nano 编辑器命令打开文件 /etc/mysql/maridb.conf.d/50-server.conf。

sudo nano /etc/mysql/maridb.conf.d/50-server.conf

在 [mysqld] 部分，添加以下一行：

sql_mode = ""

保存文件并退出编辑器。

现在运行以下命令重启 MariaDB 服务器使更改生效。

sudo systemctl status mariadb

接下来，你需要使用 mariadb-secure-installation 工具来加固 MariaDB 安装。按如下方式执行：

sudo mariadb-secure-installation

你会被询问以下配置：

• 按回车确认并完成 MariaDB 部署设置。
• 输入 Y 将认证方式改为 unix_socket。
• 输入 Y 为 MariaDB 设置 root 密码，并输入新的强密码。
• 输入 Y 从 MariaDB 服务器移除默认的匿名用户。
• 对于禁止 root 用户远程登录，再次输入 Y 确认。
• 现在从 MariaDB 服务器移除默认的 test 数据库。
• 最后，再次输入 Y 重新加载所有表权限。

既然已经加固了 MariaDB 服务器，接下来你将创建 vTiger CRM 要使用的新数据库和用户。使用以下 mariadb 命令登录 MariaDB 服务器。

在提示时输入你的 MariaDB root 密码。

sudo mariadb -u root -p

运行以下 SQL 语句为 vTiger 创建新的数据库和用户。在本示例中，你将创建一个名为 vtigerdb 的新数据库，以及一个名为 vtiger、密码为 password 的新用户。

CREATE DATABASE vtigerdb; CREATE USER vtiger@localhost IDENTIFIED BY ‘password’; GRANT ALL ON vtigerdb.* TO vtiger@localhost WITH GRANT OPTION; FLUSH PRIVILEGES;

现在运行以下查询检查用户 vtiger 的权限，确保用户 vtiger 可以访问数据库 vtigerdb 。

SHOW GRANT FOR vtiger@localhost;

输入 quit 退出 MariaDB 服务器。

下载 vTiger 源代码

既然已经配置好 PHP 和 MariaDB，接下来你将下载 vTiger 源代码，并设置具有正确权限和归属的文档根目录。

进入 /var/www 目录，并使用以下 wget 命令下载 vTiger 源代码。可访问 vTiger CRM 下载页面获取最新版本的链接。

cd /var/www/ wget https://sourceforge.net/projects/vtigercrm/files/vtiger CRM 8.2.0/Core Product/vtigercrm8.2.0.tar.gz/download

现在运行以下命令解压 vTiger 源代码。解压后，vTiger 的文档根目录应位于 /var/www/vtiger 目录。

tar -xf download

最后，将 /var/www/vtigercrm 目录的归属改为用户 www-data，并将默认权限设置为 0755 。

sudo chown -R www-data:www-data /var/www/vtigercrm sudo chmod 755 /var/www/vtigercrm

添加 Apache 虚拟主机

下载完 vTiger 源代码后，你将创建一个新的 Apache 虚拟主机来运行 vTiger。请确保已准备好你的域名，并将其解析到服务器 IP 地址。

首先，运行以下命令在 Apache Web 服务器上启用 rewrite 和 headers 模块。

sudo a2enmod rewrite headers

使用以下 nano 命令创建新的虚拟主机配置文件 /etc/apache2/sites-available/vtiger.conf。

sudo nano /etc/apache2/sites-available/vtiger.conf

添加以下配置，并务必将域名替换为你自己的域名。

<VirtualHost *:80>
    ServerName crm.howtoforge.local
    DocumentRoot /var/www/vtigercrm

     <Directory /var/www/vtigercrm/>
        Options +FollowSymlinks
        AllowOverride All
        Require all granted
     </Directory>

     ErrorLog /var/log/apache2/vtigercrm_error.log
     CustomLog /var/log/apache2/vtigercrm_access.log combined
</VirtualHost>

完成后，保存并退出文件。

现在运行以下命令以启用虚拟主机文件 vtiger.conf 并校验 Apache 语法。如果 Apache 语法正确，你将看到输出 Syntax is OK 。

sudo a2ensite vtiger.conf sudo apachectl configtest

最后，使用以下命令重启 Apache Web 服务器使更改生效——至此，你的 vTiger 安装已准备就绪。

sudo systemctl restart apache2

使用 HTTPS 保护 vTiger

为了保护 vTiger，你将通过 Certbot 和 Letsencrypt 配置 HTTPS。借助它，你可以在 Apache 虚拟主机上自动生成 SSL/TLS 证书并启用 HTTPS。

使用以下命令安装 certbot 和 python3-certbot-apache 插件。输入 Y 确认安装。

sudo apt install certbot python3-certbot-apache

安装完成后，使用以下命令为你的 vTiger 域名生成新的 SSL/TLS 证书。请务必将邮箱地址和域名替换为你自己的信息。

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d crm.howtoforge.local

当流程完成后，你的 SSL/TLS 证书将位于 /etc/letsencrypt/live/domain.com 目录。你的 vTiger 安装也将通过 HTTPS 受到保护。

安装 vTiger CRM

访问你的 vTiger 安装的域名（例如 https://crm.howtoforge.local/），你将看到 vTiger 安装向导。

点击 Install（安装）开始安装。

点击 I Agree（我同意）确认 vTiger CRM 的许可协议与条款。

现在，确认你的系统已满足 vTiger CRM 的安装要求。确保所有要求的状态均为 Yes，然后点击 Next（下一步）。

输入 MariaDB 数据库名称、用户名和密码等详细信息。然后为 vTiger 安装创建一个新的管理员用户。点击 Next（下一步）确认。

再次核对 vTiger CRM 的详细安装信息，然后点击 Next（下一步）。

将匿名数据收集部分保持默认设置，然后点击 Next（下一步）。

现在，vTiger CRM 安装将开始。

安装完成后，按需选择模块，然后点击 Next（下一步）继续。

现在，你将被重定向到如下所示的 vTiger CRM 仪表盘：

在 vTiger 的管理设置中，你可以查看与 vTiger CRM 安装和配置相关的详细信息。

结论

恭喜！你已成功在 Ubuntu 24.04 服务器上完成 vTiger CRM 的安装。你现在已通过 LAMP 技术栈（Linux、Apache、MySQL/MariaDB 和 PHP）让 vTiger CRM 运行起来，并通过 Certbot 和 Letsencrypt 使用 HTTPS 进行了保护。