playit-agent：游戏服务器隧道代理

项目简介

playit-agent 是 playit.gg 官方开源的客户端程序，使用 Rust 编写。它在本机运行，为本地服务建立隧道，让外部玩家能够连接到运行在自己电脑或服务器上的游戏服务器，省去端口转发和公网 IP 的配置。

当前非废弃版本线为 1.2.X。

主要功能

• 隧道代理：把本地服务通过 playit.gg 的隧道对外暴露。
• Windows 服务 playitd：随 Windows 启动，保持隧道在线，网络不可用时自动重试。
• 托盘图标：显示 playit 是否在线，右键可打开 playit、启停服务、查看日志或关闭「Launch at Login」。
• Docker 运行：容器以前台方式运行守护进程，输出纯文本日志到 stdout，不依赖终端或 TUI。
• NetherNet 隧道（v1.2.0）：NetherNet 流量以 UDP 方式转发，可用于 Geyser 与 WaterdogPE。

安装与使用

从官网 https://playit.gg/download 下载对应平台的安装包或二进制文件后运行。

Windows

可用 winget 安装：

winget install DevelopedMethods.playit

安装器会配置 playit.gg Windows 服务、托盘图标和快捷方式。日志位于 %ProgramData%\playit_gg\logs。独立版 playit-windows-x86_64.exe 可在自己的窗口中运行，不安装服务。

Ubuntu / Debian

先添加官方 APT 源（详见 README），然后执行：

sudo apt install playit

Docker

先在此处生成 agent secret key：https://playit.gg/account/setup/wizard/new-account/docker/docker-name 。

docker run -d --name playit --restart unless-stopped --network host \
  -e SECRET_KEY=YOUR_AGENT_SECRET ghcr.io/playit-cloud/playit-agent:latest

也可以用只读挂载的密钥文件并通过 SECRET_KEY_FILE 传入，SECRET_KEY 与 SECRET_KEY_FILE 二选一。守护进程选项放在镜像名之后，例如 --socket-path /tmp/playit.sock；-e PLAYIT_LOG=debug 可输出更详细的日志。

从源码构建

需要 Rust（https://rustup.rs）：

git clone https://github.com/playit-cloud/playit-agent.git
cd playit-agent
cargo run --release

注意事项

• 请只使用来自官方渠道的程序，或自行从源码编译运行。
• Docker 使用 bridge 网络时，127.0.0.1 指向容器自身，隧道来源地址需设置为容器可访问的地址；要共享游戏容器的回环接口，可用 --network container:GAME_CONTAINER 代替 --network host。agent 不需要发布入站端口。
• v1.2.0 的 NetherNet 隧道配置：创建 Minecraft Bedrock (NetherNet) 隧道，启用 NetherNet 传输并选择 nxs 信令，把 NXS endpoint 设为 https://nethernet.playit.gg，将隧道页面上的 token 填入 NXS token，关闭 STUN 发现，隧道 Proxy Protocol 保持 None。玩家用隧道主机名和 19132 端口连接，即使隧道页面显示的是另一个 UDP 端口。

本作品整理自 GitHub 开源项目 playit-cloud/playit-agent，原作者 @playit-cloud，许可证 BSD-2-Clause。中文介绍由 AI 根据项目 README 整理，以原仓库为准。