# 首页 ## 什么是 LoliaFRP 洛链映射？ - 洛链映射是由 Lolia Team 与 安锐普世（北京）科技有限公司 & NYANLOLI LTD 联合发起的一项公益 FRP 项目，立志于为玩家与开发者提供免费、快速、稳定的 FRP 服务，助力玩家与开发者更好地连接联机或调试 - 节点多数由捐赠者捐赠，非常感谢捐赠者们的无私付出 ## 项目成员 - Mxmilu — 现任站长、前端开发、后端开发、客户端开发、运维管理、日常巡检 - Pysio — 前端开发、后端开发、运维管理 - SaltWood — 客户端开发、日常巡检 ## 联系方式 - 邮箱： - QQ 用户交流群：[975159586](https://qm.qq.com/q/P2Pz32dw4K){rel=""nofollow""} # RDP远程桌面 ::tip 本教程适用于 Windows 操作系统 :: ::caution 重要提醒 - **安全警告**：将端口暴露给公网，请务必注意安全，例如限制访问 IP、使用复杂密码、开启网络级别认证等措施来保护你的远程桌面服务 - **合法用途**：穿透服务只提供合法的数据转发服务，请勿用于任何非法用途，否则后果自负 - **责任声明**：如果因为远程桌面暴露于公网而遭到攻击，LoliaFRP 官方不承担任何责任，请务必做好安全防护措施 :: ## 一、启用 RDP 服务（以 Windows 11 为例） ### 1.1 打开 Windows 设置 在开始菜单中搜索"设置"来找到设置 :br![搜索示意](https://docs.lolia.link/tutorials/app/rdp/1.win-setting.webp) ### 1.2 进入远程桌面配置 点击左侧列表中的**系统**，在右侧的选项中找到**远程桌面** ::note 如果找不到远程桌面选项，可能是家庭版系统。微软默认没有给家庭版配置 RDP 服务。 :: ### 1.3 启用 RDP 服务 进入远程桌面的配置项中，点击**启用**，在弹出的窗口中点击**允许/确认**。此时的 RDP 服务监听的端口为 **3389**:br![展示图](https://docs.lolia.link/tutorials/app/rdp/2.example.webp) ## 二、创建隧道 ### 2.1 打开隧道创建页面 访问：{rel=""nofollow""} ### 2.2 选择隧道类型和节点 - 选择 **TCP隧道** - 选择想要穿透的节点 :br![隧道类型图](https://docs.lolia.link/tutorials/app/rdp/3.tunnel-type.webp) ### 2.3 填写隧道配置 - **本地IP**: `127.0.0.1` - **本地端口**: `3389` - **隧道名称**: （自定义） - **远程端口**: （自定义） 填写完成后点击**创建**:br![填写信息](https://docs.lolia.link/tutorials/app/rdp/4.local-ip-port.webp) ### 2.4 获取启动命令 创建隧道完成之后，在对应隧道的创建页面复制 LoliaFRP 的专属快捷启动命令，后续会用到 **示例命令：** ```bash ./frpc -t 0000:awcczj4i312ijx53wrp0b5e9757j20pea ``` ## 三、启动隧道服务 ### 3.1 下载客户端 本教程使用的是 **LoliaFRP-CLI** 客户端 ::info 下载地址： {rel=""nofollow""} :: 通常选择 **windows-amd64** 版本，下载完成后解压到任意目录下 ### 3.2 启动隧道 在文件管理器上方的路径中输入 `powershell` 并回车，即可打开命令行窗口 输入专属快捷启动命令 ### 3.3 验证启动状态 当看到如下的日志输出时，说明隧道启动成功（日志已做脱敏处理） ```text 6:42PM INFO LoliaFRP-CLI: [91afe940a3e] [49.f31d9c1650e34157912] 成功启动隧道 6:42PM INFO LoliaFRP-CLI: [91a40a3e] [49.f31d9c165d2797157912] 您可通过 42-8524z-1.q754245q.fan:35245235 访问您的服务 ``` ## 四、连接远程桌面 从日志/隧道详情页面中获取到的访问地址为远程桌面的实际访问地址（例如上文日志中的 `42-8524z-1.q754245q.fan:35245235` 就是远程访问地址） 可以使用以下工具进行连接： - Windows 自带的**远程桌面连接**工具（mstsc） - 支持 RDP 协议的其他应用程序 # Minecraft Java 局域网 ::tip 本教程适用于 Minecraft Java Edition（国际版） :: ::note Minecraft 局域网联机穿透通常需要安装辅助 Mod。关于是否需要辅助 Mod，可参考以下条件（参考于樱花FRP）： - 没有登录皮肤站或正版账号：需辅助 Mod - 有玩家使用离线登录（直接在启动器内设置用户名）：需辅助 Mod - 有玩家登录不同皮肤站账号：需辅助 Mod - 所有人都是正版账号：不需辅助 Mod - 所有人都登录同一皮肤站账号：不需辅助 Mod 在需要辅助 Mod 时未使用，通常会出现 `登录失败：无效会话（请尝试重启游戏及启动器）` :: ## 一、将本地世界开放到局域网 ::tip 从 Minecraft 1.19.3 开始，Mojang 支持在“对局域网开放”界面直接自定义端口。请根据您的游戏版本选择对应步骤。 :: ### 1.1 Minecraft 1.19.3 及以上版本 进入您的单人存档 按下键盘 `ESC` 打开菜单，点击 `对局域网开放`，进入 `局域网世界` 设置界面 ![局域网世界界面](https://docs.lolia.link/tutorials/game/mcjava/1.lan_settings_1.19.3.png) 填写一个端口号（如 `25565`）或留空，然后点击 `创建局域网世界` 当聊天框出现 `本地游戏已在端口[xxxxx]上开启` 时，记下该端口 ![局域网创建成功](https://docs.lolia.link/tutorials/game/mcjava/2.lan_started_1.19.3.png) ### 1.2 Minecraft 1.19.3 以下版本 进入您的单人存档。 按下键盘 `ESC` 打开菜单，点击 `对局域网开放`，进入 `局域网世界` 设置界面 ![局域网世界界面](https://docs.lolia.link/tutorials/game/mcjava/1.lan_settings_1.8.9.png) 点击 `创造一个局域网世界` 当聊天框出现 `本地游戏已在端口 xxxxx 上开启` 时，记下该端口 ![局域网创建成功](https://docs.lolia.link/tutorials/game/mcjava/2.lan_started_1.8.9.png) ## 二、创建隧道 ### 2.1 打开隧道创建页面 访问：{rel=""nofollow""} ### 2.2 选择隧道类型和节点 - 选择 **TCP隧道** - 选择想要穿透的节点 ![隧道类型图](https://docs.lolia.link/tutorials/game/mcjava/3.tunnel-type.webp) ### 2.3 填写隧道配置 - **本地IP**: `127.0.0.1` - **本地端口**: `上一步记录的局域网端口` - **隧道名称**: （自定义） - **远程端口**: `留空` 填写完成后点击**创建**。 :br![填写信息](https://docs.lolia.link/tutorials/game/mcjava/4.port_example.png) ## 三、启动隧道 ### 3.1 下载客户端 本教程使用 **LoliaShizuku** 客户端 ::info 下载地址： {rel=""nofollow""} :: 根据您的系统下载对应版本，解压后双击打开登录后进入主页面 ### 3.2 启动隧道 第一次启动需要下载 Frpc，下载即可 然后点击菜单栏 `隧道`，找到您的隧道，点击启动 ![客户端隧道页面](https://docs.lolia.link/tutorials/game/mcjava/5.lolia-shizuku-tunnel.png) ### 3.3 验证启动状态 当在 `frpc 运行日志` 看到类似如下日志时，表示隧道启动成功（示例日志已脱敏）： ```text 6:42PM INFO LoliaFRP-CLI: [91afe940a3e] [49.f31d9c1650e34157912] 成功启动隧道 6:42PM INFO LoliaFRP-CLI: [91a40a3e] [49.f31d9c165d2797157912] 您可通过 42-8524z-1.q754245q.fan:11451 访问您的服务 ``` ![客户端日志页面](https://docs.lolia.link/tutorials/game/mcjava/6.lolia-shizuku-runner.png) ## 四、让好友加入你的世界 1. 从启动日志或隧道详情页获取访问地址（例如 `42-8524z-1.q754245q.fan:11451`） 2. 好友打开 Minecraft Java，进入 `多人游戏` -> `添加服务器` 或 `直接连接` 3. 在服务器地址中填写上一步的访问地址并连接 ::note 如果无法连接，请确认： - 房主游戏仍在运行，且局域网世界未关闭 - LoliaFRP-CLI 客户端仍在线 - 隧道的本地端口与游戏实际开放端口一致 - 需要安装辅助 Mod :: # LoliaFrpClient ## LoliaFrpClient > 基于 [.NET 8.0](https://dotnet.microsoft.com/){rel=""nofollow""} 与 WinUI 3 构建的 **Lolia FRP** Windows 桌面客户端，为用户提供图形化的隧道管理与 frpc 核心控制体验。 ### 简介 LoliaFrpClient 是一款专为 Windows 平台设计的桌面应用，使用 .NET 8 与 WinUI 3 框架开发，通过 Lolia 官方 OAuth 授权接入，为用户提供可视化的 FRP 隧道管理能力，无需手动编辑配置文件或在命令行中启停进程。 ## 主要功能 - **隧道管理** — 查看、创建、启动和停止隧道 - **Frpc 管理** — 自动下载、安装和更新 frpc 核心 - **流量统计** — 实时查看流量使用情况和每日趋势图 ## 快速开始 ### 直接下载使用 前往 [GitHub Releases](https://github.com/SALTWOOD/LoliaFrpClient/releases){rel=""nofollow""} 下载最新版本，安装后即可直接运行。 ## 使用说明 1. **登录账户** — 在设置页面使用 OAuth 登录您的 LoliaFrp 账户 2. **安装 Frpc** — 首次使用需要在设置页面安装 frpc 核心 3. **管理隧道** — 在隧道列表页面查看和管理您的隧道 4. **启动隧道** — 选择隧道并点击启动按钮开始内网穿透 ## 许可证 本项目基于 [许可证](https://github.com/SALTWOOD/LoliaFrpClient/blob/main/LICENSE.txt){rel=""nofollow""} 开源 # LoliaShizuku ## LoliaShizuku「ロリア・雫」 > 由 [Wails](https://wails.io){rel=""nofollow""} 驱动的 **Lolia FRP** 第三方图形客户端，为 Lolia FRP 用户提供更便捷的隧道管理与本地 Runner 控制体验。 ### 简介 LoliaShizuku 是一款基于 Wails v2 框架构建的跨平台桌面应用，后端使用 Go 语言，前端采用 Vue 3 + Vuetify，通过 Lolia 官方 OAuth 授权接入，为用户提供可视化的 FRP 隧道管理能力，无需手动编辑配置文件或在命令行中启停进程 ## 主要功能 - **OAuth 登录** — 通过 Lolia 官方授权页面完成身份验证，Token 安全存储在系统 Keyring 中 - **控制台数据看板** — 一览用户信息、流量统计、隧道数量及版本信息 - **隧道列表与流量概览** — 查看全部隧道及其实时流量数据 - **本地 Runner 启停与日志** — 图形化控制 frpc 进程的启动/停止，并实时查看运行日志 - **内置 frpc 管理** — 一键安装、更新或移除本地 frpc 可执行文件 ## 快速开始 ### 直接下载使用 前往 [GitHub Releases](https://github.com/Mxmilu666/LoliaShizuku/releases){rel=""nofollow""} 下载对应平台的最新版本，解压后直接运行即可 ## frpc 本地文件结构 frpc 相关文件统一存放在系统配置目录下： ```text {os.UserConfigDir}/LoliaShizuku/userdata/frpc/ ├── bin/ # frpc 可执行文件 ├── downloads/ # 下载缓存 ├── installed.json # 安装状态记录 └── settings.json # 下载镜像配置 ``` ## 许可证 本项目基于 [MIT 许可证](https://github.com/Mxmilu666/LoliaShizuku/blob/main/LICENSE){rel=""nofollow""} 开源 # Lolia CLI ## 什么是 Lolia CLI？ - Lolia CLi 是由 Lolia Team 开发的命令行工具，可以让用户快速，简单，优雅的一键启动 LoliaFRP，无需复杂的配置和操作，适合所有用户使用 - 由上游 [gofrp](https://github.com/fatedier/frp){rel=""nofollow""} 项目 fork 而来，持续跟进上游版本更新，并添加了独特的新功能 ## 项目地址 - GitHub: {rel=""nofollow""} ## 使用方式 ### 下载客户端 1. 打开本项目的 GitHub 页面，进入 [Releases](https://github.com/Lolia-FRP/lolia-frp/releases){rel=""nofollow""} 页面，下载适合您操作系统的客户端版本 2. 解压下载的文件，找到 `frpc` 可执行文件, `frps` 为 LoliaFRP 的服务端程序，在这里不需要使用 ### 启动隧道 1. 在网页创建好面板后，点击复制 `连接配置` 中的 `使用 LoliaFRP-CLI 快捷启动` 命令行，如 ```shell ./frpc -t 114:abcdefgjhijklmnopqrstuvwxyz123456 ``` 2. 以 Windows 11 系统为例，打开与 `frpc.exe` 同目录的文件资源管理器窗口，单击右键选择 `在终端打开` 打开终端，粘贴上一步复制的命令行并回车，即可启动 LoliaFRP-CLI，连接成功后会显示类似如下的日志输出： ```shell 2:25AM INFO LoliaFRP-CLI: [1145141919810] [1.abcdefgjhijklmnopqrstuvwxyz123456] 您可通过 114514.com:1145 访问您的服务 ``` 3. 您可通过 `114514.com:1145` 访问您的服务了，恭喜您成功使用 LoliaFRP-CLI 启动了 LoliaFRP！ ## 进阶功能 我们不仅仅提供了快速启动的功能，还添加了一些实用的功能来提升用户体验： ### AutoTLS AutoTLS 是 LoliaFRP-CLI 提供的自动化证书管理功能，让您无需手动配置即可为服务启用 HTTPS #### 工作原理 在面板中开启 **AutoTLS** 并使用快捷启动时，客户端会在 **本地** 通过 `TLS-ALPN-01` 验证方式向 [Let's Encrypt](https://letsencrypt.org/){rel=""nofollow""} 自动申请证书并完成部署 #### 证书存储路径 使用快捷启动时，证书默认保存在以下路径： ```text 程序运行目录/.autotls-cache/ ``` ::callout{color="amber" icon="i-heroicons-exclamation-triangle"} **Docker 用户注意** ：请务必将 `.autotls-cache` 目录挂载为持久化卷，避免容器重建后重复申请证书。Let's Encrypt 对证书申请频率有限制，过量申请可能导致临时封禁。 :: #### 兼容其他 FRP 服务端 此功能同样支持原版 FRPS 及其他第三方 FRP 服务端。如需自行配置，请参考官方配置示例： :read-more{target="_blank" title="frpc_full_example.toml" to="https://github.com/Lolia-FRP/lolia-frp/blob/dev/conf/frpc_full_example.toml#L332"} ### 多隧道启动 您可以在 **单个 frpc 进程** 中同时启动多个不同节点的隧道，无需运行多个客户端实例。 #### 使用方式 **方式一：使用快捷启动参数** ```shell ./frpc -t 隧道id:节点TOKEN -t 隧道id:节点TOKEN ``` **方式二：使用配置文件** ```shell ./frpc -c 隧道1.yaml -c 隧道2.yaml ``` #### 兼容原版配置 我们完全兼容原版 frp 配置文件格式，您也可以搭配本客户端与自建 FRP 节点使用此功能。 ## Docker 部署 如果您更习惯使用容器化部署，我们也提供了官方 Docker 镜像。 ### 拉取镜像 ```shell docker pull ghcr.io/lolia-frp/loliacli-frpc:latest ``` ::callout{color="blue" icon="i-heroicons-arrow-down-tray"} **国内用户**：如遇拉取缓慢，可使用镜像加速： ```shell docker pull ghcr.milu.moe/lolia-frp/loliacli-frpc:latest ``` :: ### 快速启动 **使用快捷启动参数：** ```shell docker run -d --name loliafrp \ --network=host \ --restart=unless-stopped \ ghcr.io/lolia-frp/loliacli-frpc:latest \ -t 隧道id:节点TOKEN ``` ### 持久化证书（AutoTLS 用户） 如果启用了 AutoTLS 功能，请务必挂载证书缓存目录： ```shell docker run -d --name loliafrp \ --network=host \ --restart=unless-stopped \ -v /path/to/autotls-cache:/.autotls-cache \ ghcr.io/lolia-frp/loliacli-frpc:latest \ -t 隧道id:节点TOKEN ``` ::callout{color="blue" icon="i-heroicons-light-bulb"} **提示** ：将 `/path/to/autotls-cache` 替换为您本地的持久化目录路径，确保容器重建后证书不会丢失。 :: ### Docker Compose 创建 `docker-compose.yml` 文件： ```yaml services: loliafrp: image: ghcr.io/lolia-frp/loliacli-frpc:latest container_name: loliafrp network_mode: host restart: unless-stopped command: -t 隧道id:节点TOKEN ``` **启用 AutoTLS 时的配置：** ```yaml services: loliafrp: image: ghcr.io/lolia-frp/loliacli-frpc:latest container_name: loliafrp network_mode: host restart: unless-stopped command: -t 隧道id:节点TOKEN volumes: - ./autotls-cache:/.autotls-cache ``` 启动服务： ```shell docker compose up -d ``` # MCSManager FRP模板 ::tip 本项非 LoliaFRP 官方项目，若有问题请联系 [语千](https://github.com/yuqian114514){rel=""nofollow""} 或 加入交流群 [加入群聊MCSM FRP 模板集市吃土豆交流群 | 修BUG！](https://qm.qq.com/q/VV5ZbdmdiO){rel=""nofollow""} ，官方不接受使用 MCSManager FRP 模板的任何问题反馈 :: # MCSManager FRP模板集市 - MCSManager FRP模板集市是由 [语千](https://github.com/yuqian114514){rel=""nofollow""} 基于各大FRP厂商的命令行工具和 [MCSManager](https://github.com/MCSManager/MCSManager){rel=""nofollow""} 面板制作 - LoliaFRP CLI MCSManager 模板使用了由 Lolia Team 开发的命令行工具 [Lolia CLi](https://docs.lolia.link/client/cli/cli){rel=""nofollow""} 及 由 [语千](https://github.com/yuqian114514){rel=""nofollow""} 开发的 [专属命令行启动脚本](https://github.com/yuqian114514/mcsm-frp-market-sh_bat){rel=""nofollow""} 制作 ## MCSManager FRP模板集市项目链接 - [GitHub](https://github.com/yuqian114514/mcsm-frp-market){rel=""nofollow""} - [gitee](https://gitee.com/yuqian114514/mcsm-frp-market){rel=""nofollow""} - [gitea](https://gitea.com/yuqian114514/mcsm-frp-market){rel=""nofollow""} # MCSManager FRP模板集市部署 ## 部署MCSManager 没有部署MCSManager可前往 {rel=""nofollow""} 查看教程部署 ## 安装模板 > 💡 *如果已经安装过可跳过* 1. 前往您的 MCSManager 面板登录 2. 在面板侧边栏或顶部导航中，找到并点击 **「模版市场」** 3. 点击 **「编辑应用市场」** 按钮 4. 点击 **「操作」** → 选择 **「清空当前模板」** → 弹出确认框后点击 **「确认」** 5. 点击 **「导入」**→ 选择 **「从链接导入」** → 输入 下方 链接 → 确定 ```URL https://github.nswrz.cn/https://github.com/yuqian114514/mcsm-frp-market/raw/refs/heads/master/%E9%87%8D%E6%9E%84%E7%89%88/market.json ``` 6. 点击 **「保存到面板」** ## 安装Lolia CLI模板 1. 在模板市场找到 FRP 专区并选择你的服务器 2. 找到 LoliaFRP-CLI 模板安装 ## 启动Lolia CLI 1. 打开你的 MCSManager 面板，找到你刚安装的 Lolia-CLI 模板 2. 开启您的实例 3. 启动后会显示下方页面 输入2即可 ```shell ================ 授权方式 ================ 1) 本机运行 (自动打开浏览器并接收回调) 2) 云服务器/远程 (手动把浏览器地址栏 URL 粘贴回来) ========================================= 请选择授权方式 [默认 2]: ``` 4. 现在你应该看到了一串链接 ```shell [*] 请在【你自己电脑】的浏览器中打开以下链接完成授权: https://dash.lolia.link/oauth/authorize?xxxxxxxxxxxxxxxxxxxxxxx ``` 复制到浏览器打开 登录账号授权 5. 授权后浏览器会跳到 {rel=""nofollow""}?... 这个打不开的页面 把这一串链接复制到控制台输入 > 💡 *这个页面打不开是正常的* 6. 输入对应要开启的隧道数字 开启隧道 7. 您可通过 `114514.com:1145` 访问您的服务了，恭喜您成功使用 MCSManager FRP模板 启动了 LoliaFRP！ # 如何切换及重新启动 ## 如何进行重启启动隧道 1. 打开你的 MCSManager 面板，找到你刚安装的 Lolia-CLI 模板 2. 开启您的实例 3. 您会看见下方页面 此时输入 0 回车即可 ```shell =================================== 上次隧道: xxxxxxxxxxxxxxxxxxxxxxxxxxx =================================== 1) 启动上一次的隧道 2) 切换隧道 0) 退出 =================================== 请选择: ``` ## 如何切换隧道 1. 打开你的 MCSManager 面板，找到你刚安装的 Lolia-CLI 模板 2. 开启您的实例 3. 您会看见下方页面 此时输入 2 回车 ```shell =================================== 上次隧道: xxxxxxxxxxxxxxxxxxxxxxxxxxx =================================== 1) 启动上一次的隧道 2) 切换隧道 0) 退出 =================================== 请选择: ``` 4. 输入对应要开启的隧道数字 开启隧道 # 仪表盘 ## 可用流量 - 显示当前可用流量，单位为 GB。签到成功后会自动更新。 ## 限制带宽 - 显示当前限制带宽，单位为 Mbps。 ## 隧道数 / 可用隧道数 - 显示当前已经创建的隧道数，以及账户的总可用隧道数。 ## 在线隧道数 - 显示当前在线的隧道数。 ## 近七天流量使用 - 显示近七天的流量使用情况，单位为 GB，数据仅供参考。 ## 隧道列表 - 显示当前已经创建的隧道，包含隧道名称、隧道 ID、协议、状态、节点和对隧道的快捷操作。点击操作按钮后会进入对应隧道的详细页面 # 隧道管理 ## 视图 ### 列表视图 展示隧道的基本信息和状态，提供对隧道的管理和操作。点击操作后会进入到隧道的详细信息页面。 ## 查看隧道信息 点击对应隧道的操作按钮 ### 隧道概要信息 | 概要数据 | 说明 | | ------ | ------------------------------- | | 已使用流量 | 当前隧道所消耗的流量 | | 当前连接数 | 当隧道在线时，显示当前隧道的连接数。若隧道不在线，则显示"0" | | 最近活跃时间 | 显示当前隧道的最近活跃时间，通常为隧道最后一次在线时间 | ### 基本信息 | 字段 | 说明 | | ------- | ----------------------- | | 隧道ID | 隧道的 ID | | 隧道名称 | 隧道的名称 | | 隧道类型 | 隧道所使用协议 | | 所属节点 | 隧道所使用的节点 | | FRPC 版本 | 隧道所使用的 FRPC 版本 | | 创建时间 | 隧道的创建时间 | | 最近活跃时间 | 隧道的最近活跃时间，通常为隧道最后一次在线时间 | ### 配置信息 | 字段 | 说明 | | ---- | ------------------------- | | 本地IP | 隧道所监听的 IP | | 本地端口 | 隧道所监听的端口 | | 远程地址 | 隧道所连接的远程地址，此处是实际访问地址 | | 带宽显示 | 隧道可达到的最大理论带宽，实际带宽会取决于网络情况 | ### 连接配置 此处提供两种连接方式的配置信息。以下两种方式均在右上角提供了复制按钮，方便用户快速复制。 - LoliaFRP—CLI的快捷启动信息。 - 原版 FRPC TOML 配置。 ### 危险操作 此处提供了删除隧道的按钮，删除后将无法恢复，请谨慎操作！ # 隧道创建 根据您的需要来创建所需的隧道，创建成功后会自动进入隧道的详细信息页面。 ## 选择隧道类型 我们提供了三种隧道类型，分别为 TCP、UDP 和 HTTP，您可以根据需要选择合适的隧道类型。 > **警告：禁止使用TCP隧道类型穿透HTTP/HTTPS内容，我们使用审查系统进行封禁。** - 小提示为隧道的简要介绍和使用建议。 - 若需要穿透HTTP/HTTPS内容，请使用HTTP隧道类型。同时，如果需要在中国大陆上使用HTTP隧道，则域名必须为备案域名。(部分节点只能使用特定的备案接入商的备案，例如阿里云的节点需要阿里云的接入备案，详情请联系管理员咨询) - 严禁穿透如下业务，管理团队保留最终解释权并且如实提供相关部门调查所需的用户信息： - 任何违法违规内容 - 任何侵犯他人合法权益的内容 - 任何违反社会公德的内容 - 任何危害国家安全的内容 - 任何其他违反相关法律法规的内容 - 虚拟组网服务及其中继转发服务，例如 ZeroTier、Tailscale 等 - 虚拟代理服务，例如 Shadowsocks、ShadowsocksR、Trojan 等 - 任何其他被管理团队认定为不适合穿透的内容 ## 选择节点 我们提供了多个节点供您选择，您可以根据需要选择合适的节点。部分节点不支持 UDP 或建站（HTTP），且有些节点需要实名认证方可使用 支持按照隧道类型进行筛选 ## 节点信息卡片 每个节点的信息卡片包含以下信息： - 节点名称 - 节点实名需求 - 节点状态 - 节点带宽 - 节点捐赠者 - 节点备注 - 节点支持的隧道类型（对应的类型为灰色表示不支持此隧道类型） ## 基础参数 下方的参数说明卡片有简要介绍 ### 本地服务 - 本地 IP：需要映射的本地服务的 IP 地址，默认为127.0.0.1 - 本地端口：需要映射的本地端口，需要是一个有效的端口号，范围为1-65535 ### 远程服务 - 隧道名称：为隧道设置一个易于识别的名称，便于管理和区分不同的隧道 - 远程端口：远程访问的端口号，范围为1-65535。留空则由系统随机分配一个可用端口 ## 选择摘要 此卡片为创建隧道信息的摘要，包含以下信息： - 隧道名称 - 隧道类型 - 目标节点 - 节点能力 - 实名认证 :br 当您确认隧道的信息无误后请点击创建按钮，创建成功后会自动进入隧道的详细信息页面，同时右下角会有提示隧道创建成功。 # 域名白名单 ## 域名白名单 在输入框中输入目标域名，要求为合法的二级域名，且不包含协议部分（如 http\:// 或 https\://）。例如 `example.com` ## 已添加域名 - 此处展示已经添加到白名单中的域名列表，包含域名和状态等信息 - 在上方添加完成域名后，会展示需要添加的验证信息，请将验证信息添加到对应域名的 DNS 记录中，记录类型为 TXT，等待 DNS 记录生效后点击刷新验证按钮，验证成功后该域名就可以在创建 HTTP 隧道时选择了。 - 在完成域名验证后，域名状态会变更为“已生效”，同时在域名后方会显示该域名是否已备案的标记。当前请联系管理员手动进行备案审查，只有标记为“已备案”的域名才能在中国大陆节点上创建 HTTP 隧道。（注意：部分节点需要特定接入商的备案，此处仅表示该域名已在工信部登记备案） # 应用管理 # 创建应用 # 授权管理 # 基础设置 # 安全性 # 常见问题 ## 连接稳定性 ### 上线显示 EOF 与 session shutdown TLS 的 SNI 被 RST 导致，解决方案：在配置中添加 `transport.tls.serverName = " "`（将 SNI 置为空格）。**Lolia-CLI** 快速启动配置已内置此选项，使用原版 frpc 请手动添加 ### 境内节点连接不稳定 受运营商 QOS 影响，晚高峰或跨运营商连接时可能不稳定，我们无法干预。建议： - 优先选择 **BGP 节点**或**同运营商节点** - 支持 KCP 的节点可切换至 **KCP 连接**改善稳定性 ### 境外节点连接不稳定 海外链路质量不佳所致，建议优先选择**境内节点**，或选择地理上更近的节点 --- ## 功能与使用限制 ### 支持哪些功能 支持所有上游 gofrp 功能，以下除外： `STCP & SUDP`、`XTCP`、`TCPMUX`、`VirtualNet`、`SSH Tunnel Gateway` 详见 [gofrp 官方文档](https://gofrp.org){rel=""nofollow""} ### 为什么境内节点无法搭建网站 禁止境内节点通过 TCP 隧道搭建 HTTP/HTTPS 网站，请改用**境外节点** --- ## 客户端运行与防火墙问题 ::tip 温馨提示：如果您在使用图形化客户端（如\:LoliaFrpClient）请先在设置页面安装 frpc 核心，再去启动隧道，如果还是启动失败，不妨再往下看。 :: ### frpc 被本地杀毒软件（Windows Defender 等）误报隔离怎么办？ 这是常见误报，软件本身是安全的，请放心使用。 **解决步骤：** 1. **从隔离区恢复文件** - 打开 Windows 安全中心 → “病毒和威胁防护” → “保护历史记录” - 找到被隔离的 frpc 记录，点击“操作” → “允许在设备上” 2. **第三方杀毒软件**（360、卡巴斯基等） - 若第三方杀毒找到“信任区”或“排除项”功能，将 `frpc.exe` 或整个文件夹加入白名单 > Windows 11 用户若启用了“智能应用控制”，可能需暂时关闭该功能，或添加排除项后仍无法运行，可尝试关闭“智能应用控制”。 ### 启动时出现“文件包含病毒”等错误提示怎么办？ 当您尝试启动时，可能会遇到以下错误信息： - **“无法成功完成操作，因为文件包含病毒或潜在的垃圾软件。”** - **“Windows 无法访问指定设备、路径或文件。你可能没有适当的权限访问该项目。”** - **“此程序已被组策略阻止。”** - **“操作无法完成，因为文件包含病毒。”** - **“找不到指定的文件”**（文件已被隔离删除） - **“拒绝访问”**（文件被安全软件锁定） **这些提示均表示文件已被杀毒软件隔离/删除，并非程序本身损坏。** **解决方法：** 1. 先检查杀毒软件隔离区，将文件恢复（步骤同上节）。 2. 如果文件已被彻底删除，需重新下载并先添加文件夹白名单，再运行。 ### 启动器下载被 Microsoft Defender SmartScreen 拦截怎么办？ 如果您使用 Edge 浏览器下载启动器，可能会看到提示： > **LoliaShizuku.exe（或其他） 已被 Microsoft Defender SmartScreen 当作可能不需要的应用加以阻止** 这是 SmartScreen 对未知发布者的常见保护机制。 **解决方法：** 1. **在 Edge 下载时手动保留** - 下载被阻止后，在浏览器下载列表中点击“三个点” → “保留” → “仍然保留”。 2. **如果文件已被删除，可重新下载并选择“保留”** - 重新下载时，留意浏览器底部的提示，点击“保留”而非“删除”。 > 请始终从官方渠道下载启动器，确保文件安全可靠。 --- ## 带宽与计费 ### 限速规则 - 所有用户**单隧道**限速 80Mbps - 捐赠者可解除限速限制 ### 配置文件中限速为何低于实际限速 当**节点物理带宽**小于**用户限速**时，以节点物理带宽为准。换算时（Mbps → MB/s）会向上取整，保证实际上限不低于原始值 ### 为什么节点这么少 我们作为一个公益项目，大部分节点都是由捐赠者提供的，我们无法强制要求更多的人提供节点，所以目前的节点数量有限，我们会尽力增加更多的节点，但这需要时间与资源，我们也欢迎更多的捐赠者加入我们，提供更多的节点 --- ## 账号认证 ### 支持未成年人实名认证吗 支持，但请勿冒用他人身份证信息 ### 没有在支付宝实名过，能通过认证吗 不能，必须是**支付宝实名用户**才可通过身份认证 ### 为什么实名认证需要收费 费用由支付宝收取，详见： - [支付宝身份验证收费表](https://opendocs.alipay.com/open/009yj1){rel=""nofollow""} - [支付宝电脑支付费率](https://opendocs.alipay.com/open/270/105898){rel=""nofollow""} --- ## 其他 ### 我想要反馈 BUG / 提出意见，我该去哪里反馈 请加入[官方群组](https://docs.lolia.link/community){rel=""nofollow""}或发送邮件至 **** ### 怎么捐赠节点？ 同上，加入群组后联系管理员即可 ### 为什么入群被拒绝了 请善用搜索引擎。 ### 感觉不如 xxxxFRP 好用 嗯。 # 官方群组 ## QQ 群 - QQ 用户交流群：[975159586](https://qm.qq.com/q/P2Pz32dw4K){rel=""nofollow""} ## 其他渠道 敬请期待... # LoliaFRP Open API ## 什么是 LoliaFRP Open API？ - LoliaFRP Open API 是 LoliaFRP 官方提供的开放接口，允许开发者通过编程方式与 LoliaFRP 平台进行交互 - 您可以使用 API 来管理隧道、查询流量统计、获取节点信息等，非常适合自动化运维或开发第三方客户端 ## API 文档 :read-more{target="_blank" title="LoliaFRP Open API 文档" to="https://api-docs.lolia.link/"} ## 基础信息 | 项目 | 值 | | ---- | ------------------------------- | | 基础地址 | `https://api.lolia.link/api/v1` | | 文档地址 | `https://api-docs.lolia.link/` | | 数据格式 | JSON | ## 鉴权方式 **我们推荐使用 OAuth2 进行 LoliaFRP Open API 鉴权** ### OAuth2 鉴权（推荐） OAuth2 是最安全且推荐的鉴权方式，适用于第三方应用接入 LoliaFRP 平台 ::callout{color="green" icon="i-heroicons-check-circle"} **推荐理由** ：OAuth2 可以让用户安全地授权第三方应用访问其 LoliaFRP 账户，无需直接暴露用户凭证，同时支持细粒度的权限控制 :: [OAuth2 鉴权详细指南](https://docs.lolia.link/developers/oauth) ::callout{color="blue" icon="i-heroicons-book-open"} **更多示例** ：完整的 API 文档和各语言示例代码请访问 [API 文档](https://api-docs.lolia.link/){rel=""nofollow""} :: # OAuth2 鉴权 ## 概述 LoliaFRP Open API 支持标准的 **OAuth2 Authorization Code** 授权码模式 ::callout{color="green" icon="i-heroicons-shield-check"} **安全优势** ：使用 OAuth2，用户可以随时撤销对第三方应用的授权，且第三方应用永远无法获取用户的登录凭证 :: ## 端点信息 | 端点 | 地址 | | -------- | -------------------------------------------- | | 授权端点 | `https://dash.lolia.link/oauth/authorize` | | Token 端点 | `https://api.lolia.link/api/v1/oauth2/token` | ## 权限范围（Scope） | Scope | 说明 | | -------------- | ---------- | | `user:read` | 读取用户基本信息 | | `tunnel:read` | 读取隧道信息 | | `tunnel:write` | 创建/修改/删除隧道 | | `traffic:read` | 读取流量统计 | | `domain:read` | 读取域名信息 | | `domain:write` | 创建/修改/删除域名 | | `node:read` | 读取节点信息 | | `all` | 完全访问权限 | ::callout{color="amber" icon="i-heroicons-exclamation-triangle"} **注意** ： `all` 权限将授予应用完全访问权限，请谨慎使用 :: ## 相关文档 [LoliaFRP Open API 文档](https://docs.lolia.link/developers/openapi) [OAuth 2.0 官方文档](https://oauth.net/2/){rel=""nofollow""} [RFC 6749 - OAuth 2.0 授权框架](https://www.rfc-editor.org/rfc/rfc6749){rel=""nofollow""} [小米 OAuth2.0 协议原理](https://dev.mi.com/console/doc/detail?pId=711){rel=""nofollow""} # 首页 ::u-page-hero --- class: dark:bg-gradient-to-b from-neutral-900 to-neutral-950 orientation: horizontal --- ```bash [terminal] lolia-cli -t 114:abcdefgjhijklmnopqrstuvwxyz123456 __ ___ __________ ____ ________ ____ / / ____ / (_)___ _/ ____/ __ \/ __ \ / ____/ / / _/ / / / __ \/ / / __ `/ /_ / /_/ / /_/ /_____/ / / / / / / /___/ /_/ / / / /_/ / __/ / _, _/ ____/_____/ /___/ /____/ / /_____/\____/_/_/\__,_/_/ /_/ |_/_/ \____/_____/___/ 2:25AM INFO LoliaFRP-CLI: Nya! LoliaFRP-CLI 0.67.0 启动中 2:25AM INFO LoliaFRP-CLI: 已获取到配置文件 隧道名称=MC 联机 使用节点=阿里云杭州-1 2:25AM INFO LoliaFRP-CLI: 尝试连接到服务器... 2:25AM INFO LoliaFRP-CLI: [1145141919810] 登录服务器成功, 获取 run id [1145141919810] 2:25AM INFO LoliaFRP-CLI: [1145141919810] 添加隧道: [1.abcdefgjhijklmnopqrstuvwxyz123456] 2:25AM INFO LoliaFRP-CLI: [1145141919810] [1.abcdefgjhijklmnopqrstuvwxyz123456] 成功启动隧道 2:25AM INFO LoliaFRP-CLI: [1145141919810] [1.abcdefgjhijklmnopqrstuvwxyz123456] 您可通过 114514.com:1145 访问您的服务 ``` #top :hero-background #title LoliaFRP [Documentation]{.text-primary} #description 在这里你可以找到关于 LoliaFRP 的文档，包括客户端，使用教程，注意事项等等 #links :::u-button --- size: xl to: https://docs.lolia.link/getting-started trailing-icon: i-lucide-arrow-right --- 开始阅读 ::: :::u-button --- color: neutral size: xl target: _blank to: https://lolia.link trailing-icon: i-lucide-arrow-right variant: outline --- 访问官网 ::: :: ::u-page-section --- class: dark:bg-neutral-950 --- #title 为什么选择 LoliaFRP #links :::u-button --- color: neutral size: lg target: _blank to: https://lolia.link trailingIcon: i-lucide-arrow-right variant: subtle --- 访问官网 ::: #features :::u-page-feature --- icon: i-lucide-server --- #title 多节点覆盖 #description 由社区贡献者捐赠的国内外多个节点可选，根据您的需求选择最佳服务器位置 ::: :::u-page-feature --- icon: i-lucide-rocket --- #title 快速部署 #description 下载客户端，填入配置，即可在几分钟内完成内网穿透部署 ::: :::u-page-feature --- icon: i-lucide-users --- #title 社区支持 #description 活跃的用户社区，遇到问题可以快速获得帮助和解决方案 ::: :::u-page-feature --- icon: i-lucide-headphones --- #title 技术支持 #description 提供在线客服和文档支持，帮助您解决使用中遇到的各种问题 ::: :::u-page-feature --- icon: i-lucide-smartphone --- #title 多平台客户端 #description 支持 Windows、Linux、macOS 等多个平台，随时随地进行穿透 ::: :::u-page-feature --- icon: i-lucide-refresh-cw --- #title 持续更新 #description 由 Lolia Team 持续更新上游 FRPC 版本，不断优化性能和添加独特新功能 ::: ::