现在搞活动还能免费领，链接：http://s.tb.cn/e6.0DENEf

项目架构更新

第三代乐青映射的技术栈为：

• 前端
  • Nuxt.js
  • Vue.js
• 后端
  • Spring Boot
  • Spring Cloud

网页面板

• 使用 Nuxt.js 框架进行了重写
• 从 CSR 切换到了 SSG，加载面板更快，性能更好
• 经过重新设计的 UI/UX，带来更方便的操作，更人性化的体验
• 彻底移除了 Axios，使用 ofetch 作为网络请求库

后端

• 完全重写，并规范了命名空间
• 几乎全部使用 Kotlin，增加开发效率，并减少空指针导致可能的异常
• 使用 Gradle Version Catalog 进行依赖管理，减少可能的依赖问题
• 引入了 Spring Cloud Eureka 微服务架构，为集群化部署进行了适配
• 对后端进行了模块化

数据库

• 从 MySQL 更换为了 PostgreSQL + TimescaleDB
• 对数据库结构进行了完全的重新设计，完全抛弃 Sakura Panel 的数据库格式

软件更新

• 将 Frp 从 0.51.3 版本更新到了 0.62.1 版本
• 将 Controller 移植到了非 Linux 客户端

其他更新

• 支持了港澳台证件进行身份认证
• 对用户组功能进行了重新设计
• 暂时移除了没有任何用的联机功能，后续会重新加入
• 加入了 TOML、YAML、JSON 配置的支持，移除了 INI 配置
• 引入了 Umami 统计

计划中（未完成更新）

• 通行密钥登录
• HTTP2HTTPS 自动配置

更多未列出事项，可以在 GitHub Issue Tracker 查看。

LoCyanFrpFrontend#1

1. 下载微软签名的 PreLoader.efi HashTool.efi https://blog.hansenpartnership.com/linux-foundation-secure-boot-system-released/
2. 准备一个可以读写 EFI 分区的软件（此处为 DiskGenius）
3. 确认你的磁盘格式支持安全启动
4. 一点耐心

操作步骤

将 PreLoader 和 HashTool 复制到 rEFInd 可启动项的目录

根据你实际放置的位置来，我的是 \EFI\refind，将这两个文件拷到里面即可。

复制 rEFInd 的可启动项文件

复制一份 rEFInd 的可启动项文件，比如我的是 refind_x64.efi，复制成 loader.efi。

添加 UEFI BIOS 启动项

DiskGenius 菜单栏，工具 -> 设置UEFI BIOS启动项 添加一个新的启动项，路径为刚才复制过去的 PreLoader.efi。
将启动项移动到最顶上（第一个启动的），保存。

重启设备，进入 BIOS 设置

进入你的主板 BIOS 设置，如果你不知道怎么按键盘进入那在上一步勾上下面 下次启动时直接进入UEFI BIOS设置界面（仅一次），然后点击 立即重启。

在 安全（Security）设置找到 安全启动（Secure Boot）设置，改为 开启（Enabled）。
在最后一个选项卡保存并重启（Save & Reset(有的是 Save & Restart)）。

使用 HashTool 导入 Hash

这个时候你应该会看到一个蓝色的屏幕，并显示如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

┌──────────────────────────────────────────────────────────────────────────────┐
│                            Failed to start loader                            │
│                                                                              │
│          It should be called loader.efi (in the current directory)           │
│                     Please enrol its hash and try again                      │
│                                                                              │
│                I will now execute HashTool for you to do this                │
│                                                                              │
│                                                                              │
│                                     ┌────┐                                   │
│                                     │ OK │                                   │
│                                     └────┘                                   │  
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

此时按回车，显示如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

┌──────────────────────────────────────────────────────────────────────────────┐
│                                Select Binary                                 │
│                                                                              │
│               The Selected Binary will have its hash Enrolled                │
│            This means it will Subsequently Boot with no prompting            │
│    Remember to make sure it is a genuine binary before Enroling its hash     │
│                                                                              │
│                                                                              │
│                            ┌─────────────────────┐                           │
│                            │     Enroll Hash     │                           │
│                            │ Reboot to UEFI Menu │                           │
│                            │    Reboot System    │                           │
│                            │        Exit         │                           │
│                            └─────────────────────┘                           │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

使用键盘上的上下按键，切换到 Enroll Hash，回车。
此时应该显示为：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

┌──────────────────────────────────────────────────────────────────────────────┐
│                                Select Binary                                 │
│                                                                              │
│               The Selected Binary will have its hash Enrolled                │
│            This means it will Subsequently Boot with no prompting            │
│    Remember to make sure it is a genuine binary before Enroling its hash     │
│                                                                              │
│                                                                              │
│                                ┌──────────────┐                              │
│                                │     EFI/     │                              │
│                                │    (More)    │                              │
│                                └──────────────┘                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

选择你要导入的启动项，我们这里要选择导入我们刚刚复制的 loader.efi，使用上下按键和回车来操作确认。
如果选择了文件应该会显示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

┌──────────────────────────────────────────────────────────────────────────────┐
│                      Enroll this hash into MOK database?                     │
│                                                                              │
│                         File: \EFI\rEFInd\loader.efi                         │
│     Hash: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX   │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                     ┌─────┐                                  │
│                                     │ No  │                                  │
│                                     │ Yes │                                  │
│                                     └─────┘                                  │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

选择 Yes，回车。
等待导入完毕后，还要同样的操作导入其他 rEFInd 下引导的可启动项，然后重启电脑，你应该就可以正常进入了。

排查网络

首先你要先确认一下你的设备网络是不是有问题，能不能正常连 EA 服务器，不行开个代理或者加速器。
看 EA App 是否在线就行。

重置系统代理

网络和 Internet -> 代理设置 看一下是不是有系统代理，有的话清除一下。

关掉 VPN 软件

如果你安装了 VPN 软件，先尝试关掉，能否正常启动。

关掉杀毒软件

有的杀毒软件会导致这个问题，关掉尝试能不能启动。

重置网络适配器

网络和 Internet -> 高级网络设置 -> 网络重置 重置一下网络适配器。

同时重置各种网络配置服务的方法

如果重置网络适配器没用，可以试试以管理员权限运行 cmd，然后运行下面的这些命令重置其他网络服务：

1
2
3
4
5
6

netsh winsock reset
netsh int ip reset
netsh advfirewall reset
netsh winhttp reset proxy
ipconfig /release
ipconfig /flushdns

