命令行客户端

构建与发布

构建参数、交叉编译、发布流程,以及支持的平台与发布包内容。

下载

发布包位于 GitHub Releases,也可以在网页控制台下载。每个平台提供 zip(Windows)或 tar.gz 压缩包,以及校验文件 sha256sum.txt。

平台

系统架构
Linuxamd64、386、arm、arm64、loong64
Windowsamd64、386、arm64
macOSamd64、arm64
FreeBSDamd64、386、arm64
OpenBSDamd64、386、arm64
Androidarm(armv7)、arm64

除 Android 外为关闭 CGO 的静态构建,单文件即可运行。Android 版使用 CGO 单独构建。

构建

需要 Go 1.26.10 或更高版本(go.mod 中的 go 指令要求)。依赖通过 Go module 代理下载,国内网络可以先设置镜像:

go env -w GOPROXY=https://goproxy.cn,direct

使用仓库的 Makefile:

make frpc    # 只编译客户端,产物为 bin/frpc
make frps    # 只编译服务端,产物为 bin/frps
make         # 编译两端
make web     # 单独构建前端资源(需要 Node.js)

不使用 Makefile 时,可以直接执行等价命令:

GOOS=linux GOARCH=arm GOARM=7 CGO_ENABLED=0 \
  go build -trimpath -ldflags "-s -w" -tags "frpc,noweb" -o frpc ./cmd/frpc

构建标签

标签说明
frpc客户端构建,排除服务端专用代码。
frps服务端构建,排除客户端专用代码。
noweb跳过内置 Web 面板。仓库未构建前端资源(web/frpc/dist、web/frps/dist 不存在)时不加会报 pattern dist: no matching files found。

make frpc、make frps 不需要手动指定 noweb:Makefile 会检测这两个 dist 目录,缺失时自动追加。只有直接调用 go build、又没有先执行 make web 构建前端时,才要写成 -tags "frpc,noweb"。

交叉编译

变量说明
GOOS目标系统:linux、windows、darwin、freebsd、openbsd、android。
GOARCH目标架构:amd64、386、arm、arm64、loong64、mips、mipsle、mips64。
GOARM仅 GOARCH=arm 时有效,可取 5、6、7,默认为 7。
GOMIPS、GOMIPS64仅 mips 系列有效,可取 hardfloat(默认)或 softfloat。
CGO_ENABLED保持 0,产物为静态二进制。Android 版例外,需要 CGO 与 NDK。

以 Go 1.27.4、-s -w 加 noweb 构建为例,产物大小:

目标大小
linux/arm(GOARM=7)16.0 MB
linux/arm6415.7 MB
linux/mips、linux/mipsle(softfloat)18.1 MB
linux/mips6418.4 MB

发布

推送 v* 标签后,CI 按上面的矩阵交叉编译,Windows 打包为 zip、其余平台打包为 tar.gz,生成 sha256sum.txt 并创建 Release。Android 使用 NDK 单独构建。

发布包的构建参数为 CGO_ENABLED=0、-trimpath、-ldflags "-s -w -checklinkname=0"、-tags frpc 或 frps;CI 未设置 GOARM,因此 arm 包使用默认的 GOARM=7。

发布包内容

文件说明
frpc(.exe)客户端。
frps(.exe)服务端,自建节点时使用。
LICENSE许可证。
conf/frpc.toml上游示例配置,连接本地 127.0.0.1:7000,仅供格式参考。
conf/frps.toml上游示例服务端配置。

conf/frpc.toml 是上游示例文件,不能直接用于连接 LoliaFRP。实际使用请从面板复制快捷启动命令或原版 FRPC 配置。

版本

./frpc -v
LoliaFRP-CLI 0.71.4

版本号写在 pkg/util/version/version.go 的 var version 中,构建参数不会覆盖它,发版时需要修改该文件。

校验

sha256sum -c sha256sum.txt
Get-FileHash .\发布包.zip -Algorithm SHA256

将输出的哈希与 sha256sum.txt 中对应行对比。

上游版本

Lolia CLI fork 自 fatedier/frp,持续跟随上游更新,并添加了快捷启动、AutoTLS、多隧道等能力。其余配置项参见 conf/frpc_full_example.toml。