MATLAB 代理

版权所有 (c) 2020-2022 The MathWorks, Inc. 保留所有权利。

matlab-proxy是一个 Python® 包，可让您启动 MATLAB® 并从 Web 浏览器访问它。

安装这个包会创建一个可执行文件matlab-proxy-app，它会启动 MATLAB 并提供一个 URL 来访问它。

MATLAB 代理正在积极开发中。如需支持或报告问题，请参阅反馈部分。

目录

• 要求
• 安装
  • 派皮
  • 从源头构建
• 用法
• 例子
• 限制
• 安全
• 反馈

要求

• Linux® 或 Windows® 操作系统

• MATLAB® R2020b 或更高版本已安装并位于系统 PATH 上。

  # Confirm MATLAB is on the PATH
  which matlab
  

• 运行 MATLAB 所需的依赖项。有关所需的 MATLAB 版本，请参阅matlab-deps存储库中的 Dockerfiles 。

• X Virtual Frame Buffer (Xvfb)：（仅适用于基于 Linux® 的系统）

  使用以下命令将其安装在您的 linux 机器上：

  # On a Debian/Ubuntu based system:
  $ sudo apt install xvfb
  

  # On a RHEL based system:
  $ yum search Xvfb
  xorg-x11-server-Xvfb.x86_64 : A X Windows System virtual framebuffer X server.
  
  $ sudo yum install xorg-x11-server-Xvfb
  

• Python 版本：3.7 | 3.8 | 3.9 | 3.10

• 浏览器要求

安装

派皮

这个存储库可以直接从 Python 包索引安装。

python -m pip install matlab-proxy

从源头构建

从源代码构建需要 Node.js® 版本 13 或更高版本。单击此处安装 Node.js

git clone https://github.com/mathworks/matlab-proxy.git

cd matlab-proxy

python -m pip install .

安装该软件包会创建一个名为 的可执行文件matlab-proxy-app，该可执行文件由 放置到您的系统 PATH 中pip，通常位于：$HOME/.local/bin/

# Confirm it is on the PATH
which matlab-proxy-app

用法

一旦matlab-proxy安装了软件包。

• 打开 Linux 终端并使用以下命令启动应用程序

  env MWI_BASE_URL="/matlab" matlab-proxy-app
  

  MWI_BASE_URL是一个环境变量，它控制可以访问 MATLAB 的链接。有关所有环境变量的详细列表。请参阅Advanced-Usage.md

  运行上述命令将在您的终端上打印出文本，其中将包含访问 MATLAB 的 URL。例如：

  MATLAB can be accessed on 
  http://localhost:44549/matlab/index.html
  

• 在网络浏览器中打开上面的链接。如果系统提示您这样做，请输入与 MATLAB 许可证关联的 MathWorks 帐户的凭据。如果您使用的是网络许可管理器，请切换到网络许可管理器选项卡并输入许可服务器地址。要确定适合您的许可类型的方法，请参阅MATLAB Licensing Info。

• 等待 MATLAB 会话开始。这可能需要几分钟。

• 要管理 MATLAB 会话，请单击下面显示的工具图标。

• 单击工具图标会打开一个状态面板，其中包含如下按钮：

状态面板中提供了以下选项（某些选项仅在特定上下文中可用）：

例子

• 要在 Docker 容器中安装/使用，请参阅此Dockerfile及其自述文件。
• 要在现有 Docker 映像中升级matlab-proxy ，请参阅此Dockerfile.upgrade.matlab-proxy及其自述文件。*
• 有关在 Jupyter 环境中的使用，请参阅jupyter-matlab-proxy。

平台支持

Linux

Linux 操作系统完全支持此软件包。

视窗

软件包版本中引入了 Windows® 操作系统支持v0.4.0。如果您遇到任何错误，请参阅反馈部分进行报告。

安装版本 >=0.4.0 以在 Windows 上使用该软件包。

# To upgrade an existing installation of matlab-proxy package:
$ pip install --upgrade matlab-proxy>=0.4.0

# Or to make a new installation of the latest version:
$ pip install matlab-proxy 

苹果系统

Apple® Mac 操作系统不支持此软件包。

限制

此软件包支持与 MATLAB® Online 相同的 MATLAB 功能和命令子集，但不支持 Simulink® Online。 单击此处查看 MATLAB Online 的规格和限制的完整列表。

安全

我们认真对待您的安全问题，并将尝试解决所有问题。 matlab-proxy使用其他几个 python 包，并依靠它们来修复自己的漏洞。

所有安全补丁都将作为软件包的新版本发布。补丁永远不会向后移植到旧版本或包的发行版。使用最新版本将提供最新的可用安全更新或补丁。

反馈

我们鼓励您在您的环境中尝试此存储库并提供反馈。如果您遇到技术问题或有增强请求，请在此处创建问题