教程
Lolia CLI
由 Lolia Team 开发的命令行工具,提供了便捷的功能来启动 LoliaFRP
什么是 Lolia CLI?
- Lolia CLi 是由 Lolia Team 开发的命令行工具,可以让用户快速,简单,优雅的一键启动 LoliaFRP,无需复杂的配置和操作,适合所有用户使用
- 由上游 gofrp 项目 fork 而来,持续跟进上游版本更新,并添加了独特的新功能
项目地址
使用方式
下载客户端
- 打开本项目的 GitHub 页面,进入 Releases 页面,下载适合您操作系统的客户端版本
- 解压下载的文件,找到
frpc可执行文件,frps为 LoliaFRP 的服务端程序,在这里不需要使用
启动隧道
- 在网页创建好面板后,点击复制
连接配置中的使用 LoliaFRP-CLI 快捷启动命令行,如
./frpc -t 114:abcdefgjhijklmnopqrstuvwxyz123456
- 以 Windows 11 系统为例,打开与
frpc.exe同目录的文件资源管理器窗口,单击右键选择在终端打开打开终端,粘贴上一步复制的命令行并回车,即可启动 LoliaFRP-CLI,连接成功后会显示类似如下的日志输出:
2:25AM INFO <client/control.go:205> LoliaFRP-CLI: [1145141919810] [1.abcdefgjhijklmnopqrstuvwxyz123456] 您可通过 114514.com:1145 访问您的服务
- 您可通过
114514.com:1145访问您的服务了,恭喜您成功使用 LoliaFRP-CLI 启动了 LoliaFRP!
进阶功能
我们不仅仅提供了快速启动的功能,还添加了一些实用的功能来提升用户体验:
AutoTLS
AutoTLS 是 LoliaFRP-CLI 提供的自动化证书管理功能,让您无需手动配置即可为服务启用 HTTPS
工作原理
在面板中开启 AutoTLS 并使用快捷启动时,客户端会在 本地 通过 TLS-ALPN-01 验证方式向 Let's Encrypt 自动申请证书并完成部署
证书存储路径
使用快捷启动时,证书默认保存在以下路径:
程序运行目录/.autotls-cache/
Docker 用户注意:请务必将
.autotls-cache 目录挂载为持久化卷,避免容器重建后重复申请证书。Let's Encrypt 对证书申请频率有限制,过量申请可能导致临时封禁。兼容其他 FRP 服务端
此功能同样支持原版 FRPS 及其他第三方 FRP 服务端。如需自行配置,请参考官方配置示例:
多隧道启动
您可以在 单个 frpc 进程 中同时启动多个不同节点的隧道,无需运行多个客户端实例。
使用方式
方式一:使用快捷启动参数
./frpc -t 隧道id:节点TOKEN -t 隧道id:节点TOKEN
方式二:使用配置文件
./frpc -c 隧道1.yaml -c 隧道2.yaml
兼容原版配置
我们完全兼容原版 frp 配置文件格式,您也可以搭配本客户端与自建 FRP 节点使用此功能。
Docker 部署
如果您更习惯使用容器化部署,我们也提供了官方 Docker 镜像。
拉取镜像
docker pull ghcr.io/lolia-frp/loliacli-frpc:0.67.2
国内用户:如遇拉取缓慢,可使用镜像加速:
docker pull ghcr.milu.moe/lolia-frp/loliacli-frpc:0.67.2
快速启动
使用快捷启动参数:
docker run -d --name loliafrp \
--restart=unless-stopped \
ghcr.io/lolia-frp/loliacli-frpc:0.67.2 \
-t 隧道id:节点TOKEN
持久化证书(AutoTLS 用户)
如果启用了 AutoTLS 功能,请务必挂载证书缓存目录:
docker run -d --name loliafrp \
--restart=unless-stopped \
-v /path/to/autotls-cache:/.autotls-cache \
ghcr.io/lolia-frp/loliacli-frpc:0.67.2 \
-t 隧道id:节点TOKEN
提示:将
/path/to/autotls-cache 替换为您本地的持久化目录路径,确保容器重建后证书不会丢失。Docker Compose
创建 docker-compose.yml 文件:
services:
loliafrp:
image: ghcr.io/lolia-frp/loliacli-frpc:0.67.2
container_name: loliafrp
restart: unless-stopped
command: -t 隧道id:节点TOKEN
启用 AutoTLS 时的配置:
services:
loliafrp:
image: ghcr.io/lolia-frp/loliacli-frpc:0.67.2
container_name: loliafrp
restart: unless-stopped
command: -t 隧道id:节点TOKEN
volumes:
- ./autotls-cache:/.autotls-cache
启动服务:
docker compose up -d