
LoliaShizuku
「ロリア・雫」由 Wails 驱动的 Lolia FRP 第三方客户端
功能概览
- OAuth 登录
- 控制台数据看板(用户信息、流量、隧道、版本)
- 隧道列表与流量概览
- 本地 Runner 启停与日志查看
- 内置 frpc 安装/更新/移除
技术栈
- 后端:Go 1.24、Wails v2、OAuth2、系统 Keyring
- 前端:Vue 3、TypeScript、Vuetify、Pinia、Vite
环境要求
- Go
>= 1.24
- Bun(用于前端依赖与构建)
- Wails CLI
安装 Wails CLI:
go install github.com/wailsapp/wails/v2/cmd/wails@latest
本地开发
在仓库根目录运行:
wails dev
这会自动执行 bun install 并启动前后端开发环境(以 wails.json 为准)。
如果只调试前端:
cd frontend
bun install
bun run dev
构建
在仓库根目录运行:
wails build
OAuth 与认证说明
Token 存储在系统 Keyring(service: LoliaShizuku, key: oauth_token)
默认 OAuth 回调地址为 http://localhost:1145。
配置项(环境变量)
| 变量名 |
说明 |
默认值 |
LOLIA_CENTER_API_BASE_URL |
中心 API 基地址 |
https://api.lolia.link/api/v1 |
LOLIA_HTTP_USER_AGENT |
自定义请求 UA |
— |
LOLIA_OAUTH_CLIENT_ID |
OAuth Client ID |
— |
LOLIA_OAUTH_CLIENT_SECRET |
OAuth Client Secret |
— |
LOLIA_OAUTH_AUTHORIZE_URL |
OAuth 授权地址 |
https://dash.lolia.link/oauth/authorize |
LOLIA_OAUTH_TOKEN_URL |
OAuth Token 地址 |
https://api.lolia.link/api/v1/oauth2/token |
LOLIA_OAUTH_REDIRECT_URL |
OAuth 回调地址 |
http://localhost:1145 |
LOLIA_OAUTH_USE_PKCE |
启用 PKCE(0/false/no/off 关闭) |
开启 |
LOLIA_FRPC_REPO_OWNER |
frpc Release 仓库 Owner |
Lolia-FRP |
LOLIA_FRPC_REPO_NAME |
frpc Release 仓库名 |
lolia-frp |
frpc 本地目录
frpc 安装在 os.UserConfigDir()/LoliaShizuku/userdata/frpc/ 下,主要包括:
bin/:frpc 可执行文件
downloads/:下载缓存
installed.json:安装状态
settings.json:下载镜像设置
项目状态


许可证
本项目使用 MIT 许可证开源
感谢
LoliaFRP-CLI
FRP