FRP v0.68.0 内网穿透完整教程

1
# ==========================================
2
# FRP 服务端配置 frps.toml (v0.68.0)
3
# Nginx 反代模式：vhostHTTPPort 内部使用 8080
4
# ==========================================
5

6
# ---------- 基础连接配置 ----------
7
# frpc 连接的监听地址（需要对外，所以 0.0.0.0）
8
bindAddr = "0.0.0.0"
9
# frpc 连接 frps 的端口（客户端配置与此一致）
10
bindPort = 7000
11

12
# ---------- HTTP 虚拟主机端口（Nginx 反代模式关键配置） ----------
13
# 代理监听地址：只允许本地回环访问，禁止外部直连 8080
14
proxyBindAddr = "127.0.0.1"
15
# HTTP 类型代理监听端口（Nginx 会把请求转发到此端口）
16
vhostHTTPPort = 8080
17
# HTTP ResponseHeader 超时时间（秒）
18
vhostHTTPTimeout = 60
19

20
# 如果后续需要 HTTPS 代理（Nginx 不做 SSL 终止场景），取消下行注释
21
# vhostHTTPSPort = 8443
22

23
# ---------- 鉴权配置（必须开启！） ----------
24
[auth]
25
# 鉴权方式：token 或 oidc，默认 token
26
method = "token"
27
# 附加鉴权范围（可选）：HeartBeats, NewWorkConns
28
# additionalScopes = ["HeartBeats", "NewWorkConns"]
29
# ⚠️ 令牌（必须替换为复杂随机字符串，客户端必须设置相同的值）
30
token = "123456"
31

32
# ---------- 控制台 / Dashboard 配置 ----------
33
# ⚠️ 要直接通过 IP:7500 外网访问：addr 改成 "0.0.0.0"
34
# ⚠️ 只通过 Nginx 反代访问：保持 "127.0.0.1"
35
[webServer]
36
addr = "0.0.0.0"
37
port = 7500
38
user = "admin"
39
password = "123456"
40

41
# 是否提供 Prometheus 监控接口（需要 webServer 启用）
42
# enablePrometheus = true
43

44
# ---------- 日志配置 ----------
45
[log]
46
# 日志文件路径，console 表示输出到终端
47
to = "./frps.log"
48
# 日志级别：trace, debug, info, warn, error
49
level = "info"
50
# 日志保留天数
51
maxDays = 7
52
# 禁用日志颜色（写文件时建议禁用）
53
# disablePrintColor = false
54

55
# ---------- 传输层配置（可选优化） ----------
56
[transport]
57
# 允许客户端设置的最大连接池大小
58
maxPoolCount = 5
59
# 心跳连接超时时间（秒）
60
heartbeatTimeout = 90
61
# 底层 TCP keepalive 间隔（秒），负数表示不启用
62
tcpKeepalive = 30
63
# TCP Multiplex 心跳检查间隔（秒）
64
# tcpMuxKeepaliveInterval = 60
65

66
# ---------- 其他服务端限制（可选） ----------
67
# 服务端返回详细错误信息给客户端
68
# detailedErrorsToClient = true
69
# 限制单个客户端最大同时存在的代理数，0 表示无限制
70
# maxPortsPerClient = 0
71
# 用户建立连接后等待客户端响应的超时时间（秒）
72
# userConnTimeout = 10

1
[Unit]
2
Description = FRP Server (Nginx Proxy Mode for aaa.example.com)
3
After = network.target syslog.target network-online.target
4
Wants = network.target network-online.target
5

6
[Service]
7
Type = simple
8
# 工作目录
9
WorkingDirectory = /usr/local/frp
10
# 启动命令（必须使用绝对路径）
11
ExecStart = /usr/local/frp/frps -c /usr/local/frp/frps.toml
12
# 异常自动重启策略
13
Restart = always
14
# 重启间隔（秒）
15
RestartSec = 5s
16
# 启动超时
17
TimeoutStartSec = 30s
18

19
[Install]
20
WantedBy = multi-user.target

1
# ---------- HTTP → HTTPS 强制跳转 ----------
2
server {
3
    listen 80;
4
    listen [::]:80;
5
    server_name aaa.example.com;
6
    return 301 https://$host$request_uri;
7
}
8

