Redmine项目管理软件安装与配置指南

Redmine项目管理软件安装与配置指南

redmine Mirror of redmine code source - Official Subversion repository is at https://svn.redmine.org/redmine - contact: @vividtone or maeda (at) farend (dot) jp 项目地址: https://gitcode.com/gh_mirrors/re/redmine

概述

Redmine是一款基于Ruby on Rails开发的开源项目管理工具，广泛应用于项目跟踪、问题管理和团队协作。本文将详细介绍Redmine的安装与配置过程，帮助用户快速搭建自己的项目管理平台。

系统要求

核心组件

• Ruby版本：3.2、3.3或3.4
• 数据库支持：
  • MySQL 8（推荐）
  • PostgreSQL 14
  • SQLite3 3.11
  • SQLServer 2012

可选组件

• 版本控制工具：如Git、SVN等（用于代码仓库浏览功能）
• ImageMagick：用于将甘特图导出为PNG图片

浏览器兼容性

支持最新版本的Firefox、Safari、Chrome、Chromium和Microsoft Edge浏览器。

详细安装步骤

1. 解压程序包

将下载的Redmine压缩包解压到目标目录。

2. 创建数据库

创建一个UTF-8编码的空数据库，例如命名为"redmine"。

3. 配置数据库连接

编辑config/database.yml文件，配置生产环境(production)下的数据库连接参数。默认使用MySQL数据库适配器。

4. 安装依赖包

执行以下命令安装必要的Ruby依赖包：

bundle install --without development test

注意事项：

• 系统只会安装database.yml中配置的数据库适配器对应的gem包
• 如需额外gem包，可在Redmine根目录创建Gemfile.local文件

5. 生成会话密钥

执行以下命令生成会话加密密钥：

bundle exec rake generate_secret_token

6. 编译静态资源（可选）

执行以下命令预编译静态资源：

bundle exec rake assets:precompile RAILS_ENV="production"

特殊场景处理：

• 部署到子目录时需指定URL根路径
• 遇到资源加载问题时，可先清理再重新编译

7. 初始化数据库

执行数据库迁移命令：

bundle exec rake db:migrate RAILS_ENV="production"

此操作将创建所有数据表并初始化管理员账户。

8. 设置目录权限（Windows用户可跳过）

确保运行Redmine的用户对以下目录有写权限：

• files
• log
• tmp
• public/assets

推荐权限设置：

sudo chown -R redmine:redmine files log tmp public/assets
sudo chmod -R 755 files log tmp public/assets

9. 测试运行

启动Puma服务器：

ruby bin/rails server -e production

访问http://localhost:3000/应能看到欢迎页面。

10. 初始登录

使用默认管理员账户登录：

• 用户名：admin
• 密码：admin

首次登录后，建议进入"管理"界面加载默认配置数据并调整应用设置。

数据库高级配置

MySQL事务隔离级别

Redmine 5.1.1及以上版本使用MySQL时，需将事务隔离级别从默认的REPEATABLE READ改为READ COMMITTED。

配置方法：

1. 在database.yml中添加：

production:
  adapter: mysql2
  database: redmine
  host: localhost
  [...]
  variables:
    transaction_isolation: "READ-COMMITTED"

2. 或直接修改MySQL服务器配置

SMTP邮件服务器配置

1. 复制示例配置文件：

cp config/configuration.yml.example config/configuration.yml

2. 编辑configuration.yml配置SMTP参数

3. 修改后需重启Redmine应用

重要提示：不要将SMTP配置放在environment.rb文件中。

常见问题排查

1. 数据库连接问题：

   • 检查database.yml配置是否正确
   • 确保数据库服务已启动
   • 验证数据库用户权限

2. 静态资源加载失败：

   • 尝试重新预编译资源
   • 检查public/assets目录权限

3. 邮件发送失败：

   • 验证SMTP配置参数
   • 检查服务器防火墙设置
   • 查看日志获取详细错误信息

通过以上步骤，您应该能够成功安装并配置Redmine项目管理平台。如需进一步定制或遇到特殊问题，建议参考Redmine官方文档获取更多技术细节。

redmine Mirror of redmine code source - Official Subversion repository is at https://svn.redmine.org/redmine - contact: @vividtone or maeda (at) farend (dot) jp 项目地址: https://gitcode.com/gh_mirrors/re/redmine