p2peep2pee.com
控制台

客户端选择

p2pee 的客户端按部署方式分三种，同一业务的三种方式功能完全一致，按你的环境选即可。

三种方式怎么选

CLI 单文件Docker飞牛 NAS 应用
适合谁有终端习惯、想最省资源已在用容器、想统一管理飞牛 NAS 用户
安装成本下载即用一条 docker run应用商店点一下
升级方式替换二进制文件docker pull 新镜像应用中心更新
开机自启需自建 systemd / 计划任务--restart 自动应用自带
资源占用最低略高（容器开销）低
平台覆盖最全（含 arm64/386/FreeBSD）仅 amd64仅 x86
快速决策
  • 服务器 / 树莓派 / 低配设备 → CLI 单文件
  • 已经跑着 Docker、或想随时升级回滚 → Docker
  • 飞牛 NAS 用户 → 飞牛 NAS 应用（最省事）

参数对照：两大核心服务

不管用哪种方式，客户端启动时都需要账户 Key，再按业务附加不同参数。

业务程序 / 镜像 / 应用关键参数含义
文件共享p2pee-cli-* / xnkyn/p2pee / p2pee-*.fpkKEY + DIR_PATH（或第二个位置参数）要共享的目录
内网穿透p2pee-proxy-* / xnkyn/p2pee-proxy / p2pee-proxy-*.fpkKEY + TARGET要暴露的目标服务地址

文件共享

# CLI
./p2pee-cli-1.0.0-linux-amd64 <你的Key> /data/share

# Docker
docker run -d --name=p2pee \
  -v /opt:/root/p2pee \
  -e KEY='<你的Key>' \
  -e DIR_PATH='/root/p2pee' \
  xnkyn/p2pee:1.0.0

内网穿透

# Docker（注意：代理需要 host 网络才能拿到真实来源 IP）
docker run -d --name=p2pee-proxy --network=host \
  -e KEY='<你的Key>' \
  -e TARGET='http://192.168.1.209:3000' \
  xnkyn/p2pee-proxy:1.0.0

飞牛 NAS 用户在应用中心安装 P2Pee内网穿透 后，同样是在应用界面里填这两项（KEY 与目标地址），安装步骤见 飞牛 NAS 应用。

两者可以同时跑

文件共享与内网穿透是两个独立的程序，用同一个 Key 可以在同一台机器上同时运行，互不影响。

单文件 vs 容器：升级与迁移

CLI 单文件

p2pee 的二进制没有运行时依赖，升级就是替换文件：

# 1. 停止旧进程（Ctrl+C 或 kill）
# 2. 下载新版本、赋予可执行权限、重新启动
chmod +x ./p2pee-cli-<新版本>-linux-amd64
./p2pee-cli-<新版本>-linux-amd64 <你的Key> /data/share

配置（config.json 等）与二进制放在同一目录，替换二进制不会丢失配置。

Docker

docker pull xnkyn/p2pee:1.0.0     # 拉新镜像
docker stop p2pee && docker rm p2pee
# 用「同样的 run 命令」重新创建容器即可，数据在挂载的宿主机目录里
容器数据靠挂载

容器内的数据不会自动保留，务必把要共享的目录用 -v 挂到宿主机上（文件共享）、或用 --network=host 保证网络行为与宿主机一致（内网穿透）。

下一步

本页目录