OneLinkAI API 调用文档
OneLinkAI 官网模型广场
OneLinkAI 官网模型广场
  1. 最佳实践
  • 使用指南
    • 产品简介
    • 快速开始
    • API文档
      • 模型接入指南
      • 获取模型列表
      • 大语言会话模型接入
      • Vidu 系列模型接入
      • Kling 系列模型接入
      • Veo 模型接入
      • Nano Banana 模型接入
      • GPT Image 2 模型接入
      • 大语言会话模型接口
        • Embeddings 接入
        • Rerank 接入
        • OpenAI
        • OpenAI-Responses
        • Claude
        • Gemini
      • Seedance 模型接入
        • 火山方舟模型接入指南
        • Seedance2.0 真人人像素材使用
        • Seedance 2.0 私域虚拟人像素材使用
        • 真人人像素材接口
          • 1-创建真人认证H5链接
          • 2-使用BytedToken获取GroupId
          • 3-上传素材URL创建Asset
          • 4-查询素材状态
          • 5-查询素材列表 (可选)
          • 6-删除素材 (可选)
          • 7-删除素材组 (可选)
      • HappyHorse 模型接入
        • HappyHorse 文生视频
        • HappyHorse 图生视频-基于首帧
        • HappyHorse 参考生视频
        • HappyHorse 视频编辑
    • 组织功能使用文档
      • 团队记忆
  • 开发工具
    • CC-Switch使用
    • Claude Code
    • Codex
    • Gemini
  • 更新日志
    • 产品更新日志
    • Desk 产品更新日志
  • 关于我们
    • 商务合作
    • 联系我们
  • 服务条款
    • 用户协议
    • 隐私政策
    • 用户充值协议
    • 申请账号主体变更协议
    • 合作伙伴服务协议
  • 合作指南
    • 合作伙伴规则
  • OLA cloud使用指南
    • 快速开始
    • 容器实例
      • 概述
      • JupyterLab
      • SSH远程连接
      • 升降配置
      • 转换计费方式
      • 守护进程
    • 最佳实践
      • Linux 基础
      • Cmder
      • XShell
      • MobaXterm
      • VSCode
      • PyCharm
    • 常见问题
      • 不能调用GPU
      • 常见问题
    • 数据
      • 概述
      • 公开数据
  1. 最佳实践

Linux 基础

OLA Cloud 实例默认使用 Linux Ubuntu 等发行版。熟悉常用 Linux 命令,有助于完成文件管理、环境配置、程序运行、日志查看和进程管理等操作。
本文整理 Linux 远程实例中最常用的基础命令和处理场景,示例命令均在远程实例终端中执行。
原文中的平台专用路径已替换为 OLA Cloud 的通用项目目录或文件存储目录。实际路径请以当前 OLA Cloud 实例页面和实例内目录为准。

使用前准备#

开始操作前,请先通过 SSH、JupyterLab、VSCode Remote-SSH 或其他远程工具连接到 OLA Cloud 实例。
登录OLA Cloud,进入“容器管理”,启动需要使用的实例。
获取ssh登录信息.png
在实例详情或连接信息中找到SSH登录指令,并复制完整命令。下面以以下命令为例:
这条命令中各个参数的含义如下:
用户名:root
主机(host):123.xxx.xxx.32
端口号:30220
注意: 每个实例的SSH主机和端口都可能不同,请以您当前实例页面显示的登录指令为准,不要直接照抄示例中的地址和端口。

1.列出文件和文件夹#

使用 ls 命令可以列出当前目录下的文件和文件夹。
ls -l 的输出通常包含以下信息:
文件类型和权限;
所有者(Owner);
所属用户组(Group);
文件大小;
最近修改时间;
文件名。
示例:
root@ola-cloud:/tmp/test_dir# ls
 a.txt  b

root@ola-cloud:/tmp/test_dir# ls -l
total 4
-rw-rw-r-- 1 root root    0 Nov  9 10:50 a.txt
drwxrwxr-x 2 root root 4096 Nov  9 10:50 b

2.新建目录和切换路径#

使用 mkdir 命令新建目录,使用 cd 命令切换当前工作路径。
示例:
常见的特殊路径:
.. 或 ../:上一级目录;
. 或 ./:当前目录。
例如:
也可以使用 mkdir -p 一次创建多级目录:

3.查看当前路径#

使用 pwd 命令查看当前所在路径。pwd 表示 print working directory。
示例:
root@ola-cloud:~# pwd
/root

