nexus/wiki/entities/frp.md

title, type, aliases, tags

title	type	aliases	tags
frp	entity	frp内网穿透 frp工具	network proxy tunneling open-source

frp

Overview

frp (Fast Reverse Proxy) 是一个开源的高性能内网穿透工具，由 fatedier 开发维护。通过在公网服务器（frps）和内网机器（frpc）之间建立反向隧道，使内网服务可被公网访问。

Architecture

frp 采用 C/S 架构，包含两个核心组件：

组件	全称	角色	部署位置
frps	frp Server	服务端，监听客户端连接	公网 VPS
frpc	frp Client	客户端，建立反向隧道	内网机器

Core Concepts

Protocol Types

• TCP：通用 TCP 代理，适用于 SSH、数据库等任意 TCP 服务
• UDP：通用 UDP 代理，适用于 DNS、视频流等 UDP 服务
• HTTP/HTTPS：专为 Web 服务设计，支持虚拟主机和路径路由

Authentication

• Token：基于共享密钥的认证机制，frps 和 frpc 配置中的 token 必须一致
• Token 不一致会导致认证失败：authentication failed token mismatch

Dashboard (Optional)

frps 可选启用 Web 管理面板：

[dashboard]
dashboard_addr = 0.0.0.0
dashboard_port = 7500
dashboard_user = admin
dashboard_pwd = StrongPassword123!

Configuration Files

frps.ini (服务端)

[common]
bind_addr = 0.0.0.0
bind_port = 7000

# 可选：Web Dashboard
dashboard_addr = 0.0.0.0
dashboard_port = 7500
dashboard_user = admin
dashboard_pwd = StrongPassword

# 认证 Token（必须与客户端一致）
token = YourSecretTokenHere

frpc.ini (客户端)

[common]
server_addr = <frps公网IP>
server_port = 7000
token = YourSecretTokenHere

# TCP 映射示例：本地 5000 → VPS 15000
[nas]
type = tcp
local_ip = 127.0.0.1
local_port = 5000
remote_port = 15000

# SSH 映射示例
[ssh]
type = tcp
local_ip = 127.0.0.1
local_port = 22
remote_port = 60022

Installation

VPS (frps)

cd /opt
sudo mkdir frp && cd frp
FRP_VER=0.65.0
sudo curl -LO https://github.com/fatedier/frp/releases/download/v${FRP_VER}/frp_${FRP_VER}_linux_amd64.tar.gz
sudo tar xzf frp_${FRP_VER}_linux_amd64.tar.gz
sudo mv frp_${FRP_VER}_linux_amd64/* /opt/frp/

systemd Service (frps)

[Unit]
Description=frp server (frps)
After=network.target

[Service]
Type=simple
ExecStart=/opt/frp/frps -c /opt/frp/frps.ini
Restart=on-failure

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now frps
sudo systemctl status frps

Common Use Cases

1. Web 服务穿透：内网 NAS、Web 应用通过子域名访问
2. SSH 远程访问：通过 ssh -p 60022 user@vps.domain.com 访问内网机器
3. 数据库远程连接：MySQL、MongoDB 等数据库的远程管理
4. 监控系统访问：Grafana、Prometheus 等内网监控面板的公网展示

Advantages

特性	说明
轻量	单二进制文件，无额外依赖
高性能	基于 Go 语言，支持高并发连接
自动重连	网络中断后自动重连
热更新	支持配置热加载
多协议支持	TCP/UDP/HTTP/HTTPS
Web Dashboard	可选的图形化管理界面

Related Concepts

• 内网穿透 — frp 是实现内网穿透的典型工具
• 反向代理 — frp 与 Caddy/Nginx 常配合使用
• TCP 隧道 — frp 建立的底层连接机制
• VPS — frps 常部署在公网 VPS 上

References

• GitHub: https://github.com/fatedier/frp
• 文档: https://gofrp.org/docs/