内网穿透工具 frp 使用教程

bind_port

表示内网计算机和服务器计算机的通信端口，需要打开外网计算机的端口防火墙限制

vhost_http_port

http 服务映射端口，需要打开外网计算机的端口防火墙限制

vhost_https_port

https 服务映射端口，需要打开外网计算机的端口防火墙限制

token

协商令牌，客户端和服务器需要一致才可以生效

dashboard_port

frp 管理端口，需要打开外网计算机的端口防火墙限制

dashboard_user

管理端口用户名

dashboard_pwd

管理端口密码

log_file

日志文件位置

log_level

日志级别，分为debug, info, warn, error四级

log_max_days

日志保存的天数

heartbeat_timeout

心跳配置

privilege_allow_ports

frp内网穿透服务端监听的端口，如果不设置的话，所有端口都可以连接使用，但为为了不占用系统使用的端口号，建议设置允许的监听端口，比如www.chuantou.org提供的内网穿透服务器就是开放50000-60000端口

max_pool_count

连接池的数量，如果frp内网穿透客户端设置的连接池的数量大于下面的数值，就会修改frp客户端的连接池为下面的数值

max_ports_per_client

每个客户端最大可以使用的端口，0表示无限制

authentication_timeout

frp内网穿透服务端frps和frp内网穿透的客户端frpc两台电脑的时间差，如果设置为0的话，不校验时间差异，默认校验时间差为900秒。

tcp_mux

是否使用tcp复用，默认为true， frp只对同意客户端的连接进行复用

server_addr

公网服务器的公网IP

server_port

和服务器端配置一致

token

和服务器端配置一致

[ssh] / [http]

服务名称，根据个人情况设置

type

服务类型，包含 tcp, udp, http, https 等，ssh 使用 tcp即可

local_ip

本机IP，建议设置127.0.0.1 ，就不用来回改了

local_port

本地映射端口，其实本质为本地端口数据映射到服务器端端口

remote_port

服务器端端口

custom_domains

http 类型必填，需要域名解析到该公网IP上（http 类型服务需要）

bind_addr

string

服务端监听地址

0.0.0.0

bind_port

int

服务端监听端口

7000

接收 frpc 的连接

bind_udp_port

int

服务端监听 UDP 端口

0

用于辅助创建 P2P 连接

kcp_bind_port

int

服务端监听 KCP 协议端口

0

用于接收采用 KCP 连接的 frpc

proxy_bind_addr

string

代理监听地址

同 bind_addr

可以使代理监听在不同的网卡地址

log_file

string

日志文件地址

./frps.log

如果设置为 console，会将日志打印在标准输出中

log_level

string

日志等级

info

trace, debug, info, warn, error

log_max_days

int

日志文件保留天数

3

disable_log_color

bool

禁用标准输出中的日志颜色

false

detailed_errors_to_client

bool

禁用服务端返回详细错误信息给客户端

true

heart_beat_timeout

int

服务端和客户端心跳连接的超时时间

90

单位：秒

user_conn_timeout

int

用户建立连接后等待客户端响应的超时时间

10

单位：秒

authentication_method

string

鉴权方式

token

token, oidc

authenticate_heartbeats

bool

开启心跳消息鉴权

false

authenticate_new_work_conns

bool

开启建立工作连接的鉴权

false

token

string

鉴权使用的 token 值

客户端需要设置一样的值才能鉴权通过

oidc_issuer

string

oidc_issuer

oidc_audience

string

oidc_audience

oidc_skip_expiry_check

bool

oidc_skip_expiry_check

oidc_skip_issuer_check

bool

oidc_skip_issuer_check

allow_ports

string

允许代理绑定的服务端端口

格式为 1000-2000,2001,3000-4000

max_pool_count

int

最大连接池大小

5

max_ports_per_client

int

限制单个客户端最大同时存在的代理数

0

0 表示没有限制

tls_only

bool

只接受启用了 TLS 的客户端连接

false

dashboard_addr

string

启用 Dashboard 监听的本地地址

0.0.0.0

dashboard_port

int

