Linux Mantis安装全过程是怎样的？详细步骤和注意事项解析

Linux 环境下 MantisBT 的安装与配置指南

MantisBT（Mantis Bug Tracker）是一款开源的缺陷跟踪系统，广泛应用于软件开发团队中，用于管理项目中的 bug、任务和问题，本文将详细介绍在 Linux 环境下安装 MantisBT 的完整步骤，包括环境准备、数据库配置、Web 服务器设置及后续优化，确保用户能够顺利完成部署并投入使用。

环境准备

在开始安装 MantisBT 之前，需要确保系统满足以下基本要求：

1. 操作系统：推荐使用 Ubuntu 20.04+ 或 CentOS 7+ 等 Linux 发行版。
2. Web 服务器：Apache 2.4+ 或 Nginx 1.18+，本文以 Apache 为例进行说明。
3. 数据库：MySQL 5.7+ 或 MariaDB 10.2+。
4. PHP：PHP 7.4+，需启用以下扩展：mysqli、gd、curl、xml、mbstring、zip、intl。
5. 其他工具：wget、unzip（用于下载和解压安装包）。

以 Ubuntu 系统为例，首先更新软件包列表并安装必要依赖：

sudo apt update && sudo apt upgrade -y
sudo apt install -y apache2 mysql-server php php-mysql php-gd php-curl php-xml php-mbstring php-zip php-intl

数据库配置

MantisBT 需要一个独立的数据库来存储数据，以下是创建数据库和用户的步骤：

1. 登录 MySQL：

   sudo mysql

2. 创建数据库和用户：

   CREATE DATABASE mantisdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   CREATE USER 'mantisuser'@'localhost' IDENTIFIED BY 'your_password';
   GRANT ALL PRIVILEGES ON mantisdb.* TO 'mantisuser'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

   请将 your_password 替换为强密码。

下载并安装 MantisBT

1. 下载最新版本：
   访问 MantisBT 官方网站（https://www.mantisbt.org/）获取最新下载链接，或使用 wget 直接下载：

   

   wget https://github.com/mantisbt/mantisbt/archive/refs/tags/v2.25.4.zip

2. 解压并移动文件：

   unzip v2.25.4.zip
   sudo mv mantisbt-2.25.4 /var/www/html/mantis
   sudo chown -R www-data:www-data /var/www/html/mantis

3. 配置目录权限：
   确保 MantisBT 的配置和附件目录可写：

   sudo chmod -R 755 /var/www/html/mantis
   sudo chmod -R 777 /var/www/html/mantis/config
   sudo chmod -R 777 /var/www/html/mantis/files

Web 服务器配置

1. 配置 Apache 虚拟主机：
   创建一个新的配置文件：

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

   添加以下内容：

   <VirtualHost *:80>
       ServerAdmin admin@example.com
       DocumentRoot /var/www/html/mantis
       ServerName mantis.example.com
       <Directory /var/www/html/mantis>
           Options Indexes FollowSymLinks
           AllowOverride All
           Require all granted
       </Directory>
       ErrorLog ${APACHE_LOG_DIR}/mantis_error.log
       CustomLog ${APACHE_LOG_DIR}/mantis_access.log combined
   </VirtualHost>

2. 启用配置并重启 Apache：

   sudo a2ensite mantis.conf
   sudo a2enmod rewrite
   sudo systemctl restart apache2

完成 Web 安装向导

1. 访问安装页面：
   在浏览器中输入 http://mantis.example.com（替换为实际域名或 IP），进入 MantisBT 的安装向导。

2. 填写数据库信息：

   

   • Database Type：选择 MySQLi。
   • Database Host：localhost。
   • Database Name：mantisdb。
   • Database User：mantisuser。
   • Database Password：之前设置的数据库密码。
   • Admin Username/Password：设置管理员账号和密码。

3. 完成安装：
   点击“Install/Upgrade Database”按钮，等待安装完成，安装成功后，系统会提示删除 admin/install.php 文件以确保安全：

   sudo rm /var/www/html/mantis/admin/install.php

后续配置与优化

1. 配置邮件发送：
   编辑 config_inc.php 文件，设置 SMTP 服务器信息以支持邮件通知：

   $g_smtp_host = 'smtp.example.com';
   $g_smtp_port = 587;
   $g_smtp_username = 'your_email@example.com';
   $g_smtp_password = 'your_email_password';
   $g_administrator_email = 'admin@example.com';
   $g_webmaster_email = 'admin@example.com';
   $g_from_email = 'noreply@example.com';
   $g_from_name = 'MantisBT';

2. 启用 HTTPS（可选）：
   使用 Let’s Encrypt 免费证书为网站启用 HTTPS：

   sudo apt install certbot python3-certbot-apache
   sudo certbot --apache -d mantis.example.com

3. 定期备份：
   设置定期备份数据库和 MantisBT 文件夹，确保数据安全，可以使用 mysqldump 备份数据库，并结合 cron 任务自动化备份。

常见问题解决

1. 权限错误：确保 config 和 files 目录权限为 777，安装后可适当降低权限。
2. PHP 版本不兼容：若 PHP 版本过低，需通过 ppa:ondrej/php 等方式升级。
3. 页面显示异常：检查 Apache 错误日志（/var/log/apache2/error.log）排查问题。

通过以上步骤，您已成功在 Linux 服务器上部署了 MantisBT，可以根据团队需求自定义项目、用户权限和工作流程,充分发挥其在缺陷管理中的作用。