执行过后需要重启电脑。

如果上面的方法执行之后游戏连反作弊那个加载屏幕也没弹出来先去把 EA App 卸载了，然后重新安装，如果你和我一样是 Steam 买的卸载后在游戏上右键，属性 -> 已安装文件 校验游戏文件完整性，然后重新开游戏安装。

解决方法是把协议从 lb:// 改为 lb:ws(s)://

1
2
3
4
5
6
7
8
9
10
11
12

spring:
  cloud:
    gateway:
      server:
        webflux:
          routes:
            - id: api-service
              uri: lb:ws://API # <-- Here
              predicates:
                - Path=/default/**
              filters:
                - StripPrefix=1

class org.apache.catalina.connector.ResponseFacade cannot be cast to class reactor.netty.http.server.HttpServerResponse (org.apache.catalina.connector.ResponseFacade and reactor.netty.http.server.HttpServerResponse are in unnamed module of loader ‘app’)

参见 spring-cloud/spring-cloud-gateway#2039

依赖冲突，我这里是 spring-boot-starter-web 引入了 Tomcat Embed Core 导致 Gateway 使用 Tomcat 而不是 Netty，解决方案是排除依赖项：

1
2
3
4
5

dependencies {
    implementation(rootProject.libs.spring.boot.starter.web) {
        exclude(group = "org.apache.tomcat.embed", module = "tomcat-embed-core") // <-- Here
    }
}

可以使用命令

1	./gradlew <项目>:dependencies --configuration runtimeClasspath > dependencies_runtime.txt

输出运行时依赖关系，查找是哪个依赖引入了 Tomcat Embed Core

我是 LoCyanFrp 的现任站长，夏沫花火zzz🌙。
过去的两年间，LoCyanFrp 完成了大量的升级，正式发布了第二版，并得到了广大领域用户的青睐。

我们一直牢记我们的初衷，秉承着一颗做公益的心，维护着 LoCyanFrp。三年间，LoCyanFrp 一直保持着全公益的运营模式。
在这片文章里，我想谈谈我对 LoCyanFrp 接下来的规划，以及进行一部分答疑。

现状

LoCyanFrp 从 2022 年 4 月起，一直运营至今。如你所见的，我们一直是全公益的运营模式。
尽管期间我们遇到了一些难点，但是我们没有放弃，没有选择跑路，也没有选择改变为商业运营模式。

迄今为止，我们已经成为业内第四大的 Frp 内网穿透服务（按服务用户量计数）。我们拥有将近 30k 的用户，用户创建过 104k 以上的隧道，每个月传输 TB 级别的数据，与官网宣传的保守统计不同，我们实经传输数据量可能超过 100 TB。
在三年来，我们为用户提供了尽可能稳定，低成本的流量穿透服务。

稳定的背后

海量的数据传输，意味着对服务的可靠性的依赖。我们拥有着上万的用户，我们是如何保障我们的服务的呢？请听我道来。

首先，我们基于 Frp，由于 Go 语言有着在 IO 上的一些优势，使得我们的服务能够拥有优异的包转发性能，能够为用户带来高效的流量穿透。当然，也有其他语言在网络传输上具备先天优势，不过我们最开始是基于现成方案制作的，所以一直沿用至今。
其次，我们通过使用 Spring 框架自研后端，借助 JVM 和 Spring 的性能和调度优势，我们的后端每天处理超过 600k 的请求量，也丝毫不显逊色。
通过结合两者，我们实现了一套高效的系统，为用户提供更好的体验。

然而，光有性能是不够的。

或许用过同类产品的用户可能遇到过这种尴尬情况：由于主控服务器挂了或者维护，导致节点服务无法获取数据，从而无法正常使用服务或启动节点服务器。
我们的节点服务则不同，在设计上便可离线运行，即使主控服务器离线，也能维护现有状态运转或启动。通过这样的设计，即使我们对主控服务器进行维护，也不会影响节点端的运作。

另外的，为了保障我们的服务不受渗透攻击、拒绝服务攻击（DDoS）、泛洪攻击的影响，我们对全部业务采用容器化部署方式，且具备完善的 WAF 规则，可拦截大部分恶意流量，并且我们使用了 高防服务器 + 安全加速 的组合，有效防护 DDoS 和 CC 等常见攻击手段，并实现了全球的高速访问。我们在后端上也做了严格的权限控制，并在近年接入了人机验证、行为检测等技术，且实现了 OAuth 2.0 以精细化对权限的控制并进一步控制 API 访问，有效保护用户的账户数据。

感谢这些服务商，它们为我们的服务提供了高速稳定的服务（不分先后）：

• 阿里云
• 括彩智能 CDN
• 木韩网络
• 火山引擎
• 百度智能云
• Cloudflare
• 湖南裕米云数据科技有限公司
• 武汉新软科技有限公司

感谢这些产品为我们提供了高效的服务器管理和解决方案：

• 1Panel
• JumpServer

LoCyanFrp，还会有下一代吗

LoCyanFrp 目前看来是一个很完善的平台，它拥有自研的前后端面板和节点控制程序，并具备强大的服务能力。
但事情并不会这么简单，我们还有很多没完成的事情要做。在不久的将来，我们会一一实现我们的 TODO，真正做一个用户友好的、功能健全的穿透平台。所以，先不要着急，在下一步我们并不打算推出 LoCyanFrp 3，因为这是极其不负责任的——我们还有很多的事情要做，还有很多能够做的更好的地方，既然如此，又为何着急心切推出一个全新的大版本？

或许 LoCyanFrp 会有下一代，但不是现在，也不是不久后。

关于技术栈的选择

或许有一些开发者会好奇，为什么我们会选择 Spring，而不是 Gin，明明 Frp 本身就是 Go 写的，同样的技术栈不是更好维护吗？
事情并没有看起来这么简单。

首先我们先来谈谈，为什么选择了 Spring。

如你所见，Spring 是一个老牌的框架，你别看它老，正因为老，经过了无数使用者的考验，我们才选择了 Spring。我可以直接举一个例子：淘宝。淘宝的后端最初是 PHP 写的，但最后还是转向了 Spring。与 PHP 比，Spring 具备更完善的 REST API 实现，更高效的处理方式和更完善的生态链。不只是淘宝，阿里系的大部分产品都使用了 Spring。

另外的，Spring 具备有一套完整的分层，如控制层、服务层等，在每一层开发无需关心其他层的实现，这是选择 Spring 的理由之一。
以及，Java 在学习难度和上手难度上，对新手是比较友好的，无需很深入的理解，就能够写出一套完整的服务。我们的原站长刚开始编写第二代 LCF 后端时并不会 Java，他也能写的有模有样的。

Spring AOP 为我们提供了一个相对于中间件更强大的剖面系统，可以让我们根据需求打造不同的功能。

基于如上还有很多其他考量，我们选择了 Spring 而不是其他技术栈。

接下来，让我们谈谈其他技术栈。

为什么不是 Go 的 Gin？

Gin 固然是一个优秀的框架，但经过考量我们最终没有选择 Gin。

首先，Go 与大多数语言不同，它的错误处理有些独特。对于习惯了 try...catch 的我来说，转换到 Go 语言的错误处理思路非常不友好。以及 Go 脆弱的稳定性：我只是不小心写错了非常小的一个逻辑，你却让我的服务整个“panic”，造成整个程序的崩溃，进而导致整个服务体系崩溃，这很明显有违我们保障服务稳定性的初衷。尽管 Gin 提供了统一的错误处理机制，但你如何保证其他部分一定不会 panic？
其次的，我们开发组里面对 Go 的了解程度并不深。老实说，我以前完全没有接触过 Go，对语法一概不知，也没有任何实操经验。而我做过一些 Java / Kotlin 的开发，对于选择一个毫无把握的语言和框架作为服务基础，我是做不到的。当然我们的友商也有在使用 Go + Gin 的方案，不是说不好，而是不适合我们。

以及，我真的很不喜欢 Go 的 public 和 private 机制和命名法。

那，其他的呢

有人和我们提过其他语言，最多的当属 Rust 了吧。

我倒要好好说一说为什么不使用 Rust。

Rust 凭借自身的优势和各种其他因素，似乎受到很多开发者的追捧。
但我并不喜欢这门语言。我没有写过 C/C++ 这类较为低级的语言，主要还是写一些中级和高级语言，Rust 的语法对我来说非常不友好。
另外的，Rust 自开发组一直到社区的高傲的态度，实在无法令我接受。或许 Rust 是一门好的语言，抑或是高效的语言，但我无法认同它——我遇到过不少的开发者，无脑的吹捧 Rust，并一踩一捧的贬低其他语言，或是故意引战。
况且，Rust 给我的感觉，并不是一门稳定或者具备有企业级能力的语言，至少现在不是。如果你直接和我提起 Rust，我想不到一个完善的 Web 框架的名字，但 Java 和 Go 我起码能想到一个或两个。哪怕是 Node.js，我也能想到 Express 亦或是 Koa 这些框架。基于这个原因，Rust 成功的被 pass 掉了。
我们可能会用 Rust 做启动器，但不会用，至少现在不不会它来做后端。

上面提到了 Node.js，如果你问我为什么不用，那我会和你说，我们有部分开发成员代码习惯并不好，写 JS 的话后续因为动态类型绝对会炸。什么？你和我说 TypeScript？如果你很喜欢做类型体操，那我也不反对，但是我不想要在我的代码里包含如此多的毫无意义的类型定义。如果你不使用类型检查器，那 TS 的类型功能也完全是个摆设。如果你和我说那 Java 不也要声明类型，那我会和你说：拜托，请你自己去写一下 Java 和 TypeScript，你就知道 TS 的类型系统有多令人恼火了。

关于语言和框架的讨论到此为止，点到即可，我也不想引战，只是单纯发表我的观点。

未来的一些规划

在未来，我们会逐步实现这些功能：

• WebAuthn 无密码登录
• 违规使用审计与计费
• 节点详细统计数据界面
• 捐赠节点可视数据面板
• 定制节点管理面板
• Eda 功能的增强

是的，我们打算对违规使用进行计费，不按要求使用，我们为什么一定要给你免费提供服务呢？
可能还会有更多功能，敬请期待。

马上就是 LoCyanFrp 的生日了，基于各种因素，我写下了这篇博文。这些看法也不一定全对，欢迎你在评论区评论，纠错或提供建议。

获取 ADB

首先需要获取 ADB，可以参考 AOSP 的文档下载配置

https://source.android.google.cn/docs/setup/build/adb?hl=zh-cn

修改测试服务器地址

首先删除原来的

1
2

adb shell settings delete global captive_portal_https_url
adb shell settings delete global captive_portal_http_url

然后重新添加

1
2

adb shell settings put global captive_portal_https_url https://g.cn/generate_204
adb shell settings put global captive_portal_http_url http://g.cn/generate_204

如果 Google 中国的服务器你也无法访问，可以尝试其他厂商的地址:

• connectivitycheck.platform.hicloud.com/generate_204
• connect.rom.miui.com/generate_204
• wifi.vivo.com.cn/generate_204

或者你也可以自建一个，只要地址返回 204 No Content 即可。

修改完需要重新联网一下，不行就重启一下手机。

早期技术

SakuraPanel

最开始的时候，LoCyanFrp 使用的是 SakuraPanel
这一个没什么特别好提的，大多数内网穿透除去自研方案基本都是 SakuraPanel 起手

我对于 SakuraPanel 的些许看法

SakuraPanel 本身实现了一套齐全的公共 Frp 方案，但是在实际接触之后，我认为改进空间很大。
主要有以下这些我不是很满意的：

• 前后端不分离，代码混在一起
• 数据库表格混乱，包括数据列命名并不是很规范，以及数据类型混乱，隧道远程端口居然是 varchar 类型，有用户 ID，但是却用用户名查找用户等等…
• 二改并不好实现平滑的前端页面切换效果，不够现代化
• UI 风格略显老旧
• 代码并不是很好，许多回调地狱和 if 嵌套，可读性不佳
• 虽然 PHP 并不慢，但是我不喜欢这种前后端写在一起的，不好区分职能

前端升级

我们的前端先行一步进行了升级，不过这个阶段后端还是围绕 SakuraPanel 原本去实现的。
我们前端改用 Vue 3 + NaiveUI，初步实现前后端分离，这个阶段后端使用的是 ThinkPHP 框架。
整体布局是 @Daiyangcheng 写的，当时我还没有正式成为乐青团队的一员，不过给前端布局提供了一些设计思路。

PS: @Daiyangcheng 主要是写后端的，但是因为那会我们的前端都没有空，结果当时他从 0 开始手搓 Vue 3 写的，CSS 啥的都不会，有一些布局怪难看的，我就吐槽了一下，顺便给了点思路和样式。
如果你细心的话，你甚至可以发现我们前端里面有各种吐槽的注释（

那会其实还有和莱云合作，不过后面估计因为各种事情不了了之了，由于那会我还不是团队成员，具体的我也不清楚。

一点个人吐槽：你这前端保熟吗？？！

新面板确实挺简洁现代化的，但是它的代码可不一定了——一个原本写后端的从 0 起手写的，要写好确实挺有难度（
由于我的强迫症，那会面板有好多细节让我觉得超级不满意，太难受了，干脆之间 fork 改。
不改还好吧，一改人差点傻了，第一次见三种变量命名法混一起的，还有各种奇葩嵌套，看完高血压那种（
没办法，看着真不爽，只能硬着头皮改了（反正我是为了自己看的爽一定要改，当时完全没想到别的用户体验xd）
一改就是整个面板重构，改完之后整个面板终于算是基本符合自己的感觉了

后端技术的演变

更换新框架…

改完新面板不久后，@Daiyangcheng 开始写新的后端了。
新后端和旧的不同，直接抛弃了一直在用的 PHP，改为 Spring 框架。
早期的 v2 API 其实代码也不怎么好，因为 @Daiyangcheng 那会根本不会 Java，也是从 0 起手的。

在这之后一段时间我一直都在修改前端，现在你看到的整个面板基本上都被我改过，毕竟重构了这也不算夸张的（不过是基于原来代码，直接写新的我这种特别 lazy 的人是绝对不会做的）

一个写前端的孩纸突然又开始捡起后端了，变成了赛博全栈！？

在改前端和写启动器的那段时间，我一直在吐槽 API 难用（
我一直在催 @Daiyangcheng 优化，但是他真的太忙了，基本上没改过啥。
但是你这接口我看了强迫症啊，刚好我涉猎过 Java 和 Kotlin，于是干脆自己动手改了。
这一改又是重构，原来的代码看的令人红温（

于是我又把每个接口的代码从参数传入到鉴权全部重写了一遍，改的那叫一个头大，顺便实现了几个一直没有的接口。
此外 API 文档和 Minecraft 联机功能也是我写的，约等于一个人把前后端全改完了，还写了份文档（byd 累死了

即将到来的下一版本 API

其实改完后我还是有很多不满意的的地方，不过后面那段时间看基本没啥问题，跑去打游戏了，一直懒得改。
后面我的 BF 去上学了，无聊也没啥可以玩的，又回来改代码了（悲
这次也有很多大改动，还算理想的实现了很多原来设想的东西，包括:

• 添加 Turnstile 人机验证
• 向外部应用提供 OAuth2.0 授权
• 修复了一些漏洞
• 将原有的 用户名 作为唯一标识改为 用户ID 作为唯一标识，API 全部改用 用户ID 进行操作
• 同时为面板实现了全部遗留 v1 接口，完全升级到 v2 API
• 一些技术上和代码逻辑的优化

还有一些提上日程但是还没来得及实现的，这些也会在后续实现:

• WebAuthn 无密码登录
• 违规使用审计与计费
• 节点详细统计数据界面

这期间也要感谢一些提供了建议的朋友，这里就不列举了。

关于未来…

其实 Frp 这种方案在将来将会被淘汰，因为那会估计大家都普及了 IPv6 公网了，现在我一个四五线城市的都已经有 IPv6 公网了，IPv6 互联是迟早的事情。
我们也推荐我们的用户通过 IPv6 公网的方案获得更好的连接质量。
我还没有设想更多未来的事情，现在只是想做好当下的事情，为用户提供更好的内网穿透解决方案，仅此而已。
我们本身也不赚钱，甚至每个月都要贴钱进去，但是初心是不会改变的，我们会一直坚持公益服务下去。

我们现在需要添加一个注解，实现 Controller 下接口方法包含此注解时，前置鉴权条件，满足条件才执行接口逻辑

思路

1. 新建一个注解，如 @NeedAuthentication
2. 添加一个 AspectJ 逻辑，指定 Spring AOP 切面注入方法
3. 新建自定义异常，当验证不通过时抛出一个异常来终止执行
4. 添加一个全局异常处理用于处理自定异常类型，返回未授权

实现

直接上代码:

NeedAuthentication.java

1
2
3
4
5
6
7
8
9
10

package moe.muska.ami.demo.annotation;

import java.lang.annotation.*;

// 声明注解所需的内容
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface NeedAuthentication {
    // 可以根据需要添加参数，并在之后的逻辑通过 reflect 获取使用
}

AuthenticationAspect.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

package moe.muska.ami.demo.aspect;

import moe.muska.ami.demo.exception.UnauthorizedException;
import jakarta.annotation.Resource;
import jakarta.servlet.http.HttpServletRequest;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.annotation.Pointcut;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.RequestContextHolder;
import org.springframework.web.context.request.ServletRequestAttributes;

@Aspect
@Component
public class AuthenticationAspect {

    // 设置 AOP 切面
    // @annotation 代表注解
    @Pointcut("@annotation(moe.muska.ami.demo.annotation.NeedAuthentication)")
    public void needAuthenticationMethods() {}

    // 定义前置逻辑
    @Before("needAuthenticationMethods()")
    public void doAuth() {
        // 获取请求
        ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        assert attributes != null;
        HttpServletRequest request = attributes.getRequest();

        // 主鉴权逻辑

        // 请求参数
        String requestUserId = request.getParameter("user_id");
        String bearerToken = request.getHeader("Authorization");

        if (requestUserId == null) throw new UnauthorizedException(null);
        if (bearerToken == null) throw new UnauthorizedException(null);
        long userId;
        try {
            userId = Long.parseLong(requestUserId);
        } catch (NumberFormatException e) {
            throw new UnauthorizedException("Authentication data type mismatch.");
        }
        // 示例判断是否授权
        if (!authorize(userId, bearerToken)) throw new UnauthorizedException(null);
    }

    /**
     * 校验权限
     */
    private boolean authorize(long userId, String bearerToken) {
        // Demo 就不写具体逻辑了，可以自己改为 false 查看授权失败是否返回正常
        return true
    }

}

