全网最详细的 Redmine 安装教程

Redmine 是一个灵活的项目管理和问题跟踪工具，适用于多种项目管理需求。在这篇文章中，我将提供一个详细的 Redmine 安装教程，帮助你在服务器上成功部署 Redmine。

准备工作

在开始安装 Redmine 之前，请确保你已经拥有以下环境：

1. 一台运行 Linux（例如 Ubuntu）的服务器
2. 拥有 sudo 权限的用户
3. 基本的命令行操作知识

第一步：更新系统

首先，确保你的系统软件包是最新的。运行以下命令来更新包列表和升级已安装的软件包：

sudo apt update
sudo apt upgrade -y

第二步：安装依赖包

Redmine 依赖于多个软件包，包括数据库服务器、Ruby 和一些其他工具。首先，安装这些依赖包：

sudo apt install -y build-essential libssl-dev libreadline-dev zlib1g-dev \
libmysqlclient-dev libmagickwand-dev libcurl4-openssl-dev \
apache2-dev libapr1-dev libxslt1-dev libffi-dev imagemagick \
nodejs yarn

第三步：安装 Ruby

Redmine 是用 Ruby 编写的，因此我们需要安装 Ruby。使用 RVM（Ruby Version Manager）来安装 Ruby 是一个很好的选择，因为它允许你在同一台机器上管理多个 Ruby 版本。

1. 安装 GPG 密钥：

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3

2. 安装 RVM：

curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

3. 安装 Ruby：

rvm install 3.0.0
rvm use 3.0.0 --default
ruby -v

第四步：安装数据库

Redmine 支持多种数据库，包括 MySQL、PostgreSQL 和 SQLite。这里我们使用 MySQL 作为数据库。

1. 安装 MySQL：

sudo apt install -y mysql-server mysql-client

2. 配置 MySQL：

sudo mysql_secure_installation

按照提示设置 MySQL root 用户的密码并进行安全配置。

3. 创建 Redmine 数据库和用户：

sudo mysql -u root -p

进入 MySQL 命令行后，执行以下命令创建数据库和用户：

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

第五步：下载并配置 Redmine

1. 下载最新版本的 Redmine：

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

2. 安装 Bundler：

gem install bundler

3. 配置数据库连接：

cd /var/www/redmine/config
cp database.yml.example database.yml

编辑 database.yml 文件，配置 MySQL 数据库连接：

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

4. 安装 gem 依赖：

cd /var/www/redmine
bundle install --without development test

5. 生成密钥和数据库表：

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

选择你的语言并加载默认数据。

第六步：配置 Apache

为了通过 Web 访问 Redmine，我们需要配置 Apache。

1. 安装 Passenger：

gem install passenger
sudo apt install -y libapache2-mod-passenger

2. 配置 Apache：

sudo nano /etc/apache2/sites-available/redmine.conf

在文件中添加以下内容：

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/redmine/public
    <Directory /var/www/redmine/public>
        Require all granted
        Options -MultiViews
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/redmine_error.log
    CustomLog ${APACHE_LOG_DIR}/redmine_access.log combined
</VirtualHost>

3. 启用站点配置并重新启动 Apache：

sudo a2ensite redmine.conf
sudo a2enmod passenger
sudo systemctl restart apache2

第七步：访问 Redmine

现在，你可以在浏览器中访问你的 Redmine 站点。打开浏览器并输入你的服务器 IP 地址或域名，例如：

http://your_server_ip/

你将看到 Redmine 的登录页面。默认管理员账户的用户名是 admin，密码是 admin。第一次登录后，你将被要求更改密码。

总结

通过以上步骤，你已经成功在服务器上安装并配置了 Redmine。Redmine 是一个功能强大的项目管理工具，适用于各种规模的项目。希望这篇详细的安装教程对你有所帮助。