Skip to content

Web Terminal

Web Terminal 是 极值算力实例提供的基于浏览器的终端访问方式,允许用户直接通过智算云平台的 Web UI 登录和操作极值算力实例,无需额外的 SSH 客户端或终端软件。

什么是 Web Terminal

Web Terminal 是智算云平台内置的网页终端界面,提供了与传统终端相同的命令行操作体验。通过 Web Terminal,您可以:

  • 直接在浏览器中访问极值算力实例的 Linux 环境
  • 执行各种 Linux 命令和脚本
  • 管理文件和目录
  • 安装和配置软件包
  • 进行代码开发和调试

访问 Web Terminal

可通过极值算力实例列表访问极值算力实例的 Web Terminal。

前提条件

  • 极值算力实例必须处于运行中状态
  • 用户必须已登录智算云平台
  • 浏览器需要支持现代 Web 标准

通过极值算力实例列表访问

  1. 登录智算云控制台,进入极值算力实例列表页面

  2. 找到目标极值算力实例(状态必须为运行中),点击右侧操作栏中的登录按钮。系统将在新的浏览器窗口中打开 Web Terminal 界面

Web Terminal 登录的环境变量

通过 Web Terminal 进入极值算力实例时,您拿到的环境变量(尤其是 PATH)通常与 SSH 登录不同。理解 Web Terminal 的环境变量来源,有助于解释以下常见现象:

  • 在 Web Terminal 里 nvcccondapython 可用,但 SSH 里提示 command not found
  • python 在 Web Terminal 指向 Miniconda,而在 SSH 指向系统 Python(或不存在)
  • PATH 中包含 CUDA/NVIDIA 工具目录,但这些目录在 SSH 中缺失

环境变量从哪里来

Web Terminal 一般通过在容器内直接启动一个 Shell的方式实现(概念上类似 docker exec):

  • Web Terminal 会话通常继承容器运行时的环境变量(容器启动时设置的 ENV、入口脚本设置的变量等)
  • Shell 启动时可能不会完整走 SSH 的 login 初始化链路(即不一定按 /etc/profile~/.profile 的顺序执行)

因此,Web Terminal 的 PATH 更接近容器容器本体的默认环境,而 SSH 的环境变量更像登录构建出来的环境。两者不一致是预期风险,需要通过统一注入策略修复。

常见默认特征

在 Web Terminal 中执行:

language-bash
echo "$0"
echo "$PATH" | tr ':' '\n'
command -v nvcc || true
command -v conda || true
command -v python || true
command -v python3 || true

常见结果包括:

  • PATH 中包含如下目录(具体存在与否取决于镜像与平台注入值):

    • /usr/local/cuda/bin
    • /usr/local/nvidia/bin
    • /usr/local/miniconda3/bin
  • python 指向 Miniconda:which python 输出 /usr/local/miniconda3/bin/python

  • nvcc -V 可直接运行(CUDA 工具链可见)

与 SSH 不一致时如何处理

如果您发现 Web Terminal 正常,但 SSH 缺命令,推荐采用可控、可回滚、可持久化的方式统一入口行为,让 SSH 登录构建出的 PATH 与 Web Terminal 的 PATH 至少在工具链目录上保持一致(CUDA/NVIDIA/Miniconda)

详见SSH 登录的环境变量。

使用限制

自动断开连接

Web Terminal 会话默认在用户长时间无操作后自动断开连接。

如果需要执行训练等长时间运行的进程,强烈建议使用 tmux 等工具将进程放入后台,避免受到 Web Terminal 自动断开连接的影响。

关于 tmux 等后台运行工具的详细介绍,可参考教程

系统盘空间限制

当极值算力实例系统盘占用超过 100GiB 时,极值算力实例将进入安全模式,此时:

  • 仅能保证 Web Terminal 可连接
  • SSH 连接可能无法使用
  • 其他功能可能受限

常见问题

Web Terminal 无法连接怎么办?

请检查以下几点:

  1. 确认极值算力实例状态为运行中
  2. 检查网络连接是否正常
  3. 尝试刷新浏览器页面
  4. 如果问题持续,可尝试重启极值算力实例

在 Web Terminal 中无法使用 CUDA Toolkit nvcc 命令?

如果确认已经安装系统级 CUDA,则通常是环境变量问题:

language-bash
# 检查当前 PATH
echo $PATH

# 添加 CUDA 路径
export PATH=/usr/local/cuda/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/cuda/lib64:$LD_LIBRARY_PATH

# 验证 CUDA 是否可用
nvcc --version
可参考以下教程:

conda activate 命令报错怎么办?

需要根据当前的镜像选择合适的方式初始化 conda。

详见Conda 环境初始化指南

Web Terminal 与 SSH 有什么区别?

主要区别包括:

特性Web TerminalSSH
访问方式浏览器SSH 客户端
环境变量可能有差异完整环境
文件传输不支持支持 SCP/SFTP
端口转发不支持支持
稳定性依赖网络更稳定
便利性即开即用需要配置

如何在 Web Terminal 中添加 SSH 公钥?

当 SSH 密码认证失败时,可以通过 Web Terminal 手动添加公钥:

language-bash
# 创建 .ssh 目录(如果不存在)
mkdir -p ~/.ssh

# 添加公钥到 authorized_keys
echo 'your_public_key_content' >> ~/.ssh/authorized_keys

# 设置正确的权限
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

信息

如果极值算力实例可以重启,建议通过智算云平台的 SSH 密钥管理功能添加 SSH 公钥,实现极值算力实例启动时自动注入公钥。