命令行客户端

启动与连接

快捷启动与配置文件两种方式的参数、语法和并行行为。

启动方式

frpc 有两种启动方式:由面板下发配置的快捷启动,和使用本地配置文件的常规启动。

方式命令配置来源
快捷启动frpc -t <id>:<token>启动时从服务端拉取
配置文件frpc -c <file>本地 ini、yaml、json、toml 文件

同时指定 -t 与 -c 时只使用 -t,-c 指定的配置文件不会被读取。

快捷启动

frpc -t <id[,id2,...]>:<token> [-t ...]

-t 可重复出现,也可在同一段内用逗号续写。

写法示例说明
单个隧道-t 10000:abcdef隧道 10000 使用 token abcdef。
同一 token 多个隧道-t 10000,10001:abcdef只启动一个服务实例,同时承载这两个隧道。
多个 -t-t 10000:abcdef -t 10085:ghijkl两个 token 各启动一个服务实例。
逗号续写-t 10000:abcdef,10085,10086:ghijkl10000 使用 abcdef,10085 与 10086 使用 ghijkl。

位于两个 id:token 之间、自身不带 token 的 id 归属后一个 token。

./frpc -t 10000:abcdefghijklmnop

./frpc -t 10000:abcdefghijklmnop -t 10085:qrstuvwxyz123456

启动行为:

行为说明
同一 token 多个 id合并为一个服务实例。
不同 token并行启动多个服务实例,共用一个进程,日志以 [i/N] 前缀区分。
配置刷新只在启动时拉取一次,在面板修改隧道配置后需要重启 frpc。
单实例失败只打印错误,不影响其他实例。

token 会出现在进程命令行、shell 历史与 docker inspect 的输出中,不要分享完整命令。token 泄露后请在面板重建隧道。

配置文件

./frpc -c ./frpc.toml

-c 默认为 ./frpc.ini,支持 ini、yaml、json、toml 四种格式。ini 已弃用,启动时会打印告警。配置格式与原版 frp 一致,面板「连接配置」中提供的原版 FRPC TOML 配置可直接使用。

-c 可重复或用逗号分隔,每个文件启动一个服务实例:

./frpc -c ssh.toml -c web.toml
./frpc -c ssh.toml,web.toml

通过 --config_dir 指定目录时,目录(含子目录)下的每个文件都会作为配置文件启动一个实例:

./frpc --config_dir ./conf

--config_dir 不筛选后缀,目录中不要放置配置文件以外的文件。

多隧道

场景命令服务实例数
同一 token 多个 id-t 10000,10001:<token>1
多个 token-t 10000:<token1> -t 10085:<token2>2
多个配置文件-c a.toml -c b.toml2
配置目录--config_dir ./conf目录内文件数