UnauthorizedException.java

1
2
3
4
5
6
7
8
9

package moe.muska.ami.demo.exception;

// 创建一个自定义异常
public class UnauthorizedException extends RuntimeException {
    // 如果你不需要返回消息，可以去除 super 字段的逻辑
    public UnauthorizedException(String message) {
        super(message);
    }
}

AspectExceptionHandler.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

package moe.muska.ami.demo.controller;

import moe.muska.ami.demo.exception.UnauthorizedException;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import java.util.Map;

// 自定义异常处理
@RestControllerAdvice
public class AspectExceptionHandler {

    // 设置异常类型为自定义异常类型
    @ExceptionHandler(UnauthorizedException.class)
    public ResponseEntity<Map<String, Object>> onHttpRequestMethodNotSupportedException(UnauthorizedException ex) {
        // 根据实际需求返回对应类型数据
        // 以下只是例子，请结合实际应用
        return builder.unauthorized();
    }

}

Application.java

1
2
3
4
5
6
7
8
9
10
11
12
13

package moe.muska.ami.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.context.annotation.EnableAspectJAutoProxy;

// 开启 AspectJ 自动代理
@EnableAspectJAutoProxy
public class Application {
    public static void main(String[] args) {
        // ...
        SpringApplication.run(Application.class, args);
    }
}

