跳到主要内容

首次连接 / 按顺序完成接入

接入文档

按第一次连接的顺序选择能力、准备设备、取得短期凭据,并在控制台确认真实连接状态。

  1. 01选择能力公网发布或私有组网
  2. 02准备设备安装或运行对应客户端
  3. 03取得配置使用控制台生成的信息
  4. 04验证连接核对实际访问与连接路径

01 · 选择能力

公网入口和私有网络解决不同问题

需要让互联网主动访问本地服务时选择公网服务发布;只需要授权设备互访时选择私有设备组网。两个能力可以在同一账户内同时使用。

02 · Portway 客户端

使用 Portway 客户端完成设备接入

从下载页取得对应平台的安装包:Linux 为基于 Ubuntu 20.04 构建的自包含 AppImage(glibc 2.30+),下载后可直接运行;Windows 为自包含 ZIP,解压后运行 portway-desktop.exe。两者都已内置 frpc、Tailscale 与所需运行时,不需要另行安装第三方软件。客户端首次运行需要登录 Portway 账号;登录后会自动完成设备注册、FRP 连接和虚拟网络接入,服务端会把当前设备凭据、映射修订和网络入网材料交给客户端,客户端不会接受手工指定的公网端口。若继续使用官方 frpc 或 Tailscale,则按下面对应的原生客户端教程操作。

  1. 01下载并运行对应平台的安装包
  2. 02启动客户端并完成手机号登录
  3. 03在客户端创建设备,确认设备状态为活动
  4. 04创建 TCP 映射或虚拟网络,等待状态变为运行中/已连接
  5. 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
./frpc -c ./frpc.toml

04 · 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。

  1. 01安装官方 Tailscale 软件包
  2. 02启动 tailscaled 并设置开机自启
  3. 03在 Portway 控制台生成十分钟单次入网密钥
  4. 04执行一次入网命令并检查节点状态
启动并设置开机自启
sudo systemctl enable --now tailscaled.service
确认系统服务已运行
systemctl is-active tailscaled.service
首次加入 Portway 虚拟网络
sudo 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.service
恢复服务
sudo systemctl start tailscaled.service
本机永久注销
sudo 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 · 诊断

按四个阶段定位公网服务发布

控制在线设备与 frps 控制连接
映射注册授权和代理修订一致
公网入口真实监听和边缘路由
本地应用独立探测,不用心跳冒充

08 · 兼容说明

只使用已验证的官方客户端版本

公网服务发布当前验证官方 frpc 0.69.0 至 0.71.1;私有设备组网当前验证 Tailscale 官方客户端 1.80.3 至 1.98.10。停止支持状态、安装包、签名和校验值以下载清单为准。