frp 内网穿透部署

将本地服务（如 http://127.0.0.1:端口）通过公网服务器暴露，实现公网访问（如 http://example.com:端口）。

本技能使用 npm 包 @feng3d/frps 和 @feng3d/frpc 实现一键部署。

工作流程

1. 收集用户参数
2. 在公网 Linux 服务器上部署 frps（服务端）
3. 在本地 Windows/macOS 机器上部署 frpc（客户端）
4. 验证连通性

第一步：收集参数

需要的信息：

• SERVER_ADDR — 公网服务器域名或 IP（如 li.feng3d.com）
• LOCAL_PORT — 本地服务端口（如 12345）
• REMOTE_PORT — 公网暴露端口（通常与 LOCAL_PORT 相同）
• TOKEN — 认证令牌（可选，建议设置）

第二步：部署服务端（Linux）

在公网服务器上使用 npx 一键部署：

# 使用 npx 无需安装
npx @feng3d/frps -p 7000

# 带 token 认证
npx @feng3d/frps -p 7000 -t your-secret-token

# 全局安装后使用
npm install -g @feng3d/frps
frps -p 7000

命令会自动完成：

• 下载对应平台的 frps 二进制文件
• 创建配置文件
• 配置防火墙 (firewalld/ufw)
• 配置 systemd 服务（开机自启）

手动安装（备选）

如果无法使用 npx，可使用项目脚本：

bash scripts/setup_frps.sh 0.67.0 7000

第三步：部署客户端

Windows/macOS/Linux

使用 npx 一键部署：

# 交互式配置向导
npx @feng3d/frpc

# 直接指定参数
npx @feng3d/frpc --server li.feng3d.com --local-port 8080 --remote-port 8080

# 带 token 认证
npx @feng3d/frpc -s li.feng3d.com -l 8080 -r 8080 -t your-secret-token

# 全局安装后使用
npm install -g @feng3d/frpc
frpc --server li.feng3d.com --local-port 8080 --remote-port 8080

Windows 杀毒软件处理

Windows Defender 可能拦截 frpc.exe。如果遇到此问题：

1. 以管理员身份运行 PowerShell
2. 添加 Defender 排除：

   Add-MpPreference -ExclusionPath "$env:USERPROFILE\frp"
   

手动安装（备选）

如果无法使用 npx，可使用项目脚本：

# Windows
powershell -ExecutionPolicy Bypass -File scripts/setup_frpc.ps1 -Version "0.67.0" -Dest "$env:USERPROFILE\frp"

使用 assets/frpc.toml 作为配置模板：

serverAddr = "li.feng3d.com"
serverPort = 7000

[[proxies]]
name = "myapp"
type = "tcp"
localIP = "127.0.0.1"
localPort = 8080
remotePort = 8080

第四步：验证

浏览器访问 http://SERVER_ADDR:REMOTE_PORT，成功访问本地服务即表示配置正确。

常见问题

更多信息

• @feng3d/frps – 服务端包文档
• @feng3d/frpc – 客户端包文档
• frp 官方文档