都写在注释里了，可以自己研究一下

ufw-docker

https://github.com/chaifeng/ufw-docker

一键安装:

1
2
3
4
5
6

sudo wget -O /usr/local/bin/ufw-docker \
  https://github.com/chaifeng/ufw-docker/raw/master/ufw-docker
chmod +x /usr/local/bin/ufw-docker

# 写入 ufw 规则
ufw-docker install

开放端口:

1

ufw-docker allow <容器名> <容器内端口>

其他操作参考 README

已知的一些缺点

• 不能指定外部端口映射，只能映射到同一个端口上
• 貌似没法开放 UDP 端口？(至少它把我邮件服务器干了)

绑定到指定 IP

将容器开放端口绑定到指定 IP 上，其他 IP 无法访问
要禁止外部网络访问，直接绑定到 127.0.0.1 或者其他代表本地的 IP，外网就无法访问了

Docker Compose

1
2
3
4
5
6
7

services:
    exmaple:
        # ...
        ports:
            - 127.0.0.1:8080:80
            # - <本地IP>:<本地端口>:容器内端口
        # ...

Docker

启动的时候带上 --ip=127.0.0.1 参数即可
也可以修改 daemon.json 使默认 bridge 网络无法外网访问：

1
2
3
4

{
    // 要绑定的 IP
    "ip": "127.0.0.1"
}

