papp_cloud 使用手册

papp_cloud 用户手册 #

一个登录超算的命令行工具，具备 SSH、SCP、RSYNC、SFTP、SSHFS 的基础功能，支持 IPv4 和 IPv6 双栈协议。

目录 #

支持平台 #

系统架构
Linuxx86_64, i686, aarch64
macOSamd64 (Intel), arm64 (Apple Silicon)

安装设置 #

安装 #

# 1. 解压安装包
unzip papp_cloud-*.zip
cd papp_cloud-*

# 2. 执行安装脚本
./install.sh install

# 3. 验证安装
papp_cloud --version

升级 #

./install.sh update

卸载 #

./install.sh remove
手动安装（安装脚本不可用时）
# 选择适合你系统的文件：
# Linux x86_64: papp_cloud_linux_amd64
# Linux aarch64: papp_cloud_linux_aarch64
# macOS Intel: papp_cloud_darwin_amd64
# macOS M1/M2/M3: papp_cloud_darwin_arm64

sudo cp papp_cloud_* /usr/local/bin/papp_cloud
sudo chmod +x /usr/local/bin/papp_cloud

前置依赖 #

功能依赖说明
SSH/SCP/SFTPOpenSSH系统通常自带
rsync 同步rsync大多数系统已预装
挂载目录sshfs需单独安装

安装 sshfs：

# Ubuntu/Debian
sudo apt install sshfs

# CentOS/RHEL
sudo yum install sshfs

# macOS
brew install sshfs

快速开始 #

以下操作在 Linux/macOS 命令行中完成。

1. 登录 #

papp_cloud login -u demo@paratera.com -p

2. 查看可用账号 #

papp_cloud acct

3. 查看支持的超算中心 #

papp_cloud lsc

4. SSH 登录超算 #

papp_cloud ssh paratera@gz

命令详解 #

login - 登录 #

登录并行云服务，获取访问凭证。

格式：

papp_cloud login -u <email|mphone> -p
参数说明
-u并行账号（邮箱或手机号）
-p启用密码输入模式

示例：

# 使用邮箱登录
papp_cloud login -u demo@paratera.com -p

# 使用手机号登录
papp_cloud login -u 13800138000 -p

登录成功后，Token 有效期 12 小时，存储在 ~/.config/papp_cloud/papp_cloud.db。

logout - 登出 #

退出登录状态，清除本地凭证。

格式：

papp_cloud logout

lsc - 查看集群 #

查看支持的超算中心列表。

格式：

papp_cloud lsc

输出示例：

+------------+-------------------------+----------+
| SHORT NAME |       FULL NAME         |  LABEL   |
+------------+-------------------------+----------+
| gz         | GUANGZHOU               | 广州中心 |
| th1        | TIANHE-1                | 天河一号 |
| th2        | TIANHE-2                | 天河二号 |
+------------+-------------------------+----------+

acct - 查看账号 #

查看你的超算账号信息。

格式：

papp_cloud acct

输出示例：

+----+--------------+------------+-------------------------+
| ID | ACCOUNT NAME | SCC SHORT  |        SCC FULL         |
+----+--------------+------------+-------------------------+
|  1 | paratera     | gz         | GUANGZHOU               |
|  2 | test_user    | th2        | TIANHE-2                |
+----+--------------+------------+-------------------------+

ssh - 远程登录 #

通过 SSH 协议登录超算节点。

格式：

papp_cloud ssh [<flags>] <user@sccname> [<command>...]
参数说明
-v, --verbose详细输出（调试）
-s, --select选择链路
-X, --x11X11 转发（图形界面）
-6, --ipv6使用 IPv6

目标格式： user@sccname

  • user：超算登录用户名
  • sccname：集群简称（通过 lsc 查看）

示例：

# 基本登录（IPv4）
papp_cloud ssh paratera@gz

# 使用 IPv6 登录
papp_cloud ssh -6 paratera@gz

