智川云
智川云RIVERMIND

主题

MATLAB 安装与启动（R2025a） ​

本文介绍在智川云实例中安装 MATLAB R2025a，并在 JupyterLab 中通过网页方式打开 MATLAB。

注意

  • 以下命令默认以 root 用户执行。
  • MATLAB 需要有效的 MathWorks 许可证账号（邮箱+密码）登录。

1. 切换到数据盘目录 ​

bash
cd /root/rivermind-data

2. 下载并准备官方安装工具（MPM） ​

bash
wget https://www.mathworks.com/mpm/glnxa64/mpm
chmod +x mpm

3. 安装 MATLAB 核心与工具箱 ​

bash
./mpm install \
  --release=R2025a \
  --destination=/root/rivermind-data/MATLAB/R2025a \
  --products MATLAB Simulink Control_System_Toolbox Robust_Control_Toolbox Deep_Learning_Toolbox Simscape_Electrical Parallel_Computing_Toolbox

4. 监控安装进度 ​

在新的 Terminal 中执行：

bash
watch -n 2 du -sh /root/rivermind-data/MATLAB/R2025a

目录体积持续增长表示安装仍在进行。

5. 安装系统依赖（图形与声音库） ​

bash
apt-get update && apt-get install -y \
  libgdk-pixbuf2.0-0 libgtk-3-0 libasound2 libxtst6 libnss3

安装虚拟显示器相关依赖：

bash
apt-get install -y xvfb dbus-x11

补齐图形加速库：

bash
apt-get install -y libgbm1 libdrm2 libxshmfence1

6. 创建全局命令软链接 ​

bash
ln -s /root/rivermind-data/MATLAB/R2025a/bin/matlab /usr/local/bin/matlab

7. 关闭 ROOT 沙盒限制（建议持久化） ​

当前会话生效：

bash
export MWI_DISABLE_SANDBOX=1

写入 ~/.bashrc（新会话自动生效）：

bash
echo 'export MWI_DISABLE_SANDBOX=1' >> ~/.bashrc
source ~/.bashrc

8. 命令行启动测试 ​

bash
matlab -nodisplay -nosplash

进入 MATLAB 后执行：

matlab
quit

9. 安装 Jupyter 插件 ​

bash
pip install jupyter-matlab-proxy

10. 在 JupyterLab 中打开 MATLAB ​

  1. 回到 Jupyter 页面并刷新整个网页
  2. 在 Launcher 中点击蓝色 Open MATLAB 图标
  3. 页面跳转后，使用 MathWorks 许可证邮箱和密码登录

完成后即可在网页中使用 MATLAB。

常见问题 ​

启动报图形相关错误 ​

通常是系统图形库缺失。请确认第 5 步依赖均已安装完成。

matlab 命令找不到 ​

检查软链接是否创建成功：

bash
ls -l /usr/local/bin/matlab

网页打开后无法进入 MATLAB ​

  1. 确认许可证账号有效
  2. 确认已安装 jupyter-matlab-proxy
  3. 刷新 Jupyter 页面后重试

相关文档 ​

附录：进阶与运维 ​

常用命令速查 ​

bash
# 查看 MATLAB 路径
which matlab

# 查看软链接指向
ls -l /usr/local/bin/matlab

# 无界面执行单条命令
matlab -batch "disp(version); quit"

# 查看已安装产品
matlab -batch "ver"

升级到新版本（示例：R2025b） ​

建议并行安装新版本，不覆盖旧版本，便于回滚：

bash
cd /root/rivermind-data
./mpm install \
  --release=R2025b \
  --destination=/root/rivermind-data/MATLAB/R2025b \
  --products MATLAB Simulink Control_System_Toolbox Robust_Control_Toolbox Deep_Learning_Toolbox Simscape_Electrical Parallel_Computing_Toolbox

切换默认命令到新版本：

bash
rm -f /usr/local/bin/matlab
ln -s /root/rivermind-data/MATLAB/R2025b/bin/matlab /usr/local/bin/matlab

卸载与清理 ​

如需删除某个版本（以 R2025a 为例）：

bash
rm -f /usr/local/bin/matlab
rm -rf /root/rivermind-data/MATLAB/R2025a

若系统仍需 matlab 命令，请重新链接到保留版本：

bash
ln -s /root/rivermind-data/MATLAB/R2025b/bin/matlab /usr/local/bin/matlab

启动参数建议 ​

  • 服务器无图形环境测试：使用 -nodisplay -nosplash
  • 批处理任务：优先使用 -batch "your_command"，便于脚本化和日志收集
  • Web 打开异常时：优先检查 MWI_DISABLE_SANDBOX、系统图形库、许可证登录状态

智算无疆 川流不息

Copyright © 2026 智川云