LoCyanFrp 简写 LCF

关于这个项目

相识

这个项目并不是我发起的。
2022年，我生日当天，刚好正在寻找一个免费的 Frp 服务。像往常一般，我在搜索引擎简单搜索了一下，找到了这家 Frp 内网穿透服务。却曾想，这成为了我接下来几年里的转折点。

前世

早期 LoCyanFrp 由站长 Daiyangcheng 以及另外两位成员 DXCFTDE、Zhiyuan36 共同维护。记得那时候还在用 Freenom 的免费域名，这个域名目前我还记得，是 freenat.gq 。不过这个域名现在已经被回收了，并不属于 LoCyanFrp 。
当时完全是使用的 SakuraPanel 以及 Daiyangcheng 手搓 ThinkPHP 框架造的后端，虽然能用，但是因为数据库问题出过一些事故（吐槽一下 PHP 还没关 DEBUG 输出，官网上面两行大大的连不上数据库难绷）。客户端也非常简陋，甚至没有图形化界面（就是 PyLauncher）
包括后来的实名，最开始是人工审核，后面换成了 BOT，现在还保留着这个功能，不过实际意义不大了
这期间我也是成功和站长和管理成员混熟了成功混入

一个小插曲

刚好那天是我生日，于是我进官方群那会看到群里的人都在 @Daiyangcheng 要管理，我凑热闹结果他因为刚好当天是我生日送了我一天管理体验卡结果后面因为比较活跃一直都是管理了

从陌生到相识

从最开始的局外人，到成为团队的一员，总归来说是社区贡献。

LCF 首页

当时 ZDX(DXCFTDE) 写了个新的起始页，用的 MDUI 1
写出来有很多奇怪的地方，于是 DYC 就叫 ZDX 来问我改byd为什么是我，然后我看太炸裂了干脆直接帮他们改了tmd我还改了

LoCyanFrpPanel

当时初三，但是成就优异，并不是很担心学业，刚好设计了一套系统，本来打算实现的，不过后面弃坑了
结果技术全部用到了 LoCyanFrpPanel 上 xd

关于一本书（题外）

我没有恰广告，而是阐述我的观点

书名叫《Vue.js 设计与实现》。
这本书非常详细的解释了 Vue 3 的设计及实现，这也是我学习 Vue 3 的起点。
在这之前，我一直都在写原生的 HTML5/CSS3/JS，当时看到很多网站都在使用框架，于是决定入门一个框架，最终决定入坑 Vue。
但是我并没有看过任何 Vue 3 完整的教程，而是从 Vue 3 的原理上去学习的。《Vue.js 设计与实现》这本书给了我很大的帮助，它详细的解释了 Vue 3 的设计理念，并给出了具体的实现。我初三中后期在校期间除了把没啥难度的试题做完，就是在看这本书，因为 Vue 3 的逻辑很有趣，同时这是我买的第一本关于程序相关的书，兴趣使然使我简单了解了 Vue 3 在各种方法上与 Vue 2 的差异，以及 Vue.js 的优点和简便性。
虽然最后看到 Diff 算法之后就没有看了，但是这本书影响了我后续编程的思想和代码理念，不仅局限于 Vue，在其他语言上我也深受此书启发。

代码能跑和能优雅的运行永远是不一样的，能跑局限于能跑，而后者则更令人赏心悦目。
我不喜欢看到一大堆混乱的代码，也不喜欢看到一大堆的警告。

正题

当时 LCF 正在更新 2.0，用 Vue + NaiveUI 写了一个面板，好看归好看，但是因为 @Daiyangcheng 当时糟糕的 Vue 水平，导致面板移动端适配很怪以及组件间距非常难绷，于是我就看到经常吐槽太史了以及经常给出一堆 CSS 样式，然后 DYC(Daiyangcheng) 按我说的去改了
不过后面还是有很多地方看着不满意（强迫症（悲）），干脆直接 fork 改

