宝塔搭建RubyonRails环境教程

本文深入解析了在宝塔面板上部署 Ruby on Rails 环境时最常踩的四大“坑”：RVM 命令在非交互式 Shell 中失效的根本原因与稳定解决方案（推荐使用 wrapper 绝对路径而非 source）；rvm install 卡顿或编译失败的系统级依赖缺失问题（含 Ubuntu/CentOS 必装包清单和国内源配置）；Nginx 反向代理 Rails 时如何正确绑定 RVM 指定 Ruby 版本与 Gemset（强调 wrapper 脚本不可替代）；以及极易被忽视却致命的用户权限、文件属主与路径不一致问题（如 /www/wwwroot 与 /home/wwwroot 混淆、www 用户 vs 开发者用户权限冲突）。每一步都直击生产环境部署失败的核心症结，帮你绕过玄学报错，真正跑通 Rails 应用。

RVM 不能直接在宝塔面板的 Web 界面里安装或管理 —— 它必须通过 SSH 终端以用户身份运行，且宝塔默认不加载 RVM 的 shell 函数，硬塞进面板脚本会失效。

为什么宝塔面板里执行 rvm 命令报 “command not found”

宝塔的后台任务、网站 Shell 执行器、计划任务等环境都是非交互式 shell（no-interactive），不会自动 source ~/.bashrc 或 ~/.bash_profile，而 RVM 正是靠这些文件里的 source ~/.rvm/scripts/rvm 注入到 shell 函数中的。

常见错误现象：

• 在宝塔「终端」里输入 rvm list 报错：command not found
• 用宝塔「网站」→「Shell」执行 rvm use 3.3.4，返回空或无效果
• 写进宝塔计划任务的 rvm use 2.7.8 && bundle exec rails server 直接失败

解决办法只有两个：

• 手动在每条命令前加 source ~/.rvm/scripts/rvm &&（不推荐，易漏）
• 改用完整路径调用：比如 ~/.rvm/wrappers/ruby-3.3.4@myapp/ruby（推荐，稳定）

rvm install 在宝塔服务器上卡住或编译失败

不是网络慢，而是缺编译依赖或 OpenSSL 版本冲突。Ubuntu/Debian 系统尤其常见，CentOS 需额外装 epel-release 和 gcc-c++。

必须提前装好的系统包（以 Ubuntu 22.04+ 为例）：

• build-essential（含 gcc、make）
• libssl-dev（不是 openssl 命令本身）
• libreadline-dev（否则 irb 启动报错）
• zlib1g-dev（否则 gem 安装失败）
• libyaml-dev、libsqlite3-dev（Rails 项目基本依赖）

执行前务必先跑一遍：

sudo apt update && sudo apt install -y build-essential libssl-dev libreadline-dev zlib1g-dev libyaml-dev libsqlite3-dev

另外，国内用户一定要换源，否则 rvm install 3.3.4 会卡在下载 ruby 源码阶段：

sed -i 's!ftp\.ruby-lang\.org/pub/ruby!ruby\.taobao\.org/mirrors/ruby!' ~/.rvm/config/db

如何让 Nginx 反代的 Rails 应用真正用上 RVM 指定的 Ruby + Gemset

Nginx worker 进程完全不认你的用户 shell 环境，它只认你配置里写的绝对路径。指望 passenger_ruby 写 rvm-exec 或 rvm do 是徒劳的。

正确做法是用 RVM 生成的 wrapper 脚本：

• 先创建带 gemset 的环境：rvm use 3.3.4@myapp --create
• 再生成可执行 wrapper：rvm wrapper 3.3.4@myapp myapp
• 此时会生成：~/.rvm/wrappers/ruby-3.3.4@myapp/ruby 和 ~/.rvm/wrappers/myapp/ruby

然后在 Nginx 的站点配置中写死这个路径：

passenger_ruby /home/wwwroot/myapp/.rvm/wrappers/ruby-3.3.4@myapp/ruby;

注意：passenger_ruby 必须指向 ruby 可执行文件，不是 bundle 或 rails；passenger_app_env 也得设对，比如 production。

宝塔里部署 Rails 项目时最容易被忽略的权限和路径问题

宝塔新建网站时，默认把项目根目录设为 /www/wwwroot/myapp，但 RVM 安装的 Ruby 和 gem 全在 /home/wwwroot/ 下（用户主目录），而宝塔的 PHP/Python 站点往往用 www 用户跑，Ruby 却必须用你自己的用户（比如 admin）运行 —— 权限不一致直接导致 bundle install 失败或 Passenger 启动报 Permission denied。

关键检查点：

• 确认 Rails 项目所有文件属主是你自己的用户（如 admin），不是 www：chown -R admin:admin /www/wwwroot/myapp
• 确保 /www/wwwroot/myapp 可被该用户读写，尤其 tmp/、log/、public/assets
• 不要把 .ruby-version 或 .rvmrc 放进项目根目录——宝塔不会识别，反而可能误导本地开发环境
• 用 bundle install --deployment --without development test，避免依赖路径写死在用户 home 下

RVM 的 wrapper 路径、用户权限、系统依赖这三块没对齐，Nginx 就永远看不到 Rails 进程起来。其他花哨配置都得排在这之后。

理论要掌握，实操不能落！以上关于《宝塔搭建RubyonRails环境教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！