本教程适用于以下操作系统版本
- Ubuntu 22.04 (Jammy Jellyfish)
- Ubuntu 20.04 (Focal Fossa)
本页内容
- 准备工作
- 安装依赖项
- 配置 MySQL 服务器
- 安装 Redmine
- 为 Redmine 配置虚拟主机
- 配置 UFW 防火墙
- 完成 Redmine 安装
- 总结
Redmine 是一款免费的开源项目管理和问题跟踪工具。它是一款基于 Web 的应用软件,主要使用 Ruby on Rails 编写。它跨平台,并支持多种数据库和多种语言。Redmine 非常灵活,可用于各类组织和项目,无论是小型、中型还是大型组织。它允许你创建和管理多个项目,每个项目都拥有自己的 Wiki、论坛、问题跟踪等功能。此外,它还允许你根据组织需求创建自定义角色,等等。Redmine 基于 GNU GPL v2 许可发布,可以安装在任何操作系统上,例如 Linux、Windows 或 macOS。它支持多种类型的数据库,包括 PostgreSQL、MySQL 和 SQLite(默认)。
在本指南中,你将在 Ubuntu 22.04 服务器上,使用 Apache2 Web 服务器和 MySQL 服务器安装 Redmine。你还将使用 SSL 证书来保护 Redmine 安装的安全。
准备工作
本教程需要满足以下要求:
- 一台 Ubuntu 22.04 服务器 —— 本示例使用的是主机名为 redmine-server 的 Ubuntu 服务器。
- 一个具有 sudo 管理员权限的非 root 用户 —— 当然你也可以使用 root 用户。
- 一个指向你服务器 IP 地址的域名 —— 在生产环境中,你必须确保域名已指向服务器的 IP 地址。
一切准备就绪后,你就可以进入 Redmine 安装的第一步了。
安装依赖项
Redmine 是一款开源的项目管理和问题跟踪工具,主要使用 Ruby 和 Ruby on Rails (RoR) 编写。要安装 Redmine,你必须先安装 Ruby,然后才能安装其他依赖项,例如 Apache2 Web 服务器和 MySQL 服务器数据库。
在本示例中,你将使用 Apache2 Web 服务器和 MySQL 服务器来运行 Redmine。
在开始安装软件包之前,请运行以下 apt 命令更新并刷新你的 Ubuntu 软件包索引。
sudo apt update
仓库更新完成后,通过以下 apt 命令安装以下部分软件包依赖项。
通过该命令,你将安装 Apache2 Web 服务器,随后安装 libapache2-mod-passenger,它将用于配置 RoR 应用以在 Apache2 下运行。你同时还会安装 Ruby 软件包。
sudo apt install apache2 ruby ruby-dev build-essential libapache2-mod-passenger libmysqlclient-dev
当提示确认安装时,输入 y 然后按 ENTER 键继续。

Apache2 和 Ruby 安装完成后,运行以下命令安装 MySQL 服务器。Redmine 支持多种 RDBMS,例如 PostgreSQL、MySQL/MariaDB 和 SQLite。在本示例中,你将使用 MySQL 服务器。
sudo apt install mysql-server
当提示确认安装时,输入 y,然后按 ENTER 键继续。

对于 Redmine 安装,你还需要在 Ubuntu 服务器上安装一个 bundler。bundler 是一个命令行工具,用于管理 Ruby Gems 软件包。
运行以下命令将 bundler 安装到你的系统中。
sudo gem install bundler
bundler 安装完成后,你将看到类似以下的输出:

最后,通过以下 systemctl 命令验证 Apache2 和 MySQL 服务。这将确保 Apache2 和 MariaDB 服务都已运行并启用。
验证 Apache2 服务。
sudo systemctl is-enabled apache2
sudo systemctl status apache2
你可以在下方看到,Apache2 服务已启用,并将在系统启动时自动运行。该服务当前的状态为 running(运行中)。

验证 MySQL 服务。
sudo systemctl is-enabled mysql
sudo systemctl status mysql
你将看到类似以下的输出 —— MySQL 服务已启用,并将在系统启动时自动运行。MySQL 服务当前的状态为 running(运行中)。

配置 MySQL 服务器
Apache2 和 MySQL 服务器安装完成后,你将通过 mysql_secure_installation 设置 MySQL root 密码并加固部署。然后,你还将为 Redmine 创建一个新的 MySQL 数据库和用户。
通过以下 mysql 命令登录 MySQL。
sudo mysql
现在通过以下查询修改 MySQL root 密码。请务必将密码替换为你自己的密码。然后输入 quit 退出 MySQL shell。
ALTER USER root@localhost IDENTIFIED WITH mysql_native_password BY 'password';
quit

