本文以CentOS操作系统为例，介绍如何快速开通PFS，并通过客户端访问PFS文件系统。

适用范围

本文的快速入门仅适用于BCC挂载与卸载极速型L3。

前提条件

1. 已开通并行文件存储PFS服务。首次登录并行文件存储PFS控制台时，需要根据页面引导开通PFS服务。
2. 已创建一个BCC云服务器实例，且为客户端支持的Linux操作系统。

挂载操作步骤

步骤一：创建文件系统

1. 登录并行文件存储PFS控制台。
2. 在实例页面，单击创建实例，并填写必要配置，包括地域、可用区、实例类型、实例名称、实例备注和标签等信息。参数详细说明请见：创建文件系统。
3. 单击创建，完成购买。

步骤二：创建挂载点

1. 在并行文件存储PFS控制台，点击实例名称进入实例详情页，点击挂载信息。
2. 在挂载信息页点击添加挂载点，在弹出的页面中设置挂载点名称、协议类型、VPC、子网、指定IP地址、权限组等信息。参数详细说明请见：挂载点（极速型L3）

注意事项

1. 同一子网下只能添加一个挂载点，且子网的设备类型仅支持通用型。
2. 为保证访问性能，建议客户端、挂载点和PFS实例处于同一可用区。
3. 若跨可用区访问，因可用区距离增加网络时延，会导致性能1～4倍下降（数据来源于测试，请以实际情况为准）。
4. 后续使用该挂载点进行挂载时，挂载点所在VPC需与待挂载的计算节点（如BCC）处于同一个VPC，如不在同一VPC内，需要通过对等连接打通两个VPC网络后方可正常挂载访问。

5. 点击确认后，即可查看挂载点信息。请记录此处的挂载点地址（pfs-****.lb-****.pfs.**.baidubce.com），用于后续的挂载。

步骤三：挂载

极速型L3当前支持BPFS协议和NFS协议，两种协议的主要区别如下：

（一）挂载BPFS协议PFS

1. 登录到需要挂载PFS文件系统的云服务器BCC。
2. （可选）如果要挂载的本地目录不存在，先创建本地挂载目录。

1mkdir -p ${LocalPath}

• 参数说明

• 示例

1mkdir -p /pfs_mnt

3. （可选）下载挂载脚本：首次挂载需要下载挂载脚本（pfs_mount.sh）。后续执行挂载和卸载时，无需重复下载（如脚本被删除，请重新下载）。

1## 使用 wget 下载：
2wget -O ${PfsMountScriptPath}/pfs_mount.sh -nv ${PfsMountScriptUrl}
3
4## 若机器未安装 wget，可使用 curl 下载：
5curl -o ${PfsMountScriptPath}/pfs_mount.sh ${PfsMountScriptUrl}
6
7## 为脚本添加执行权限：
8chmod +x ${PfsMountScriptPath}/pfs_mount.sh

• 参数说明

• 示例

1wget -O /opt/pfs_mount.sh -nv https://su-pfs-client-bucket.su.bcebos.com/pfs_mount.sh?authorization=bce-auth-v1/ALTAKHlK9LpHdrzobnY6YBMQcF/2026-07-06T06:35:12Z/-1/host/f415d4122134701d39ae39988b505c9247696c9bf83a2beccf9ea26402472d87
2
3chmod +x /opt/pfs_mount.sh

4. 执行挂载命令

1${PfsMountScriptPath}/pfs_mount.sh mount --mount_point ${MountPoint} --pfs_path ${PFSRemotePath} --local_path ${LocalPath} [--mode RWMode] [--o Options] [--install_dir ${PfsClientPath}] 

• 参数说明：

参数	是否必选	说明
PfsMountScriptPath	是	PFS挂载脚本（pfs_mount.sh）所在的BCC本地目录，如示例中目录/opt。
MountPoint	是	PFS实例的挂载点地址。需在PFS控制台「挂载信息」中查看并复制。
PFSRemotePath	是	PFS文件系统内已存在的绝对路径。可以为根目录（例如：/）或已存在的子目录（例如：/dir0）。
LocalPath	是	BCC服务器上用于挂载PFS的已存在本地目录路径，必须是以/开头的绝对路径（例如：/pfs_mnt）。
RWMode	否	文件系统的挂载模式，支持只读（ro）和读写（rw）两种模式，默认是读写挂载（rw）。
Options	否	挂载选项，支持allow_other和default_permissions（默认）两种参数： allow_other： 允许其他用户访问挂载的文件系统。 default_permissions： 启用内核默认权限检查，按UID、GID和权限位进行访问控制。 建议保持默认值开启，非必要无需改动。
PfsClientInstallPath	否	pfs_client的安装目录，默认安装在pfs_mount.sh脚本所在目录。若首次挂载时指定了其他目录，后续对于该挂载的挂载和卸载都需要指定目录。

