tangramor/redmine

Redmine Docker镜像（Nginx+Passenger）

镜像概述

本镜像为生产就绪的Redmine项目管理系统镜像，基于AlmaLinux或CentOS系统，集成Nginx和Passenger Web服务器，支持MySQL数据库，提供多个Redmine版本（6.0.4、5.1.7、5.0.12、4.2.11、3.3.3）供选择，可快速部署用于团队协作、任务跟踪和项目管理。

核心功能

1. 多版本支持：涵盖Redmine 3.x到6.x的稳定版本，适配不同需求；
2. 生产环境就绪：集成Nginx+Passenger，优化性能和稳定性；
3. 数据库支持：仅支持MySQL，自动初始化数据库并执行迁移；
4. 插件扩展：支持安装Redmine插件（如redmine_agile）；
5. 多语言支持：部分版本可通过LOCALE环境变量设置语言（如zh_CN.UTF-8）；
6. 数据持久化：通过卷映射保存Redmine和MySQL数据。

使用场景

• 企业/团队的项目管理、任务分配与跟踪；
• 软件开发过程中的需求管理、缺陷跟踪；
• 小型团队的协作与文档管理。

配置说明

1. 数据库配置：修改docker-compose.yml、config/database.yml和initial.sql中的MySQL用户名/密码（默认root密码为Password1，redmine用户密码为Password2）；
2. 卷映射：调整docker-compose.yml中的卷映射，Redmine数据路径为/home/redmine，MySQL数据路径为/home/mysql<version>_data；
3. 语言设置：Redmine 3.3.3或4.2.11版本可通过设置LOCALE=zh_CN.UTF-8支持中文；
4. 跳过自动迁移：若需自行导入数据库，创建空文件config/init_db.lock。

部署示例

Docker Compose部署

1. 下载对应版本的docker-compose.yml和config文件夹（从GitHub仓库获取）；
2. 修改配置文件中的数据库信息和卷映射；
3. 启动容器：

   bash
   docker compose up -d
   

4. 等待容器状态变为healthy（约2分钟），访问http://127.0.0.1即可使用。

加载默认数据集

bash
# 进入Redmine容器
docker exec -it -u service -w /var/www/html/redmine redmine bash
# 加载环境变量
source ~/.bash_profile
# 加载中文默认数据集
RAILS_ENV=production REDMINE_LANG=zh bundle exec rake redmine:load_default_data

登录系统

使用默认管理员账号：

• 用户名：admin
• 密码：admin

安装插件示例（redmine_agile）

1. 下载插件包并复制到/home/redmine/plugins；
2. 进入容器执行以下命令：

   bash
   docker exec -it -u service -w /var/www/html/redmine redmine bash
   source ~/.bash_profile
   cd plugins && unzip redmine_agile-x_x_x-light.zip
   cd .. && bundle install --without development test --no-deployment
   bundle exec rake redmine:plugins NAME=redmine_agile RAILS_ENV=production
   touch tmp/restart.txt