j4ym0/mantisbt

Mantis Bug Tracker Docker (MantisBT)

概述

MantisBT是一款开源缺陷跟踪系统，旨在帮助团队高效管理软件项目中的缺陷、错误与任务。本Docker镜像提供MantisBT的容器化部署方案，简化安装配置流程，便于快速搭建稳定的缺陷跟踪环境。

核心功能与特性

• 容器化部署：基于Docker封装，简化安装、升级与维护流程
• 缺陷跟踪管理：支持缺陷创建、分配、状态更新、优先级设置等全流程管理
• 现代用户界面：提供直观的问题列表、个人视图、问题详情等界面（见截图）
• 灵活配置：支持外部配置文件挂载，自定义系统参数
• 高可用性：支持容器自动重启，保障服务稳定运行

使用场景与适用范围

• 软件开发团队进行缺陷跟踪与管理
• 项目管理团队监控任务进度与问题解决情况
• 需要快速部署缺陷跟踪系统的中小型团队
• 希望通过容器化技术简化环境配置的开发/测试环境

使用方法与配置说明

运行容器

后台运行

bash
docker run -d -p 60001:80 --name mantisbt j4ym0/mantisbt

前台运行（调试模式）

bash
docker run -it -p 60001:80 --name mantisbt j4ym0/mantisbt

使用外部配置文件

推荐挂载本地config_inc.php自定义系统配置：

bash
docker run -d -v /my/local/config_inc.php:/config/config_inc.php -p 60001:80 --name mantisbt j4ym0/mantisbt

自动重启配置

添加--restart unless-stopped参数实现容器崩溃或系统启动时自动重启：

bash
docker run -d --restart unless-stopped -v /my/local/config_inc.php:/config/config_inc.php -p 60001:80 --name mantisbt j4ym0/mantisbt

系统访问与初始化

• 首次运行且无外部配置时，访问http://127.0.0.1:60001进入初始化向导
• 需提前准备独立SQL数据库服务器（容器内不含数据库）
• 初始化完成后，执行以下命令清理安装文件：

  bash
  docker exec mantisbt /cleanup.sh
  

Apache代理转发配置

如需通过域名访问，可配置Apache虚拟主机代理：

1. 创建虚拟主机配置文件/etc/apache2/sites-available/mantis.my-site.com.conf：

apache
<VirtualHost *:80>
  ServerAdmin admin@localhost
  ServerName mantis.my-site.com
  ServerAlias mantis.my-site.com
  ProxyPreserveHost On
  ProxyRequests Off 
  ProxyPass / http://127.0.0.1:60001/
  ProxyPassReverse / http://127.0.0.1:60001/
  
  ErrorLog ${APACHE_LOG_DIR}/error.log
  CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

2. 启用站点：

bash
a2ensite mantis.my-site.com

截图

!https://github.com/mantisbt/mantisbt/raw/master/doc/modern_view_issues.png

!https://github.com/mantisbt/mantisbt/raw/master/doc/modern_my_view.png

!https://github.com/mantisbt/mantisbt/raw/master/doc/modern_view_issue.png

官方文档

完整管理指南请参阅MantisBT官方文档：https://github.com/mantisbt/mantisbt/doc%EF%BC%88%E6%8F%90%E4%BE%9B%E6%96%87%E6%9C%AC%E3%80%81PDF%E5%8F%8AHTML%E6%A0%BC%E5%BC%8F%EF%BC%89

参考链接

• MantisBT官方网站