教程

Lolia CLI

由 Lolia Team 开发的命令行工具,提供了便捷的功能来启动 LoliaFRP

什么是 Lolia CLI?

  • Lolia CLi 是由 Lolia Team 开发的命令行工具,可以让用户快速,简单,优雅的一键启动 LoliaFRP,无需复杂的配置和操作,适合所有用户使用
  • 由上游 gofrp 项目 fork 而来,持续跟进上游版本更新,并添加了独特的新功能

项目地址

使用方式

下载客户端

  1. 打开本项目的 GitHub 页面,进入 Releases 页面,下载适合您操作系统的客户端版本
  2. 解压下载的文件,找到 frpc 可执行文件, frps 为 LoliaFRP 的服务端程序,在这里不需要使用

启动隧道

  1. 在网页创建好面板后,点击复制 连接配置 中的 使用 LoliaFRP-CLI 快捷启动 命令行,如
./frpc -t 114:abcdefgjhijklmnopqrstuvwxyz123456
  1. 以 Windows 11 系统为例,打开与 frpc.exe 同目录的文件资源管理器窗口,单击右键选择 在终端打开 打开终端,粘贴上一步复制的命令行并回车,即可启动 LoliaFRP-CLI,连接成功后会显示类似如下的日志输出:
2:25AM INFO <client/control.go:205> LoliaFRP-CLI: [1145141919810] [1.abcdefgjhijklmnopqrstuvwxyz123456] 您可通过 114514.com:1145 访问您的服务
  1. 您可通过 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