xlrl/mantisbt

MantisBT Docker镜像文档

镜像概述与主要用途

本Docker镜像用于部署MantisBT，这是一个开源问题跟踪系统，在简单性与功能性之间取得了良好平衡。通过该镜像，用户可以快速搭建MantisBT服务，用于项目中的问题管理、错误跟踪等任务。

Docker配置的源代码地址：https://github.com/xlrl/docker-mantisbt

核心功能与特性

• 支持多种数据库：可与MySQL、MariaDB或PostgreSQL配合使用
• 环境变量配置：支持设置时区（MANTIS_TIMEZONE）、启用管理员目录（MANTIS_ENABLE_ADMIN）
• 持久化存储：配置文件和自定义文件可通过卷挂载实现持久化
• 灵活部署：支持通过docker-compose快速编排服务，包含数据库组件

使用场景与适用范围

适用于需要搭建问题跟踪系统的团队或项目，尤其适合：

• 软件开发团队的错误管理和任务跟踪
• 项目管理中的问题上报与处理流程
• 需要快速部署且易于维护的中小型团队或个人项目

使用方法与配置说明

Docker Compose配置示例

以下示例假设容器数据存储在/srv/mantis目录，可根据服务器情况调整路径。

yaml
mantisbt:
  image: xlrl/mantisbt:latest
  environment:
    MANTIS_TIMEZONE: Europe/Berlin  # 设置时区
    MANTIS_ENABLE_ADMIN: 0          # 是否启用admin目录（0：禁用，1：启用）
  ports:
    - "8989:80"                     # 映射容器80端口到主机8989端口
  links:
    - mysql                         # 链接到mysql服务
  volumes:
    - ./config:/var/www/html/config  # 持久化配置文件
    - ./custom:/var/www/html/custom  # 持久化自定义文件
  restart: always                   # 总是重启容器

mysql:
  image: mariadb:latest
  environment:
    - MYSQL_ROOT_PASSWORD=root       # MySQL root密码
    - MYSQL_DATABASE=bugtracker      # MantisBT数据库名
    - MYSQL_USER=mantisbt            # MantisBT数据库用户
    - MYSQL_PASSWORD=mantisbt        # MantisBT数据库密码
  volumes:
    - ./mysql:/var/lib/mysql         # 持久化数据库数据
  restart: always

你可以使用mysql/postgres代替mariadb。

安装步骤

重要提示： 要能够访问"admin"目录，必须通过设置MANTIS_ENABLE_ADMIN=1启用它。

1. 启动容器后，通过浏览器访问安装页面：

   bash
   $ firefox http://localhost:8989/admin/install.php
   

2. 登录安装页面（默认凭据）：

   • 用户名：administrator
   • 密码：root

3. 配置安装选项（按以下参数填写）：

==================================================================================
安装选项
==================================================================================
数据库类型                                        MySQL/MySQLi
数据库服务器主机名                              mysql
数据库用户名                                    mantisbt
数据库密码                                      mantisbt
数据库名称                                      bugtracker
创建数据库所需的管理员用户名                      root
创建数据库所需的管理员密码                      root
仅打印SQL查询而不写入数据库                      [ ]
执行安装                                        [安装/升级数据库]
==================================================================================

邮件配置

编辑/srv/mantis/config/config_inc.php文件，添加以下配置以启用邮件功能：

php
$g_phpMailer_method = PHPMAILER_METHOD_SMTP;
$g_administrator_email = 'admin@example.org';       // 管理员邮箱
$g_webmaster_email = 'webmaster@example.org';       // 网站管理员邮箱
$g_return_path_email = 'mantisbt@example.org';      // 退信邮箱
$g_from_email = 'mantisbt@example.org';             // 发件人邮箱
$g_smtp_host = 'smtp.example.org';                  // SMTP服务器地址
$g_smtp_port = 25;                                  // SMTP端口
$g_smtp_connection_mode = 'tls';                    // 连接模式（tls/ssl）
$g_smtp_username = 'mantisbt';                      // SMTP用户名
$g_smtp_password = '**';                      // SMTP密码

LDAP配置

编辑/srv/mantis/config/config_inc.php文件，添加以下配置以启用LDAP认证（针对Active Directory服务器）：

php
$g_login_method = LDAP;                            // 登录方式设为LDAP
$g_ldap_server = 'ldap://dc.example.com';          // LDAP服务器地址
$g_ldap_root_dn = 'dc=example,dc=com';             // LDAP根目录
$g_ldap_bind_dn = 'cn=readuser, dc=example, dc=com'; // 绑定用户DN
$g_ldap_bind_passwd = 'geheim123';                 // 绑定用户密码
$g_ldap_organization = '';                         // 组织筛选条件（留空）
$g_use_ldap_email = ON;                            // 使用LDAP中的***
$g_use_ldap_realname = ON;                         // 使用LDAP中的真实姓名
$g_ldap_protocol_version = 3;                      // LDAP协议版本
$g_ldap_follow_referrals = OFF;                    // 禁用引用跟踪
$g_ldap_uid_field = 'sAMAccountName';              // 用户ID字段