启用 Dashboard 监听的本地端口

0

dashboard_user

string

HTTP BasicAuth 用户名

admin

dashboard_pwd

string

HTTP BasicAuth 密码

admin

enable_prometheus

bool

是否提供 Prometheus 监控接口

false

需要同时启用了 Dashboard 才会生效

asserts_dir

string

静态资源目录

Dashboard 使用的资源默认打包在二进制文件中，通过指定此参数使用自定义的静态资源

vhost_http_port

int

为 HTTP 类型代理监听的端口

0

启用后才支持 HTTP 类型的代理，默认不启用

vhost_https_port

int

为 HTTPS 类型代理监听的端口

0

启用后才支持 HTTPS 类型的代理，默认不启用

vhost_http_timeout

int

HTTP 类型代理在服务端的 ResponseHeader 超时时间

60

subdomain_host

string

二级域名后缀

custom_404_page

string

自定义 404 错误页面地址

tcpmux_httpconnect_port

int

为 TCPMUX 类型代理监听的端口

0

启用后才支持 TCPMUX 类型的代理，默认不启用

server_addr

string

连接服务端的地址

0.0.0.0

server_port

int

连接服务端的端口

7000

http_proxy

string

连接服务端使用的代理地址

格式为 {protocol}😕/user:passwd@192.168.1.128:8080 protocol 目前支持 http 和 socks5

log_file

string

日志文件地址

./frpc.log

如果设置为 console，会将日志打印在标准输出中

log_level

string

日志等级

info

trace, debug, info, warn, error

log_max_days

int

日志文件保留天数

3

disable_log_color

bool

禁用标准输出中的日志颜色

false

pool_count

int

连接池大小

0

user

string

用户名

设置此参数后，代理名称会被修改为 {user}.{proxyName}，避免代理名称和其他用户冲突

dns_server

string

使用 DNS 服务器地址

默认使用系统配置的 DNS 服务器，指定此参数可以强制替换为自定义的 DNS 服务器地址

login_fail_exit

bool

第一次登陆失败后是否退出

true

protocol

string

连接服务端的通信协议

tcp

tcp, kcp, websocket

tls_enable

bool

启用 TLS 协议加密连接

false

heartbeat_interval

int

向服务端发送心跳包的间隔时间

30

heartbeat_timeout

int

和服务端心跳的超时时间

90

start

string

指定启用部分代理

当配置了较多代理，但是只希望启用其中部分时可以通过此参数指定，默认为全部启用

authentication_method

string

鉴权方式

token

token, oidc

需要和服务端一致

authenticate_heartbeats

bool

开启心跳消息鉴权

false

需要和服务端一致

authenticate_new_work_conns

bool

开启建立工作连接的鉴权

false

需要和服务端一致

token

string

鉴权使用的 token 值

需要和服务端设置一样的值才能鉴权通过

oidc_client_id

string

oidc_client_id

oidc_client_secret

string

oidc_client_secret

oidc_audience

string

oidc_audience

oidc_token_endpoint_url

string

oidc_token_endpoint_url

admin_addr

string

启用 AdminUI 监听的本地地址

0.0.0.0

admin_port

int

启用 AdminUI 监听的本地端口

0

admin_user

string

HTTP BasicAuth 用户名

admin

admin_pwd

string

HTTP BasicAuth 密码

admin

asserts_dir

string

静态资源目录

AdminUI 使用的资源默认打包在二进制文件中，通过指定此参数使用自定义的静态资源

type

string

代理类型

是

tcp

tcp, udp, http, https, stcp, sudp, xtcp, tcpmux

use_encryption

bool

是否启用加密功能

否

false

启用后该代理和服务端之间的通信内容都会被加密传输

use_compression

bool

是否启用压缩功能

否

false

启用后该代理和服务端之间的通信内容都会被压缩传输

proxy_protocol_version

string

启用 proxy protocol 协议的版本

否

v1, v2

如果启用，则 frpc 和本地服务建立连接后会发送 proxy protocol 的协议，包含了原请求的 IP 地址和端口等内容

bandwidth_limit

string

