如何在 Ubuntu 22.04 上安装 Redmine

介绍

Redmine 是一款功能强大且灵活的开源项目管理工具，提供 issue tracking、time tracking、wiki 功能以及 version control 集成。它基于 Ruby on Rails 构建，并支持多个数据库后端，包括 MySQL 和 PostgreSQL。在本指南中，我们将逐步讲解如何在 Ubuntu 22.04 上安装 Redmine。

前提条件

在开始之前，请确保您的系统满足以下要求：

• 全新安装的 Ubuntu 22.04
• 具有 sudo 权限的非 root 用户
• 可正常使用的互联网连接
• 一个域名（可选，但推荐）

步骤 1：更新系统软件包

首先，更新软件包列表并升级现有软件包，以确保您的系统保持最新：

sudo apt update && sudo apt upgrade -y

步骤 2：安装所需依赖

Redmine 需要多个依赖项，包括 Ruby、Bundler 和数据库服务器。我们将先安装这些软件包。

sudo apt install -y curl gnupg2 git-core libmysqlclient-dev imagemagick libmagickwand-dev libpq-dev build-essential libssl-dev libreadline-dev zlib1g-dev

步骤 3：安装 Ruby

Ubuntu 22.04 默认不包含最新版本的 Ruby，因此我们将使用

安装 Ruby。

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

现在安装 Ruby：

rbenv install 3.2.0  # Use the latest stable version
rbenv global 3.2.0
ruby -v  # Verify installation

步骤 4：安装数据库服务器

Redmine 支持 MySQL 和 PostgreSQL。在本指南中，我们将使用 MySQL。

sudo apt install -y mysql-server

确保 MySQL 安装安全：

sudo mysql_secure_installation

创建 Redmine 数据库和用户：

sudo mysql -u root -p

在 MySQL shell 中，运行以下命令：

CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'strongpassword';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
FLUSH PRIVILEGES;
EXIT;

步骤 5：安装 Redmine

下载并解压最新稳定版的 Redmine：

cd /var/www/
wget https://www.redmine.org/releases/redmine-5.0.0.tar.gz
sudo tar -xvf redmine-5.0.0.tar.gz
sudo mv redmine-5.0.0 redmine
cd redmine

配置数据库连接：

cp config/database.yml.example config/database.yml
nano config/database.yml

按如下方式修改 MySQL 部分：

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "strongpassword"
  encoding: utf8mb4

步骤 6：安装 Bundler 和依赖

运行以下命令以安装 Bundler 和所需的 gems：

gem install bundler
bundle install --without development test

步骤 7：设置数据库

运行以下命令来初始化数据库：

bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake redmine:load_default_data RAILS_ENV=production

步骤 8：设置文件权限

确保 Redmine 具有正确的权限：

sudo mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R www-data:www-data files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets

步骤 9：启动 Redmine

您可以使用内置的 WEBrick 服务器启动 Redmine：

bundle exec rails server -e production

或者，配置 Redmine 与 Passenger 以及 Apache 或 Nginx 一起运行，用于生产环境。

步骤 10：访问 Redmine

打开您的网页浏览器并访问：

http://your-server-ip:3000

使用默认凭据登录：

• 用户名：
  admin
• 密码：
  admin

结论

您已成功在 Ubuntu 22.04 上安装 Redmine。对于生产环境，请考虑设置带有 Nginx 或 Apache 的反向代理，启用 SSL，并配置自动备份。Redmine 现在已准备好高效管理您的项目！