环境准备与系统要求
在开始安装Mantis BT之前,需确保Linux系统满足基本要求,Mantis BT基于PHP开发,支持MySQL或MariaDB数据库,因此需提前搭建LAMP(Linux+Apache+MySQL+PHP)或LNMP(Linux+Nginx+MySQL+PHP)环境,推荐系统为Ubuntu 20.04 LTS或CentOS 8,具体要求如下:

- Web服务器:Apache 2.4+(需启用mod_rewrite模块)或Nginx 1.18+
- 数据库:MySQL 5.7+、MariaDB 10.2+或PostgreSQL 12+
- PHP环境:PHP 7.4+(需安装php-gd、php-mysql、php-mbstring、php-json等扩展)
- 系统资源:至少512MB内存、1GB可用磁盘空间,推荐2GB以上内存以保证流畅运行
安装步骤详解
安装Web服务器与数据库
以Ubuntu系统为例,首先更新软件包列表并安装Apache和MariaDB:
sudo apt update && sudo apt install apache2 mariadb-server php libapache2-mod-php php-mysql php-gd php-mbstring php-json -y
安装完成后启动服务并设置开机自启:
sudo systemctl start apache2 mariadb sudo systemctl enable apache2 mariadb
若使用Nginx,需替换安装命令为sudo apt install nginx,并手动配置PHP-FPM支持。
创建数据库与用户
登录MariaDB并创建Mantis专用的数据库及用户:

sudo mysql -u root -p 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;
下载并配置Mantis BT
从官方源码仓库下载最新稳定版(以2.25.1为例):
cd /tmp wget https://downloads.sourceforge.net/project/mantisbt/mantisbt/mantis-stable/2.25.1/mantisbt-2.25.1.tar.gz tar -xvzf mantisbt-2.25.1.tar.gz sudo mv mantisbt-2.25.1 /var/www/html/mantis sudo chown -R www-data:www-data /var/www/html/mantis
配置Web服务器与PHP
对于Apache,在/etc/apache2/sites-available/目录下创建配置文件mantis.conf如下:
<VirtualHost *:80>
ServerName mantis.example.com
DocumentRoot /var/www/html/mantis
<Directory /var/www/html/mantis>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
启用配置并重载Apache:
sudo a2ensite mantis.conf sudo a2enmod rewrite sudo systemctl reload apache2
若使用Nginx,需配置/etc/nginx/sites-available/mantis,并设置PHP-FPM sock路径。

完成Web界面安装
访问http://服务器IP/mantis,进入Mantis安装向导,填写数据库信息(数据库名、用户名、密码)及管理员账户信息,点击“安装”即可完成初始化,安装成功后删除config/config_inc.php文件中的安装临时配置,并设置文件权限:
sudo chmod 644 /var/www/html/mantis/config/config_inc.php
常见问题与优化建议
- 权限问题:确保Web服务器用户(如www-data)对Mantis目录有读写权限,可通过
sudo chown -R www-data:www-data /var/www/html/mantis修复。 - PHP内存限制:若遇到内存不足错误,编辑
/etc/php/7.4/apache2/php.ini(路径根据PHP版本调整),将memory_limit调整为256M或更高。 - URL重写失效:检查Apache的mod_rewrite模块是否启用,并确保
.htaccess文件中的配置正确。 - 邮件功能配置:编辑
config/config_inc.php,设置$g_administrator_email和SMTP相关参数,确保系统通知邮件正常发送。
通过以上步骤,即可完成Mantis BT在Linux环境下的安装与基础配置,后续可根据团队需求调整插件、权限及工作流,进一步提升缺陷管理效率。