4.重命名和移动文件或文件夹#

使用 mv 命令重命名或移动文件、文件夹。mv 表示 move。
如果目标目录不存在,mv 也可能被当作重命名操作:
示例:
使用 mv 前请确认源路径和目标路径。目标位置已经存在同名文件时,可能会覆盖原文件。

5.拷贝文件和文件夹#

使用 cp 命令拷贝文件或文件夹。拷贝文件夹时需要使用 -r 参数进行递归复制。
示例:
常用选项:
-r:递归拷贝目录及其内容;
-i:覆盖文件前询问;
-v:显示正在执行的拷贝操作。
重要文件建议使用 -i,减少误覆盖的风险:

6.删除文件和文件夹#

使用 rm 命令删除文件。删除文件夹及其内容时,需要使用 -r 参数。
-f 表示强制删除,执行前不会询问:
rm -rf 具有较高风险,路径写错可能导致重要文件被删除。建议先使用 pwd 和 ls 确认位置;不确定时优先使用不带 -f 的命令,或先备份重要数据。
通配符 * 表示匹配目录下的内容。例如:

7.设置环境变量#

使用 export 命令可以在当前终端中设置环境变量。常见环境变量包括 PATH 和 LD_LIBRARY_PATH。

PATH#

如果某个程序没有加入 PATH,通常需要输入完整路径才能执行。例如:
将 Miniconda 的 bin 目录加入 PATH 后,可以直接使用 python 命令:
$PATH 表示保留原有的 PATH 内容。多个路径之间使用冒号 : 分隔,路径顺序会影响系统查找可执行文件的优先级。
如果使用 Conda 虚拟环境,建议先激活对应环境,而不是盲目修改全局 PATH:

LD_LIBRARY_PATH#

LD_LIBRARY_PATH 用于设置动态链接库的搜索路径。例如:
可以使用以下命令查看环境变量:
通过 export 设置的环境变量通常只对当前终端会话有效。如果希望每次打开 Bash 终端时自动生效,可以将命令写入 ~/.bashrc:
写入 ~/.bashrc 前请确认命令内容正确,避免重复添加或覆盖已有环境配置。

8.编辑文本文件#

Linux 中常用 vim 编辑文本文件:
Vim 常用操作:
按 i 进入编辑模式;
按 Esc 返回普通模式;
输入 :w 保存文件;
输入 :q 退出 Vim;
输入 :wq 保存并退出;
输入 :q! 不保存并退出。
Vim 的高级用法较多,初次使用时建议先熟悉编辑、保存和退出操作。

9.压缩和解压#

Linux 中常用 zip、unzip 和 tar 处理压缩文件。

zip 和 unzip#

如果实例中没有安装 zip 或 unzip,可以先安装:
将目录压缩为 ZIP 文件:
解压 ZIP 文件:
解压到指定目录:

tar.gz#

tar 常用于 Linux 中的目录打包和压缩。常见参数如下:
c:创建压缩包;
x:解压压缩包;
z:使用 gzip 格式;
f:指定压缩包文件名;
j:使用 bzip2 格式。
将目录压缩为 tar.gz 文件:
解压 tar.gz 文件:
解压到指定目录:
处理 tar.bz2 文件:

10.查看 GPU 信息#

使用 nvidia-smi 查看 NVIDIA GPU 的驱动版本、CUDA 版本、显存占用和 GPU 利用率:
输出中的常见字段:
Memory-Usage: 显存使用情况,例如 408MiB / 12194MiB 表示已使用约 408MiB,总显存约 12194MiB;
GPU-Util: GPU 使用率,例如 2% 表示当前 GPU 利用率约为 2%;
Processes: 当前占用 GPU 显存的进程。
如果需要持续查看 GPU 状态,可以定期执行:
也可以使用 OLA Cloud 控制台中的实例监控功能查看 GPU 使用情况。具体入口和展示内容请以当前平台页面为准。

11.查看和结束进程#

使用 ps 查看正在运行的进程,使用 kill 结束指定进程。
可以通过进程名称找到目标程序的 PID。例如:
root@ola-cloud:~# ps -ef
UID  PID  PPID  C STIME TTY      TIME CMD
root 1    0     0 14:04 ?        00:00:00 bash
root 60   48    0 14:04 ?        00:00:00 sshd -D
root 402  338   99 14:05 pts/0   00:00:06 python train.py
上例中,python train.py 的进程 ID 是 402。可以先尝试正常结束:
如果进程没有退出,再使用强制结束:
结束后再次执行 ps -ef,确认进程是否已经退出;如果进程占用 GPU 显存,也可以使用 nvidia-smi 检查显存是否释放。
kill -9 会强制终止进程,程序可能来不及保存状态或清理文件。除非普通 kill 无法结束进程,否则不建议优先使用它。

