Linux 环境下 MantisBT 安装与配置指南
MantisBT 是一款开源的缺陷跟踪系统,广泛应用于软件开发团队中,用于管理和跟踪项目中的问题,本文将详细介绍在 Linux 系统中安装 MantisBT 的完整步骤,包括环境准备、数据库配置、Web 服务器设置及后续优化,帮助读者快速搭建高效的缺陷管理平台。

环境准备与依赖安装
在安装 MantisBT 之前,需确保服务器满足以下基本要求:操作系统为 CentOS 7+/Ubuntu 18.04+,Web 服务器推荐使用 Apache 2.4+ 或 Nginx 1.18+,数据库支持 MySQL 5.7+ 或 MariaDB 10.2+,PHP 版本需 7.3 或更高,以 CentOS 7 为例,首先更新系统并安装必要的依赖包:
sudo yum update -y sudo yum install -y httpd mariadb-server php php-mysql php-gd php-mbstring php-xml php-json php-curl
安装完成后,启动 Apache 和 MariaDB 服务,并设置开机自启:
sudo systemctl start httpd mariadb sudo systemctl enable httpd mariadb
数据库配置
MantisBT 需要独立的数据库存储数据,以 MariaDB 为例,首先登录数据库并创建新用户及数据库:
mysql -u root -p
在 MariaDB 命令行中执行以下 SQL 语句(替换 mantis_db、mantis_user 和 password 为实际值):
CREATE DATABASE mantis_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'mantis_user'@'localhost' IDENTIFIED BY 'your_password'; GRANT ALL PRIVILEGES ON mantis_db.* TO 'mantis_user'@'localhost'; FLUSH PRIVILEGES; EXIT;
下载与配置 MantisBT
-
下载 MantisBT
访问 MantisBT 官方网站(https://www.mantisbt.org/)获取最新稳定版下载链接,或使用 wget 命令直接下载(以 2.25.4 版本为例):cd /var/www/html sudo wget https://downloads.sourceforge.net/project/mantisbt/mantisbt-stable/2.25.4/mantisbt-2.25.4.tar.gz sudo tar -zxvf mantisbt-2.25.4.tar.gz sudo mv mantisbt-2.25.4 mantis sudo chown -R apache:apache mantis
-
配置数据库连接
进入 MantisBT 安装目录,复制并编辑config_inc.php文件:
cd /var/www/html/mantis sudo cp config_inc.php.sample config_inc.php sudo vim config_inc.php
添加以下数据库配置信息:
$g_db_type = 'mysql'; $g_hostname = 'localhost'; $g_db_username = 'mantis_user'; $g_db_password = 'your_password'; $g_database_name = 'mantis_db';
-
设置文件权限
确保 MantisBT 目录及子目录的权限正确:sudo chown -R apache:apache /var/www/html/mantis sudo chmod -R 755 /var/www/html/mantis
Web 服务器配置
-
Apache 配置
创建 Apache 虚拟主机配置文件(如/etc/httpd/conf.d/mantis.conf):<VirtualHost *:80> ServerName mantis.example.com DocumentRoot /var/www/html/mantis <Directory /var/www/html/mantis> AllowOverride All Require all granted </Directory> </VirtualHost>重启 Apache 服务加载配置:
sudo systemctl restart httpd
-
Nginx 配置(可选)
若使用 Nginx,需配置 PHP-FPM 支持,并创建以下配置文件:server { listen 80; server_name mantis.example.com; root /var/www/html/mantis; index index.php; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }
完成安装与初始化
通过浏览器访问 http://mantis.example.com,进入 MantisBT 安装向导页面,根据提示完成以下步骤:

- 数据库连接测试:系统会自动检测数据库配置是否正确。
- 创建管理员账户:设置管理员用户名和密码。
- 配置站点信息:填写项目名称、默认语言等基本信息。
安装完成后,删除 admin 目录以增强安全性:
sudo rm -rf /var/www/html/mantis/admin
后续优化与维护
-
安全加固
- 配置防火墙规则,仅开放必要端口(如 80、443)。
- 定期更新 MantisBT 及依赖组件至最新版本。
-
性能优化
- 启用 PHP OPcache 提升脚本执行效率。
- 配置数据库索引优化查询性能。
-
备份策略
定期备份 MantisBT 数据库及配置文件,确保数据安全。
通过以上步骤,您已成功在 Linux 系统中部署 MantisBT,接下来可根据团队需求自定义工作流程、插件及通知设置,充分发挥其在缺陷管理中的作用。















