如何修改rtx(mise-en-place)默认安装路径为/opt/mise并支持多用户共享

核心配置逻辑 #

RTX的工具安装路径由RTX_DATA_DIR环境变量控制，默认指向用户个人目录。要实现多用户共享集中目录，需全局配置该变量并确保目录权限符合要求。

分步配置步骤 #

1. 设置全局环境变量 #

创建系统级环境变量配置文件，确保所有用户登录时自动加载：

sudo touch /etc/profile.d/rtx.sh
sudo tee /etc/profile.d/rtx.sh <<EOF
export RTX_DATA_DIR=/opt/mise
# 可选：设置全局配置文件目录，统一管理工具版本规则
export RTX_CONFIG_DIR=/etc/rtx
EOF
sudo chmod 644 /etc/profile.d/rtx.sh

2. 初始化集中存储目录 #

创建目标目录并配置合理权限，保证所有用户能读取、使用已安装的工具，同时允许授权用户安装新工具：

sudo mkdir -p /opt/mise /etc/rtx
# 将目录归属设为root和用户组（比如users），可根据服务器实际用户组调整
sudo chown -R root:users /opt/mise /etc/rtx
# 设置权限：所有者与用户组可读写执行，其他用户只读执行
sudo chmod -R 775 /opt/mise /etc/rtx

3. 验证配置生效 #

让所有用户登出后重新登录，或手动加载配置：

source /etc/profile.d/rtx.sh

执行以下命令验证路径是否生效：

# 查看当前RTX数据目录
rtx env | grep RTX_DATA_DIR
# 安装测试工具，检查是否写入/opt/mise
rtx install node@20
ls /opt/mise/installs/node

4. 全局版本统一（可选） #

如果需要强制所有用户使用统一的工具版本，在全局配置文件中添加规则：

sudo tee /etc/rtx/config.toml <<EOF
[tools]
# 配置全局默认工具版本，可按需添加更多
node = "20"
python = "3.11"
EOF

常见问题排查 #

• 配置后不生效：检查是否登出重新登录，或确认环境变量已正确加载（执行echo $RTX_DATA_DIR）
• 安装工具时权限报错：确认/opt/mise目录的用户组包含所有需要使用RTX的用户，且权限设置为775
• 个人用户覆盖配置：提醒用户不要在个人shell配置文件（如_/.bashrc、/.zshrc）中重新定义RTX_DATA_DIR

官方文档相关内容翻译 #

RTX_DATA_DIR：指定RTX存储工具安装包、缓存及元数据的目录，默认路径为~/.local/share/rtx。将其设置为全局路径（如/opt/mise）后，所有用户将共享该目录下的工具资源，实现版本统一管理。
RTX_CONFIG_DIR：指定RTX读取全局配置文件的目录，默认仅读取用户个人目录下的配置。设置为/etc/rtx后，管理员可统一配置工具版本规则，无需每个用户单独设置。

内容的提问来源于stack exchange，提问作者Bartholome SIMPSON