Auto-sync: 2026-04-22 04:02

wiki/frp.md

@@ -0,0 +1,142 @@
+---
+title: "frp"
+type: entity
+aliases: [frp内网穿透, frp工具]
+tags: [network, proxy, tunneling, open-source]
+---
+
+# frp
+
+## Overview
+**frp** (Fast Reverse Proxy) 是一个开源的高性能内网穿透工具，由 [fatedier](https://github.com/fatedier/frp) 开发维护。通过在公网服务器（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 管理面板：
+```ini
+[dashboard]
+dashboard_addr = 0.0.0.0
+dashboard_port = 7500
+dashboard_user = admin
+dashboard_pwd = StrongPassword123!
+```
+
+## Configuration Files
+
+### frps.ini (服务端)
+```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 (客户端)
+```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)
+```bash
+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)
+```ini
+[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
+```
+
+```bash
+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/