Nya LoCyanFrp! 乐青映射启动器

此项目是我成为 LCT 成员的主要贡献。
当时 LCF 还没有一个带 GUI 的启动器，刚好另一边有其他项目拉我去开发（现在一直咕咕咕还没新建文件夹），定了前端要用 Flutter 开发，但是当时我并不会 Flutter，所以本来不打算学的，但是定好了大家都不打算改的样子，就顺便打算写个 LCF 启动器练练手的。
Flutter 我是从《Flutter 技术入门与实战》《Flutter 实战 第2版》这两本书中学来的，虽然随着 Dart 和 Flutter 更新这两本书内容稍微有点过时了，不过想学我还是很推荐这两本书的。
刚开始入坑 Flutter 并不顺手，因为当时我还没有那么成熟的界面设计观念，要设计一整套完整的交互，确实对于一个初三生有点那啥了（
后面也是因为各种原因弃坑大概有2个月？（记得不清楚），因为期间 LCF 官方在开发新的客户端，我就没管这个项目。
后面觉得 LCF 那个新客户端太丑了，功能啥也没有，觉得这根本不行啊（恼
于是又回坑去填坑了
当时已经有初版的 v2 API 了，但是那会我是 Query 一把梭类型（对的，令牌都用 Query Params），调 API 出了点小插曲，调用 dio 卡了半天
后面各种奇葩操作把启动器拼出来了，欸你别说比官方的好看（
这不得直接发 LCF 群找个幸运儿体验（x
在这里我要吐槽一下 Dart 的垃圾 IO 库，进程操作啥也没有，属于是要啥没啥，全部得自己造轮子系列
后面研究打包器发现沟槽的打包器有 BUG，又自己 fork 下来魔改，最后成功发布了 0.1.x 版本
但是后面有用户反馈说 macOS 版用不了，加上我没有 macOS 的设备，翻 Apple 那个构思文档翻了半天，最后才解决了权限之类的各种我自己根本不可能遇到的问题。

随着 Nya LoCyanFrp! 的不断完善，最终成为了新的官方启动器。
后续工作中，我也在潜移默化中成为了 LCT(LoCyanTeam) 的一员。

我是如何成为站长的

我在 NyaLCF 开发以后，随着暑假过去，顺理成章成为了市一中的一员，但是后面因为一些我个人原因（性别认同之类的），导致我高一中期重度抑郁休学。
休学后我病情稍微好转一些，也和 DYC 的关系逐渐比较近，同时虽然抑郁但是有时候非常无聊我就会去更新 NyaLCF，本身原站长和 LCT 其他成员人就比较忙，作为为 LCF 产生了大量社区贡献的我最终成为了 LCT 的一员，后面由于原站长即将踏入高三，便把项目托付给我了。

自此我成为 LCF 的站长，但其实我并不是特别了解 Frp 及 SakuraPanel 的很多东西，后面虽然原站长暂时退出，但我依然会去请教相关问题，包括现在，我希望尊重原站长的意见，他虽然很忙但是还是很在意这个项目的，毕竟这也是他亲手创办的东西嘛。

——To be continued

Closing listening socket does not affect connections already established

一不小心就踩坑了，这个居然不会影响现有连接，居然还要自己去实现，绝了

一个轻量级的服务器资源监控，官方描述：

A lightweight server resource monitoring hub with historical data, docker stats, and alerts.

正如介绍所言，而且不但轻量，UI 界面也美观。

一点关于博主更换 Beszel 的经历

博主曾经使用哪吒监控，但它并不好用，以下是原因：

1. 哪吒监控的前端并不好看
2. 哪吒监控的前端对移动端适配很差，能用但是很糟心
3. 哪吒监控的前端代码和处理逻辑非常糟糕，博主曾自制过主题
4. 哪吒监控的后台没有搜索功能，有人可能会说 Ctrl + F，但其实服务器多了并没有自带搜索直观

出于种种原因，我最终更换了 Beszel 作为服务器探针。

部署 Hub

Hub 就是 Beszel 的控制端，很简单，使用 Docker 就可以轻松部署。
我这里选择使用 Compose 部署，示例如下：

1
2
3
4
5
6
7
8
9

services:
  beszel:
    image: 'henrygd/beszel'
    container_name: 'beszel'
    restart: unless-stopped
    volumes:
      - ./data:/beszel_data
    ports:
        - "8090:8090"

将这个配置写到你喜欢的地方，比如 /opt/beszel
然后：

1
2

cd /opt/beszel
docker-compose up -d

现在访问 http://<服务器地址>:8090 即可进入 Beszel 后台，在这里配置完管理员信息就完成了。

部署 Agent

Agent 同样可以使用 Docker Compose 部署。
在 Hub 的右上角点击 Add System，点击 Copy docker compose 即可复制 Agent 部署用的 docker-compose.yml 模板，参考上方 Hub 的部署方法，正常部署然后在 Hub 完成信息填写并添加即可。

Watchtower 自动更新 Agent

Beszel 不会自动更新 Agent，可以通过配置 Watchtower 实现容器自动更新：

1

docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower beszel-agent

添加依赖包

需要用到的是 dynamic_color

1

flutter pub add dynamic_color

根据官方说明，各个平台取色方式如下：

Android S+: 用户壁纸颜色
Linux: GTK+ 主题的 @theme_selected_bg_color
macOS: 应用程序的 accent color
Windows: accent color 或者 window/glass color

修改入口文件

修改你的 main.dart ，一个完整的示例如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

import 'package:dynamic_color/dynamic_color.dart';
import 'package:flutter/material.dart';

