首次连接 / 按顺序完成接入
接入文档
按第一次连接的顺序选择能力、准备设备、取得短期凭据,并在控制台确认真实连接状态。
- 01选择能力公网发布或私有组网
- 02准备设备安装或运行对应客户端
- 03取得配置使用控制台生成的信息
- 04验证连接核对实际访问与连接路径
01 · 选择能力
公网入口和私有网络解决不同问题
需要让互联网主动访问本地服务时选择公网服务发布;只需要授权设备互访时选择私有设备组网。两个能力可以在同一账户内同时使用。
02 · Portway 客户端
使用 Portway 客户端完成设备接入
从下载页取得对应平台的安装包:Linux 为基于 Ubuntu 20.04 构建的自包含 AppImage(glibc 2.30+),下载后可直接运行;Windows 为自包含 ZIP,解压后运行 portway-desktop.exe。两者都已内置 frpc、Tailscale 与所需运行时,不需要另行安装第三方软件。客户端首次运行需要登录 Portway 账号;登录后会自动完成设备注册、FRP 连接和虚拟网络接入,服务端会把当前设备凭据、映射修订和网络入网材料交给客户端,客户端不会接受手工指定的公网端口。若继续使用官方 frpc 或 Tailscale,则按下面对应的原生客户端教程操作。
- 01下载并运行对应平台的安装包
- 02启动客户端并完成手机号登录
- 03在客户端创建设备,确认设备状态为活动
- 04创建 TCP 映射或虚拟网络,等待状态变为运行中/已连接
- 05用本地服务和公网端点分别验证实际流量
安装包已自包含:Linux AppImage 内置 GTK/WebKit,Windows 包内置 WebView2 引导、frpc 与 Tailscale,无需再手动下载或安装任何第三方软件。Linux 基于 Ubuntu 20.04 构建,要求 glibc 2.30+,并需要桌面环境提供的 Secret Service;Windows 缺少 WebView2 时首次运行会自动安装(仅该步骤需要联网)。内置组件均为官方未修改版本,协议兼容性不变。首次接入虚拟网络时系统会请求一次管理员授权以启用 TUN。若你选择继续使用官方 frpc 或 Tailscale,可按下方对应的原生客户端教程操作。
03 · frpc
不要手工选择公网端口
登录 https://www.tonat.cn,依次创建设备和映射,然后下载完整配置。系统会自动写入 FRPS 地址、端口、设备公开编号、一次性设备凭据、TLS 参数和已分配的公网端口。普通映射详情长期只提供不含秘密的代理片段;凭据遗失后需明确轮换整台设备的凭据,旧配置随后需要同步替换。公网访问端口只能由平台分配,不能在本地自行指定。
./frpc -c ./frpc.toml04 · Linux 服务器
Linux 服务器部署 frpc
加载中
05 · Tailscale
使用十分钟单次入网密钥
登录 https://www.tonat.cn 生成入网材料。入网密钥只用于一个预期节点,上游确认使用后,即使控制面响应丢失也不会重新展示或释放名额。
tailscale up --force-reauth --login-server=https://www.tonat.cn --auth-key=<一次性入网密钥>06 · Linux 命令行
Linux 无桌面服务器
无桌面环境不需要安装 Portway Desktop。请先按 官方 Tailscale Linux 安装说明安装与你的发行版匹配的软件包,确认系统同时提供 tailscale 命令和 tailscaled.service。
- 01安装官方 Tailscale 软件包
- 02启动 tailscaled 并设置开机自启
- 03在 Portway 控制台生成十分钟单次入网密钥
- 04执行一次入网命令并检查节点状态
sudo systemctl enable --now tailscaled.servicesystemctl is-active tailscaled.servicesudo tailscale up --force-reauth \
--login-server=https://www.tonat.cn \
--auth-key=<一次性入网密钥> \
--hostname=<设备名称>tailscale status官方 Linux 软件包会把节点状态保存在 /var/lib/tailscale/tailscaled.state。只要该文件仍在且节点未从 Portway 控制台移除,开机自启的 tailscaled 会使用原状态恢复连接。一次性入网密钥不要写入启动脚本、环境变量或长期配置文件。
停止、恢复与永久移除
临时停止或恢复整台机器的 Tailscale 服务时使用 systemd;这不会删除节点身份。永久移除此机器时,先在 Portway 控制台移除对应节点,再在本机注销。
sudo systemctl stop tailscaled.servicesudo systemctl start tailscaled.servicesudo tailscale logout连接失败时检查
sudo systemctl status tailscaled.service --no-pager
sudo journalctl -u tailscaled.service -n 100 --no-pager
test -c /dev/net/tun && echo "TUN ready"07 · 诊断
按四个阶段定位公网服务发布
08 · 兼容说明
只使用已验证的官方客户端版本
公网服务发布当前验证官方 frpc 0.69.0 至 0.71.1;私有设备组网当前验证 Tailscale 官方客户端 1.80.3 至 1.98.10。停止支持状态、安装包、签名和校验值以下载清单为准。