Linux下如何安装Redmine

发布时间：2022-02-17 09:38:43 作者：小新
来源：亿速云阅读：314

# Linux下如何安装Redmine

Redmine是一款基于Ruby on Rails开发的开源项目管理工具，支持多项目管理、问题跟踪、文档管理等功能。本文将详细介绍在Linux系统（以Ubuntu 20.04为例）上安装Redmine的完整流程。

## 一、环境准备

### 1. 系统要求
- Linux操作系统（本文以Ubuntu 20.04为例）
- 至少2GB内存（生产环境建议4GB以上）
- 10GB可用磁盘空间
- Ruby 2.6+（Redmine 4.2+要求）
- MySQL 5.7+或MariaDB 10.3+
- Apache/Nginx（可选）

### 2. 更新系统
```bash
sudo apt update && sudo apt upgrade -y

二、安装依赖组件

1. 安装基础依赖包

sudo apt install -y build-essential zlib1g-dev libssl-dev libreadline-dev \
libyaml-dev libcurl4-openssl-dev libffi-dev libxml2-dev \
libxslt1-dev libmagickwand-dev imagemagick git curl

2. 安装数据库

选项A：MySQL安装

sudo apt install -y mysql-server mysql-client libmysqlclient-dev
sudo mysql_secure_installation

选项B：MariaDB安装

sudo apt install -y mariadb-server mariadb-client libmariadb-dev
sudo mysql_secure_installation

三、安装Ruby环境

1. 使用rbenv安装Ruby

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.7.6  # 根据Redmine版本要求选择
rbenv global 2.7.6

2. 验证安装

ruby -v  # 应显示2.7.6或更高版本
gem -v

四、安装Redmine

1. 下载Redmine

wget https://www.redmine.org/releases/redmine-4.2.3.tar.gz
tar xvf redmine-4.2.3.tar.gz
sudo mv redmine-4.2.3 /opt/redmine

2. 创建数据库

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

3. 配置数据库连接

编辑/opt/redmine/config/database.yml：

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

4. 安装依赖

cd /opt/redmine
gem install bundler
bundle config set --local without 'development test'
bundle install

五、初始化Redmine

1. 生成密钥

bundle exec rake generate_secret_token

2. 数据库迁移

RLS_ENV=production bundle exec rake db:migrate

3. 加载默认数据

RLS_ENV=production bundle exec rake redmine:load_default_data
# 选择语言时输入zh（中文）

六、配置Web服务器

选项A：使用Puma（开发/测试环境）

安装Puma

gem install puma

启动服务

bundle exec puma -e production -d

选项B：使用Passenger + Nginx（生产环境）

安装Passenger

sudo apt install -y dirmngr gnupg apt-transport-https ca-certificates
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 561F9B9CAC40B2F7
sudo sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger focal main > /etc/apt/sources.list.d/passenger.list'
sudo apt update
sudo apt install -y nginx libnginx-mod-http-passenger

配置Nginx 编辑/etc/nginx/sites-available/redmine.conf：

server {
    listen 80;
    server_name your_domain.com;
    root /opt/redmine/public;
    passenger_enabled on;
    passenger_ruby /home/your_user/.rbenv/shims/ruby;
    
    client_max_body_size 10m;
    
    location ~ ^/(assets|system|attachments) {
        expires max;
        break;
    }
}

启用配置

sudo ln -s /etc/nginx/sites-available/redmine.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

七、配置邮件通知

编辑/opt/redmine/config/configuration.yml：

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "smtp.yourmail.com"
      port: 587
      domain: "yourdomain.com"
      authentication: :plain
      user_name: "your_email@example.com"
      password: "your_password"
      enable_starttls_auto: true

八、定期任务设置

创建cron任务

crontab -e

添加以下内容：

*/5 * * * * cd /opt/redmine && bundle exec rake redmine:send_reminders RLS_ENV=production
0 2 * * * cd /opt/redmine && bundle exec rake redmine:fetch_changesets RLS_ENV=production

九、安全加固建议

文件权限设置

sudo chown -R www-data:www-data /opt/redmine
sudo chmod -R 755 /opt/redmine/files

防火墙配置

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

十、常见问题解决

1. 安装时出现”Gem::FilePermissionError”

# 使用rbenv时不需要sudo
bundle install --path vendor/bundle

2. 访问时出现500错误

检查日志：

tail -f /opt/redmine/log/production.log

3. 邮件发送失败

测试邮件配置：

RLS_ENV=production bundle exec rails console
>> ActionMailer::Base.mail(from: "test@example.com", to: "your@email.com", subject: "Test", body: "Test").deliver_now

结语

通过以上步骤，您已成功在Linux系统上安装配置了Redmine。建议初次登录后： 1. 修改管理员密码（默认admin/admin） 2. 配置项目跟踪和工作流程 3. 安装需要的插件（如Agile、CRM等）

Redmine的灵活性和可扩展性使其成为团队协作的优秀工具，合理配置后可以显著提升项目管理效率。 “`

注：实际安装时请根据您的Redmine版本调整Ruby和数据库版本要求，生产环境建议使用备份策略并定期更新系统补丁。