# X11 转发（运行图形程序）
papp_cloud ssh -X paratera@gz

# 登录后执行命令
papp_cloud ssh paratera@gz ls -la

# 调试模式
papp_cloud ssh -v paratera@gz

scp - 文件传输 #

在本地和超算之间传输文件。

格式：

papp_cloud scp [<flags>] <source ... target>
参数说明
-v, --verbose详细输出
-s, --select选择链路
-6, --ipv6使用 IPv6
-r递归（目录）

示例：

# 上传文件（IPv4）
papp_cloud scp file1 file2 paratera@gz:/home/paratera

# 上传文件（IPv6）
papp_cloud scp -6 file1 file2 paratera@gz:/home/paratera

# 上传目录
papp_cloud scp -r ./data/ paratera@gz:/home/paratera/data/

# 下载文件
papp_cloud scp paratera@gz:/home/paratera/file1 /data

# 下载目录
papp_cloud scp -r paratera@gz:/home/paratera/data/ ./local_data/

rsync - 文件同步 #

同步文件，支持断点续传。

格式：

papp_cloud rsync [<flags>] <source ... target>
参数说明
-v, --verbose详细输出
-s, --select选择链路
-6, --ipv6使用 IPv6
-z, --compress压缩传输
--dry-run模拟运行（预览）
--delete删除目标多余文件
--timeout超时时间（秒）
--retrys重试次数
--exclude排除文件
--include包含文件

示例：

# 同步文件到超算（IPv4）
papp_cloud rsync file1 file2 paratera@gz:/home/paratera

# 同步文件到超算（IPv6）
papp_cloud rsync -6 file1 file2 paratera@gz:/home/paratera

# 压缩传输
papp_cloud rsync -z ./data/ paratera@gz:/home/paratera/data/

# 模拟运行（查看会传输哪些文件）
papp_cloud rsync --dry-run ./data/ paratera@gz:/home/paratera/data/

# 删除目标多余文件（保持一致）
papp_cloud rsync --delete ./data/ paratera@gz:/home/paratera/data/

# 失败自动重试
papp_cloud rsync --retrys 3 ./data/ paratera@gz:/home/paratera/data/

# 下载文件
papp_cloud rsync paratera@gz:/home/paratera/file1 /data

sftp - 安全传输 #

交互式安全文件传输。

格式：

papp_cloud sftp [<flags>] <user@sccname>
参数说明
-v, --verbose详细输出
-s, --select选择链路
-6, --ipv6使用 IPv6
-b, --batchfile批处理文件

示例：

# 交互式连接（IPv4）
papp_cloud sftp paratera@gz

# 交互式连接（IPv6）
papp_cloud sftp -6 paratera@gz

# 批处理模式
papp_cloud sftp -b commands.txt paratera@gz

SFTP 内部命令：

命令说明
ls查看远程目录
lls查看本地目录
cd切换远程目录
lcd切换本地目录
get <file>下载文件
put <file>上传文件
exit退出

sshfs - 挂载目录 #

将远程超算目录挂载到本地。

格式：

papp_cloud sshfs <user@sccname:dir> <mountpoint>
参数说明
-v, --verbose详细输出
-s, --select选择链路
-6, --ipv6使用 IPv6

示例：

# 挂载远程目录
papp_cloud sshfs paratera@gz:/home/paratera /localdir

# 使用完毕后卸载
# Linux:
fusermount -u /localdir

# macOS:
umount /localdir

注意：需要先安装 sshfs。

completion - 命令补全 #

生成命令行自动补全的 shell 脚本。

格式：

papp_cloud completion [bash|zsh|fish|powershell]

示例：

# 生成 bash 补全脚本
papp_cloud completion bash > /etc/bash_completion.d/papp_cloud

# 生成 zsh 补全脚本
papp_cloud completion zsh > "${fpath[1]}/_papp_cloud"

