CentOS 7上OTRS 6.0.30保姆级部署教程：从Apache、MySQL到Perl模块避坑全记录

CentOS 7企业级OTRS工单系统部署实战：从零构建高可用服务支持平台

在数字化转型浪潮中，高效的问题跟踪与工单管理系统已成为企业IT服务管理的核心基础设施。作为开源工单系统的标杆之作，OTRS凭借其符合ITIL标准的架构设计、多语言支持能力以及高度可定制性，在全球范围内积累了超过16万企业用户。本文将基于CentOS 7环境，深入解析OTRS 6.0.30的完整部署流程，特别针对生产环境中常见的依赖冲突、权限配置、性能调优等痛点问题提供经过验证的解决方案。

1. 环境准备与系统优化

1.1 基础环境配置

在开始部署前，建议使用最小化安装的CentOS 7系统，确保环境干净无残留。首先更新系统并安装基础工具链：

yum update -y && yum install -y epel-release wget unzip vim bash-completion

对于生产环境，需要调整系统内核参数以优化OTRS性能。编辑/etc/sysctl.conf添加以下参数：

# 增加文件描述符限制 fs.file-max = 65536 # 优化网络性能 net.ipv4.tcp_tw_reuse = 1 net.ipv4.ip_local_port_range = 1024 65000

执行sysctl -p使配置生效后，创建专用系统用户并设置权限：

useradd -r -d /opt/otrs -c 'OTRS User' otrs

1.2 存储规划建议

根据实际业务规模规划存储方案：

提示：建议将MySQL数据目录单独挂载高性能存储设备，如SSD或NVMe硬盘

2. 核心服务部署

2.1 Apache与PHP集成

安装Apache 2.4并配置MPM事件模型：

yum install -y httpd httpd-devel sed -i 's/^Listen 80/Listen 8080/' /etc/httpd/conf/httpd.conf systemctl enable --now httpd

关键性能参数调整（/etc/httpd/conf.modules.d/00-mpm.conf）：

<IfModule mpm_event_module> StartServers 3 MinSpareThreads 75 MaxSpareThreads 250 ThreadsPerChild 25 MaxRequestWorkers 400 MaxConnectionsPerChild 0 </IfModule>

2.2 MySQL深度配置

采用MySQL 5.7社区版作为数据库后端，建议使用以下安装方式：

wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm rpm -ivh mysql57-community-release-el7-11.noarch.rpm yum install -y mysql-community-server

OTRS专用数据库配置模板（/etc/my.cnf.d/otrs.cnf）：

[mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci innodb_buffer_pool_size=2G innodb_log_file_size=512M innodb_flush_log_at_trx_commit=2 max_allowed_packet=128M query_cache_type=1 query_cache_size=64M

初始化数据库并创建OTRS专用账户：

CREATE DATABASE otrs CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'otrs'@'localhost' IDENTIFIED BY 'ComplexP@ssw0rd!'; GRANT ALL PRIVILEGES ON otrs.* TO 'otrs'@'localhost'; FLUSH PRIVILEGES;

3. OTRS核心安装与调优

3.1 依赖解决与模块管理

OTRS对Perl模块有严格依赖，推荐使用以下命令批量安装：

yum install -y "perl(Archive::Zip)" "perl(Crypt::SSLeay)" \ "perl(DBD::mysql)" "perl(Encode::HanExtra)" "perl(JSON::XS)" \ "perl(Mail::IMAPClient)" "perl(Net::LDAP)" "perl(Template)" \ "perl(XML::LibXML)" "perl(YAML::XS)" perl-core procmail

对于无法通过yum安装的模块，使用CPAN最小化安装：

perl -MCPAN -e 'install Moo' perl -MCPAN -e 'install DateTime'

3.2 系统安装与初始化

下载官方RPM包进行安装：

wget https://ftp.otrs.org.cn/releases/RPMS/rhel/7/otrs-6.0.30-02.noarch.rpm rpm -ivh otrs-6.0.30-02.noarch.rpm

关键目录权限设置：

chown -R otrs:apache /opt/otrs chmod -R 775 /opt/otrs/var

数据库初始化建议采用手动导入方式，确保数据结构可控：

mysql -u root -p otrs < /opt/otrs/scripts/database/otrs-schema.mysql.sql mysql -u root -p otrs < /opt/otrs/scripts/database/otrs-initial_insert.mysql.sql

4. 生产环境加固与监控

4.1 安全配置最佳实践

1. 网络层防护：

   • 配置Apache仅监听内网IP
   • 启用ModSecurity WAF模块
   • 强制HTTPS连接

2. 应用层防护：

   • 修改默认管理员密码
   • 启用OTRS双因素认证
   • 定期备份/opt/otrs/Kernel/Config.pm

3. 数据库安全：

   • 启用MySQL SSL连接
   • 配置定期自动备份
   • 设置数据库操作审计

4.2 性能监控方案

推荐使用以下组合进行系统监控：

• 资源监控：Prometheus + Grafana
• 日志分析：ELK Stack
• 应用监控：OTRS内置System Monitoring模块

关键性能指标报警阈值：

5. 高级配置与扩展

5.1 邮件网关集成

配置Postfix作为邮件网关的示例：

yum install -y postfix cyrus-sasl-plain

/etc/postfix/main.cf关键配置：

relayhost = [smtp.office365.com]:587 smtp_sasl_auth_enable = yes smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd smtp_sasl_security_options = noanonymous

5.2 高可用架构设计

对于关键业务系统，建议采用以下架构：

+-----------------+ | 负载均衡器 | +--------+--------+ | +----------------+----------------+ | | +----------+----------+ +----------+----------+ | OTRS节点1 | | OTRS节点2 | | - Apache | | - Apache | | - OTRS应用 | | - OTRS应用 | +----------+----------+ +----------+----------+ | | +----------------+----------------+ | +--------+--------+ | MySQL集群 | +-----------------+

实现要点：

1. 使用GlusterFS同步/opt/otrs目录
2. 配置MySQL主从复制
3. 使用Keepalived实现VIP漂移

6. 故障排查指南

6.1 常见问题诊断流程

1. 服务不可用：

   • 检查systemctl status httpd
   • 查看/var/log/httpd/error_log
   • 验证端口监听netstat -tulnp

2. 数据库连接问题：

   • 测试MySQL连接mysql -u otrs -p
   • 检查/opt/otrs/Kernel/Config.pm配置
   • 查看MySQL错误日志/var/log/mysqld.log

3. 性能下降：

   • 使用top查看资源使用
   • 分析慢查询mysqldumpslow
   • 检查OTRS守护进程状态/opt/otrs/bin/otrs.Daemon.pl status

6.2 日志分析技巧

关键日志文件位置：

使用实时监控命令：

# 复合监控命令 tail -f /var/log/httpd/error_log /opt/otrs/var/log/otrs.log | grep -E 'error|fail|warning'

7. 升级与维护策略

7.1 版本升级路径

OTRS版本升级路线图：

6.0.30 → 6.1.32 → 7.0.x → 8.0.x

升级前检查清单：

1. 完整备份数据库和配置文件
2. 验证当前系统兼容性
3. 在测试环境先行验证
4. 准备回滚方案

7.2 自动化维护方案

推荐使用Ansible进行自动化管理：

# otrs_maintenance.yml - hosts: otrs_servers tasks: - name: Backup database command: mysqldump -u root -p{{ mysql_root_pass }} otrs > /backups/otrs-$(date +%F).sql - name: Rotate logs command: /opt/otrs/bin/otrs.LogfileCleanup.pl -d 30 - name: Verify daemon status command: /opt/otrs/bin/otrs.Daemon.pl status register: daemon_status failed_when: "'running' not in daemon_status.stdout"

设置cron定时任务：

0 3 * * * /usr/bin/ansible-playbook /etc/ansible/otrs_maintenance.yml

8. 扩展功能开发

8.1 自定义模块开发

OTRS模块基本结构示例：

package Kernel::Modules::CustomDashboard; use strict; use warnings; use Kernel::System::Web::InterfaceCustomer; sub new { my ($Type, %Param) = @_; my $Self = {%Param}; bless($Self, $Type); return $Self; } sub Run { my ($Self, %Param) = @_; # 业务逻辑实现 return $Self->{LayoutObject}->Output( TemplateFile => 'CustomDashboard', Data => \%Param, ); } 1;

8.2 REST API集成

启用API功能的配置步骤：

1. 修改Kernel/Config.pm：

$Self->{'GenericInterface::Invoker::Module::TicketCreate'} = { ConfigDialog => 'AdminGenericInterfaceInvokerDefault', };

2. 创建API用户：

INSERT INTO gi_webservice (name, config) VALUES ('TicketAPI', '{"Debugger":{"Active":0},"Provider":{"Operation":{"TicketCreate":{"Type":"Ticket::TicketCreate"}}}}');

3. 使用curl测试API：

curl -X POST -H "Content-Type: application/json" \ -d '{"UserLogin":"api_user","Password":"secret","Ticket":{"Title":"API测试","Queue":"系统默认","State":"新建"}}' \ http://otrs.example.com/otrs/nph-genericinterface.pl/Webservice/TicketAPI/TicketCreate

在实际部署过程中发现，OTRS对Perl模块版本的兼容性要求极为严格，特别是在跨版本升级时，建议使用perlbrew管理多版本Perl环境。数据库连接池的配置对高并发场景至关重要，可通过调整Apache的prefork参数和MySQL的连接池大小来获得最佳性能表现。