1. 为什么选择Docker来部署Redmine如果你正在为团队寻找一个靠谱的项目管理工具Redmine绝对是个经典选择。它功能全面从任务跟踪、Wiki文档到甘特图、日历视图一应俱全而且开源免费社区活跃。但很多朋友在第一步“安装”上就卡住了——传统的安装方式需要你手动配置Ruby环境、安装数据库、处理各种依赖步骤繁琐不说还容易因为环境差异导致“在我机器上好好的”这种尴尬局面。我当年第一次部署Redmine光是解决Ruby版本和数据库适配问题就折腾了大半天。直到后来用上了Docker整个过程才变得清爽无比。Docker就像一个标准化的“集装箱”它把Redmine运行所需的所有东西——操作系统、Ruby环境、依赖库、应用代码——都打包在一起。你不需要关心底层系统是Ubuntu还是CentOS也不用担心缺少某个库文件直接拉取镜像、运行容器几分钟就能得到一个可用的Redmine服务。这种“容器化”带来的最大好处就是环境一致性和部署便利性。开发、测试、生产环境可以做到完全一致避免了因环境差异导致的诡异Bug。部署和迁移也变得极其简单一个docker run命令就能搞定备份和恢复也只需处理几个数据卷。对于中小团队或个人开发者来说这能节省大量运维精力让你更专注于项目本身的管理而不是工具的维护。2. 部署前的准备工作理清思路与资源动手之前我们先花几分钟把整个架构想清楚。一个典型的Redmine Docker部署通常包含两个核心服务MySQL数据库和Redmine应用本身。数据库负责存储所有项目数据、用户信息而Redmine容器则提供Web界面和业务逻辑。它们会通过Docker网络进行通信。你需要准备的东西很简单一台服务器云服务器、本地虚拟机甚至你性能不错的个人电脑都可以。操作系统推荐Linux如Ubuntu 20.04/22.04 LTS或CentOS 7/8对Docker支持最好。安装好Docker和Docker Compose这是我们的基础工具。如果你的系统还没装可以快速执行几条命令搞定。以Ubuntu为例# 更新软件包索引 sudo apt-get update # 安装必要的依赖 sudo apt-get install apt-transport-https ca-certificates curl software-properties-common # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - # 添加Docker仓库 sudo add-apt-repository deb [archamd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable # 再次更新并安装Docker sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io # 安装Docker Compose一个更方便管理多容器的工具 sudo curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose规划好数据存储路径这是最重要的一步决定了你的数据安全。我们绝不能把项目数据、数据库文件放在容器内部因为容器一旦删除数据就没了。必须使用Docker的“卷”Volume或“绑定挂载”Bind Mount功能将容器内的数据目录映射到宿主机的硬盘上。我习惯在/opt/docker-data目录下为每个应用创建独立的子文件夹结构清晰备份也方便。3. 第一步用Docker启动MySQL数据库数据库是Redmine的基石我们先把它稳当地跑起来。这里我选择MySQL 5.7的官方镜像它稳定且与Redmine兼容性好。我们不仅仅要启动它还要做好数据持久化和基础优化。创建一个专门的工作目录比如/opt/redmine-docker然后新建一个docker-compose.yml文件。用Docker Compose来管理会让后续操作启动、停止、查看日志更统一。当然如果你喜欢直接用docker run命令我也会给出对应的示例。使用Docker Compose方式推荐在docker-compose.yml文件中我们先定义MySQL服务version: 3.8 services: mysql: image: mysql:5.7 container_name: redmine-mysql restart: unless-stopped # 确保容器意外退出时自动重启 environment: MYSQL_ROOT_PASSWORD: YourStrongRootPassword123! # 请务必修改成复杂密码 MYSQL_DATABASE: redmine MYSQL_USER: redmine MYSQL_PASSWORD: YourRedmineUserPassword456! # 同样修改成强密码 TZ: Asia/Shanghai # 设置容器时区避免时间错乱 volumes: - ./mysql/data:/var/lib/mysql # 持久化数据库文件 - ./mysql/conf.d:/etc/mysql/conf.d # 挂载自定义MySQL配置 - /etc/localtime:/etc/localtime:ro # 同步宿主机时间 ports: - 3306:3306 # 将宿主机的3306端口映射到容器方便本地工具连接管理 networks: - redmine-network # 使用自定义网络便于容器间通信 networks: redmine-network: driver: bridge我来解释一下几个关键点volumes卷这里做了三个挂载。第一个./mysql/data:/var/lib/mysql是最核心的它把容器里MySQL存放数据文件的目录映射到了当前目录下的mysql/data文件夹。这样即使容器被删除你的项目数据、用户信息都安全地留在宿主机上。第二个挂载./mysql/conf.d:/etc/mysql/conf.d允许你放入自定义的MySQL配置文件比如my.cnf可以调整字符集、缓冲区大小等参数。第三个是时间同步。environment环境变量我们通过环境变量预设了root密码并创建了Redmine专用的数据库redmine和用户redmine。这比进入容器后再用SQL命令创建要方便和安全得多。networks网络我们创建了一个名为redmine-network的桥接网络。之后Redmine容器也会加入这个网络它们之间就可以直接用服务名mysql来通信就像在同一个局域网内一样比旧的--link方式更现代、更灵活。保存文件后在终端进入该目录执行一条命令即可启动MySQLdocker-compose up -d mysql-d参数代表“后台运行”。用docker-compose logs -f mysql可以实时查看启动日志确保没有报错。如果你想用纯docker run命令效果等同的指令如下docker run -d \ --name redmine-mysql \ --network redmine-network \ -p 3306:3306 \ -v /opt/redmine-docker/mysql/data:/var/lib/mysql \ -v /opt/redmine-docker/mysql/conf.d:/etc/mysql/conf.d \ -v /etc/localtime:/etc/localtime:ro \ -e MYSQL_ROOT_PASSWORDYourStrongRootPassword123! \ -e MYSQL_DATABASEredmine \ -e MYSQL_USERredmine \ -e MYSQL_PASSWORDYourRedmineUserPassword456! \ -e TZAsia/Shanghai \ mysql:5.74. 第二步部署Redmine应用容器并连接数据库数据库跑起来后我们就可以部署Redmine了。Redmine官方提供了维护良好的Docker镜像我们直接使用即可。同样在docker-compose.yml文件中追加Redmine服务的配置。在刚才的docker-compose.yml文件中services:部分下面添加redmine服务services: mysql: ... # 保持之前的MySQL配置不变 redmine: image: redmine:latest # 使用最新稳定版镜像也可指定如 redmine:5.0 container_name: redmine-app restart: unless-stopped depends_on: - mysql # 声明依赖确保先启动mysql environment: REDMINE_DB_MYSQL: mysql # 数据库主机名这里直接用service名因为它们在同一个网络 REDMINE_DB_DATABASE: redmine REDMINE_DB_USERNAME: redmine REDMINE_DB_PASSWORD: YourRedmineUserPassword456! # 与MySQL服务中设置的密码一致 REDMINE_SECRET_KEY_BASE: generate-a-very-long-random-secret-key-here # 重要用于加密会话 REDMINE_DB_PORT: 3306 TZ: Asia/Shanghai volumes: - ./redmine/files:/usr/src/redmine/files # 上传的文件 - ./redmine/logs:/usr/src/redmine/log # 应用日志 - ./redmine/plugins:/usr/src/redmine/plugins # 插件目录 - ./redmine/config/configuration.yml:/usr/src/redmine/config/configuration.yml # 邮件等配置 - /etc/localtime:/etc/localtime:ro ports: - 3000:3000 # Redmine默认运行在3000端口 networks: - redmine-network这里有几个细节需要特别注意REDMINE_SECRET_KEY_BASE这个环境变量至关重要它用于加密和验证Cookie等安全数据。绝对不能使用示例中的简单字符串也不要用默认值。你应该生成一个足够长且随机的字符串。在Linux/Mac上可以用这个命令生成openssl rand -hex 64。把它替换到配置中。如果这个密钥泄露或太简单你的Redmine实例将面临安全风险。volumes数据持久化我们映射了多个目录。files用户上传的附件、图片都存放在这里。logsRedmine的运行日志出问题时排查用。plugins这是扩展Redmine功能的黄金位置。你可以把下载的插件通常是.zip解压后的文件夹放到宿主机的./redmine/plugins目录重启Redmine容器后就能自动识别。比如安装一个更好的甘特图插件或者与GitLab集成的插件非常方便。configuration.yml这是Redmine的核心配置文件尤其是邮件通知功能就靠它配置。我们稍后会详细讲。网络通信注意REDMINE_DB_MYSQL: mysql这里的mysql就是我们在同一个Docker Compose文件中定义的MySQL服务名。Docker的网络机制会自动将其解析为正确的容器IP地址。现在启动Redmine服务如果之前只启动了MySQLdocker-compose up -d redmine或者如果你第一次运行直接启动所有服务docker-compose up -d启动过程可能需要一两分钟因为Redmine要初始化数据库、创建表结构。你可以用docker-compose logs -f redmine跟踪日志看到类似“*** Starting application server...”这样的信息就说明启动成功了。打开浏览器访问http://你的服务器IP:3000。你应该能看到Redmine的登录界面了默认的管理员账号是admin密码也是admin。首次登录会强制要求你修改密码请务必设置一个强密码。5. 核心配置详解邮件通知与LDAP集成一个“活”起来的项目管理平台离不开邮件通知和用户统一认证。这两项配置能让你的Redmine从单机工具升级为团队协作平台。5.1 配置邮件通知configuration.ymlRedmine的任务分配、状态更新等操作可以通过邮件自动通知相关人员这极大提升了协作效率。配置邮件需要在宿主机上准备configuration.yml文件然后通过卷映射给容器。首先从Redmine容器里拷贝出默认的配置文件作为模板# 先启动一个临时Redmine容器如果还没运行的话或者从已运行的容器拷贝 docker run --rm redmine:latest cat /usr/src/redmine/config/configuration.yml.example ./redmine/config/configuration.yml这样就在宿主机的./redmine/config/目录下生成了一个配置样例。我们用文本编辑器如vim或nano打开它找到关于邮件配置的部分通常是production:段下的email_delivery:。以下是一个使用SMTP服务比如公司邮箱、QQ企业邮箱、SendGrid等的配置示例# 文件路径./redmine/config/configuration.yml production: email_delivery: delivery_method: :smtp smtp_settings: address: smtp.your-email-provider.com # SMTP服务器地址 port: 587 # 通常587是TLS端口465是SSL端口 domain: your-domain.com # 发件人域名 authentication: :plain # 认证方式也可以是 :login, :cram_md5 user_name: notificationsyour-domain.com # 发件邮箱账号 password: your-email-password # 邮箱密码或授权码 enable_starttls_auto: true # 启用TLS # 如果使用SSL请使用以下配置并注释掉 enable_starttls_auto # tls: true # openssl_verify_mode: none # 如果证书有问题可以暂时这样设置生产环境建议解决证书问题重要提示很多个人邮箱如QQ、163需要使用“授权码”而不是登录密码。请根据你的邮箱服务商说明进行配置。修改保存后需要重启Redmine容器使配置生效docker-compose restart redmine重启后你可以在Redmine后台的“管理” - “设置” - “邮件通知”里点击“发送测试邮件”来验证配置是否成功。5.2 集成LDAP/AD统一认证对于已经使用LDAP如OpenLDAP或微软Active DirectoryAD管理内部账号的公司让Redmine直接集成LDAP认证是必选项。这样用户可以用公司统一账号登录无需在Redmine里单独创建和管理。配置LDAP需要在Redmine的Web界面中操作。使用管理员账号登录后进入“管理” - “LDAP认证” - “新建认证模式”。你需要填写以下关键信息具体值需要向你的IT部门或LDAP管理员获取名称 一个易于识别的名字如“公司LDAP”。主机 LDAP服务器地址如ldap.your-company.com。端口 通常是389明文或636SSL。LDAPS 如果使用636端口勾选此项。基本DN 搜索用户的起点例如ouusers,dcyour-company,dccom。登录名属性 通常为uid或sAMAccountName对于AD。名字属性、姓氏属性、邮件属性 分别对应LDAP中存储用户姓名和邮箱的字段如givenName,sn,mail。账号和密码 一个具有搜索LDAP目录权限的只读账号和密码Bind DN。填写完毕后可以点击“测试”连接成功后保存。之后用户就可以在Redmine登录界面选择“LDAP”选项卡使用公司账号密码登录了。新用户首次成功登录后Redmine会自动在本地创建对应的用户记录非常方便。6. 进阶实战插件安装、数据备份与日常维护平台搭起来只是开始让它更强大、更稳定地运行才是关键。6.1 安装插件扩展功能Redmine的强大之处在于其丰富的插件生态。比如你可以安装redmine_agile插件来获得看板Kanban功能或者安装redmine_gitlab_hook来实现与GitLab代码提交的关联。安装插件非常简单得益于我们之前做的卷映射。以安装一个主题插件为例从Redmine插件官网或GitHub找到插件下载发布包通常是.zip格式。在宿主机上解压到./redmine/plugins/目录下。确保解压后的文件夹名就是插件名。重启Redmine容器docker-compose restart redmine。重启后进入Redmine的“管理” - “插件”页面你应该能看到新安装的插件并进行配置。注意有些插件可能需要额外的数据库迁移操作。重启容器时观察日志输出如果看到类似“Running migrations...”的提示说明插件正在自动执行数据库变更等待其完成即可。如果插件安装失败首先检查日志最常见的问题是插件版本与Redmine版本不兼容。6.2 数据备份与恢复策略你的项目数据、用户上传文件都存储在宿主机挂载的卷里。因此备份的核心就是备份这些目录和数据库。数据库备份最可靠的方式是使用mysqldump命令定期备份。你可以写一个简单的脚本# 备份脚本 backup.sh #!/bin/bash BACKUP_DIR/opt/backups/redmine DATE$(date %Y%m%d_%H%M%S) docker exec redmine-mysql mysqldump -uredmine -pYourRedmineUserPassword456! redmine $BACKUP_DIR/redmine_db_$DATE.sql # 同时备份文件卷 tar -czf $BACKUP_DIR/redmine_files_$DATE.tar.gz /opt/redmine-docker/redmine/files/ # 保留最近7天的备份 find $BACKUP_DIR -name *.sql -mtime 7 -delete find $BACKUP_DIR -name *.tar.gz -mtime 7 -delete然后通过crontab设置定时任务例如每天凌晨2点执行一次。恢复数据如果需要迁移服务器或恢复数据步骤是1) 在新服务器上按照同样的目录结构部署好Docker环境先不启动Redmine。2) 将备份的SQL文件导入新数据库docker exec -i redmine-mysql mysql -uredmine -pYourRedmineUserPassword456! redmine backup.sql。3) 将备份的文件卷压缩包解压到对应的宿主机目录。4) 启动所有容器。6.3 日常维护与问题排查运行久了可能会遇到一些小问题。掌握几个常用的Docker命令能让维护工作事半功倍查看日志docker-compose logs -f redmine实时查看Redmine日志docker-compose logs --tail100 mysql查看MySQL最近100行日志。进入容器有时需要排查问题或执行一些命令可以进入容器内部docker exec -it redmine-app /bin/bash。更新镜像当有新的Redmine或MySQL镜像版本时可以更新docker-compose pull拉取最新镜像然后docker-compose up -d重新创建容器数据卷保持不变。资源监控使用docker stats查看各容器的CPU、内存使用情况。我自己的经验是将整个/opt/redmine-docker目录包含docker-compose.yml和所有数据子目录纳入版本控制如Git管理是一个好习惯。这样服务器配置和部署结构一目了然重建环境时几乎可以做到一键还原。这个用Docker搭建的Redmine平台我已经稳定运行了两年多服务了多个项目团队它的可靠性和便利性在实战中得到了充分验证。