设置单个 proxy 的带宽限流

否

单位为 MB 或 KB，0 表示不限制，如果启用，会作用于对应的 frpc

local_ip

string

本地服务 IP

是

127.0.0.1

需要被代理的本地服务的 IP 地址，可以为所在 frpc 能访问到的任意 IP 地址

local_port

int

本地服务端口

是

xxxx

配合 local_ip

plugin

string

客户端插件名称

否

见客户端插件的功能说明

用于扩展 frpc 的能力，能够提供一些简单的本地服务，如果配置了 plugin，则 local_ip 和 local_port 无效，两者只能配置一个

plugin_params

map

客户端插件参数

否

map 结构，key 需要都以 “plugin_” 开头，每一个 plugin 需要的参数也不一样，具体见客户端插件参数中的内容

group

string

负载均衡分组名称

否

用户请求会以轮询的方式发送给同一个 group 中的代理

group_key

string

负载均衡分组密钥

否

用于对负载均衡分组进行鉴权，group_key 相同的代理才会被加入到同一个分组中

health_check_type

string

健康检查类型

否

tcp,http

配置后启用健康检查功能，tcp 是连接成功则认为服务健康，http 要求接口返回 2xx 的状态码则认为服务健康

health_check_timeout_s

int

健康检查超时时间(秒)

否

3

执行检查任务的超时时间

health_check_max_failed

int

健康检查连续错误次数

否

1

连续检查错误多少次认为服务不健康

health_check_interval_s

int

健康检查周期(秒)

否

10

每隔多长时间进行一次健康检查

health_check_url

string

健康检查的 HTTP 接口

否

如果 health_check_type 类型是 http，则需要配置此参数，指定发送 http 请求的 url，例如 “/health”

remote_port

int

服务端绑定的端口

是

用户访问此端口的请求会被转发到 local_ip:local_port 当type=tcp时，此项必选

remote_port

int

服务端绑定的端口

是

用户访问此端口的请求会被转发到 local_ip:local_port

custom_domains

[]string

服务器绑定自定义域名

是(和 sub_domain 两者必须配置一个)

用户通过 vhost_http_port 访问的 HTTP 请求如果 Host 在 custom_domains 配置的域名中，则会被路由到此代理配置的本地服务

subdomain

string

自定义子域名

是(和 custom_domains 两者必须配置一个)

和 custom_domains 作用相同，但是只需要指定子域名前缀，会结合服务端的 subdomain_host 生成最终绑定的域名

locations

[]string

URL 路由配置

否

采用最大前缀匹配的规则，用户请求匹配响应的 location 配置，则会被路由到此代理

http_user

string

用户名

否

如果配置此参数，暴露出去的 HTTP 服务需要采用 Basic Auth 的鉴权才能访问

http_pwd

string

密码

否

结合 http_user 使用

host_header_rewrite

string

替换 Host header

否

替换发送到本地服务 HTTP 请求中的 Host 字段

headers

map

替换 header

否

map 中的 key 是要替换的 header 的 key，value 是替换后的内容

custom_domains

[]string

服务器绑定自定义域名

是(和 sub_domain 两者必须配置一个)

用户通过 vhost_http_port 访问的 HTTP 请求如果 Host 在 custom_domains 配置的域名中，则会被路由到此代理配置的本地服务

sub_domain

string

自定义子域名

是(和 custom_domains 两者必须配置一个)

和 custom_domains 作用相同，但是只需要指定子域名前缀，会结合服务端的 subdomain_host 生成最终绑定的域名

role

string

角色

是

server

server,visitor

server 表示服务端，visitor 表示访问端

sk

string

密钥

是

服务端和访问端的密钥需要一致，访问端才能访问到服务端

role

string

角色

是

server

server,visitor

server 表示服务端，visitor 表示访问端

sk

string

密钥

是

服务端和访问端的密钥需要一致，访问端才能访问到服务端

role

string

角色

是

server

server,visitor

server 表示服务端，visitor 表示访问端

sk

string

密钥

是

服务端和访问端的密钥需要一致，访问端才能访问到服务端