Skip to content

快速上手

把本地服务暴露到公网只需三步:安装客户端、下载隧道配置、运行。

1. 安装客户端

Linux / macOS

bash
curl -fsSL https://console.nicefrp.com/install.sh | bash

脚本会自动识别系统和 CPU 架构,下载官方 frpc 并安装到 /usr/local/bin (无权限时回退到 ~/.local/bin)。可用环境变量 NICEFRP_FRP_VERSION 指定 frp 版本。

Windows(PowerShell)

powershell
irm https://console.nicefrp.com/install.ps1 | iex

脚本会把 frpc.exe 安装到 %LOCALAPPDATA%\NiceFRP\bin 并加入用户 PATH。

验证安装:

bash
frpc -v

2. 下载隧道配置

登录控制台,打开隧道并下载 nicefrp-<tunnel-id>.toml。文件包含访问令牌,请用 chmod 600 保存。

3. 运行 frpc

bash
frpc -c nicefrp-<tunnel-id>.toml

看到 start proxy success 即表示隧道已上线,用控制台显示的域名或远程端口 访问即可。

诊断

隧道无法连接时,运行:

bash
curl -fsSL https://console.nicefrp.com/nicefrp-diag.sh | bash

脚本会依次检查:frpc 是否安装、配置是否存在、节点端口是否可达、本地服务 是否在监听,并指出具体失败环节。

常见问题

  • login to server failed — 节点可能离线,或防火墙拦截了控制端口,用 诊断脚本确认。
  • 本地服务不可达 — 请先启动本地服务,frpc 只做转发,不会替你启动。
  • 找不到 frpc — 安装后重开终端使 PATH 生效,或手动把安装目录加入 PATH。

仍有问题?发邮件至 support@nicefrp.com