宝塔面板执行rvm命令报“command not found”是因为非交互式shell不自动加载~/.bashrc中的rvm环境,需用完整路径调用wrapper脚本或手动source。

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 进程起来。其他花哨配置都得排在这之后。