void main() async {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // 默认主题色种子
  static const _defaultColorSeed = Colors.blueAccent;

  // 根组件
  @override
  Widget build(BuildContext context) {
    Get.put(ProgressbarController());
    // Monet 取色
    return DynamicColorBuilder(
      builder: (ColorScheme? lightDynamic, ColorScheme? darkDynamic) {
        ColorScheme lightColorScheme;
        ColorScheme darkColorScheme;

        if (lightDynamic != null && darkDynamic != null) {
          // 亮色模式 Monet 取色
          lightColorScheme = lightDynamic.harmonized();
          // 暗色模式 Monet 取色
          darkColorScheme = darkDynamic.harmonized();
        } else {
          // Fallback 颜色，当不支持 Monet 取色的时候使用
          lightColorScheme = ColorScheme.fromSeed(
            seedColor: _defaultColorSeed,
          );
          darkColorScheme = ColorScheme.fromSeed(
            seedColor: _defaultColorSeed,
            brightness: Brightness.dark,
          );
        }
        // 覆盖取色后的颜色可以用 ColorScheme.copyWith(); 方法 
        // lightColorScheme.copyWith(secondary: Color.blue);

        return GetMaterialApp(
          title: 'Monet Example',
          // 亮色模式主题，直接调用获取到的 ColorScheme
          theme: ThemeData(
            useMaterial3: true,
            colorScheme: lightColorScheme,
            // ...
          ),
          // 暗色模式主题，同上
          darkTheme: ThemeData(
            useMaterial3: true,
            brightness: Brightness.dark,
            colorScheme: darkColorScheme,
            // ...
          ),
          // 设置主题跟随系统
          themeMode: ThemeMode.system,
          // ...
        );
      },
    );
  }
}

接下来，热重启应用程序即可看到效果~

准备

• ADB
• 一款第三方桌面软件

步骤

首先确保已经把手机导航方式切换为传统按键导航。
然后打开手机开发人员选项，打开 ADB 调试功能。

确保已经安装好第三方启动器。
博主使用的是 微软桌面 ，当然你用别的也不是不可以。

方法一

ADB 连接到手机，使用命令设置默认主屏幕应用：

1

adb shell pm set-home-activity com.microsoft.launcher

方法二

ADB 连接到手机，执行以下命令先禁用中兴自带的桌面软件：

1

adb shell pm disable-user com.zte.mifavor.launcher

然后回到手机，此时返回桌面，会提示选择打开方式，选中自己安装的第三方桌面软件并勾选 设为默认 。
此时手势导航不能用，我们解除禁用中兴的桌面软件：

1

adb shell pm enable com.zte.mifavor.launcher

然后去设置里面把导航方式切换回原来的导航方式即可正常使用。

可以通过 ADB 设置属性开启 Android 9 中的深色模式，不过系统本身没有适配，只有应用会适配

1

adb shell settings put secure ui_night_mode 2

如果你像我的一样安装了 GMS 框架，但是发现设置了之后 Google 家的一些应用还一样浅色模式显示，得手动到应用的设置设成深色

1. tailscale_enabler 每次启动都要重新下载 Tailscale，我认为这是非常愚蠢的设计。
2. tailscale_enabler 部分资源使用 GitHub 下载，国内访问不畅通。

正文

下载安装最新版 Tailscale 的 ipk

访问 https://pkgs.org/download/tailscale ，往下找到 OpenWrt，选择合适架构的 ipk 文件，点击进入，往下滑找到 Download 进入，有一个下载链接，下载并使用 opkg 安装。
我使用的是基于 OpenWrt 22 的系统，能正常使用，虽然这个是 OpenWrt 23 源中的文件。

安装好了之后，此时正常接入内网会显示不是最新版，先别着急，我们执行新版 Tailscale 带有的 update 命令：

1

tailscale update

执行完毕后，你就会发现 Tailscale 已经正常升级到最新版。

• 一台能够跑Docker的服务器
• 服务器能开放stun的端口 UDP/3478
• 一个域名
• (可选)SSL证书

本文假设服务器发行版为普通 Debian 12

Docker 近期国内访问困难，以下是截止本文发布时可用的镜像：

• docker.1panel.live
• dockerhub.icu

关于 Docker 及 Docker Compose 安装本文不再赘述，请自行查阅其他文档。

防火墙放行端口

iptables/nftables和服务器安全组都要放行以下端口：

• UDP/3478
• TCP/<PORT>

<PORT> 请改为一个你需要的端口

（可选）安装 Tailscale

此步骤用于鉴权，若你搭建的是公开 DERP 服务，那么可以跳过。

更新: 如果你想使用容器版本的 Tailscale，那么也可以跳过此步，往下一步有更多说明。

1

curl -fsSL https://tailscale.com/install.sh | sh

写入 Docker Compose

创建 Derper 文件夹：

1
2

mkdir -p /opt/derper
mkdir -p /opt/derper/cert # 证书目录

请将 <PORT> 替换为你希望的 DERP 端口，<HOST> 替换为你希望的 DERP 连接域名。
本文假设你需要 SSL，故写入证书相关。关于证书请继续往下。若不需要 SSL，请自行移除 -certdir=/cert/ -certmode=manual 部分。
如果需要搭建的为公共 DERP，请移除 -verify-clients 部分。

如果你不需要鉴权，无需关心 Tailscale 客户端安装方式，因为并不需要安装。
如果你需要让 DERP 获取真实 IP，请将网络模式改为 host 模式（修改 STUN 端口可用 -stun-port 参数指定）。

使用宿主机 Tailscale 客户端鉴权

1
2
3
4
5
6
7
8
9
10
11
12

services:
  derper:
    image: qctt/derper
    container_name: derper
    restart: unless-stopped
    ports:
      - "<PORT>:443"
      - "3478:3478/udp"
    volumes:
      - ./cert/:/cert/ # 证书目录
      - /var/run/tailscale/tailscaled.sock:/var/run/tailscale/tailscaled.sock:ro # 用于给私有DERP鉴权
    command: /derper -stun -a 0.0.0.0:443 -hostname <HOST> -certdir=/cert/ -certmode=manual -verify-clients

使用容器版本 Tailscale 鉴权

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

services:
  tailscale_client:
    image: tailscale/tailscale:latest 
    container_name: derper-tailscale-client
    restart: unless-stopped

    volumes:
      - ./tailscale:/var/lib/tailscale
    environment:
      - TS_USERSPACE=true # 使用 userspace mode 以便无需映射 tun
      - TS_STATE_DIR=/var/lib/tailscale
      - TS_SOCKET=/var/lib/tailscale/run.sock # tailscaled socket

  derper:
    image: qctt/derper
    container_name: derper
    restart: unless-stopped
    ports:
      - "<PORT>:443"
      - "3478:3478/udp"

    volumes:
      - ./cert/:/cert/ # 证书目录
      - ./tailscale/run.sock:/var/run/tailscale/tailscaled.sock:ro # 用于给私有DERP鉴权
    command: /derper -stun -a 0.0.0.0:443 -http-port -1 -hostname <HOST> -certdir=/cert/ -certmode=manual -verify-clients

