Linux下安装Redmine项目管理教程

本文详细介绍了在Linux系统上部署Redmine项目管理平台的三种主流方案：新手推荐使用Bitnami一键安装包，集成Apache、MySQL、Ruby等全部依赖，全程图形化引导、免配置、开箱即用；生产环境建议源码编译安装，通过RVM精准管理Ruby版本、手动配置MariaDB与Apache+Passenger，确保高稳定性与可维护性；轻量场景则可采用DNF/YUM结合RubyGems方式，利用系统Ruby和SQLite实现零数据库服务依赖的极简部署。无论你正被Ruby环境混乱、数据库连接失败或权限报错困扰，本文都提供了清晰排障要点与分步实操指令，助你高效、可靠地落地Redmine。

如果您希望在 Linux 系统上搭建 Redmine 项目管理平台，但尚未完成基础环境配置或遇到安装中断、依赖缺失、数据库连接失败等问题，则可能是由于 Ruby 环境未就绪、数据库服务未启用或权限配置不正确所致。以下是多种可行的安装部署方法：

一、使用 Bitnami 一键安装包（推荐新手）

该方法将 Apache、MySQL、Ruby、Redmine 及其依赖全部集成封装，无需手动编译与配置，适合快速验证和测试环境部署。

1、访问 https://bitnami.com/stack/redmine/installer 下载对应架构的安装包（如 bitnami-redmine-6.0.4-0-linux-x64-installer.run）。

2、通过 scp 或 xftp 将安装包上传至目标服务器任意目录（例如 /opt）。

3、赋予执行权限：chmod 777 bitnami-redmine-6.0.4-0-linux-x64-installer.run。

4、运行安装程序：./bitnami-redmine-6.0.4-0-linux-x64-installer.run。

5、按提示选择语言（输入 5 进入简体中文），后续所有选项均输入 Y 确认默认安装。

6、指定安装路径（默认为 /opt/redmine-6.0.4-0），若需修改请直接在冒号后键入新路径。

7、设置管理员账户信息（用户名、密码、邮箱），其中 Apache 默认端口为 80，MySQL 默认端口为 3306；若已被占用，必须在此步骤中修改为其他可用端口。

8、配置 SMTP 邮箱（可选）：以 163 邮箱为例，SMTP 主机填 smtp.163.com，端口填 465，安全连接选 SSL，密码须为邮箱授权码而非登录密码。

9、等待进度条完成，安装结束后访问 http://[服务器IP]/redmine 即可进入 Redmine 登录页。

二、源码编译安装（适用于 CentOS/RHEL 系统）

此方式完全可控，适用于生产环境，要求手动安装并配置 Ruby、数据库、Web 服务器及 Redmine 核心组件，各环节需严格匹配版本兼容性。

1、更新系统并启用 EPEL 源：yum update -y && yum install -y epel-release。

2、安装基础依赖：yum install -y gcc-c++ patch readline readline-devel zlib zlib-devel libyaml-devel libffi-devel openssl-devel make bzip2 autoconf automake libtool bison iconv-devel ImageMagick ImageMagick-devel。

3、安装 MariaDB：yum install -y mariadb-server mariadb && systemctl start mariadb && systemctl enable mariadb。

4、登录 MariaDB 创建数据库：mysql -u root -p，执行：
CREATE DATABASE redmine CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
FLUSH PRIVILEGES;。

5、安装 RVM 并部署 Ruby 3.1.4：curl -sSL https://get.rvm.io | bash -s stable && source /etc/profile.d/rvm.sh && rvm install 3.1.4 && rvm use 3.1.4 --default。

6、安装 Bundler 和 MySQL2 驱动：gem install bundler && gem install mysql2 -v '0.5.5'。

7、下载 Redmine 源码：wget https://www.redmine.org/releases/redmine-6.0.4.tar.gz && tar zxvf redmine-6.0.4.tar.gz -C /opt/。

8、复制并编辑数据库配置：cp /opt/redmine-6.0.4/config/database.yml.example /opt/redmine-6.0.4/config/database.yml，将 production 区块中的 adapter 设为 mysql2，database、username、password 填写上一步创建的值。

9、安装 Gem 依赖：cd /opt/redmine-6.0.4 && bundle install --without development test。

10、生成密钥并初始化数据库：bundle exec rake generate_secret_token && RAILS_ENV=production bundle exec rake db:migrate。

11、预编译静态资源：RAILS_ENV=production bundle exec rake assets:precompile。

12、配置 Apache + Passenger：安装 mod_passenger，在 Apache 虚拟主机中指定 DocumentRoot /opt/redmine-6.0.4/public 并启用 PassengerEnabled on。

三、使用 DNF/YUM + RubyGems 方式（适用于 Fedora/CentOS 8+）

利用系统包管理器安装 Ruby 运行时与关键库，再通过 Gem 安装 Redmine，避免 RVM 干扰系统 Ruby，适合轻量级部署。

1、安装系统 Ruby 及开发工具：dnf install -y ruby ruby-devel rubygems gcc make sqlite-devel postgresql-devel mysql-devel。

2、升级 Bundler：gem install bundler --version '2.4.22'。

3、下载并解压 Redmine 至 /var/www/redmine，确保该目录属主为 apache:apache（CentOS）或 www-data:www-data（Debian）。

4、配置 SQLite3 数据库（免服务依赖）：cp config/database.yml.example config/database.yml，将 production 区块改为：
adapter: sqlite3
database: /var/www/redmine/db/production.sqlite3。

5、创建数据库文件目录并赋权：mkdir -p db && chown apache:apache db && chmod 755 db。

6、执行初始化：RAILS_ENV=production bundle exec rake db:create && RAILS_ENV=production bundle exec rake db:migrate。

7、设置日志与临时目录权限：chown -R apache:apache log tmp public/plugin_assets && chmod -R 755 log tmp public/plugin_assets。

8、配置 SELinux 允许 Apache 访问 Redmine 目录：semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/redmine(/.*)?" && restorecon -Rv /var/www/redmine。

9、启动 httpd 服务：systemctl start httpd && systemctl enable httpd。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Linux下安装Redmine项目管理教程》文章吧，也可关注golang学习网公众号了解相关技术文章。