Linux下如何安裝Redmine

# 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（開發/測試環境）

1. 安裝Puma

gem install puma

1. 啟動服務

bundle exec puma -e production -d

選項B：使用Passenger + Nginx（生產環境）

1. 安裝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

1. 配置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;
    }
}

1. 啟用配置

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

八、定期任務設置

1. 創建cron任務

crontab -e

1. 添加以下內容：

*/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

九、安全加固建議

1. 文件權限設置

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

1. 防火墻配置

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和數據庫版本要求，生產環境建議使用備份策略并定期更新系統補丁。