PXFS · Agent 文件服务

面向 AI Agent 的数据库原生文件系统： PXFS

PolarDB-X FileSystem（PXFS）把标准文件系统直接架在 PolarDB-X 上。文件写入即事务级持久化，自带时间点历史和内容去重——不改代码，就是普通文件。

标准 NFS v4.1 文件接口，Agent 直接读写普通文件，无需 SDK
每次写入都落库持久化，文件级原子提交，支持时间旅行视图
领取即独占整套实例：专属 PolarDB-X 企业版底座 + PXFS，释放即销毁

Read https://zero.polardbx.com/pxfs/SKILL.md and follow the instructions to mount a PXFS workspace.

PXFS 实例

Beta

从预热池领取一套专属 PXFS + PolarDB-X 企业版

三步完成挂载

先跑一个 Token 隧道 sidecar，再把 PXFS 挂成本地 NFS 卷。

Linux (Docker)

# 1. 保存访问 Token（600 权限，不进 shell history）
printf '%s' '<YOUR_ACCESS_TOKEN>' > ./pxfs-token && chmod 600 ./pxfs-token

# 2. 启动 sidecar 隧道（TLS + SCRAM，本地监听 127.0.0.1:12050）
docker run -d --name pxfs-sidecar \
  --network host --restart unless-stopped \
  --mount type=bind,src=$PWD/pxfs-token,dst=/etc/pxfs/token,readonly \
  -e PXFS_LISTEN=127.0.0.1:12050 \
  -e PXFS_TUNNEL_ENDPOINT='pxc-xxxxxxxxwn-pfs-pub.polarxpxfs.example.aliyuncs.com:12049' \
  -e PXFS_TOKEN_FILE=/etc/pxfs/token \
  reg.docker.alibaba-inc.com/apsaradb/pxfs-sidecar:latest

# 3. 挂载 NFS（见 mount 页签）

当前命令使用示例占位值；在上方领取实例后，真实接入地址和 Token 会自动填入。

你将获得什么

一套标准文件系统，附送数据库级能力。

📁

标准接口

POSIX / NFS

普通文件，零代码改造

NFS v4.1 协议，内核原生挂载
任意语言的标准文件 API 直接可用
Git、SQLite 等现有工具开箱即用
按用户隔离的 home 与共享目录

🗄️

数据库原生

Transactional

文件直接存在 PolarDB-X 里

文件级原子提交
微秒级时间旅行视图
.versions / .snapshot 虚拟目录
内容寻址去重，相同内容只存一份

🔐

安全接入

Token Tunnel

一枚 Token 对应一个身份

TCP/TLS 隧道 + SCRAM-SHA-256 鉴权
租户 / 身份 / Token 层层隔离
公网接入口支持 IP 白名单
Token 吊销立即生效

🤖

Agent 就绪

For AI Agents

为 Agent Workspace 而生

每个 Agent 身份一个独立 Workspace
内置官方文件系统 Skill
支持在 PXFS 上运行 SQLite
租户级配额与限流

实例生命周期

领取、挂载、使用，到期平台自动回收全部资源。

🎫

领取

从预热池领取一套专属 PXFS + PolarDB-X 企业版，平台当场下发接入地址和访问 Token。

🔌

挂载

用 Token 启动 sidecar 隧道，在 Linux 或 macOS 上把 PXFS 挂成本地 NFS 卷。

📂

使用

把 Agent 的 home 指向挂载点；文件自动持久化、带版本历史，还能在库里查。

♻️

释放

手动释放或 TTL 到期后，整套实例销毁且不会回池复用。

PolarDB-X Zero