12.查看 CPU 和内存占用#

使用 top 查看系统和进程的实时资源占用:
常见字段:
%CPU:进程的 CPU 使用率;
%MEM:进程占用的内存比例;
RES:进程实际占用的物理内存;
PID:进程 ID;
COMMAND:进程名称。
如果某个进程 CPU 使用率较高,通常会排在列表前面。可以根据 PID 和 COMMAND 判断该进程是否为目标程序。
在 top 中按 e 可以切换内存显示单位。
OLA Cloud 控制台如果提供实例监控功能,也可以使用控制台查看 CPU、内存和 GPU 的资源变化。具体监控项目请以当前实例页面为准。

13.重定向程序日志#

Linux 程序通常会将日志输出到标准输出(stdout)或标准错误(stderr)。可以使用 > 将输出重定向到文件。
直接运行程序时,日志会显示在终端中:
将标准输出重定向到日志文件:
同时将标准输出和标准错误都写入日志文件:
其中:
1 代表标准输出 stdout;
2 代表标准错误 stderr;
2>&1 表示将标准错误重定向到标准输出当前指向的位置。
使用 cat 查看日志文件:
使用 tail 查看日志末尾内容:
如果需要让程序在后台运行,可以在命令末尾添加 &:
对于需要长时间运行的训练任务,建议结合 screen 或 tmux 使用,而不是只在普通终端中添加 &。这样可以降低 SSH 断开后程序被终止的风险。

14.常见使用场景#

场景一:程序停止了,但显存仍然被占用#

这种情况可能是程序进程仍然存在但处于假死状态。可以按以下顺序检查:
确认目标进程的 PID 后,先尝试正常结束:
如果仍未退出,再使用:
最后重新执行 nvidia-smi,确认显存是否已经释放。

场景二:将模型或数据复制到文件存储目录#

如果 OLA Cloud 实例提供独立的数据盘、文件存储或共享存储,请先确认其实际挂载路径:
假设 OLA Cloud 文件存储目录为 /root/ola-data/,可以使用 cp -r 复制文件或目录:
/root/ola-data/ 只是OLA Cloud默认的数据盘挂载路径,不代表所有 OLA Cloud 实例都使用该目录。请以实例实际挂载路径为准,不要直接照抄。

场景三:进程内存持续增长并最终被 Killed#

可以使用 top 观察进程的内存占用。如果内存持续增长,可能是程序存在内存泄漏、缓存没有释放或数据引用没有及时清理等问题。
建议检查:
是否不断向列表、字典或缓存中追加数据;
是否重复加载数据而没有释放旧对象;
是否将计算图或 GPU 张量长期保存在变量中;
DataLoader、日志记录和中间结果是否占用了过多内存。
可以先使用以下命令查看系统和进程状态:

场景四:远程终端关闭后仍希望继续查看训练日志#

对于长时间运行的训练任务,可以使用 screen 或 tmux 创建持久终端,并配合日志重定向:
使用 Ctrl + A + D 离开 screen 会话。之后重新连接实例,执行以下命令恢复会话或查看日志:
这样即使关闭网页、退出 SSH 工具或暂时断开网络,训练程序和日志文件仍有机会继续运行和保存。

15.常用命令速查#

目的命令
查看文件ls -la
查看当前路径pwd
切换目录cd path
创建目录mkdir -p path
移动或重命名mv source target
拷贝文件cp source target
递归拷贝目录cp -r source_dir target_dir
删除文件rm file
查看进程ps -ef
结束进程kill PID
查看 CPU 和内存top
查看 GPUnvidia-smi
查看磁盘空间df -h
查看日志末尾tail -f log_file
压缩目录tar czf archive.tar.gz directory/
解压目录tar xzf archive.tar.gz
命令执行前请确认当前目录、目标路径和进程 PID。尤其是 rm -rf、kill -9 等高风险命令,不要在无法确认对象时直接执行。
修改于 2026-08-05 03:21:31
上一页
守护进程
下一页
Cmder
Built with