推荐新手使用bitnami一键安装包，集成apache、mysql、ruby及redmine全部依赖，无需手动配置；生产环境可选源码编译安装，需严格匹配ruby、数据库与redmine版本；轻量部署可用dnf/yum+rubygems方式，支持sqlite免服务依赖。
如果您希望在 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: sqlite3database: /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。
