99 lines
3.5 KiB
Markdown
99 lines
3.5 KiB
Markdown
---
|
||
title: "frp"
|
||
type: concept
|
||
tags: [networking, open-source, golang, tunneling, self-hosted]
|
||
last_updated: 2026-04-03
|
||
---
|
||
|
||
## Aliases
|
||
- Fast Reverse Proxy
|
||
- fatedier/frp
|
||
- frps
|
||
- frpc
|
||
|
||
## Definition
|
||
frp（Fast Reverse Proxy）是一款开源的高性能内网穿透工具，由 Go 语言编写，通过客户端-服务端架构建立反向隧道，使处于 NAT 或防火墙后的内网服务可以被公网访问。包含两个核心组件：frps（服务端，运行在公网 VPS）和 frpc（客户端，运行在内网设备）。
|
||
|
||
## Core Architecture
|
||
```
|
||
公网用户 → VPS:7000(frps) ←——— 反向隧道 ←——— frpc(内网设备)
|
||
```
|
||
|
||
## Key Components
|
||
- **frps**（frp server）：运行在公网 VPS，监听 7000 端口（默认），接收 frpc 连接，管理端口映射
|
||
- **frpc**（frp client）：运行在内网设备，主动连接 frps，建立反向隧道
|
||
- **frps.ini / frps.toml**：frps 配置文件
|
||
- **frpc.ini / frpc.toml**：frpc 配置文件
|
||
|
||
## Supported Protocol Types
|
||
| 类型 | 说明 | 适用场景 |
|
||
|------|------|---------|
|
||
| TCP | 原始 TCP 流量 | SSH、任意 TCP 端口 |
|
||
| UDP | 原始 UDP 流量 | DNS、视频流 |
|
||
| HTTP/HTTPS | 应用层代理 | Web 服务 |
|
||
| STCP | 加密 TCP | 安全内网访问 |
|
||
| SUDP | 加密 UDP | 安全数据传输 |
|
||
| XTCP | P2P UDP | 穿越对称型 NAT |
|
||
|
||
## Key Configuration Parameters
|
||
**frps.ini**:
|
||
```ini
|
||
[common]
|
||
bind_addr = 0.0.0.0
|
||
bind_port = 7000
|
||
token = <shared_secret> # 认证 token
|
||
dashboard_addr = 0.0.0.0
|
||
dashboard_port = 7500
|
||
dashboard_user = admin
|
||
dashboard_pwd = <password>
|
||
```
|
||
|
||
**frpc.ini**:
|
||
```ini
|
||
[common]
|
||
server_addr = <vps_ip>
|
||
server_port = 7000
|
||
token = <shared_secret> # 必须与 frps 一致
|
||
|
||
[service_name]
|
||
type = tcp
|
||
local_ip = 127.0.0.1
|
||
local_port = <local_port>
|
||
remote_port = <vps_port> # VPS 暴露端口
|
||
```
|
||
|
||
## Version Used in This Wiki
|
||
- **frp v0.65.0**（当前使用版本）
|
||
- 配置文件格式：`frpc.ini` / `frps.ini`（TOML 格式为 v0.52+，本 Wiki 使用 INI 格式）
|
||
|
||
## 在本 Wiki 中的应用
|
||
- [[通过VPS+内网反向代理实现域名访问内网穿透]]：完整实践指南（frps + Caddy + 阿里云 DNS）
|
||
- [[ubuntu-安装-frp-0-65-0-x86-64-操作笔记]]：Ubuntu frpc 客户端安装配置
|
||
- [[mac-mini-安装-frp-0-65-0-arm64-操作笔记]]：Mac Mini ARM64 安装配置
|
||
- [[家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]]：通过 frp 穿透 Grafana/Prometheus 端口
|
||
|
||
## SSH 穿透注意事项
|
||
SSH 穿透使用 `type = tcp`，不走 HTTP/HTTPS 代理层（Caddy 不参与）。SSH 连接命令：`ssh -p 60022 user@vps_domain`（`60022` 是 remote_port）。
|
||
|
||
## Troubleshooting
|
||
详见 [[通过VPS+内网反向代理实现域名访问内网穿透]] 故障排查章节：
|
||
1. 确认 frps 监听端口 `ss -lntup | grep frps`
|
||
2. 确认 token 与 frpc 一致 `journalctl -u frps -n 100`
|
||
3. 确认防火墙放行 7000 端口
|
||
4. telnet 诊断确认连接是否到达 frps
|
||
5. 强制重启 frps + frpc
|
||
|
||
## Related Concepts
|
||
- [[内网穿透]]：frp 是实现内网穿透的工具
|
||
- [[TCP隧道]]：frp 的 TCP 类型映射建立 TCP 隧道
|
||
- [[反向代理]]：Caddy 通常在 frp 上层提供 HTTPS 访问
|
||
|
||
## Related Entities
|
||
- [[RackNerd]]：托管 frps 的 VPS 提供商
|
||
- [[VPS]]：运行 frps 的公网服务器
|
||
- [[阿里云 DNS]]：管理 frp 穿透所需的域名解析
|
||
|
||
## References
|
||
- GitHub: https://github.com/fatedier/frp
|
||
- 文档: https://github.com/fatedier/frp#configuration
|