Redmine 安装部署指南
Redmine 是一款灵活的项目管理工具,基于 Ruby on Rails 开发,支持多种数据库,并提供丰富的插件系统。本文将详细介绍 Redmine 的安装与部署,包括所需的环境配置、安装步骤以及注意事项与实用技巧。
环境准备
- 操作系统:推荐使用 Ubuntu 22.04 或 CentOS 7/8
- Ruby 版本:建议使用 Ruby 2.5 及以上版本
- 数据库:MySQL 或 PostgreSQL
- Web 服务器:Apache 或 Nginx
安装软件包
在开始安装之前,需要确保系统安装了一些必需的软件包。这些包包括 Ruby、Rails、数据库客户端、以及一些开发工具。
sudo apt update
sudo apt install -y build-essential libmysqlclient-dev libpq-dev libsqlite3-dev libxml2-dev libcurl4-openssl-dev libssl-dev git
安装 Ruby
使用 RVM(Ruby Version Manager)安装 Ruby
使用 RVM 安装 Ruby 可以方便管理 Ruby 的版本。

sudo apt install -y gnupg2
curl -sSL https://get.rvm.io | bash -s stable --ruby
source ~/.rvm/scripts/rvm
rvm install 2.7.6
rvm use 2.7.6 --default
验证 Ruby 安装
ruby -v
确保输出的版本符合要求。
安装 Rails
安装 Rails 框架,确保 Ruby 和 Rails 的版本兼容。
gem install rails -v 6.1.4
安装数据库
安装 MySQL
sudo apt install -y mysql-server
sudo mysql_secure_installation
根据提示设置 root 密码并完成安全配置。
创建 Redmine 数据库
sudo mysql -u root -p
登录 MySQL 后,执行以下命令来创建数据库和用户:
CREATE DATABASE redmine CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'redmineuser'@'localhost' IDENTIFIED BY 'securepassword';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmineuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;
下载 Redmine
从官方 GitHub 仓库下载 Redmine 源代码。
cd /opt
sudo git clone https://github.com/redmine/redmine.git
cd redmine
sudo git checkout stable
配置 Redmine
安装依赖项
bundle install --without development test
配置数据库连接
编辑数据库配置文件。
cp config/database.yml.example config/database.yml
nano config/database.yml
在编辑器中修改内容为:
production:
adapter: mysql2
database: redmine
host: localhost
username: redmineuser
password: "securepassword"
encoding: utf8mb4
生成密钥
bundle exec rake generate_secret_token
数据库迁移
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake redmine:load_default_data
配置 Web 服务器
使用 Apache 部署 Redmine
sudo apt install -y apache2 libapache2-mod-passenger
创建 Apache 配置文件:
sudo nano /etc/apache2/sites-available/redmine.conf
添加以下配置:
<VirtualHost *:80>
ServerName yourdomain.com
DocumentRoot /opt/redmine/public
PassengerRuby /usr/bin/ruby
<Directory /opt/redmine/public>
Allow from all
Options -MultiViews
Require all granted
</Directory>
</VirtualHost>
启用配置并重启 Apache 服务:
sudo a2ensite redmine.conf
sudo systemctl restart apache2
使用 Nginx 部署 Redmine
sudo apt install -y nginx
创建 Nginx 配置文件:
sudo nano /etc/nginx/sites-available/redmine
添加以下内容:
server {
listen 80;
server_name yourdomain.com;
root /opt/redmine/public;
passenger_enabled on;
passenger_ruby /usr/bin/ruby;
location / {
try_files $uri $uri/index.html $uri.html @app;
}
location @app {
proxy_pass http://your_app;
}
}
启用配置并重启 Nginx 服务:
sudo ln -s /etc/nginx/sites-available/redmine /etc/nginx/sites-enabled/
sudo systemctl restart nginx
注意事项与实用技巧
- 定期备份:建议定期备份数据库和文件,确保数据安全。
- 插件管理:使用 gem 或将插件放入 plugins 目录中,并确认其兼容性。
- 性能优化:考虑使用 Redis 或 Memcached 进行缓存,加速页面加载。
- 安全设置:务必为数据库用户设置强密码,并限制访问权限。
测试与访问
完成所有配置后,通过浏览器访问您的网站:
http://yourdomain.com
使用默认管理员账户进行登录:
username: admin
password: admin
首次登录后,请务必修改管理员密码以确保系统安全。