# 临时启用（当前会话）
source <(papp_cloud completion bash)

高级功能 #

链路选择 #

默认情况下，papp_cloud 自动选择延时最小的链路。如需手动选择，添加 -s 参数。

支持的命令： ssh、scp、rsync、sftp、sshfs

格式：

papp_cloud ssh -s paratera@gz
papp_cloud scp -s file paratera@gz:/path
papp_cloud rsync -s ./data/ paratera@gz:/path
papp_cloud sftp -s paratera@gz
papp_cloud sshfs -s paratera@gz:/path /mnt

交互示例：

$ papp_cloud ssh -s paratera@gz
Super Computing link list:
[0]. cn-zhongwei-cstnet-22 (10690)
[1]. cn-beijing-22 (1020409)
[2]. cn-beijing-22 (118859)
[3]. cn-beijing-80 (506390)
Please input a number continue or enter 'q' to quit: 2

输入数字选择链路，或输入 q 退出。

调试模式 #

连接失败时，使用 -v 参数查看详细信息。

papp_cloud ssh -v paratera@gz

典型任务 #

任务一：首次使用 #

# 1. 登录
papp_cloud login -u demo@paratera.com -p

# 2. 查看可用集群和账号
papp_cloud lsc
papp_cloud acct

# 3. 连接集群
papp_cloud ssh paratera@gz

任务二：上传代码并运行作业 #

# 1. 上传项目目录
papp_cloud rsync ./my_project/ paratera@gz:/home/paratera/my_project/

# 2. SSH 连接并提交作业
papp_cloud ssh paratera@gz
cd my_project
sbatch run.sh
exit

# 3. 下载结果
papp_cloud scp -r paratera@gz:/home/paratera/my_project/results/ ./

任务三：增量同步数据 #

# 1. 先预览会传输哪些文件
papp_cloud rsync --dry-run ./data/ paratera@gz:/home/paratera/data/

# 2. 确认后执行同步
papp_cloud rsync --delete ./data/ paratera@gz:/home/paratera/data/

# 3. 网络不稳定时启用重试
papp_cloud rsync --retrys 3 ./data/ paratera@gz:/home/paratera/data/

任务四：编辑远程文件 #

# 1. 创建本地挂载点
mkdir -p ~/remote/gz

# 2. 挂载远程目录
papp_cloud sshfs paratera@gz:/home/paratera ~/remote/gz

# 3. 用本地编辑器编辑
code ~/remote/gz/project/main.py

# 4. 完成后卸载
umount ~/remote/gz  # macOS
fusermount -u ~/remote/gz  # Linux

任务五：运行图形程序 #

# 1. 确保本地已安装 X Server
#    Linux: 通常自带
#    macOS: 安装 XQuartz

# 2. 使用 -X 参数连接
papp_cloud ssh -X paratera@gz

# 3. 运行图形程序，界面显示在本地
glxgears

参考 #

命令概览 #

命令说明
login登录并行云服务
logout登出并行云服务
lsc查看支持的超算中心
acct查看可用超算账号
sshSSH 登录超算
scp上传/下载文件
rsync同步文件
sftp安全文件传输
sshfs挂载远程目录
completion生成命令补全脚本

通用参数 #

参数说明
-v, --verbose详细输出（调试）
-s, --select选择链路
-6, --ipv6使用 IPv6
-a, --api指定网关地址

文件位置 #

文件路径
登录凭证~/.config/papp_cloud/papp_cloud.db

获取帮助 #

# 查看帮助
papp_cloud --help
papp_cloud ssh --help

# 查看版本
papp_cloud --version

附录：scp vs rsync #

场景推荐原因
首次上传大量小文件scp简单直接
增量同步rsync只传输变化的文件
断点续传rsync --retrys支持重试
精确控制传输内容rsync支持 include/exclude
网络不稳定rsync --retrys自动重试

版本：v4.0.0 · 更新：2026-03-12