Web Terminal
Web Terminal 是 AIStudio 开发机提供的基于浏览器的终端访问方式，允许用户直接通过智算云平台的 Web UI 登录和操作开发机，无需额外的 SSH 客户端或终端软件。
什么是 Web Terminal
Web Terminal 是智算云平台内置的网页终端界面，提供了与传统终端相同的命令行操作体验。通过 Web Terminal，您可以：
- 直接在浏览器中访问开发机的 Linux 环境
- 执行各种 Linux 命令和脚本
- 管理文件和目录
- 安装和配置软件包
- 进行代码开发和调试
访问 Web Terminal
可通过开发机列表或 AICoder 访问开发机的 Web Terminal。
前提条件
- 开发机必须处于运行中状态
- 用户必须已登录智算云平台
- 浏览器需要支持现代 Web 标准
通过开发机列表访问
登录智算云控制台，进入开发机列表页面
找到目标开发机（状态必须为运行中），点击右侧操作栏中的登录按钮。系统将在新的浏览器窗口中打开 Web Terminal 界面
通过 AICoder 访问
通过 AICoder 访问开发机 Web Terminal，可以在 AICoder 界面中打开多个开发机的 Web Terminal 标签页，避免频繁切换浏览器标签页。
- 登录智算云控制台，在顶部导航栏 AICoder。
- 选择 AICoder 可用区后，进入 AICoder 页面。在左上角图标中，找到「登录开发机」图标，点击后将展示用户在当前可用区的所有运行中开发机。
- 点击目标开发机（状态必须为运行中），即可在 AICoder 界面新增标签页，访问开发机的 Web Terminal。
Web Terminal 登录的环境变量
通过 Web Terminal 进入开发机时，您拿到的环境变量（尤其是 PATH）通常与 SSH 登录不同。理解 Web Terminal 的环境变量来源，有助于解释以下常见现象：
- 在 Web Terminal 里
nvcc、conda、python可用，但 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 中执行：
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/pythonnvcc -V可直接运行（CUDA 工具链可见）
与 SSH 不一致时如何处理
如果您发现 Web Terminal 正常，但 SSH 缺命令，推荐采用可控、可回滚、可持久化的方式统一入口行为，让 SSH 登录构建出的 PATH 与 Web Terminal 的 PATH 至少在工具链目录上保持一致（CUDA/NVIDIA/Miniconda）
详见SSH 登录的环境变量。
使用限制
自动断开连接
Web Terminal 会话默认在用户长时间无操作后自动断开连接。
如果需要执行训练等长时间运行的进程，强烈建议使用 tmux 等工具将进程放入后台，避免受到 Web Terminal 自动断开连接的影响。
系统盘空间限制
当开发机系统盘占用超过 100GiB 时，开发机将进入安全模式，此时：
- 仅能保证 Web Terminal 可连接
- SSH 连接可能无法使用
- 其他功能可能受限
常见问题
Web Terminal 无法连接怎么办？
请检查以下几点：
- 确认开发机状态为运行中
- 检查网络连接是否正常
- 尝试刷新浏览器页面
- 如果问题持续，可尝试重启开发机
在 Web Terminal 中无法使用 CUDA Toolkit nvcc 命令？
如果确认已经安装系统级 CUDA，则通常是环境变量问题：
# 检查当前 PATH
echo $PATH
# 添加 CUDA 路径
export PATH=/usr/local/cuda/bin:$PATH
export LD_LIBRARY_PATH=/usr/local/cuda/lib64:$LD_LIBRARY_PATH
# 验证 CUDA 是否可用
nvcc --versionconda activate 命令报错怎么办？
需要根据当前的镜像选择合适的方式初始化 conda。
Web Terminal 与 SSH 有什么区别？
主要区别包括：
| 特性 | Web Terminal | SSH |
|---|---|---|
| 访问方式 | 浏览器 | SSH 客户端 |
| 环境变量 | 可能有差异 | 完整环境 |
| 文件传输 | 不支持 | 支持 SCP/SFTP |
| 端口转发 | 不支持 | 支持 |
| 稳定性 | 依赖网络 | 更稳定 |
| 便利性 | 即开即用 | 需要配置 |
如何在 Web Terminal 中添加 SSH 公钥？
当 SSH 密码认证失败时，可以通过 Web Terminal 手动添加公钥：
# 创建 .ssh 目录（如果不存在）
mkdir -p ~/.ssh
# 添加公钥到 authorized_keys
echo 'your_public_key_content' >> ~/.ssh/authorized_keys
# 设置正确的权限
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys注意
如果开发机可以重启，建议通过智算云平台的 SSH 密钥管理功能添加 SSH 公钥，实现开发机启动时自动注入公钥。