接下来,运行以下命令开始加固 MySQL 服务器部署。
sudo mysql_secure_installation
当提示输入 MySQL root 密码时,输入你正确的密码。
然后,你将被询问其他 MySQL 配置项,例如禁用 root 用户的远程登录、删除匿名用户、删除默认的 test 数据库,以及重新加载所有权限表。对于所有这些 MySQL 服务器设置,输入 Y 以确认配置。
加固 MySQL 部署之后,是时候为 Redmine 设置一个新数据库和用户了。
通过以下 mysql 命令登录 MySQL shell。系统会提示你输入 MySQL root 密码,请输入你的 MySQL root 用户的正确密码,然后按 ENTER 键。
sudo mysql -u root -p
现在运行以下查询,为 Redmine 创建一个新的 MySQL 数据库和用户。在本示例中,你将创建一个新数据库,以及用户 redmine,密码为 ' secretPassword '。你可以将数据库密码替换为你自己的密码。
CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'secretPassword';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
FLUSH PRIVILEGES;

接下来,运行以下查询来验证 MySQL 用户 redmine 的权限。请确保 MySQL 用户 redmine 对数据库 redmine 拥有权限。
SHOW GRANTS FOR redmine@localhost;
quit
你可以在下方看到 MySQL 用户 redmine@localhost 对数据库 redmine 拥有权限。

最后,输入 quit 退出 MySQL shell。
所有依赖项已安装完毕,并且 MySQL 数据库和用户也已创建,你现在可以在 Ubuntu 服务器上安装 Redmine 项目管理工具了。
安装 Redmine
在此步骤中,你将安装最新版本的 Redmine。本文撰写时,Redmine 的最新版本为 v5.0.2。
你将下载 Redmine 源代码、配置数据库、通过 build 安装 Ruby 依赖项、设置 Redmine secret token(密钥令牌),并迁移数据库。
在本示例中,你将在 /opt/redmine 目录下安装 Redmine。
切换到 /opt 目录。
cd /opt/
现在,使用以下 wget 命令下载 Redmine 源代码。下载完成后,你将在 /opt 目录下看到文件 redmine-5.0.2.tar.gz。
wget https://www.redmine.org/releases/redmine-5.0.2.tar.gz
接下来,运行以下命令解压 Redmine 源代码 redmine-5.0.2.tar.gz,并为 Redmine 目录创建指向 /opt/redmine 的新符号链接。
tar -xvzf redmine-5.0.2.tar.gz
sudo ln -s redmine-5.0.2 redmine
Redmine 的主安装目录将为 /opt/redmine。
切换到 /opt/redmine 目录。
cd /opt/redmine/
将默认的数据库配置文件 'config/database.yml.example' 复制为 'config/database.yml'。然后,使用 nano 编辑器打开数据库配置文件 'config/database.yml'。
cp config/database.yml.example config/database.yml
nano config/database.yml

在 'production'(生产环境)部分,修改 MySQL 数据库和用户的详细信息。请务必使用 Redmine 正确的数据库用户和密码。
production: adapter: mysql2 database: redmine host: localhost username: redmine password: "secretPassword" # Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7 encoding: utf8mb4
完成后保存文件并退出编辑器。
接下来,运行以下 bundler 命令,为 Redmine 应用安装 Ruby 依赖项。
bundle config set --local without 'development test'
bundle install
你将看到类似以下的输出:

Redmine 依赖项安装完成后,运行以下命令生成 Redmine secret token(密钥令牌)并迁移数据库。
bundle exec rake generate_secret_token
RAILS_ENV=production bundle exec rake db:migrate
在下方截图中,你可以看到 Redmine secret token 已生成,以及 Redmine 数据库迁移的过程。

最后,使用以下命令将默认数据加载到你的 Redmine 安装中。当询问选择语言时,输入 en 表示 English(英语)。
RAILS_ENV=production bundle exec rake redmine:load_default_data
Redmine 默认数据加载完成后,你将看到输出信息 " Default configuration data loaded "(默认配置数据已加载)。

现在 Redmine 已安装完成,接下来你将为 Redmine 配置一个 Apache2 虚拟主机。
为 Redmine 配置虚拟主机
在此步骤中,你将为 Redmine 创建一个新的 Apache2 虚拟主机配置。因此,请确保你已将域名指向服务器 IP 地址,并且已生成 SSL 证书。
运行以下命令启用 Apache 模块 ssl 和 rewrite。
sudo a2enmod ssl rewrite
你将看到类似以下的输出:

