fjudith/redmine

Redmine Docker镜像文档

概述

本镜像用于构建Redmine容器化部署环境，Redmine是一款开源的项目管理和缺陷跟踪工具，支持多项目管理、问题跟踪、文档管理、版本控制集成等功能。

版本信息

当前版本：sameersbn/redmine:4.0.4

注意：如果您的安装依赖于各种第三方插件，请坚持使用2.6.xx系列以避免兼容性问题。

安装

推荐通过Docker Hub的自动构建获取镜像：

bash
docker pull sameersbn/redmine:latest

自2.4.2版本起，镜像开始使用版本标签，您可以指定特定版本拉取：

bash
docker pull sameersbn/redmine:4.0.4

也可手动构建镜像：

bash
docker build -t sameersbn/redmine github.com/sameersbn/docker-redmine

快速启动

最快的启动方式是使用docker-compose：

bash
wget https://raw.githubusercontent.com/sameersbn/docker-redmine/master/docker-compose.yml
docker-compose up

或者手动启动Redmine和PostgreSQL容器：

步骤1：启动PostgreSQL容器

bash
docker run --name=postgresql-redmine -d \
  --env='DB_NAME=redmine_production' \
  --env='DB_USER=redmine' --env='DB_PASS=password' \
  --volume=/srv/docker/redmine/postgresql:/var/lib/postgresql \
  sameersbn/postgresql:9.6-4

步骤2：启动Redmine容器

bash
docker run --name=redmine -d \
  --link=postgresql-redmine:postgresql --publish=10083:80 \
  --env='REDMINE_PORT=10083' \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

注意：Redmine应用启动需要1-2分钟时间。

访问http://localhost:10083，使用默认账号登录：

• 用户名：admin
• 密码：admin

建议登录后访问"管理"链接并"加载默认配置"，然后再创建项目。

配置

数据存储

Redmine需要挂载卷以持久化存储文件，挂载路径为：

• /home/redmine/data

SELinux用户配置

SELinux用户需要修改挂载点的安全上下文：

bash
mkdir -p /srv/docker/redmine/redmine
sudo chcon -Rt svirt_sandbox_file_t /srv/docker/redmine/redmine

挂载卷示例

bash
docker run --name=redmine -it --rm \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

数据库

Redmine支持MySQL和PostgreSQL数据库后端。

MySQL

内部MySQL服务器

镜像已移除内部MySQL服务器，请使用链接的MySQL容器或外部MySQL服务器。

如果之前使用内部MySQL服务器，可按以下步骤迁移到链接的MySQL容器：

bash
# 启动MySQL容器（假设数据存储在/srv/docker/redmine/mysql）
docker run --name=mysql-redmine -d \
  --volume=/srv/docker/redmine/mysql:/var/lib/mysql \
  sameersbn/mysql:5.7.22-1

然后登录MySQL容器创建用户，再链接到Redmine容器。

外部MySQL服务器

首先在外部MySQL服务器创建数据库和用户：