9
# ---------- HTTPS 443 主站点 ----------
10
server {
11
    listen 443 ssl http2;
12
    listen [::]:443 ssl http2;
13
    server_name aaa.example.com;
14

15
    # SSL 证书路径（根据实际路径修改）
16
    ssl_certificate     /etc/letsencrypt/live/aaa.example.com/fullchain.pem;
17
    ssl_certificate_key /etc/letsencrypt/live/aaa.example.com/privkey.pem;
18

19
    # SSL 安全配置
20
    ssl_protocols TLSv1.2 TLSv1.3;
21
    ssl_ciphers HIGH:!aNULL:!MD5;
22
    ssl_prefer_server_ciphers on;
23
    ssl_session_cache shared:SSL:10m;
24
    ssl_session_timeout 10m;
25

26
    # HSTS（可选，仅全站 HTTPS 时开启）
27
    # add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
28

29
    # 其他 location 配置（反代、Dashboard 等同上，保持不变）
30
    access_log  /var/log/nginx/aaa.example.com.access.log  main;
31
    error_log   /var/log/nginx/aaa.example.com.error.log   warn;
32
    client_max_body_size 1024m;
33

34
    location / {
35
        proxy_pass http://127.0.0.1:8080;
36
        proxy_set_header Host $host;
37
        proxy_set_header X-Real-IP $remote_addr;
38
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
39
        proxy_set_header X-Forwarded-Proto $scheme;
40
        proxy_set_header X-Forwarded-Host $host;
41
        proxy_set_header X-Forwarded-Port $server_port;
42
        proxy_http_version 1.1;
43
        proxy_set_header Upgrade $http_upgrade;
44
        proxy_set_header Connection "upgrade";
45
        proxy_connect_timeout 60s;
46
        proxy_send_timeout 300s;
47
        proxy_read_timeout 300s;
48
        proxy_buffering off;
49
    }
50
}

1
# ==========================================
2
# FRP 客户端配置 frpc.toml (v0.68.0)
3
# 场景：穿透 Windows 本地 80 端口 Web 服务
4
# 域名：aaa.example.com
5
# ==========================================
6

7
# ---------- 连接服务端配置 ----------
8
# ⚠️ 替换为你的公网服务器公网 IP 地址
9
serverAddr = "123.123.123.123"
10
# frps 的 bindPort（必须与服务端 frps.toml 的 bindPort 一致）
11
serverPort = 7000
12

13
# 第一次连接失败是否立即退出（true 方便调试，生产建议 false + 重连）
14
loginFailExit = false
15

16
# ---------- 鉴权配置（⚠️ 必须与服务端 frps.toml 完全一致！） ----------
17
[auth]
18
method = "token"
19
token = "123456"
20
# additionalScopes = ["HeartBeats", "NewWorkConns"]  # 服务端开启了这里也要开
21

22
# ---------- 客户端 Admin WebServer（可选，本地管理面板） ----------
23
# 浏览器访问：http://127.0.0.1:7400
24
[webServer]
25
addr = "127.0.0.1"
26
port = 7400
27
user = "admin"
28
password = "123456"
29

30
# ---------- 日志配置 ----------
31
[log]
32
to = "./frpc.log"
33
level = "info"
34
maxDays = 7
35
# disablePrintColor = false
36

37
# ---------- 传输层配置（可选优化） ----------
38
[transport]
39
# 通信协议：tcp, kcp, quic, websocket, wss（Nginx 反代场景用 tcp 即可）
40
protocol = "tcp"
41
# 连接服务端超时（秒）
42
dialServerTimeout = 10
43
# 底层 TCP keepalive（秒）
44
dialServerKeepalive = 30
45
# 连接池大小（与服务端 maxPoolCount 协调）
46
poolCount = 1
47
# TCP Multiplex（默认启用）
48
tcpMux = true
49
# 心跳包间隔（秒），tcpMux 启用后可设为 -1
50
heartbeatInterval = 30
51
# 心跳超时（秒）
52
heartbeatTimeout = 90
53

54
# TLS 连接（v0.68.0 默认启用，提高通信安全性）
55
[transport.tls]
56
enable = true
57

58
# ---------- 其他客户端配置 ----------
59
# 可选：附加元数据（服务端插件用）
60
# [metadatas]
61
# location = "office-shanghai"
62
# device = "windows-pc-01"
63

64
# ==========================================
65
# 代理配置：穿透本地 80 端口的 Web 服务
66
# ==========================================
67
[[proxies]]
68
# 代理名称（唯一，可自定义，服务端 Dashboard 中显示）
69
name = "web-80"
70
# 代理类型：http（域名复用、虚拟主机支持）
71
type = "http"
72
# 是否启用该代理（默认 true，false 可临时禁用不删除配置）
73
# enabled = true
74
# 被代理的本地服务 IP（本机就是 127.0.0.1；要代理局域网其他机器填对应 IP）
75
localIP = "127.0.0.1"
76
# 被代理的本地服务端口（Windows 上跑的 Web 端口）
77
localPort = 80
78

79
# ---------- HTTP 代理域名配置（必须与 Nginx server_name 一致！） ----------
80
customDomains = ["aaa.example.com"]
81

82
# 可选：通过子路径路由（例如只代理 /api/*）
83
# locations = ["/"]
84

85
# 可选：给穿透的网站加 HTTP Basic Auth 访问密码
86
# httpUser = "website-viewer"
87
# httpPassword = "Viewer@Pass2026"
88