现在,使用 nano 编辑器创建一个新的 Apache2 虚拟主机配置文件 ' /etc/apache2/sites-available/redmine.conf '。
sudo nano /etc/apache2/sites-available/redmine.conf
将以下配置添加到文件中。请务必将域名和 SSL 证书的路径替换为你自己的配置。
<VirtualHost *:80>
ServerName redmine.example.local
ServerAdmin
[email protected]
# Redirect Requests to SSL
Redirect permanent "/" "https://redmine.example.local/"
</VirtualHost>
<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerName redmine.example.local
RailsEnv production
DocumentRoot /opt/redmine/public
ErrorLog ${APACHE_LOG_DIR}/redmine.example.local.error.log
CustomLog ${APACHE_LOG_DIR}/redmine.example.local.access.log combined
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/redmine.example.local/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/redmine.example.local/privkey.pem
<Directory "/opt/redmine/public">
Allow from all
Require all granted
</Directory>
</VirtualHost>
</IfModule>
保存文件并退出编辑器。
接下来,运行以下命令激活虚拟主机文件 ' redmine.conf '。然后,验证你的 Apache2 配置,确保配置正确。
sudo a2ensite redmine.conf
sudo apachectl configtest
当 Apache2 配置正确时,你现在会收到类似 " Syntax OK "(语法正确)的输出信息。

最后,通过以下 systemctl 命令重启 Apache2 服务,以应用新的虚拟主机文件。
sudo systemctl restart apache2
至此,Redmine 已安装完毕,虚拟主机也已配置完成。你现在应该可以通过你的域名访问 Redmine 安装了。
配置 UFW 防火墙
在生产环境中,你应该开启防火墙。对于 Ubuntu 系统,你可以使用默认的防火墙 UFW (Uncomplicated Firewall)。
现在,你将添加 UFW 规则以开放默认的 HTTP 和 HTTPS 服务,使 Redmine 能够从其网络外部访问。
运行以下 ufw 命令,将默认的 " OpenSSH " 应用配置添加到 UFW。然后启动并启用 UFW 防火墙。
sudo ufw allow "OpenSSH"
sudo ufw enable
当询问确认时,输入 y 以启动并启用 UFW 防火墙服务。

接下来,运行以下命令,将 " Apache Full " 应用配置添加到防火墙。然后,通过以下命令验证 UFW 状态。
sudo ufw allow "Apache Full"
sudo ufw status
你应该看到 UFW 防火墙状态为 active(活跃),并且当前已启用的应用配置为 OpenSSH 和 " Apache Full "。这将开放默认的 SSH 端口 22 以及 HTTP 和 HTTPS 服务端口 80 和 443。

完成 Redmine 安装
打开 Web 浏览器,访问你的 Redmine 安装的域名(例如:https://redmine.example.local/ )。
你现在将看到 Redmine 项目管理和问题跟踪工具的默认主页。点击 " Sign In "(登录)以登录 Redmine 管理后台。

输入默认的 Redmine 管理员用户名和密码 " admin - admin "。

登录后,系统会要求你修改 Redmine 的默认密码。输入你的 Redmine 安装的新密码,然后点击 " Apply "(应用)。

最后,编辑你的 Redmine 管理员用户的详细信息,并点击 " Save "(保存)以应用配置。你现在已经完成了 Redmine 的基础配置。

要添加新项目,点击 " Projects "(项目)菜单。你应该能够在你的 Redmine 上创建、编辑或删除项目。

现在,如果你想为 Redmine 添加配置,点击 " Administration "(管理)菜单。通过它,你可以添加更多用户、设置用户组、定义角色、启用通过第三方应用(例如 LDAP)的认证,等等。

总结
在本教程中,你已在 Ubuntu 22.04 服务器上安装并配置了 Redmine 项目管理和问题跟踪工具。你还为 Redmine 配置了 MariaDB 数据库和 Nginx Web 服务器。此外,你还使用 SSL 证书保护了 Redmine 安装的安全。
Redmine 现已安装在你的系统上,你可以通过添加一些额外的配置来扩展你的 Redmine 安装,例如将 Redmine 集成到当前的基础设施中,如添加 LDAP 认证,以及与 SVN、Git 和 Mercurial 等 SCM 集成。此外,你还可以根据组织或公司的需要添加角色。