使用 docker compose logs tailscale_client -f 查看 Tailscale 客户端的日志获取登录链接进行授权，或者使用 TS_AUTH_KEY 来授权。

关于证书

证书及私钥文件名为：

• <HOST>.crt
• <PORT>.key

如果你和我一样使用 1Panel 申请和管理证书，那么你可以在证书申请的配置中勾选 推送证书到本地目录 和 申请证书之后执行脚本，并填入：

推送证书到本地目录:

1

/opt/derper/cert

申请证书之后执行脚本:

1
2

mv /opt/derper/cert/fullchain.pem /opt/derper/cert/<HOST>.crt
mv /opt/derper/cert/privkey.pem /opt/derper/cert/<HOST>.key

启动 Derper 服务

1
2

cd /opt/derper
docker-compose up -d

添加到Tailscale

在你的Tailscale管理界面找到 Access Controls (点我直达 )
在其中插入片段，示例如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

{
    "acls": [
    // ...
    ],
    "ssh": [
        // ...
    ],
    // ...
    "derpMap": {
        "Regions": {
            "900": {
                "RegionID":   900, // 900以上
                "RegionCode": "cni-zj-nb", // 区域代码，会在 `tailscale netcheck` 显示
                "RegionName": "中国-湖北", // 区域名称，会在 `tailscale netcheck` 显示
                "Nodes": [
                    {
                        "Name":     "zj-nb-1", // 随意填写
                        "RegionID": 900, // 对应上方ID
                        "HostName": "xxxxx.xxx", // 填写你的DERP服务域名
                        "DERPPort": 12345, // 你的DERP服务端口
                    },
                ],
            },
            // 更多DERP节点
        },
    },
    // ...
}

使用 tailscale netcheck 检查，发现多出自建DERP，成功

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

Report:
        * UDP: true
        * IPv4: yes, xxx.xxx.xxx.xxx:xxxxx
        * IPv6: no, but OS has support
        * MappingVariesByDestIP: true
        * PortMapping:
        * CaptivePortal: false
        * Nearest DERP: 中国-湖北-崇阳
        * DERP latency:
                - cni-hb-cy: 41.4ms  (中国-湖北-崇阳)
                - cni-zj-nb: 59.6ms  (中国-浙江-宁波)
                - lax: 239.7ms (Los Angeles)
                - sfo: 245.8ms (San Francisco)
                - sea: 251.3ms (Seattle)
                - den: 255.6ms (Denver)
                - tor: 267ms   (Toronto)
                - dfw: 269ms   (Dallas)
                - ord: 269.5ms (Chicago)
                - hnl: 271.7ms (Honolulu)
                - nyc: 278.9ms (New York City)
                - mia: 286.8ms (Miami)
                - tok: 336.3ms (Tokyo)
                - lhr: 343.1ms (London)
                - cnh: 361ms   (中国香港)
                - par: 361.5ms (Paris)
                - fra: 364ms   (Frankfurt)
                - mad: 366.2ms (Madrid)
                - syd: 370.7ms (Sydney)
                - ams: 377.1ms (Amsterdam)
                - waw: 380.1ms (Warsaw)
                - hkg: 386.6ms (Hong Kong)
                - sin: 400ms   (Singapore)
                - sao: 404ms   (São Paulo)
                - blr: 463.2ms (Bangalore)
                - dbi: 466.5ms (Dubai)
                - nai: 509.7ms (Nairobi)
                - jnb: 518.5ms (Johannesburg)
                - usa:         (美国)

以下示例均为 ini 配置，其他配置请自行变通。

在 Frpc 配置文件对应隧道配置后加入：

1

proxy_protocol_version = v2

e.g.

1
2
3
4
5
6
7
8
9

[testTunnel]
privilege_mode = true
type = tcp
local_ip = 127.0.0.1
local_port = 25565
remote_port = 11451
use_encryption = 0
use_compression = 0
proxy_protocol_version = v2

重启 Frpc（如果正在运行）。

Paper Global 配置开启 HAProxy 支持

演示版本为 Paper-1.21-109 ，配置文件位于 config/paper-global.yml。
将 proxies.proxy-protocol 设置为 true 。

1
2
3
4
5
6
7
8

proxies:
  bungee-cord:
    online-mode: true
  proxy-protocol: true # <--- 这里
  velocity:
    enabled: false
    online-mode: true
    secret: ''

重启服务端（如果正在运行）。

All done

如果你是按照教程配置的，那么现在加入服务器已经会显示客户端的实际 IP 。

1
2
3

[21:23:54] [User Authenticator #0/INFO]: UUID of player Muska_Ami is <UUID>
[21:23:57] [Server thread/INFO]: Muska_Ami joined the game
[21:23:57] [Server thread/INFO]: Muska_Ami[/117.183.xxx.xxx:24884] logged in with entity id 25 at ([world]-0.5, 69.0, -3.5)

由于当前启动器的代码体量并不小，为了便于维护，打算进一步模块化。
同时避免重复代码，将 nyalcf_core 完全分离，以便开发新的命令行版本（原定是用 Terminal UI 实现，但是后面还是决定直接用 CLI 了）。

项目目录树

• nyalcf_core - 核心模块
• nyalcf_inject - 通讯模块
• nyalcf_gui - 图形化版本
  • nyalcf_ui - 用户界面模块
  • nyalcf_core_extend - 核心扩展模块
  • nyalcf_inject_extend - 通讯扩展模块
• nyalcf_cli - 命令行版本

由于命令行版本刚起步，模块信息可能日后会有变动。

关于核心改动

从 nyalcf_core 里面提取了小部分的代码，这些代码与 nyalcf_ui 深度绑定导致无法移除，所以统一提取到 nyalcf_core_extend 来解决这个问题。
同时 nyalcf_inject 本身也有部分与 nyalcf_ui 代码存在绑定关系，同样提取到了 nyalcf_inject_extend 以便去除 Flutter 依赖使得可以直接在命令行版本中使用 nyalcf_inject 。

其他改动

• 现在窗口可以缩放的更小了
• 优化了开源许可证页面的展示
• 窗口默认大小变的更大了
• 深度链接集成

更多改动在实际开发中可能会产生，最终结果请以往后 Releases 发布内容为准。
如果你有兴趣来维护这个项目，欢迎提交 PR 。贡献相关请查阅 https://github.com/Muska-Ami/NyaLCF?tab=readme-ov-file#how-to-contribute