89
# 可选：修改转发给后端的 Host Header（默认是 $host，按需改）
90
# hostHeaderRewrite = "internal.dev.local"
91

92
# 可选：请求/响应 Header 操作
93
# [proxies.requestHeaders]
94
# set = { "X-From-Frp" = "true", "X-Frp-User" = "admin" }
95
# [proxies.responseHeaders]
96
# set = { "X-Proxy" = "frp-v0.68.0" }
97

98
# ---------- 传输加密与压缩（推荐开启） ----------
99
[proxies.transport]
100
# 压缩传输内容（文本类资源效果显著，二进制图片/视频效果一般）
101
useCompression = true
102
# 额外加密（已启用全局 TLS 时可不开，双重加密略吃 CPU 但更安全）
103
useEncryption = true
104
# 可选：带宽限流（例如限制 10MB/s，防止内网带宽被占满）
105
# bandwidthLimit = "10MB"
106
# bandwidthLimitMode = "client"  # client 或 server
107

108
# ---------- 健康检查（可选，推荐开启） ----------
109
# 本地服务异常时自动下线，恢复后自动上线
110
# [proxies.healthCheck]
111
# # 检查类型：tcp 或 http
112
# type = "http"
113
# # http 类型必填：健康检查的 PATH
114
# path = "/"
115
# # 检查间隔（秒）
116
# intervalSeconds = 15
117
# # 单次超时（秒）
118
# timeoutSeconds = 5
119
# # 连续失败多少次判定不健康
120
# maxFailed = 3
121

122
# ==========================================
123
# 扩展：如果还想穿透其他端口/服务，可以继续加 [[proxies]]
124
# 示例：穿透 Windows 远程桌面 3389（TCP 类型）
125
# ==========================================
126
# [[proxies]]
127
# name = "windows-rdp-3389"
128
# type = "tcp"
129
# localIP = "127.0.0.1"
130
# localPort = 3389
131
# remotePort = 13389   # 服务端对外开放的端口（防火墙放行 13389）
132
# 然后在另一台电脑 mstsc 连接：服务器IP:13389

1
bindAddr = "0.0.0.0"
2
bindPort = 7000
3
proxyBindAddr = "127.0.0.1"
4
vhostHTTPPort = 8080
5

6
[auth]
7
method = "token"
8
token = "123456"
9

10
[webServer]
11
addr = "0.0.0.0"
12
port = 7500
13
user = "admin"
14
password = "123456"
15

16
[log]
17
to = "./frps.log"
18
level = "info"
19
maxDays = 7

1
serverAddr = "123.123.123.123"
2
serverPort = 7000
3
loginFailExit = false
4

5
[auth]
6
method = "token"
7
token = "123456"
8

9
[webServer]
10
addr = "127.0.0.1"
11
port = 7400
12
user = "admin"
13
password = "FrpClient@789"
14

15
[log]
16
to = "./frpc.log"
17
level = "info"
18
maxDays = 7
19

20
[transport.tls]
21
enable = true
22

23
[[proxies]]
24
name = "web-80"
25
type = "http"
26
localIP = "127.0.0.1"
27
localPort = 80
28
customDomains = ["aaa.example.com"]
29

30
[proxies.transport]
31
useCompression = true
32
useEncryption = true

1
server {
2
    listen 80;
3
    listen [::]:80;
4
    server_name aaa.example.com;
5

6
    access_log  /var/log/nginx/aaa.example.com.access.log  main;
7
    error_log   /var/log/nginx/aaa.example.com.error.log   warn;
8

9
    client_max_body_size 1024m;
10

11
    location / {
12
        proxy_pass http://127.0.0.1:8080;
13
        proxy_set_header Host $host;
14
        proxy_set_header X-Real-IP $remote_addr;
15
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
16
        proxy_set_header X-Forwarded-Proto $scheme;
17
        proxy_set_header X-Forwarded-Host $host;
18
        proxy_set_header X-Forwarded-Port $server_port;
19
        proxy_http_version 1.1;
20
        proxy_set_header Upgrade $http_upgrade;
21
        proxy_set_header Connection "upgrade";
22
        proxy_connect_timeout 60s;
23
        proxy_send_timeout 300s;
24
        proxy_read_timeout 300s;
25
        proxy_buffering off;
26
    }
27

28
    location ^~ /_frp_dashboard/ {
29
        proxy_pass http://127.0.0.1:7500/;
30
        proxy_set_header Host $host;
31
        proxy_set_header X-Real-IP $remote_addr;
32
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
33
        proxy_set_header X-Forwarded-Proto $scheme;
34
        proxy_http_version 1.1;
35
        proxy_set_header Upgrade $http_upgrade;
36
        proxy_set_header Connection "upgrade";
37
    }
38
}