sql
mysql -uroot -p
CREATE USER 'redmine'@'%.%.%.%' IDENTIFIED BY 'password';
CREATE DATABASE IF NOT EXISTS `redmine_production` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`;
GRANT SELECT, LOCK TABLES, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `redmine_production`.* TO 'redmine'@'%.%.%.%';

启动Redmine容器连接外部MySQL：

bash
docker run --name=redmine -it --rm \
  --env='DB_ADAPTER=mysql2' \
  --env='DB_HOST=192.168.1.100' --env='DB_NAME=redmine_production' \
  --env='DB_USER=redmine' --env='DB_PASS=password' \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

链接MySQL容器

使用https://github.com/sameersbn/docker-mysql%E9%95%9C%E5%83%8F%E5%90%AF%E5%8A%A8MySQL%E5%AE%B9%E5%99%A8%EF%BC%9A

bash
# 拉取MySQL镜像
docker pull sameersbn/mysql:5.7.22-1

# 创建数据存储目录（SELinux用户需设置安全上下文）
mkdir -p /srv/docker/redmine/mysql
sudo chcon -Rt svirt_sandbox_file_t /srv/docker/redmine/mysql

# 启动MySQL容器
docker run --name=mysql-redmine -d \
  --env='DB_NAME=redmine_production' \
  --env='DB_USER=redmine' --env='DB_PASS=password' \
  --volume=/srv/docker/redmine/mysql:/var/lib/mysql \
  sameersbn/mysql:5.7.22-1

链接MySQL容器启动Redmine：

bash
docker run --name=redmine -it --rm --link=mysql-redmine:mysql \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

支持的MySQL容器镜像：

• https://hub.docker.com/_/mysql/
• sameersbn/mysql
• https://hub.docker.com/r/centurylink/mysql/
• https://hub.docker.com/r/orchardup/mysql/

PostgreSQL

外部PostgreSQL服务器

在外部PostgreSQL服务器创建数据库和用户：

sql
CREATE ROLE redmine with LOGIN CREATEDB PASSWORD 'password';
CREATE DATABASE redmine_production;
GRANT ALL PRIVILEGES ON DATABASE redmine_production to redmine;

启动Redmine容器连接外部PostgreSQL：

bash
docker run --name=redmine -it --rm \
  --env='DB_ADAPTER=postgresql' \
  --env='DB_HOST=192.168.1.100' --env='DB_NAME=redmine_production' \
  --env='DB_USER=redmine' --env='DB_PASS=password' \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

链接PostgreSQL容器

使用https://github.com/sameersbn/docker-postgresql%E9%95%9C%E5%83%8F%E5%90%AF%E5%8A%A8PostgreSQL%E5%AE%B9%E5%99%A8%EF%BC%9A

bash
# 拉取PostgreSQL镜像
docker pull sameersbn/postgresql:9.6-4

# 创建数据存储目录（SELinux用户需设置安全上下文）
mkdir -p /srv/docker/redmine/postgresql
sudo chcon -Rt svirt_sandbox_file_t /srv/docker/redmine/postgresql

# 启动PostgreSQL容器
docker run --name=postgresql-redmine -d \
  --env='DB_NAME=redmine_production' \
  --env='DB_USER=redmine' --env='DB_PASS=password' \
  --volume=/srv/docker/redmine/postgresql:/var/lib/postgresql \
  sameersbn/postgresql:9.6-4

链接PostgreSQL容器启动Redmine：

bash
docker run --name=redmine -it --rm --link=postgresql-redmine:postgresql \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

支持的PostgreSQL容器镜像：

• https://hub.docker.com/_/postgres/
• sameersbn/postgresql
• https://hub.docker.com/r/orchardup/postgresql/
• https://hub.docker.com/r/paintedfox/postgresql/

Memcached（可选）

可配置Memcached服务器加速Redmine，适用于用户量较大的场景。

外部Memcached服务器

通过环境变量MEMCACHE_HOST和MEMCACHE_PORT指定外部Memcached服务器：

bash
docker run --name=redmine -it --rm \
  --env='MEMCACHE_HOST=192.168.1.100' --env='MEMCACHE_PORT=11211' \
  sameersbn/redmine:4.0.4

链接Memcached容器

使用https://github.com/sameersbn/docker-memcached%E9%95%9C%E5%83%8F%E5%90%AF%E5%8A%A8Memcached%E5%AE%B9%E5%99%A8%EF%BC%9A

bash
docker run --name=memcached-redmine -d sameersbn/memcached:1.5.6

链接Memcached容器启动Redmine：

bash
docker run --name=redmine -it --rm --link=memcached-redmine:memcached \
  sameersbn/redmine:4.0.4

邮件配置

通过环境变量配置邮件服务，默认使用Gmail发送邮件，需指定有效的用户名和密码。

Gmail配置示例

bash
docker run --name=redmine -it --rm \
  --env='SMTP_USER=USER@gmail.com' --env='SMTP_PASS=PASSWORD' \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

非Gmail配置

使用其他SMTP服务器时，需配置SMTP_HOST和SMTP_PORT参数。使用自定义域名的Google Apps账户时，需设置SMTP_DOMAIN参数。

可通过IMAP_相关环境变量配置邮件接收功能（用户可通过回复邮件评论问题），该功能自版本2.6.6-2、3.0.4-2和3.1.0-2起可用。

SSL配置

可通过SSL加密访问Redmine，需要私钥（.key）和SSL证书（.crt）。

生成自签名证书

1. 创建服务器私钥：

   bash
   openssl genrsa -out redmine.key 2048
   

2. 创建证书签名请求（CSR）：

   bash
   openssl req -new -key redmine.key -out redmine.csr
   

3. 使用私钥和CSR签名证书：

   bash
   openssl x509 -req -days 365 -in redmine.csr -signkey redmine.key -out redmine.crt
   

增强服务器安全性

生成更强的DHE参数：

bash
openssl dhparam -out dhparam.pem 2048

安装SSL证书

默认证书路径为/home/redmine/data/certs，可通过SSL_KEY_PATH、SSL_CERTIFICATE_PATH和SSL_DHPARAM_PATH修改。将证书文件复制到数据存储目录：

bash
mkdir -p /srv/docker/redmine/redmine/certs
cp redmine.key /srv/docker/redmine/redmine/certs/
cp redmine.crt /srv/docker/redmine/redmine/certs/
cp dhparam.pem /srv/docker/redmine/redmine/certs/
chmod 400 /srv/docker/redmine/redmine/certs/redmine.key

启用HTTPS支持

设置REDMINE_HTTPS=true启用HTTPS：

bash
docker run --name=redmine -d \
  --publish=10083:80 --publish 10445:443 \
  --env='REDMINE_PORT=10445' --env='REDMINE_HTTPS=true' \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

配置HSTS

通过NGINX_HSTS_MAXAGE设置HSTS max-age值（默认31536000秒）：

bash
docker run --name=redmine -d \
  --env='REDMINE_HTTPS=true' \
  --env='NGINX_HSTS_MAXAGE=2592000'
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

设置NGINX_HSTS_ENABLED=false完全禁用HSTS。

负载均衡器下的HTTPS配置

使用负载均衡器（如nginx/haproxy/hipache）时，SSL配置应在负载均衡器上完成，容器内无需安装SSL证书，但必须设置REDMINE_HTTPS=true：

bash
docker run --name=redmine -d --publish=10083:80 \
  --env='REDMINE_HTTPS=true' \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

子目录部署（相对URL根目录）

通过REDMINE_RELATIVE_URL_ROOT配置Redmine在子目录下运行，例如部署到/redmine：

bash
docker run --name=redmine -d --publish=10083:80 \
  --env='REDMINE_RELATIVE_URL_ROOT=/redmine' \
  --volume=/srv/docker/redmine/redmine:/home/redmine/data \
  sameersbn/redmine:4.0.4

注意：REDMINE_RELATIVE_URL_ROOT参数必须以斜杠开头。

插件管理

安装插件

将插件放置在数据存储目录的plugins子目录中：

bash
mkdir -p /srv/docker/redmine/redmine/plugins
git clone https://github.com/插件仓库.git /srv/docker/redmine/redmine/plugins/插件名称

重启Redmine容器使插件生效。

卸载插件

删除插件目录并重启容器：

bash
rm -rf /srv/docker/redmine/redmine/plugins/插件名称
docker restart redmine

主题管理

安装主题

将主题放置在数据存储目录的themes子目录中：

bash
mkdir -p /srv/docker/redmine/redmine/themes
git clone https://github.com/主题仓库.git /srv/docker/redmine/redmine/themes/主题名称

重启Redmine容器，然后在Redmine管理界面选择主题。

卸载主题

删除主题目录并重启容器：

bash
rm -rf /srv/docker/redmine/redmine/themes/主题名称
docker restart redmine

维护

创建备份

备份数据存储目录和数据库：

bash
# 备份数据存储
tar -zcvf redmine_data_backup.tar.gz /srv/docker/redmine/redmine

# 备份数据库（PostgreSQL示例）
docker exec postgresql-redmine pg_dump -U redmine redmine_production > redmine_db_backup.sql

恢复备份

bash
# 恢复数据存储
tar -zxvf redmine_data_backup.tar.gz -C /srv/docker/redmine/redmine

# 恢复数据库（PostgreSQL示例）
cat redmine_db_backup.sql | docker exec -i postgresql-redmine psql -U redmine redmine_production

自动备份

可使用cron任务定期执行备份脚本。

Rake任务

通过容器执行Redmine Rake任务：

bash
docker exec -it redmine bundle exec rake redmine:rake_task RAILS_ENV=production

升级

1. 停止并删除当前容器：

   bash
   docker stop redmine && docker rm redmine
   

2. 拉取新版本镜像：

   bash
   docker pull sameersbn/redmine:4.0.4
   

3. 使用相同的配置启动新容器。

Shell访问

获取容器Shell访问：

bash
docker exec -it redmine bash

可用配置参数