注意：

1. 执行挂载命令时，将请求使用root用户权限进行挂载。
2. pfs_client依赖GCC12。若/opt/compiler目录下未安装GCC 12，执行挂载命令时会自动安装GCC12到该目录。请不要删除/opt/compiler下GCC 12，否则挂载的文件系统将无法正常使用；GCC 12安装需预留2GB以上磁盘空间。
3. 安装pfs client的目录需预留20GB以上磁盘空间。

• 示例

1/opt/pfs_mount.sh mount --mount_point pfs-*****.lb-*****.pfs.su.baidubce.com --pfs_path / --local_path /pfs_mnt

（二）挂载NFS协议PFS

1. 登录到需要挂载PFS文件系统的云服务器BCC。
2. （可选）如果要挂载的本地目录不存在，先创建本地挂载目录。

1mkdir -p ${LocalPath}

• 参数说明

• 示例

1mkdir -p /pfs_mnt

3. （可选）在云服务BCC中安装NFS客户端（需root权限）

• CentOS/RHEL操作系统请运行以下命令：

1yum install nfs-utils

• Ubuntu/Debian操作系统请运行以下命令:

1apt-get install nfs-common

4. 执行挂载命令（需root权限）

1mount -t nfs4 -o minorversion=1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport ${MountPoint}:${PFSRemotePath} ${LocalPath}

• 参数说明

选项	是否必选	说明
MountPoint	是	PFS实例的挂载点地址。需在PFS控制台「挂载信息」中查看并复制。
PFSRemotePath	是	PFS文件系统内已存在的绝对路径。可以为根目录（例如：/）或已存在的子目录（例如：/dir0）。
LocalPath	是	BCC服务器上用于挂载PFS的已存在本地目录路径，必须是以/开头的绝对路径（例如：/pfs_mnt）。
minorversion	是	挂载协议的小版本号。必须为1，指定使用NFS 4.1协议。
rsize	是	设置客户端文件读请求可以接收的数据最大字节数。该值设置过小，会导致读吞吐下降。 推荐值：1048576。
wsize	是	设置客户端文件写请求可以发送的最大字节数。该值设置过小，会导致写吞吐下降。 推荐值：1048576。
hard	否	客户端重试行为选项，有 hard 和 soft 两个可选值，不指定默认使用 hard。 hard 选项下，客户端在服务端回复前会无限重试，该选项能最大限度保证数据完整性。soft 选项下，客户端重试一段时间后放弃，同时返回错误给客户端，如果启用该选项，建议调大 timeo 值，来降低数据损坏风险。 推荐值：hard。
timeo	是	客户端在重试 NFS 请求之前等待响应的时间，单位是分秒（0.1s）。该值不应该低于 150，即 15 秒。 推荐值：600。
retrans	是	客户端重试请求次数，超过此次数之后将尝试进一步的恢复操作。 推荐值：2。
noresvport	是	是否使用特权端口号，有 resvport 和 noresvport 两个可选值，默认使用 resvport。 resvport 代表使用特权端口号（1-1023），noresvport 代表不使用特权端口号（>1023）。非特权端口号的范围更大，可以减少一些因为端口分配问题导致的服务不可用问题。 推荐值：noresvport。

更多参数说明请参考 NFS文档。

• 示例

1mount -t nfs4 -o minorversion=1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport pfs-*****.lb-*****.pfs.bj.baidubce.com:/ /pfs_mnt

步骤四：查询

1. 通过以下命令查询是否挂载成功

1df -h

如果返回如下信息，则代表挂载成功

2. 挂载成功后，您可以在BCC上把PFS文件系统当作一个普通的本地目录来访问和使用。

卸载操作步骤

(一)卸载BPFS协议PFS

1. 登录到挂载PFS文件系统的云服务器BCC。
2. 执行命令 ：

1${PfsMountScriptPath}/pfs_mount.sh umount [--install_dir PfsClientInstallPath]

• 参数说明：

• 示例

1/opt/pfs_mount.sh umount

3. 执行"df -h" 命令，查看卸载结果。如果回显中未找到您挂载的PFS文件系统信息，表示该文件系统已卸载成功。

注意：卸载PFS文件系统前请确保客户端节点已无业务IO任务，否则卸载会导致业务IO任务中断并失败。

(二)卸载NFS协议PFS

1. 登录到挂载PFS文件系统的云服务器BCC。
2. 执行命令 ：

1umount ${LocalPath}

• 参数说明

• 示例

1umount /pfs_mnt

3. 执行“mount -l”命令，查看卸载结果。如果回显中未找到您挂载的PFS文件系统信息，表示该文件系统已卸载成功。

注意：卸载PFS文件系统前请确保客户端节点已无业务IO任务，否则卸载会导致业务IO任务中断并失败。