璨梦踏月の小窝

文章内容说明/其他事项/站点更新日志

璨梦踏月 — Thu, 14 Aug 2025 00:00:00 GMT

好风景难得,平常心奢侈;在这样的黄金时代,愿这份电子日记可以让我们现在的记忆在将来以更美的方式再度浮现[^恩祈儿]

[^恩祈儿]: BiliBili@恩祈儿 - 谁把家里的等身大手办搬街上来了！？

:::tip

~~我知道我写的内容没人看~~

站点更新日志:

2025-07-20: 增加Twikoo评论系统, 见集成 Twikoo 评论系统

2025-08-16: (已失效)文章显示更新时间, 支持系列文章/链接卡片/文章置顶

2025-08-23: (已失效)为移动端(竖屏设备/只要你右侧无法展示目录都算)增加了目录功能(来自Mizuki), 增加导航栏智能显隐

2025-08-25: (已失效)增加伪i18n支持, 当默认语言非简体中文时会自动高亮翻译按钮并文字提醒

2025-11-16: 博客迁移至Firefly主题,先前自定义功能已失效(原计划迁移到Mizuki)

2026-01-11: 域名迁移,增加国内CDN

2026-01-16: 去除绝大多数文章的封面以及随机图加载,由于当前加载速度并不快,这会显著拖慢网页加载时长

2026-01-18: 增快国内CDN访问速度(背景图片加载依然略慢,会在未来尝试解决)

2026-01-20: 随机图api已更新,大幅优化背景图片加载速度 :::

关于AIGC

部分文章可能会使用AI润色,均会在文章顶部申明:

:::caution[AI内容警告]

本文使用了AI润色,更多内容请看文章内容说明

:::

在无特殊注明情况下均为

AI润色 -> 人工审查并再次润色

主要目的为优化整体表述和样式, 增强可读性, 查漏补缺/纠正错误; 并不会以AI生成内容为主

一般情况下仅会把合适的内容使用高级语法突出显示,不会生成/修改其他内容

如何免费注册一个阿里云企业邮箱并用于发/收信件

璨梦踏月 — Sat, 18 Jul 2026 00:00:00 GMT

有一个笨蛋在注册后未记录相关内容,导致想修改内容的时候找不到怎么登录阿里企业邮箱了,经过重新探索后,回忆起了相关方法,遂记录

购买企业邮箱（免费版）

首先你得有个域名,不过能点进来,应该是具备相关基础知识,不会没有吧...? 以阿里云国内版作为演示,国际版我不道;另请注意单个阿里云账号最多可申请一个企业邮箱（免费版），一个完成实名认证的用户身份最多可申请两次企业邮箱（免费版）
购买企业邮箱(免费版),输入你持有的域名,时长任意,保持默认1年即可
访问企业邮箱控制台,找到刚刚购买的名为"企业邮箱免费版"(业务内容就是你的域名),点击右侧管理
点击设置解析,按照指引添加DNS解析
点击重置密码,这里设置的密码是管理员账户的密码(管理员账号默认没有初始密码,需要通过重置密码的方式来设置密码)
切换到基本信息,这里会展示你的管理员账号和邮箱访问地址;复制管理员账号,然后访问邮箱访问地址,输入你的管理员账号和刚刚设置的密码并登录
接下来会进入到管理员视角,点击左侧员工账号,新建账号;在这里就可以创建你需要的发件人(收件人)地址

可以在侧边栏安全管理 -> 账号安全 -> 密码策略处把定期修改密码关闭,如果你不需要的话,否则会定期发邮件提醒你修改密码

创建新账户后,右上角退出登录,然后登录你刚刚创建的那个新账户
登录后,右上角设置->更多设置, 左侧侧边栏账户与安全 -> 账户安全,底部,建议开启三方客户端安全密码,然后在这里生成新密码;SMTP/IMAP服务器在侧边栏邮箱设置中可以查看
在你的第三方客户端或者发信/收信服务填入你新账户对应的邮箱,三方客户端的密码,设置好SMTP/IMAP服务器

大功告成! 教程结束! 如有需要也可查看官方文档

记录一下我的歌单

璨梦踏月 — Tue, 30 Jun 2026 00:00:00 GMT

当前歌单

顺序不分先后

All Falls Down - Alan Walker&Noah Cyrus&Digital Farm Animals&Juliander
All For Love - Tungevaag&Raaban&Richard Smitt
Aurora - JJD/Alex Skrindo
Barbara - bzd4576
Be The One - PANDORA/Beverly
Blossom - PIKASONIC
Burning Desires 绝望吧台 - 三Z-STUDIO/HOYO-MiX
By Your Side - Jonas Blue&RAYE
China-RhyThm - Maker/听风Xyi
Counting Stars - OneRepublic
Dangerous - Olivia Addams
Ena - Hinkik
Ethereal - RuKoops
Fly to the moon (feat. 中村さんそ) - PSYQUI/中村さんそ
Franna - CNA
GoneBad - Bobina
Got It 6 (氛围Phonk) - VZEUS/YaKio/Wehti/离离离
Inverted World (Extended Mix) - ARForest
Last Dance - Xomu
Little Wish (片段循环 by 璨梦踏月) - 塞壬唱片-MSR/Sincere/Ws Music
Magical Girl - Kirara Magic
Miles Away (Original Mix) - Janji
Mine (Illenium Remix) - ILLENIUM&Phoebe Ryan
Nevada - Vicetone&Cozi Zuehlsdorff
Normal No More (Explicit) - Tysm
Outside - Calvin Harris&Ellie Goulding
Pixel Candy - Elements Garden

来自视觉小说《天选庶民的真命之选》

Run Free - Deep Chills/IVIE
So Far Away - Martin Garrix&David Guetta&Jamie Scott&Romy Dya
Survivors - CH17S
Take me hand - Cécile Corbel
Umbrella (Matte Remix) - MatteEmber Island
Wake (Live) - Hillsong Young & Free
Walk Thru Fire - Vicetone&Meron Ryan
Withered - Mr Chip/暴君de
bonbon sucré Song - 水月陵

来自视觉小说《与你相恋的恋爱Recette》（我没玩过）

【NeuroV3 Evil】学猫叫 (首次中文歌) 20240807 - Neuro和Evil
【Nightcore】怦然心动 - "看晚霞彩虹夜空和繁星和你零距离"
【Nightcore】落日星空 - "因为落日和星空只能在黄昏相拥"
クリームソーダとシャンデリア - Akie秋绘/早凉
テルテルユー - 鎖那
今天不是明天 (feat. 兰音Reine) - 电音联盟/音波狂潮/V-Festival/兰音Reine/PIKASONIC
Ivory Tower - bilibili@任舒瞳
你看世界好美（《卡拉彼丘》香奈美角色主题曲） - 卡拉彼丘/宴宁
再会の誓い - BGMer
奔向天际线 - Akie秋绘
定玄 - 鸣潮先约电台/黄霄雲/杨秉音
幻境中 - 兰音Reine
拂晓 Proi Proi - HOYO-MiX/NIDA
桃花庵 - 音阙诗听/封茗囧菌
Ring Ring Ring (Single Version) - 梦音茶糯
比天高 - 兰音Reine
永不结束的歌 - 鸣潮先约电台/xTR33x/Tarokiki
独角 - UnicornPhantom
红昭愿-Akie秋绘 - bilibili@Akie秋绘&Akie秋绘
银河与星斗 - 兰音Reine
门前篱下 - s-zero-pie

变化记录

2026-06-30

新增定玄 - 鸣潮先约电台/黄霄雲/杨秉音
移除深海回响 (LUYA版) - Luya
移除暮色回响【原神五神】 - bilibili@澈零喵
移除调查中（砂金填词） - bilibili@澈零喵
移除把回忆拼好给你（崩铁） - bilibili@祸尾氏
移除 ⚡用原神全三十位五星角色唱一曲原神版【半山腰】⚡ (改编版) - bilibili@萌宠教主

2026-07-01

新增反乌托邦 - 乌托邦P

小米17全系(含红米K90PM)秒解解锁BL！？完全免费,无需授权,无需9008,无需拆机

璨梦踏月 — Sun, 08 Mar 2026 00:00:00 GMT

起因

8号早上的时候朋友突然跟我说200块就能解锁BL,还不快冲?

我因为换机原因(首发换的小米17PM)无法解锁BL所以被迫放弃了root,原先计划是等过保之后花钱解,但是现在居然这么便宜还不用拆机,还能远程??

于是去闲鱼和酷安搜了一下,发现都在传,当时是有多个店铺在卖,然后立即下单开始排队;中午的时候,突然有人公开的解锁方法,使用了三个漏洞实现,于是就见证了价格从1000邮寄->300拆机->200远程->0!?

三个漏洞

这三个漏洞分别为关闭SELinux强制执行, 以root身份执行任意命令, 永久解锁bootloader

关闭SELinux强制执行
fastboot oem set-gpu-preemption-value 0 androidboot.selinux=permissive
此漏洞为高通限定,已修复
以root身份执行任意命令
service call miui.mqsas.IMQSNative 21 i32 1 s16 "命令" i32 1 s16 "参数列表" s16 '输出路径' i32 600
系统自带组件提权 uid0 root
永久解锁bootloader
https://github.com/hicode002/qualcomm_gbl_exploit_poc
此漏洞为高通限定(8e5新加的分区),把 gbl_efi_unlock.efi 写入 efisp 分区,需要root权限

于是,我们组合起来就可以: 进入 bootloader -> 关闭SELinux强制执行 -> 以 root 权限将 gbl_efi_unlock.efi 写入 efisp 分区 -> 解锁 BL

实际操作

:::tip 在8号下午约16:00左右,就已经开始了下发补丁进行修复(关闭系统自动更新无效,依然会更新) 这个漏洞在小米17系列上,只有Android安全更新在2026-02-01前的版本可用,正式版最高是2026-01-01;K90PM即使安全更新为 2026-02-01 依然可用如果在低版本并且想解锁BL,建议立刻使用adb权限将系统更新卸载,防止补丁修复的版本被强制推送 :::

设备开启adb并连接
具体顺序如图在关闭SELinux强制执行后执行 fastboot continue 继续启动(设备会黑屏,这是正常的),然后推送解锁文件,用root权限将 gbl_efi_unlock.efi 写入 efisp 分区,重启至 bootloader 即可解锁BL

大功告成,于是我们就成功解锁了!

网站全球秒开：教你如何实现网站分流解析

璨梦踏月 — Sat, 21 Feb 2026 00:00:00 GMT

:::tip

教程以本站为例
只适用于需要分流解析子域名，根域名不进行分流
本教程中使用的国内 CDN 需要域名备案，否则无法提供服务 :::

NS 解析

将域名托管至 Cloudflare（即根域名 NS 解析在 Cloudflare）。

DNS 解析

由于 Cloudflare 的 DNS 记录不支持根据地区等其他方式分流解析，因此我们需要使用其他 DNS 服务商。二选一（或其他支持根据地域解析的服务商），后续以阿里云为例：
- DNSPod
- 阿里云（国际站/国内站）
在 DNS 解析中添加你需要分流的子域名（阿里云的 DNS 在 云解析 DNS -> 解析配置 -> 公网权威解析），并按要求通过 TXT 等其他方式验证域名；然后在 Cloudflare 的 DNS 记录中将对应子域名 NS 解析到服务商要求的记录。

部署静态页面

国外源：通过 Cloudflare Workers 部署页面（如果通过 Vercel 等其他方式部署可跳过）。

:::tip 为什么要使用 Workers 而不是 Pages？ 因为 Pages 需要检查 CNAME 解析是否正确。在本例中，CNAME 解析是不指向 Pages 要求的 CNAME，而 Workers 不检查。 :::

国内源：推荐使用 腾讯云 EdgeOne Pages / 阿里云 ESA Pages 部署页面（均免费但需要域名备案）。

:::tip

纯静态页面不使用函数的情况下我更推荐阿里云 ESA，因为能直接绑定域名并且可以享受到 CDN 的 WAF。腾讯云的 EdgeOne 独立于 CDN，（近乎）无法配置 WAF，除非你确信你的网站不会受到攻击。
阿里云 ESA 的函数兼容性较差，例如可以在腾讯云 EdgeOne 和 Cloudflare Workers 运行的函数，跑到阿里云 ESA 就会报错。
（腾讯云 EdgeOne 在下文简称 EO，阿里云 ESA 在下文简称 ESA） :::

动态页面

国内：直接使用 EO 或 ESA 进行回源即可。如果是非标端口推荐使用 EO，ESA 需要占用一个规则位置才能配置自定义回源端口，而 EO 可以直接设置。
国外：使用 Cloudflare 回源。

DCV 委派

由于 CNAME 是分流解析，且免费服务默认使用的证书签发大概率为 Let's Encrypt / Digicert，他们获取到的是非国内解析的 CNAME，无法颁发证书，因此需要通过DCV委派的方式签发证书。

EO：在接入站点（域名）后，域名服务 -> 域名管理 -> 右侧 HTTPS 配置，根据指引设置 CNAME 记录。
ESA：在 站点管理 -> 点击你接入的域名 -> SSL/TLS -> 边缘证书 -> 下方托管 DCV，根据指引设置 CNAME 记录（ESA 免费版只有 Let's Encrypt 证书，因此设置的是 _acme-challenge.）。

设置解析

以阿里云 DNS 配置为例：

非国内解析需要在 Cloudflare 添加一个任意子域名，然后 A 记录填写 192.0.2.1，并开启代理；然后将这个域名填写至记录值中（这个设置是让流量打到 Cloudflare CDN 上，然后就可以正常解析了）！

配置完如图：

大功告成！

结果如图：

叛逆神魂创意工坊剧情补丁安装教程

璨梦踏月 — Tue, 13 Jan 2026 00:00:00 GMT

所有教程与补丁文件发布地址

有猪咪把NSFW打成了NFSW(包含图片中的内容),这些错误会在下一次整体更新时修正,但视频教程中的内容可能不会修正

此教程链接只在steam创意工坊以及其他教程内发布,因此默认您是从创意工坊来的,所以本篇不会有指向steam创意工坊的链接

:::warning 黑屏问题已知,但由于相关补丁文件在完成后,从未进行过任何二次更改,且在1.78及以前的版本可正常使用(可先降级至1.78版本体验,方法见叛逆神魂更新公告);因此我倾向于是叛逆神魂更新导致的问题 :::

教程

本博客(本帖包含教程)
QQ群 (530516796)

此群已被群风险提醒,如果炸了请等待新群或先加入 Discord/TG 群组. ~~没炸也可以加一下备用~~

Discord
BiliBili (视频教程)
YouTube (视频教程)

补丁文件

QQ群群文件
Discord
TG (已绑定讨论群组,亦可加入讨论群组;如果找不到补丁文件请使用搜索功能搜索频道内容#叛逆神魂)
OneDrive

补丁安装教程

下载对应角色的补丁文件
Steam右键叛逆神魂->管理->浏览本地文件->将地址栏的 common\GODSOUL 替换为 workshop\content\1213300 (这个文件夹即是叛逆神魂创意工坊目录)
Steam Deck 用户替换为 workshop/content/1213300
补丁文件的数字即是ModID,将压缩包内文件覆盖至相同ModID的文件夹

启动游戏! 读取存档后找到对应角色的好感度剧情

不常见问题

这些问题真的不常见,一般不会遇到问题

Q: 订阅后没有创意工坊目录
A: 尝试手动创建对应目录,然后安装补丁文件(别问我,我不知道为什么喵,问steam喵)
Q: 订阅模组或安装补丁后,游戏内对应角色没有出现所订阅模组的好感度剧情
A: 请检查游戏版本确保为最新版本或 EA1.68 及以上的版本,考古版本可能还未支持创意工坊~
什么!?你还有问题!?评论区留言或通过QQ/Discord/TG向我(昵称:璨梦踏月)联系;请勿直接通过steam发送好友申请,陌生人一般不会同意

通过render+supabase部署umami

璨梦踏月 — Sun, 07 Dec 2025 00:00:00 GMT

supabase

https://supabase.com/

创建新项目，点击上方的Connet，Method切换到Session pooler，复制并将[YOUR-PASSWORD]替换为你的密码然后保存，如果遗忘可以在数据库设置中进行重置(像我这样的笨蛋已经忘记密码了)

render

https://dashboard.render.com/

创建项目选Web Services，Image填docker.umami.is/umami-software/umami:postgresql-latest

环境变量

必须

Key	Value
APP_SECRET	random string
DATABASE_URL	在supabase保存的内容

可选

Key	Value
TRACKER_SCRIPT_NAME	自定义你的脚本名称，可以帮助你避免某些广告拦截器
DATABASE_TYPE	postgresql

更多环境变量请见 https://umami.is/docs/environment-variables

之后部署即可

保活

使用任意手段，每10分钟访问一次你的网页(理论14分钟也可以)，例如uptimebot

Git 双仓库同步与提交压缩实战指南

璨梦踏月 — Sun, 16 Nov 2025 00:00:00 GMT

:::caution[AI内容警告]

本文使用了AI润色,更多内容请看文章内容说明

:::

初始化

首先使用git init进行初始化(这里假设是全新私有仓库,如果需要在现有仓库则跳过此步)
git commit --allow-empty -m "Initial commit"创建一个空提交
git remote add origin https://github.com/your-username/my-awesome-project.git添加你的远程私有仓库(替换链接)

设置上游并合并

:::note 下文的所有upstream均可自定义为你想要的上游仓库的名称,master修改为实际你需要同步的上游仓库分支的名称(一般主分支名称为main或master) :::

使用git remote add upstream https://github.com/your-username/my-awesome-project.git添加上游公开仓库
git fetch upstream获取上游仓库最新内容
git merge upstream/master合并上游仓库(注意主分支名称) :::tip 如果出现fatal: refusing to merge unrelated histories报错是正常的,因为提交历史不同,添加--allow-unrelated-histories参数强制合并即可:

git merge --allow-unrelated-histories upstream/master

如果不希望合并立即被提交可以使用git merge --squash upstream/main，--squash 参数会把文件变更应用到你当前的工作区和暂存区。

如果是在已有仓库上合并,可能会出现大量文件冲突,需要手动解决冲突。 :::

git tag last-sync-point upstream/master在上游的提交添加标签用于后续增量同步内容

后续同步

git fetch upstream
git diff last-sync-point upstream/master > upstream.patch
git apply --reject upstream.patch 然后解决冲突(如果有),删除upstream.patch文件并提交 :::tip 推荐使用 --reject 选项，它可以在发生冲突时，生成.rej文件而不会报错终止；如果遇到冲失败需要手动查看.rej并处理内容 :::
更新标签

# 先删除旧的标签
git tag -d last-sync-point

# 获取 upstream/master 最新的哈希值，并创建同名新标签
git tag last-sync-point upstream/master

:::tip 如果你的情况比较复杂，那么我建议还是使用merge来合并上游仓库吧 (

如果遇到大量.rej文件生成,也可以考虑使用AI辅助处理冲突内容,但是注意审查AI修改后的内容 :::

压缩提交

:::caution 重要警告：git rebase 会重写历史。这意味着你需要使用 git push --force(强制推送)。请确保这个分支只有你一个人在用，或者你的所有协作者都清楚你在重写历史，并知道如何同步 :::

假设当前 Git 历史如下：

A --- B --- C --- D   <-- main, origin/main

A 是你上次从 upstream 同步后得到的那个“大”提交。
B, C, D 是你在这段时间内自己做的三个新提交。

目标把 B, C, D 压缩成一个提交 BCD:

A --- BCD   <-- main

找到 A 提交的哈希值,复制它哈希值的前 7 位以上(假设是 a1b2c3d)
使用交互式变基

git rebase -i a1b2c3d

执行命令后，Git 会打开一个文本编辑器，里面是这样的内容：

pick b1b2b3b Commit message of B
pick c1c2c3c Commit message of C
pick d1d2d3d Commit message of D

# Rebase ...
# ... (注释说明)

需要修改这个文件来告诉 Git 如何压缩。把第二行及以后的 pick 改成 s (squash) 或者 f (fixup)。

s (squash): 会把这个提交和上一个提交合并，并且让你重新编辑合并后的提交信息。
f (fixup): 和 s 一样，但会直接丢弃这个提交的信息，使用上一个的。

修改成这样：

pick b1b2b3b Commit message of B
s c1c2c3c Commit message of C
s d1d2d3d Commit message of D

保存并关闭。

编写新的提交信息

因为你使用了 squash，Git 会再次打开编辑器，让你为这个合并后的新提交（BCD）写一个新的、总结性的提交信息。比如 "Feature: Add user login and profile page"。写好后保存退出。推送到远程仓库即可(需要使用 -f 强制推送)。

5TB OneDrive存储空间,微软Office 365 E3订阅免费购买

璨梦踏月 — Fri, 14 Nov 2025 00:00:00 GMT

注册账号

(如果已有Microsoft 365 Admin Center账号并且确保你有管理员权限就跳过此步)

https://signup.microsoft.com/get-started/signup?products=35dffc92-9eb4-4d5c-82c2-2582b37bb9c4&culture=zh-cn&country=cn

推荐注册国区(可以选择Alipay,且实际不需要绑定)(其他区域需要对应区域的Visa卡或万事达等国外银行卡,修改country=你需要的区域)

(纳税人识别号随便填写一个15位数即可)

(最后会要求验证信用卡,可以直接下一步的链接购买E3)

购买E3

:::tip 不用修改数量, “选择许可证数量”已为 25 个 :::

https://admin.cloud.microsoft/?pid=C69E7747-2566-4897-8CBA-B998ED3BAB88&quan=25&bc=1&sku=189a915c-fe4f-4ffa-bde4-85b9628d07a0&ru=PDP#/Purchase/checkout

设置OneDrive

进入主页

https://admin.cloud.microsoft/#/homepage

左侧账单(Billing) -> 你的产品(Your products) -> Office 365 E3 Developer -> 分配许可证(Assign licenses)
分配给你的账户 :::tip 建议修改计费频率为年付,如果修改时有任何报错,等待一段时间再试 :::

回到主页 -> 点击全部显示(Show all) -> 点击管理中心(Admin centers)下的SharePoint (如果没有请等待几分钟) -> 设置 -> 存储限制(为用户设置默认存储限制) -> 修改为5120

打开 https://myapplications.microsoft.com/ 点击OneDrive,如果无法打开/主页提示出了点问题请等待一段时间(可能长达数小时甚至12小时及以上)

回到主页 -> 用户(Users) -> 活跃用户(Active users) -> 选择你的用户 -> OneDrive -> 编辑(Edit) -> 存储限制(Storage limit)改为此用户的最大存储空间(Maximum storage for this user)

结束!

参考资料:

https://forum.naixi.net/thread-6702-1-1.html

https://forum.naixi.net/forum.php?mod=viewthread&tid=6723

https://blog.2b2x.cn/posts/ms-e3/

https://www.tr0.cn/officefore3/

https://www.nodeseek.com/post-504804-1

https://www.nodeseek.com/post-505193-1

解决Windows下DNS泄露问题

璨梦踏月 — Tue, 21 Oct 2025 00:00:00 GMT

导致DNS泄露的原因主要就两种:

配置不对导致的
Windows导致的(智能多宿主名称解析)

正确配置DNS

:::note 此处DNS配置仅适用于mihomo内核,其他内核格式与此不同

另外在DNS配置中始终不要使用fallback,这会直接导致泄露 :::

(推荐) 使用fake-ip :::tip 在fake-ip模式下,所有的DNS请求均会返回一个虚假IP地址,DNS 解析的责任从代理客户端转移到了代理服务器、尽可能避免在本地进行 DNS 解析，因此 Fake IP 无需额外的 DNS 转发配置、天生就具备「无视 DNS 污染」和「CDN 体验优化」两大优势。^fake-ip
因此,由于DNS解析不在本地进行(直连访问依然是本地解析),配置极为简单,只需要配置default-nameserver和nameserver为国内DNS即可 :::

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-filter-mode: blacklist
  fake-ip-range: 28.0.0.1/8

  # 其他设置
  
  # 默认 DNS, 用于解析 DNS 服务器 的域名
  # 必须为 IP, 可为加密 DNS
  # 推荐使用国内DNS/运营商DNS
  default-nameserver:
    - tls://223.5.5.5
  # 访问直连域名使用的DNS服务器
  # 默认的域名解析服务器
  # 推荐使用国内DNS/运营商DNS
  nameserver:
    - https://dns.alidns.com/dns-query
    - https://doh.pub/dns-query

使用redir-host

dns:
  enable: true
  enhanced-mode: redir-host

  # 其他设置

  # 默认 DNS, 用于解析 DNS 服务器 的域名
  # 必须为 IP, 可为加密 DNS
  # 推荐使用国内DNS/运营商DNS
  default-nameserver:
    - tls://223.5.5.5
  # 访问非直连域名使用的DNS服务器
  # 推荐使用国内外DNS
  # 把下方#后的 自动选择 和 节点选择 替换为你的配置中真实的代理组(这个代理组的节点会用于访问DNS),这里仅为示例
  nameserver:
    - tls://1.1.1.1#自动选择
    - https://dns.google/dns-query#节点选择
  # 访问直连域名使用的DNS服务器
  # 推荐使用国内DNS/运营商DNS
  direct-nameserver:
    - https://dns.alidns.com/dns-query
    - https://doh.pub/dns-query

:::tip 你也可以使用客户端接管DNS设置并使用客户端的使用图形化界面进行调整(如果支持的话) :::

智能多宿主名称解析

"智能多宿主名称解析"（LLMNR，Link-Local Multicast Name Resolution）是微软引入Windows的加快DNS解析速度的功能，通过在所有可用的网络适配器上发送DNS请求来实现，并自动选择返回速度最快的信息。
简单来说,这会导致在tun模式下DNS泄露(系统代理模式下不受此影响,如果系统代理模式下泄露请检查配置)(会给你系统默认的网卡发送一个 DNS 请求)

关闭方法

打开组策略( Win + R 输入 gpedit.msc 回车)
计算机配置->管理模板->网络->DNS 客户端
右侧找到 禁用智能多宿主名称解析
双击,在弹出窗口中选择已启用并确定

依然泄露?

请检查规则中是否存在IP类规则,如有请添加no-resolve参数

除了配置的问题之外

例如Firefox/Zen浏览器在经过上面两步后依然泄露,但是在相同情况下Chrome/Edge浏览器不泄漏

有两种解决办法:

启用严格路由

在tun的配置中增加 strict-route: true 或者在你的客户端中修改tun模式的配置 :::warning 这将将所有连接路由到 tun 来防止泄漏，但你的设备将无法其他设备被访问
(如遇内网无法访问,可以尝试添加排除自定义网段) :::

修改Firefox的设置(两种办法,Zen同理)
1. 修改基于 HTTPS 的 DNS为最大保护 (绕过系统及内核的DNS)
2. 在内核设置中开放混合端口(默认7890)打开Firefox的连接设置,改为手动配置代理,在SOCKS 主机主机处填写IP(mihomo内核运行在本机使用就127.0.0.1)和端口(默认7890),确保使用SOCKS_v5,并勾选使用 SOCKS v5 时代理 DNS 查询

如果你还想了解更多DNS/fake-ip相关的内容,建议阅读Sukka的博客

参考资料:

https://linux.do/t/topic/198120

https://linux.do/t/topic/1061825

https://medium.com/@ValdikSS/beware-of-windows-10-dns-resolver-and-dns-leaks-5bc5bfb4e3f1

https://wiki.metacubex.one/config/dns/#default-nameserver

https://finalpi.github.io/post/002.html

https://www.v2ex.com/t/1034325

Backblaze免费存储无银行卡外网无限流量访问教程

璨梦踏月 — Tue, 14 Oct 2025 00:00:00 GMT

免费10GB,流量无限 :::note Backblaze加入了CloudFlare的带宽联盟（ Bandwidth Alliance） Backblaze与CloudFlare之间的流量直接免费，也就是每天无限量下行流量，配上CloudFlare超长缓存，每天下载请求无限次免费
注意：如果是公网访问，1GB流量是免费的，如果前面套了 Cloudflare 的CDN，那基本是全免了 ::: :::tip 部分内容参考Linux Do 本文可能会省略一些过程 :::

开始

需要准备的内容

前置内容

在Cloudflare增加一个你准备用于访问存储桶的域名(开启小黄云也就是代理,CNAME向任意地址)
Cloudflare 左侧栏点击规则->创建规则->URL 重写规则,名称随意,选择自定义筛选表达式,字段选择主机名,运算符选择等于,值输入在步骤1中添加的域名,路径选择重写到...,内容随意写,然后部署,然后再次编辑刚刚创建的URL 重写规则,随意修改一点内容,然后部署(这里的内容后续都会被CloudFlare Workers覆盖,因此可以随意填写)
Cloudflare 转到账户概述->管理账号->审核日志->稍等几分钟日志出现->找到操作类型为update,资源为rulesets,参与者电子邮箱为你的账号邮箱,参与者上下文为dash,点击右侧详细信息,找到raw部分的uri部分,内容类似

/zones/3abcxxxxxxxxxxxxx9e79b/rulesets/741axxxxxxxxxxxx1b228c/rules/24abafxxxxxxxxxxxxxxxfd63e7

zones后的3abcxxxxxxxxxxxxx9e79b就是区域ID,复制并保存,rulesets是规则集ID,复制并保存,rules是规则ID,复制并保存 4. Cloudflare 主界面右上角,进入配置文件(个人资料)->API令牌->创建令牌->创建自定义令牌->名称随意,添加两个权限账户 - 账户规则集 - 读取,区域 - 转换规则 - 编辑然后保存,妥善保存这个 CloudFlare API 令牌

存储桶

打开 Backblaze ,创建存储桶(私有桶,公共桶要求一次性付款一美元或者有历史付款记录),保存存储桶名
Application Keys->Add a New Application Key->名称随意,Allow access to Bucket选择步骤1中创建的存储桶(all也可以,如果你就这一个存储桶的话),然后点击下方按钮创建密钥,妥善保存keyID和applicationKey

Workers

打开Cloudflare,进入Workers 和 pages->创建应用程序->从 Hello World! 开始->名称随意,自己认识/知道是干什么的即可,点击部署->点击设置,找到变量和机密,点击添加

变量名	值
B2KeyID	Backblaze 的 `keyID`
B2AppKey	Backblaze 的 `applicationKey`
B2BucketName	Backblaze 的存储桶名
CfAuthKey	上面创建的 CloudFlare API 令牌
CfHostname	CloudFlare CNAME好的域名
CfZoneID	区域 ID
CfRulesetID	规则集 ID
CfRuleID	规则 ID

添加完成后选择保存版本(如果手快选择了部署也无所谓),右上角编辑代码,复制下方代码,然后部署

addEventListener("fetch", (event) => {
  event.respondWith(handleRequest(event.request));
});
addEventListener("scheduled", (event) => {
  event.waitUntil(updateRule());
});

const getB2Token = async () => {
  const res = await fetch(
    "https://api.backblazeb2.com/b2api/v2/b2_authorize_account",
    {
      headers: {
        Authorization: "Basic " + btoa(B2KeyID + ":" + B2AppKey),
      },
    }
  );
  const data = await res.json();
  return data.authorizationToken;
};

const updateRule = async () => {
  const b2Token = await getB2Token();

  const res = await fetch(
    `https://api.cloudflare.com/client/v4/zones/${CfZoneID}/rulesets/${CfRulesetID}/rules/${CfRuleID}`,
    {
      method: "PATCH",
      headers: {
        "Authorization": `Bearer ${CfAuthKey}`
      },
      body: 
      `{
        "description": "修改Backblaze桶地址和访问令牌",
        "action": "rewrite",
        "expression": "(http.host eq \\\"${CfHostname}\\\" and not starts_with(http.request.uri.path, \\\"/file/${B2BucketName}\\\"))",
        "action_parameters": {
          "uri": {
              "path": {
                  "expression": "concat(\\\"/file/${B2BucketName}\\\", http.request.uri.path)"
              },
              "query": {
                  "value": "Authorization=${b2Token}"
              }
          }
        }
      }`,
    }
  );

  const data = await res.text();
  console.log(data);
  return data;
};

async function handleRequest(request) {
  const data = await updateRule();
  return new Response(data);
}

如果代码错误,请访问:

https://gist.github.com/longsays/0527603c1d6b883b73e7249e053b83da

部署完成后访问,看到如下界面则代表成功

最后,进入设置->触发事件->Cron 触发器->Cron 表达式->输入0 4,16 * * *

BackBlaze的文档说一个 Token 的有效期最大不超过 24 小时，我为了保险起见，选择每天两次触发这个 Worker 来生成一个新的 Token

折腾中柏N100迷你主机记录

璨梦踏月 — Sun, 21 Sep 2025 00:00:00 GMT

前言

因需要一台低功耗设备长期运行作为"家里云"去运行某些服务,挑选很久后选择了中柏N100(闲鱼)

系统选择了飞牛OS,虽然这是一个NAS系统 (还是想要一个图形化界面的)

刷入飞牛OS

:::warning

在此之前,需要准备一个大于等于8G的U盘用于烧录系统

如果安装前硬盘有任何重要数据请先备份

:::

下载系统镜像

访问

https://www.fnnas.com/

选择下载 fnOS

下载烧录工具

访问

https://github.com/balena-io/etcher/releases

选择适合你系统的版本进行下载

烧录系统

下载完成后打开 Etcher ,选择从文件烧录,选择你下载的飞牛OS镜像,然后选择你的目标磁盘,最后点击烧录

等待完成,拔出U盘,~~狠狠地~~插入到需要装系统的设备上

安装飞牛OS

通过U盘启动和BIOS的一些设置

启动设备,选择通过U盘启动

以中柏N100为例,按 Delete 键进入 BIOS ,确保 Boot option #1是你的U盘

设置来电开机(可选):

在 Advanced 选项中选择「OEM Configuration」
在最后一行「AC Power Loss」中选择模式

Power Off: 关闭相关功能。 Power On: 传统意义上的来电自启，只要接通电源就会自启动。 Last State: 只有在上次关机是意外断电导致时，接通电源才会自启动。

设置网络唤醒(可选):

网络唤醒只能从有线网络唤醒，设置位置也在「OEM Configuration」下面。

「Wake from Lan」

有线网络唤醒开启后，虽然在关机时，网口的灯不亮，但可以唤醒。

设置完成后按 f10+enter 重启

等待一段时间进入 fnOS Install 安装界面,选择你需要把系统安装到的硬盘,系统分区和Swap大小建议默认

:::warning

如果硬盘有重要数据,现在是最后的备份机会 :::

最后点击确定 这将格式化硬盘

网卡设置

使用有线网络

插入网线后一般能够自动识别,不需要管,拔出引导盘点击保存确定即可,然后跳转到进入飞牛

使用无线网络(需要无线网卡)

拔出引导盘,点击保存确定

来到重启后的界面,确保选中Debian GNU/Linux,按 E,向下移动到linux所在的行,按 ctrl+e ,输入(注意开头有个空格)

 init=/bin/bash

输入完成后按 ctrl+x 启动系统

等待出现命令行后输入并回车

mount -o remount,rw /

输入并回车

passwd root

出现New password:输入新密码并回车(然后会要求再次输入相同密码,输入密码时不会显示),出现passwd: password updated successfully为设置成功

输入并回车

sync

输入并回车(重启系统)

reboot -f

等待出现命令行(FNOS图标)

输入root(用户名)回车,然后后输入密码

接下来输入查找附近WiFi

nmcli device wifi list

:::tip

非英文/数字 WiFi名称会显示异常为正常情况

:::

输入你需要连接的WiFi名称和密码并回车(别漏空格和双引号哦)

nmcli device wifi connect "WiFi名称" password "密码"

回车后看到Device '网卡名称' successfully activated with '串码'即为连接成功

输入reboot -f重启

进入飞牛

进入系统后会显示IP:port,直接访问即可,首次进入需要注册访问用户(此处密码不等于之前设置的root用户密码)

:::tip

恭喜你,现在已经安装完成并且可以访问了

:::

使用飞牛OS

创建存储空间

看个人需求自行设置即可

其他

都图形化界面了,应该不用说什么了吧

1panel

来源:

https://bbs.fit2cloud.com/t/topic/6418

在飞牛OS上安装1panel后可能会出现重启设备后无法访问1panel

解决方法如下:

sudo vim /etc/systemd/system/1panel.service
# 修改

[Service]
ExecStartPre=/bin/sleep 10

:::warning

升级、快照恢复这些操作会覆盖 /etc/systemd/system/1panel.service 需要重新修改 :::

切换TCP拥塞控制算法(BBR)

sudo -i

echo -e "\nnet.core.default_qdisc=fq\nnet.ipv4.tcp_congestion_control=bbr" >> /etc/sysctl.conf && sysctl -p

sysctl net.ipv4.tcp_congestion_control

#root@MEmini-B20E:~# sysctl net.ipv4.tcp_congestion_control

#net.ipv4.tcp_congestion_control = bbr

如何删除:
nano /etc/sysctl.conf
编辑文件夹

删除
nnet.core.default_qdisc=fq
nnet.ipv4.tcp_congestion_control=bbr
保存退出

sysctl -p
再执行这个代码

一些常用mods来源备份

璨梦踏月 — Thu, 18 Sep 2025 00:00:00 GMT

1.往生堂Mod（up主：往生堂桃姐aa）资源导航页：

https://link3.cc/xiaohutao

2.辉辉的七月时光

https://huihui168.org/

3.小散的mod文档（up主：Supreme小散）（最会咕咕的）

https://docs.qq.com/smartsheet/DZVNZbnlBZmRiWFB5?tab=BB08J2

3.可莉的小仓库（小散の老版本文档）

https://kdocs.cn/l/ccSu7CnMVaKL/

4.寄子游戏分享导航页主页

https://docs.qq.com/aio/DYWpwemFBSm9acGVG

5.咖啡森林（up主：林离a）

https://docs.qq.com/aio/DS3RlZUtDTU1XeFNz

6.踩蘑菇网站（up：虹汐哥）

https://www.caimogu.cc/circle/440.html

给你的VPS增加WARP出口(非全局)

璨梦踏月 — Thu, 21 Aug 2025 00:00:00 GMT

:::important

本教程仅用于个人使用和通信，请勿将其用于非法目的，请勿在生产环境中使用。

:::

:::tip

本文建立在你已安装3X-UI的基础上,3X-UI安装使用教程

我相信你应该知道这里所指的VPS是干什么的VPS,国内一般连不上WARP

WARP出口位置和你的VPS所在地理位置有关联,通常是相同/相近区域

:::

:::note[为什么要增加WARP出口?]

~~增强隐私 (并非主要目的)~~
给送中IP使用的 (Google的IP定位漂移到中国,这会导致无法使用一些服务,例如 YouTube Premium / Gemini)
解锁AI(例如 ChatGPT)/奈飞
~~WARP出口可以被认为真实用户,能减少各类网站验证? (不过也存在滥用,不好说)~~
如果你是单栈(只有IPV4/IPV6)的机器,走WARP后能有双栈体验(IPV4/IPV6都有,如果是单IPV4,即使你在代理工具的配置没有开启IPV6,依然能访问IPV6网站,前提走WARP出口)

:::

快速开始

在此之前你需要在入站列表已经创建好需要走warp出口的入站

进入面板

左侧选择Xray 设置
选择出站规则
点击WARP,添加出口
确保在出站规则下能看到一个warp标签,wireguard协议的出站,然后点击路由规则
点击添加规则,接下来分两种使用情况 (如果你需要切换到入站列表创建新的入站,记得先保存设置哦)
1. 根据域名/IP分流(指定域名/IP走WARP出口)
- 在Domain/IP处添加需要走WARP出口的域名/IP(逗号分隔)
- Inbound Tags选择你的入站
- Outbound Tag选择warp
1. 根据入站分流(指定入站走WARP出口)
- Inbound Tags选择你需要走WARP的入站
- Outbound Tag选择warp
修改完成后点击左上角保存,重启Xray;等待重启完成后即可使用

NoActive进阶文档

璨梦踏月 — Sat, 09 Aug 2025 00:00:00 GMT

<div align='center' >NoActive</div> <div align='center' >进阶文档</div>

:::caution[文章内容过时警告]

此文章内容上次更新应该是24年底或25年初,部分内容可能过时;例如SukiSU等管理器可能需要自行探索

:::

前言

:::warning

本文是为极客和有折腾精神的人所准备的进阶篇文档,大部分内容需要你自己动手实操，并且可能会出现包括但不限于以下几种情况：手机变砖、出现发热与卡顿、环境异常等

:::

如果你觉得本文有任何错误或需要补充的地方，可在频道@Glitchspire(频道ID)进行添加或修改

如果找不到@Glitchspire(频道ID)可以尝试@璨梦踏月-JOYUI13-5.10(频道ID)

:::caution

免责声明

你所进行的一切行为均由你自己承担责任，别砖了过来找我，不会提供任何帮助，自己想办法

:::

Re-Kernel KPM相关问题

KPM模块为Apatch独占（即Apatch管理器内核模块一栏），所以你需要刷入Apatch才能使用KPM版Re-Kernel

Apatch与其它Root方案共存

你需要两个东西：KernelPatch镜像与Apatch Apk

KernelPatch

Apatch

:::important

无论何时都只建议使用Release版本进行替换，Pre-Release或Github Ci构建的的版本可能导致不可知的问题

以及，请务必使Apatch安装包的原KernelPatch版本号与你要替换的版本号对应，不对应的版本号会不生效，同时有极大概率导致变砖，一定注意

:::

这里以Apatch 10763版本为例，下载对应的kpimg-linux

然后重命名kpimg-linux为kpimg，并替换掉Apatch Apk当中的kpimg

:::tip

kpimg在assets文件夹

:::

然后用Scene之类的工具提取你当前的boot.img，用你替换完的Apatch修补后再刷入boot.img

:::note

VAB分区的设备你当前处于哪个分区就提取哪个，别搞错活动分区了

例：A分区设备提取boot_a.img

:::

至此，共存部分结束，重启后你会发现仅内核模块可用，Root授权和系统模块均不可用，这时就可以使用Re-Kernel KPM了

:::warning

只建议先加载，然后再使用嵌入，以防止出现内核不兼容导致的卡开机问题等

:::

用Apatch作为Root方案

流程与其它Root方案几乎一致

Apatch Apk

:::important

无论何时，Apatch提取并修补的都是boot分区，除非Google未来更换Linux内核位置，否则均为boot

:::

从Magisk/Kernel SU切换至Apatch

太简单了，不想写，你们自己看吧：查看链接

:::important

使用此方法可能会导致Root方案残留，我只建议走2的流程，使用纯净boot修补然后正常刷入

:::

内存优化

如果你希望修改内存的保留值，你可以到/data/system/NoActive_xxxxxxxx/config/MemConfig.json中修改freeRAM或freeSWAP

0(自动)，负整数(关闭)，正整数为指定的值单位为MB

:::important

注意：ZRAM和Swapfile都属于SWAP(交换分区) 你需要写入符合JSON语法格式的配置，否则Noactive会自动清除错误配置并还原

:::

{
	"freeRAM":0,   <---- 物理内存保留值
	"freeSWAP":0,  <---- 交换分区保留值
	"highPriorityUidSet":[ <-- (高)
		10258,
		10299
	],
	"lowPriorityUidSet":[ <-- (低)
		10272,
		10289
	],
	"mediumPriorityUidSet":[ <-- (中)
		
	]
}

FCM解冻

Noactive自pro-173往后支持FCM解冻，由于配置文件变更，此处仅讨论此文发出时的最新版pro-185

不使用自定义，所有应用都支持FCM解冻

你需要更改的配置文件/data/system/NoActive_xxxxxxxx/的AdvanceConfig文件，receiveFCM后面的false改成true，保存后无需重启即可生效

示例配置:

{
	"adaptiveIcon":false,
	"fcmAppSet":[
	],
	"receiveFCM":true,    
	"speedMode":false
}

使用自定义，选择部分应用可以FCM解冻

配置文件依然为/data/system/NoActive_xxxxxxxx/的AdvanceConfig文件

{
	"adaptiveIcon":false,
	"fcmAppSet":[
        "com.microsoft.office.outlook",
        "com.x8bit.bitwarden"                 <-- (在这里添加包名)
	],
	"receiveFCM":false,
	"speedMode":false
}

:::important

你依然需要填写符合JSON格式的包名

如果填写包名，则receiveFCM应为false

:::

冻结Binder

关于Binder的介绍请查看名词解读与定义：名词解读

BinderFreeze用于阻断被冻结的应用与其它应用之间的通信，此特性自5.10内核开始支持，但目前仍然存在各种各样的问题，包括但不限于应用假断网、出现卡屏或闪弹

:::tip

Noactive的BinderFreeze默认关闭，如果你出现以上这些问题请看：名词解读

2025-08-09迁移时注释: 我不确定这个是不是指向这里, 之前虽然也是指向的名词解读, 但这对于解决问题似乎没有帮助

:::

6.1内核会比5.10/5.15具有更良好的BinderFreeze体验，但仍然不建议使用BinderFreeze，目前的Binder临时解冻虽然不够完美，但依然是目前唯一不存在问题的解决方案

NoActive新人必看文档

璨梦踏月 — Fri, 08 Aug 2025 00:00:00 GMT

<div align='center' >NoActive</div>

<div align='center' >新人必看文档</div>

:::tip

本文于 2025-08-08 从旧博客开始迁移至新博客,修改部分内容

主要更新日志:

2025-08-08: 新人必看文档迁移

2025-08-09: 名词解读合并进新人必看文档, 迁移进阶文档, 修复页内锚点失效

:::

:::caution

新人必看已完全停更，主要维护者均已放弃维护此文档，如你想继续维护可联系任意一人 @Glitchspire @小天（小康PRO版） @璨梦踏月-JOYUI13-5.10

基于以上原因，一切新人必看与官方文档不符的部分均以官方文档为准，也请不要以新人必看内的内容来质疑官方文档

:::

<div style="border: 2px solid #dddddd; border-radius: 10px;"> <details style="padding: 5px;"> <summary>一些删除内容</summary> 本文由@小天（小康PRO版）(频道ID),@Glitchspire(频道ID),@璨梦踏月-JOYUI13-5.10(频道ID)共同维护,只会将个人认为比较重要,或者官方文档没有写的内容放进来,如果文中有错误或你有补充可以在频道@我们进行添加/修改 转载自腾讯文档: <a href="https://docs.qq.com/doc/DS0hGeUppQmFyWW5X">NoActive新人必看</a>,<a href="https://docs.qq.com/doc/DS05PalBZbFR6cEdB">NoActive进阶文档</a>,<a href="https://docs.qq.com/doc/DWG5HUUx5UGREd0ti">名词解读</a> 已经完成全部的迁移,腾讯文档现已放弃维护，请直接查看本篇文章. 目录可以帮你快速找到解答，{% label 目录在右侧(没看到就往下翻,手机端在右下角有目录按钮) orange %},如果你的问题在新入必看文档中无法得到解答，可以带着详细描述与相关截图到频道内进行询问，或尝试查看{% btn '../NoActive进阶文档',进阶文档,far fa-hand-point-right,orange larger %}寻找答案 {% note warning flat %} 类似于{% btn '#常见问题解答',跳转到常见问题解答,far fa-hand-point-right,outline blue larger %}的页内跳转锚点偶尔会失效!请手动查找目录或再次点击 </details> </div>

官方文档链接：

https://app.myflv.cn/

官方下载站链接：

https://down.app.myflv.cn

封面来自: <a href="https://www.coolapk.com/feed/57006904?shareKey=NzNiMjExZmM3MWVkNjc3MTViMTg~&shareUid=26757217&shareFrom=com.coolapk.market_13.3.6">Starrhymelodge的酷安</a>

NoActive新人必看文档

NoActive简介

NoA只是单纯的墓碑模块，与任何墓碑或与墓碑相关的模块都会产生冲突。

墓碑作用：通过冻结的方式降低后台应用的CPU使用率，让更多的CPU能被前台应用使用，从而让前台应用更流畅 在不保留大量后台的情况下，使不使用墓碑基本上是无感的，在某些时候，甚至不如不使用墓碑模块 在某些地方，你会看到使用墓碑可以更省电的或类似的话，这类话出现的原因大概为：后台消耗的CPU降低了，电就省下来了。事实上靠墓碑省电的效果微乎其微，墓碑最大的作用就是在内存高压状态下尽可能保持前台应用使用的流畅
任何可以使用LSPosed框架的设备都可以正常使用NoActive

此外,你需要确保你的Android版本受支持,以及LSPosed正常,第三方LSPosed导致的问题不受理,请更换至官方版本(7024/7058/内测版)

见支持的Android版本, 排查LSPosed版本

<div style="border: 2px solid #dddddd; border-radius: 10px;"> <details style="padding: 5px;"> <summary>此处修改</summary> 原文:任何可以使用LSPosed框架，可以正常授权Root的Root管理器都可以正常使用NoActive </details> </div>
NoActive是一个独立的Xposed墓碑模块

工作方法并不是建立于系统的墓碑，理论上任何拥有LSPosed的安卓系统都可以正常使用NoActive（第三方系统/内核使用出现问题请不要反馈）

你并不需要调整开发者选项内的某些设置，NoActive工作不依赖也从未依赖过这些设置
NoActive不管省电，只保证前台流畅性

由于应用被冻结后依然会占用物理内存，而高内存占用必然带来额外耗电及卡顿，包括但不限于频繁的解压缩物理内存至Zram/Swap，或者频繁切换前台导致的内存压力增大，都会影响流畅度和耗电 如果你觉得使用NoActive之后变得更加耗电，请做好严格的变量控制。如果真的是这样，你可以选择停止使用NoActive。
NoActive与系统杀后台并没有直接的关联

如果你发现应用经常重新加载，请确定应用是被杀了还是因为没有Binder而重载。如果是因为没有Binder而重载，你可以选择使用Re-kernel Binder注释点击Binder Re-kernel说明点击跳转到Re-kernel
3.x版NoActive并没有配置进程功能

由于应用的部分进程未冻结，可能会与冻结进程进行Binder通信，导致应用产生很多未知问题 而杀死进程每次在应用后台后杀死，再次打开时会重新启动，反反复复杀死进程的开销更大 所以NoActive设计上是整体冻结应用，不会支持白名单进程，也不会支持杀死进程
NoActive冻结后应用会断网

如果你发现冻结后应用断网了，影响了某个APP的使用，你可以给予白名单，或停止使用NoActive，冻结QQ后，再打开QQ，消息加载慢很可能是因为这个
NoActive冻结的是带应用uid的系统/三方应用，且对于具备系统签名的应用默认白名单，NoActive不会冻结或者休眠不具备uid的进程

至于某充电模块，NoActive与你的模块不存在任何冲突，请不要再宣传这一概念然后让用户来这里反馈bug，毫无意义，且浪费开发者的时间

关于版本号

例:2.x；3.x

最前面的数字代表的是大版本，例如第二代NoA,第三代NoA
后面的x代表的是小版本号，2x版本最终停留在了2.9，3x版本目前是3.9，还在更新中，

2.x支持的安卓版本: 11-13

3.x支持的安卓版本: 12-15

:::important

停更的正式版及最后一个免费版3.3pro不支持Android15，所以别再问为什么用不了了 Pro版自 3.9Pro-185 支持Android15

:::

在此之外，你还会在【公告】NoA-Pro 看到版本更新写着PRO-xxx，这里的xxx代表着小小版本号，正常更新为小小版本号迭代，~~小小版本号不会在NoActive的当前版本与系统中写出来~~ 某次更新后会在NoActive中显示小小版本号了 据@myflavor 所说，这样做是为了方便降级

注： 3.9Pro-172之前版本＆免费版的NoActive文件配置目录为/data/system/NoActive 3.9Pro-172之后版本的NoActive文件配置目录为/data/system/NoActive_xxxxxxxx（8位随机字符） 所以跨大版本号升级/降级NoActive都需要去mt管理器卸载NoA的文件目录

墓碑附加模块的介绍

该模块是为了给新版本NoActive或Freezer提供必要的运行环境，想要使用新版本的NoActive，附加模块必须安装，别再问什么os什么ui要不要装了，必须装
附加模块已经整合了Hans_Config与Millet_Config_V2，并且自动判定使用哪个。所以说安装墓碑附加模块后，Hans_Config与Millet_Config_V2模块就可以卸载了
老版本NoActive也可以使用墓碑附加模块，没必要卸载了换回Hans_Config或Millet_Config_V2 当然，你使用了其他墓碑，为了禁用系统的墓碑也可以使用这个模块
墓碑附加模块内并未内置Re-kernel，Re-kernel跟墓碑附加模块也没有任何关系，所以别问刷了一个另外一个要不要刷这种问题了

注：如果刷入墓碑附加模块，NoActive UI或日志依然提示说要安装附加模块的，点击跳转到UI内一直弹出提示“请刷入附加模块并在LSPosed中激活NoActive”

如果你使用的是NoActive或Freezer，刷入了附加模块后，附加模块显示未在设备中发现Freezer和NoActive，这只是一个bug，具体以NoActive或Freezer的日记为准

如何正确的进行捐赠(重要)

在此之前，你可以查看历史更新记录，再决定是否需要进行捐赠：

https://down.app.myflv.cn/#/Pro/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97

捐赠链接快速访问：

https://qr.alipay.com/tsx16080oparhrwyitxop12

如果你认为本条链接并不安全，可以选择前往官方文档快速开始的最下面，付费说明里或NoActive的设置进行捐赠

下载任意版本的NoActive
打开NoActive的设置，设置最下面有支付宝捐赠的链接（一个激活码需捐赠10RMB）

注：别问为什么没有微信捐赠途径，没有就是没有如果你在其他地方发现有说是 @myflavor 的微信/支付宝捐赠途径/链接，请立即反馈，并且不要在那进行捐赠，被骗了我们并不会负责

前往激活码领取链接输入你领取激活码的邮箱地址与支付宝订单号激活码领取链接：https://app.myflv.cn/pay

注: 现在无需进入频道也可随时获取最新的下载密码，前往激活码找回链接，输入你领取激活码的邮箱，等待激活码与最新版下载密码的发放即可激活码找回链接：http://app.myflv.cn/find

如果你还想加入频道PRO用户的话

将捐赠截图发[反馈]NoActive并 @myflavor （不听的禁言7天起步）

:::caution 请先领取激活码再发捐赠截图，避免被小人先行一步领取激活码，激活码将通过你提供的邮箱地址进行发放，每个订单号只能输入一次，注意邮箱地址是否正确，注意查收邮件

::: 完成以上操作后，等待下载密码与激活码的发放，等待@myflavor 拉你进《富家子弟—NoActive》身份组

被拉进《富家子弟—NoActive》身份组后，将多出2个子频道： [Pro用户]NoActive [公告]NoA-Pro

注：别问什么时候拉你进身份组，由@myflavor 人工审核并拉入身份组，再问禁言 1天。点击跳转到激活码的使用

PRO版下载密码会发在[公告]NoA-Pro, 进了身份组频道就别退了，NoActive大多数东西，例如更改后的密码，更新的公告，都是在频道发布，你退出频道之后，身份组也会跟着丢失，付款后7天内退出又重新加入频道，有一次机会可拉回身份组，7天后则需重新捐赠走流程

激活码的说明

2024年2月18号前捐赠的用户，为不限设备用户（激活码请使用2月16之后发放的），该用户的激活码无激活设备限制，但激活3个设备后还要激活的需要带上你接收验证码的邮箱在【反馈】NoActive 告知@myflavor

2024年2月18号后捐赠，默认1个激活码10RMB 如果出现设备数量达到上线 需重新捐赠10r，然后前往激活码领取链接输入你领取激活码的邮箱地址与支付宝订单号 激活码领取链接：点击跳转

<!--

-->

:::warning

注：请注意，刷入或关闭改主板ID，序列号，机型的模块都会导致NoActive激活失效，使用该类型模块导致的激活失效，清除激活信息也会记录在3个月清除一次的记录内

如果你实在想对应用更改机型，可以考虑使用Zygisk-Tweaker对应用进行配置更改机型，或自行寻找能对应用单独改机型的模块修改。(Zygisk-Tweaker与Zygisk-Next疑似存在兼容性的问题，同时使用可能会发生卡第二屏的现象。)

使用Zygisk-Tweaker对应用进行配置后，会泄露Zygisk被配置的应用检测到。

https://www.coolapk.com/feed/51335047 (此链接无法访问)

:::

刷机的，只要没改变设备ID就可以继续使用激活码，如果不能重新使用，点击<a href="#激活码的说明">跳转到激活码的说明</a>解决（自己重新激活看看能不能激活成功就知道了，谁都不知道你刷的什么，没人能明确回答你）。
如果激活码丢失了，可以前往激活码找回链接输入你领取激活码的邮箱找回激活码激活码找回链接

激活码的使用

前置：请先确保你刷入了墓碑附加模块并在LSPosed中启用了NoActive，完成这两步之后，打开NoActive, UI无提示弹出，即可进行下一步操作

附加模块相关在墓碑附加模块的介绍

如果刷入墓碑附加模块，NoActive UI或日志依然提示说要安装附加模块的，点击UI内一直弹出提示“请刷入附加模块并在LSPosed中激活NoActive

获取激活码相关请点击跳转到如何正确的进行捐赠(重要)

打开NoActive的设置页面，”当前版本“这一项会显示“未激活”，点击“未激活”，之后会出现输入激活码的UI，将你的激活码输入，然后重启即可正常使用

如果遇到”激活出错”请排查你的网络问题和模块 如果遇到“激活设备达到上线”点击激活码的说明

如果使用了会更改设备id，序列号之类的模块，脚本请勿激活，否则重启之后会显示未激活，当你不小心使用了会更改设备id，序列号之类的模块，脚本，并且不小心激活了，记得关了，然后点击激活码的说明

如果你想获得更好的使用体验，可以考虑开启后台优化与内存优化（后台优化与内存优化默认不开启） 即解锁NoActive完全体

激活NoActive后直接在NoActive设置中开启后台优化，开启后NoActive最顶上会提示“当前配置重启后生效”，之后重启即可 （后台优化功能介绍请点击跳转到后台优化）

开启后台优化后，在NoActive的设置中长按“当前版本”一栏即可开启内存优化，开启后NoActive最顶上会提示“内存优化已开启，重启生效”，之后重启即可

注： 内存优化只有开启后台优化后才可使用 （内存优化功能介绍请点击跳转到内存优化） 后台优化与内存优化的关闭方法与开启相同，并且都需要重启

常见问题解答

需要使用的冻结模式

:::tip

如果内核支持v2, 那么始终建议使用v2

:::

根据内核判断，一般而言5.4及其往上使用v2，5.4以下使用v1或kill

对于部分厂商而言，4.19系内核且使用高通处理器的设备同样支持v2，这部分需要自行测试，或使用Tombed Monitor进行查看

如果不确定冻结模式选什么的可以下载Tombed Monitor查看，打开之后授权Root，然后点右上角感叹号就可以了

下载链接

显示已挂载v2就用v2 显示已挂载v1就用v1 显示不支持Freezer就用kill

系统不支持v2冻结,但是我想使用怎么办

如果你的内核是4.19，你可以尝试刷入挂载v2模块，看看挂载后能不能使用v2模式冻结（2个都可以试试，不保证成功，但是可以试试）

下载链接1 来自@ff19(频道ID)，由@Prslc(频道ID)修改，不限系统使用

下载链接2 来自@Jark006(频道ID),仅安卓11-安卓13可使用

如果你是其他内核，或4.19刷挂载v2，没能成功挂载v2，可以尝试刷入apatch的内核级挂载v2模块（详情可以看点击跳转到Re-kernel-KPM

:::important

注：如果你的机子，支持Binder临时解冻，请勿挂载v2（Apatch的内核级挂载除外），因为这将直接导致Binder通知事件消失。怎么检测是否支持Binder临时解冻请点击跳转到快速测试是否有Binder

在有Binder通知的情况下，使用v1其实与使用v2的体验并无太大区别，如果想完美使用v2,必须使用内核级别的挂载v2模块

:::

查看应用是否冻结

在NoActive主页中，先将应用列表切换为运行列表，这时候可以看见还在运行的非系统应用，如果应用后面有kill;v1;v2，并且写了X个进程X个已冻结则代表冻结成功

如果你使用的是3.5Pro-19或之后的版本，还可以点击想查询的应用，用以查看应用状态

:::important kill，v1，v2为使用的冻结方式，正常情况下不会同时出现，如果同时出现了你需要排除一下是否使用了多个墓碑，是否屏蔽系统墓碑等 冻结时，应用的所有进程一般也会全部冻结，例如3个进程3个已冻结，如果出现了冻结不完全你需要排除一下是否使用了多个墓碑，是否屏蔽系统墓碑等

:::

快速测试是否有Binder

使用陌陌判断(推荐)

下载链接
使用QQ登陆陌陌
日记出现Binder 临时解冻等字眼即可

:::important

注： 1.使用QQ登录陌陌时，QQ需要在后台，并且是冻结状态 2.如果没有Binder解冻，陌陌将登录不了，会出现白屏，无反应现象 3.如果你的系统不支持binder解冻，并且你使用是付费版的NoActiive。那么可以考虑使用Re-kernel系列模块获得binder事件的检测（具体可以查看Re-kernel）点击跳转日志查看方法

:::

从系统判断(不推荐)

这个方法只是单纯的猜,不能作为实际,因此已删除;

如无法使用陌陌判断,可使用一段时间(例如一天)后去日志查看是否包含有 Binder通知临时解冻 这样的内容,必须要有实际的Binder解冻,仅仅是日志的 xx专属Binder正常不能作为完全的判断依据

<div style="border: 2px solid #dddddd; border-radius: 10px;"> <details style="padding: 5px;"> <summary>删除的内容</summary> 这只是个初略的判断方法。我更建议你{% btn '#使用陌陌判断-推荐',使用陌陌判断,far fa-hand-point-right,outline blue larger %} 如果你使用的系统是官方的ColorOS；RealmeUI；MIUI；HyperOS；originOS，并且内核是官方内核，内核版本在5.10或以上，一般情况下，都是支持Binder解冻的 </details> </div>

UI内一直弹出提示“请刷入附加模块并在LSPosed中激活NoActive”

首先最基本的，你需要刷入附加模块，该“附加模块”指的是“墓碑附加模块”，而非Rekernel

下载链接与模块解释点击跳转到墓碑附加模块的介绍

排查Magisk版本

附加模块使用了Magiskpolicy来修补Selinux规则并允许 NoActive 加载 jni 运行库，但Magisk版本号高于27000并小于27007的版本存在一个未修复的Magiskpolicy bug，无法正常修补Selinux规则导致NoActive不能正常运行

如果你正在使用Kitsune Mask，请切换至Canary或Alpha，所有在Kitsune Mask环境下反馈的问题和bug均会被忽视

解决方法： 1.切换至Magisk Alpha 27006及其以上 2.切换至Magisk Canary 27007及其以上 3.切换至其它Root方案

下载地址

Magisk官方

Magisk Alpha

KernelSU (可考虑MKSU,链接自行探索)

Apatch：~~目前不建议使用，可能出现相同的问题~~ 自行探索

SukiSU等其他自行探索

排查LSPosed版本

有能力者请优先使用 LSPosed 内测版，内测版通用于目前所有主流安卓版本 内测版需要自己申请

如果你正在使用的安卓版本低于Android 14，请使用LSPosed官方版，即LSPosed 7024/7058
如果你正在使用Android 14及以上，可尝试使用LSPosed npm 7075，该版本在A14上已测试通过，可以正常使用NoActive，但A15未经测试，可自行尝试是否可用
如果你正在使用Android 15，可尝试使用LSPosed（By JingMartix）优先推荐使用内测版LSPosed，因为第三方LSPosed版本众多，出现bug各不相同，不会因为你使用的是改版LSPosed而修复bug

下载地址:

LSPosed 官方 (停更)

LSPosed 内测版申请

LSPosed npm

LSPosed（JingMatrix）

以上两种均符合还提示

如果你按照以上方式排查了，UI还是一直提示“请刷入附加模块并在LSPosed中启用NoActive”，可以尝试卸载墓碑附加模块重新刷入，不行的话再带着你的环境信息，到[Pro用户]NoActive进行提问

:::important

需要带上的环境信息有：

LSPosed版本，安卓版本，NoActive版本，使用的root管理器，root管理器的版本

:::

怎么查看日志

先从NoActive设置里查看你路径的输出方式(默认是框架，建议改成文件)

日志等级修改同样在NoActive设置中，一般来讲信息足矣，如果你需要反馈bug请使用调试

框架的输出路径在LSP的日志里 文件的输出路径在/data/system/NoActive_xxxxxxxx/的log文件与last.log文件里 log文件记录的是你当前的日志 last.log文件记录的是你最近一次重启前的日志 注： <del>改完文件输出路径需要重启才生效</del> 在新版本中是立即生效无需重启

如果出现多次系统界面Hook，说明你的系统界面莫名其妙的挂掉了，每次重启系统界面NoAcitve都会再次进行Hook以确保磁贴解冻正常工作

如图,属于正常现象

报错

NoAcitve的常见报错一般分为两种，前置Hook报错及冻结错误，此处仅讨论本条目更新时的最新版Pro-196

:::important

停更的正式版（3.3 Pro）不支持Android15，别再问为什么报错/用不了了 以下所有情况均为基于官方包官方内核讨论，如果你正在使用官改/第三方Rom，也可尝试按以下流程走，但既不保证解决问题也不保证你的问题能得到修复

:::

前置Hook报错

一般而言，这是因为你使用的LSPosed版本是三方/魔改版，请尽量使用LSPosed 7024/7058，有能力者尽量使用内测版LSPosed

关于Android 14/15 LSPosed版本的选择，排查LSPosed版本有详细说明，此处不再写

如果已经排查过LSPosed版本，但问题依然存在，可按照如何提问与反馈的格式向@myflavor 进行反馈

冻结错误

常见情况分为两种

2.1 该进程在被NoActive冻结时被杀死

出于很明显的原因，当NoActive冻结时进程必须存活，当进程死亡与冻结同时发生时就会出现该报错，属于正常情况

2.2 你使用了你的设备不支持的冻结方式

如果频繁出现该报错，说明你的设备不支持你选择的冻结方式，如何选择冻结方式写在需要使用的冻结模式，如果你的设备不支持v2冻结但你希望使用可看系统不支持v2冻结,但是我想使用怎么办

警告

NoActive的警告通常出现在你未在LSPosed中选择全部推荐作用域，目前只有一个不勾选文件的警告

检测Binder是否正常请点击快速测试是否有Binder

Re-Kernel的使用请点击Re-kernel

冻结系统应用

配置文件示例:

{
	"backgroundOptimize":false,
	"commandInject":true,
	"dozeType":"off",
	"freezeBinder":false,
	"memoryOptimize":false,
	"netLink":0,
	"rotationInterval":360,
	"rotationThaw":false,
	"skipXposed":true,
	"systemAppSet":[
		"com.tencent.mobileqq"
	],
	"userAppSet":[
		"com.agzvev.app",
		"com.whzvaj.app"
		
	]
}

systemAppSet意思为在NoA中将某个应用视为系统应用

例： 我想在NoA中，将用户应用“QQ”视为系统应用，应用列表中不出现“QQ”，就找到“QQ”的包名，输入到和示例文件中的相同位置

效果： 输入进去，并且保存重启了，NoA会将“QQ”从用户应用更改为系统应用，不会出现在应用配置列表里面，也不会进行冻结

userAppSet意思为在NoA中将某个应用识别为用户应用

例： 我想在NoA中，将系统应用“天气”视为用户应用，并可以进行配置冻结，就找到“天气”的包名，输入到和示例文件中"com.agzvev.app","com.whzvaj.app"相同的位置

效果： 输入进去后，并且保存重启了，NoA会将“天气”从系统应用识别更改为用户应用，默认冻结它，你可以在应用列表中对其进行配置（例如进行白名单，常驻通知等操作）

:::warning

注： 1.添加包名之前请仔细思考，确定是否要添加，@myflavor 不在列表加入系统应用最主要的原因就是，随意冻结可能会导致莫名的bug，以及系统应用利用Binder频繁解冻。 2.包名前后必须加"符号。 3.想添加多个应用，需要换行，并且在每个应用的包名后面加上英文,符号（最后的包名不需要加） 例： "com.agzvev.app", "com.whzvaj.app", "com.ajwvdv.app" 4.重启手机配置才生效。 5.如果你使用的是付费版本，将会出现冻结系统应用警告 6.如果你填写的包名格式不符合Json的语法要求，NoActive将自动还原该配置文件为默认配置 配置文件地址： /data/system/NoActive_xxxxxxxx/config/的MasterConfig.json文件

:::

官方文档原话：

为了保证系统稳定，系统应用不会被冻结，你可以修改/data/system/NoActive_xxxxxxxx/config/MasterConfig.json

通过userAppSet添加用户应用，格式应用包名例如 com.xiaomi.smarthome

再次提醒：谨慎进行配置！！！

视频演示:

始终无法解析摆烂了

设置白名单的应用被冻结

如果你设置白名单的应用被冻结了，一般有以下几种情况：

情况1.你刷了多个墓碑，设置白名单的应用被另外一个墓碑冻结了，

情况2.系统墓碑把白名单应用冻结了

情况3.其他原因

如果是情况1，卸载其他墓碑即可 如果是情况2，可以先确定一下你的系统 如果你是米系系统，请先检查一下有没有刷入Millet_Config_V2模块 如果你是Oppo系系统，请检查一下有没有刷入Hans_Config模块 如果你是除了这两个系统之外的系统，那么这个问题大概率无解，因为找不到对应的模块来禁用你系统的墓碑（这个可以不需要管，因为是系统墓碑冻结的，一般不会对使用体验造成太大的影响） 注： 因为墓碑附加模块把Hans_Config与Millet_Config_V2的模块内容整合进去了，并把他们的下载地址移除了，所以说你是，米系用户或oppo系用户，可以下墓碑附加模块安装上，以此禁用系统墓碑（附加模块介绍在点击跳转到墓碑附加模块的介绍） 如果你是情况3，欢迎带上你的系统环境+详细描述来群里提问

墓碑冻结应用后,应用不发送通知

你可以尝试让应用走第三方的push，或给予白名单

:::important

注： 如果你使用了华为的HMS push，请将HMS core给予白名单 微信不支持走第三方push，虽然有很多方法可以让其冻结后也能接收到消息，但是我都不推荐。<del>我还是建议你去骂（）小龙</del>

:::

HMS使用教程

~~MiPush使用教程：查看链接~~

不建议使用该MiPush教程,因为该教程版本过旧，建议滑动Android·墓碑频道到最下方能够看到"MiPush",点击会自动跳转至MiPush频道(或点击加入MiPush频道),随后查看讨论组的第一个选项"指南"

FCM相关问题

NoActive Pro现已支持FCM解冻

:::important

请不要问微信为什么走不了FCM推送，这本来就是玄学，与NoActive无关

:::

设置FCM解冻相关请查看：进阶文档

在使用NoActive后Zygisk失效

据@myflavor(频道ID)所说，掉zygisk是因为你使用的系统对system_server开启了ptrace调试

解决方法 1.使用历史版本里的163版本NoActive，在此之后的所有版本均存在该问题（163版不支持安卓15）

2.更换系统ROM

3.将selinux从宽容改成严格并重启（自行确定可行性）

如何提问与反馈

大部分时候，你应该考虑优先查看文档，而非选择出问题直接提问，更不要指望会有人立刻解答你的问题，管理的时间不是无限的，不会一天24小时盯着群

在查看文档无解答之后，可优先前往【Pro用户】NoActive进行提问

:::warning

注： 正如本条目开头所说，请优先查看文档，而非直接提问并希望有人给出解答

:::

如果确认是Bug，请按照以下格式操作

前往【反馈】NoActive按照以下格式把你遇到的Bug反馈进去即可

Bug反馈 安卓版本: 定制UI： 内核版本： 使用的冻结模式： Bug表现： 正常表现：

附上调试级别日志，大多情况下无需复现就能直接修复，最好再附上bug视频。如未上传，Bug可能无限期不修复

由于安卓的系统，内核众多，不可能每个系统，每个内核遇到的bug都给你修复，所以只能保证你是在官方系统，官方内核的情况下进行修复

请不要反馈看更新日志就能解决的睿智问题

例： Bug反馈 安卓版本：13 定制UI：MIUI14 内核版本：5.10 使用的冻结模式：v2 Bug表现：启用模块后重启，掉Zygisk 正常表现：启用模块后不掉Zygisk 再附上调试级别日志，最好再附上bug视频。大多情况下无需复现就能直接修复，如未上传，Bug可能无限期不修复 注： 请不要不带任何信息就在群里提问，每个人的环境，遇到的问题都不一样，没有统一的标准答案，所以说请一定要带上设备环境与详细信息

后台优化及内存优化

后台优化

激活NoActive后直接在NoActive设置中开启后台优化，开启后NoActive最顶上会提示“当前配置重启后生效”，之后重启即可

开启后NoActive会修改oom_adj，应用设置内将会多出重要程度一栏，有“高中低”选项给你选，白名单默认“高”，其他默认“低”，你按照你认为应用的重要程度了来设置就好了。设置后系统优先杀你设置不重要的应用，即先杀设置“低”的。

例子: 假如我这里有5款软件，scene,李跳跳，QQ,酷安，抖音。 scene对我来说很重要，我不想让他被系统随便杀死，那我就设置“高”。 李跳跳，酷安我觉得不是很重要，但是也不想让系统优先杀死他们，那我就设置“中”。 QQ，抖音对我来说一-点都不重要，系统可以优先杀死他们，那我就设置“低”。 系统在杀死了设置“低”的应用QQ之后如果内存充足，那么他就不会继续杀抖音，李跳跳，酷安，scene等。 如果杀死了设置低的应用QQ，抖音之后内存还是不足，那么他将会继续杀死设置“中”的应用酷安，李跳跳，直到达到系统内存阈值 注： 任何修改oom_adj的模块或功能都与后台优化冲突 后台优化本身并没有杀后台的行为，只是将应用进行排序，让系统自己杀后台

内存优化

开启后台优化后，在NoActive的设置中长按“当前版本”一栏即可开启内存优化，开启后NoActive最顶上会提示“内存优化已开启，重启生效”，之后重启即可

开启此功能后，NoActive会在应用页面切换时检测设备的内存使用率。当可用内存低于设定的保留值时，NoActive会评估应用的后台留存时长。仅对于重要程度设置为低的应用，如果这些应用在长时间未回到前台的情况下，将会被清理。清理的顺序从最长时间未开启的应用到最近开启的应用，直到内存使用率回升至保留值以上时停止清理。

:::important

从Pro-173开始，FCM临时解冻、Shell临时解冻、意图临时解冻、轮番解冻、UI设置白名单解冻、Binder解冻，都不会影响到OOM排序 注： 内存优化只有开启后台优化后才可使用 从Pro-173开始所有设备固定保留值为物理内存和虚拟内存的10% 如果你希望自定义，请查看：进阶文档

:::

Re-kernel

:::important

只有Pro版NoActive接入了Re-kernel，对于目前停更的免费版而言，刷入也不会有任何效果 (因为免费版更新时Re-kernel尚未出现)

:::

模块效果：

为不支持监测对应系统Binder通讯的系统添加共同的Binder通讯，使用的墓碑模块只需要接入了Re-kernel就可以监测Binder。如果你的系统能被检测到Binder，并且可以正常使用，就没必要刷了

Re-kernel跟墓碑附加模块并没有任何关联。不存在刷了一个另外一个有没有必要刷的情况。

对于米系，OPPO系，VIVO系原厂系统用户，因为NoActive支持这三家系统底层的binder通讯检测，所以刷不刷都行，但如果你使用自带的Binder时出现重载，闪弹，卡屏现等象可尝试刷入Re-kernel看看能不能解决，但其他系统的用户，为了更好的使用体验，还是建议刷上

注： 关于是否能被检测到Binder，是否有Binder解冻可以看快速测试是否有Binder LKM版Re-kernel与KPM版Re-kernel并不兼容，一起使用会死机（来自Re-kernel kpm的作者@lztxer(频道ID)的提醒）

Re-kernel LKM

:::warning

使用要求 内核大版本必须大于等于5.10（低于5.10请点击跳转到Re-kernel-KPM） 目前已知Pandora内核，Marisa内核，OriginOS系统内核，HarmonyOS系统内核，较新魅族系统内核无法使用该版rekernel，请使用kpm版rekernel跳转到Re-kernel-KPM） 注： 移植包正常情况下是没有Binder通知的。关于闪弹，重载，卡屏的词语解释在名词解读

:::

Re-kernel模块名称解析：

ReKernel-Lite-v7.5 -（5.10 A12）.zip rekernel: 模块名称 Lite：去除了网络通讯通知，精简了对应的代码（精简掉的代码是配合网络解冻使用的，但NoActive没有这个功能，故而精简对应的代码） V7.5：模块版本 5.10 ：对应的内核版本 a12：指定了内核安卓版本”为Android12的才可用，未表明a几则无需在意这个

Re-kernel下载链接

注：对应内核版本下载，不要下错了 例： 5.10内核用户下载5.10的 Re-Kernel-v7.5-5.10.zip 5.15内核用户下载5.15的 Re-Kernel-v7.5-5.15.zip 6.1内核用户下载的6.1的 Re-Kernel-v7.5-6.1.zip 警告： 内核为6.1的OPPO系统用户，使用ksu的情况下请勿刷版本为v2.7的rekernel

Re-kernel KPM

该模块能被4.4；4.19；5.4；5.10；5.15；6.1的内核使用，但是因为需要兼容低版本内核，所以说在执行效率上不如LKM版Rekernel，高版本内核推荐LKM版Rekernel
由于该模块的特殊性，所以需要依靠Apatch管理器运行，所以在此之前，你需要把管理器更换成Apatch或者让Magisk/Kernel SU与Apatch共存

方法
Re-kernel KPM官方路径链接

:::warning

注： kpm无需看内核下载对应的版本，只要是模块支持的内核版本，一般选择最新刷入即可因为NoActive并没有网络解冻功能，所以优先推荐使用没network后缀的版本 如若内核不支持该模块，将会导致手机发生死机；无限重启；软重启等现象 模块支持的内核版本。内核不支持该模块是两个概念，请勿搞混，如若发生死机；无限重启；软重启等问题，先刷入原Boot 如果你正在使用VK内核，则需要去配置文件里把netlink后面的数字改成26，这是因为VK内核自带的Rekernel是残疾状态，不会告知binder通讯，且会与Rekernel KPM抢占通讯通道，这将会导致NoActive日志显示连接成功，但事实上不会输出binder并解冻应用 配置文件目录：/data/system/NoActive_xxxxxxx/config/MasterConfig.json

:::

因为Apatch的特殊性，所以写上2条你们可能用得上的特殊KPM模块
- 4.1 挂载v2模块（4.4；4.9；4.14；419可用）
  
  官方路径链接：查看链接
- 4.2 拦截内核kill信号模块（保后台类型）
  
  官方路径链接：查看链接

名词解读

白重载

由应用被压缩太严重，进程被杀或者应用没及时进行解冻造成。

表现为：

打开应用，应用页面重新加载

黑重载

相当于冷启动，因为存在程序不完整或者进程丢失，也就是炸binder。

表现为：

应用黑闪一下，出现桌面，然后重新加载页面

闪弹

目前闪弹触发条件不明，我觉得大部分出现于kill上面。

表现为：

应用进入后台之后再次打开，应用在动画没结束的时候就会自动闪退。等再次进入的时候就会发现重新启动了【这种再次重新加载也被成为冷启动】

内存泄漏

1.当你打开软件，然后清掉后台，重复操作，内存占用会一直累加，等到内存耗尽，就会出现卡顿和死机

正常情况下杀死应用后会回收应用占用内存（如QQ占用1.7G内存，杀死QQ及其后台以后系统应能空闲出1.7G左右内存），但是内存泄漏情况下杀死应用后内存不会被回收，导致内存占用越来越多。目前仅freezerv1存在此问题。

表现为：

打开进程查询软件，如果出现2个一样的进程就是内存泄露（非双开应用）

注：

内存泄露会无法释放内存，导致内存满手机卡死，noa3x已经打了内存泄露补丁缓解，但是还是会造成内存泄露

解决方法：

重启手机

掉卡片

表现为：

1.软件进程还在，你去点应用的快捷方式还能打开，但是后台任务卡片掉了

2.长时间不用的app在后台界面，卡片和进程一起丢失

解决方法：

刷入hook了后台防掉卡片的模块，例如后台优化，AppRetention等

冻死

目前出现情况不明，在冻它和noa中我都见过冻死

表现为：

1.滑动页面，点击页面无响应

2.滑动页面，点击页面无响应，重新切一次后台才能显示刚刚滑动，点击的页面，但是继续滑动页面，点击页面还是无响应，需要重新切一次后台才能显示刚刚滑动，点击的页面

解决方法：

杀死应用重新打开一次

注：

把应用从后台切换至前台，其中有一段时间无法滑动屏幕，需要过一段时间才可以滑动屏幕，这不是冻死，而是应用从交换分区交换至RAM中，或者是应用还在解冻中（一般情况下为前者）

卡屏

日前怀疑是binder有问题出现的

表现为：

点击/滑动页面无响应，切后台重新进就正常

卡屏与冻死的区别：

卡屏切换后台重新进就解决，冻死之后，切换后台重新进也只是加载一下页面而已，滑动，点击还是不响应，切一次后台加载一下页面

假断网

出现情况不明表现为：重新打开应用，在网络正常的情况下，应用无法连接网络解决方法：杀死应用重新打开一次

Binder

1.Binder驱动是系统里负责应用之间通信，传递通信数据的驱动，位于dev/binder。如果应用只是冻结的运行，而没有冻结其binder通信接口，那么在其冻结状态下，如果遇到其他应用发来的通信请求，京就无法及时回复，超时不回复将被安卓框架层认为应用运行异常而杀死。而后应用解冻时，大概率将发生瞬间闪退，重启，重载等等情况（来自冻它官网）

2.常见binder通信路径在/dev/binder如果你刷的第三方内核魔改了binder就会出现路径错乱情，况只有小米原生墓碑才能使用binder_ open外加binder_ Freezer 在冻它对binder使用的是/dev/binder所以如果是5.4内核的就不要刷所谓的完整binder通信的内核除非你用小米的原生墓碑( 来自 @魔威补充)

3.虽然平时一直只说binder，实际上是两个东西，binder是Android本来就有的，冻结提到的binder实际上是通知墓碑有binder消息，要不要解冻（来自@lztxzr 补充）

Freezer

Freezer是cgroup的其中一个子控制器，用于冻结进程的CPU使用权。

FreezerV1

Freezer1很早便在内核中支持，3.×/4.×/5.×内核都会支持。部分内核的FreezerV1存在缺陷，进程处于冻结状态时无法被杀死，依旧占据内存，类似内存泄漏，需要解冻才能结束进程并释放内存。这是内核级缺陷，应用层大率无法解决，只能积极解冻来缓解

注：某些手机厂商基于V1的墓碑机制（例如Freezerv1版Millet）会捕获杀进程信号及时解冻，这样会及时释放进程的内存。（充电时或者各类按键事件时，Millet也会积极解冻应用

FreezerV2

Freezer2在5.4内核Android11起支持，冻结效果好，且没有V1的类似内存泄漏问题高通平台一般在4.19内核就获得支持，但部分厂商的手机可能默认不会开启，需要使用额外模块手动开启。谷歌Pixel某些机型甚至在4.14内核中也有实现

SIGSTOP

SIGSTOP是Linux中编号19的系统信号，不能被进程捕获，一旦进程收到该信号则被立即强制暂停运行。

解冻方式

Binder 解冻

利用系统间的通讯 binder进行临时解冻

效果最好

轮番解冻

因为没有binder压死之后就需要让app来活一会让他以为自己还活着，轮的意思是轮着解

冻一个app3秒，解冻是最久没打开的那个app

例：

我有5个应用，正常情况下是按顺序解冻的，也就是12345，但这时候我突然打开了3了，这时候顺序就会变成12453。

noactive拥有这种解冻方式，该解冻方式不如binder解冻，只能作为binder解冻的下位品

定时解冻

设置一个解冻时间，时间到了应用全部解冻

冻它拥有这种解冻方式，该解冻方式不如binder解冻，只能作为binder解冻的下位品

单应用定时解冻

给应用绑定一个单独的定时器，时间到了解冻该应用。效果也好，但是会略微增加功耗

仅noactive-2.0拥有这种解冻方式，该解冻方式虽然不如binder解冻，但能与轮番解冻形成互补

其他内容

NoActive进阶文档

3X-UI安装使用教程

璨梦踏月 — Thu, 07 Aug 2025 00:00:00 GMT

:::important

本项目仅用于个人使用和通信，请勿将其用于非法目的，请勿在生产环境中使用。

:::

:::tip

更新日志: 2025-10-11: 增加新的reality筛选域名方法

:::

3X-UI是什么?

3X-UI — 一个基于网页的高级开源控制面板，专为管理 Xray-core 服务器而设计。它提供了用户友好的界面，用于配置和监控各种 VPN 和代理协议。

快速开始

支持的操作系统

:::tip

如果在这里没有你的操作系统，你可以使用 Docker。

:::

System	Minimal Version
Ubuntu	22.04
Debian	12
CentOS	8
OpenEuler	22.03
Fedora	36
AlmaLinux	9.5
Rocky Linux	9.5
Oracle Linux	8
Amazon Linux	2023
Virtuozzo Linux	8
Windows	Server 2016

详细内容建议直接看官方文档

开始安装

默认你当前已在root用户

如果已运行防火墙,请自行放行对应端口

运行:

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

等待提示:

Would you like to customize the Panel Port settings? (If not, a random port will be applied) [y/n]:

选择y输入你想自定义的端口或随机端口

然后会提示

###############################################
Username: xxx
Password: xxx
Port: 12345
WebBasePath: xxx
Access URL: http://xxx.xxx.xxx.xxx:12345/xxx
###############################################

妥善保存这些内容.~~如果你的机器非nat机器,那么直接复制Access URL的内容粘贴到浏览器打开,输入上面的用户名和密码即可进入,nat机器需要额外前往服务商转发端口~~ :::caution 请勿在面板没有开启SSL登录之前直接访问面板,这会导致面板信息/节点信息暴露

没有开启前应使用本地终端与VPS建立加密隧道然后访问面板

ssh -L <本地端口>:127.0.0.1:<远程面板端口> <服务器用户名>@<服务器IP>
# 例：ssh -L 54321:127.0.0.1:55555 root@178.157.58.201

# 若 SSH 用非默认端口（如 2222），加 -p 2222：

ssh -fN -p 2222 -L <本地端口>:127.0.0.1:<远程面板端口> <服务器用户名>@<服务器IP>
# 例：ssh -fN -p 2222 -L 54321:127.0.0.1:55555 root@178.157.58.201

:::

常用配置

左侧入站列表->添加入站

vless+tcp+reality

名称	值
协议	vless
安全	reality

然后下方点击Get New Cert,点击创建;创建完成后点击左侧+号,点击编辑客户端Flow改为xtls+rprx-vision

左侧二维码点击后即可扫描使用(或可点击更多信息,也有订阅链接)

:::note

nat机器注意设置转发端口

:::

这种是最常见的, 也是绝对性能最高的方案.

该方案优点: 直接传输 TCP 流量, 并在承载 TLS 流量时启用零拷贝, 避免了双重加密; 通过 “vision” 的方案对 TLS 握手包执行 padding 以尽可能消除 TLS in TLS 的特征.

该方案缺点: 在代理服务器位于美西等地, 延迟较大的场景下, 由于执行零拷贝无法复用连接, 每承载一个请求都会建立一个底层 TLS 连接, REALITY 目前的官方实现 (by RPRX) 并没有正确实现会话恢复, 导致每次建立底层 TLS 连接都得执行完整的握手流程, 延迟就直接起飞了. 如果 “偷” 证书的目标选得不好, 落地机器到之的延迟也不低的话, 雪上加霜.

偷邻居的域名

使用脚本(方案1)

脚本来源:

https://www.youtube.com/watch?v=zE8CFQ6muUI

https://v2rayssr.com/reality-2.html

在自己的设备上下载适合自己设备的版本(非Linux,Windows设备需要自行编译;MacOS用户可访问上方第二个链接的博客下载)

https://github.com/XTLS/RealiTLScanner/releases

在自己设备上运行命令 (将VPSIP改为你自己VPS的IP) :::important 尽量在本地运行，不要在远端 :::

# MacOS、Linux 命令
# 若是提示文件损坏请 执行 sudo xattr -r -d com.apple.quarantine （app地址）
./RealiTLScanner -addr VPSIP -port 443 -thread 100 -timeout 5 -out file.csv

# Windows 命令:
RealiTLScanner-windows-64.exe -addr VPSIP -port 443 -thread 100 -timeout 5 -out file.csv

使用SSH连接VPS,将RealiTLScanner输出的文件上传到VPS,然后在文件同目录下运行

https://github.com/V2RaySSR/RealityChecker/releases

# centos 把 apt 换为 yum 

apt update
apt install unzip curl wget -y

# 根据自己的系统架构下载相对应的版本 以下为 X86 机型
wget https://github.com/V2RaySSR/RealityChecker/releases/latest/download/reality-checker-linux-amd64.zip
unzip reality-checker-linux-amd64.zip
chmod +x reality-checker

# 开始检测
./reality-checker check apple.com                           # 基础单域名检测
./reality-checker batch apple.com tesla.com microsoft.com   # 批量检测多个域名（空格分隔）
./reality-checker csv file.csv                              # 从CSV文件批量检测域名

手动筛选(方案2)

目标网站必须满足 5 个条件：

使用 TLS 1.3 协议
- 打开网站，按 F12，在设置中更改显示语言
- 在 "安全" 选项卡下，"连接" 应显示 "TLS 1.3，X25519 和 AES_xxxx"
使用 X25519 签名算法
支持 HTTP/2 协议（H2）
- 在控制台中输入window.chrome.loadTimes()?.npnNegotiatedProtocol，输出的值应为 "h2"
不使用 CDN - 如果 Reality 目标网站使用 CDN，数据将转发到 CDN 节点，使你的 Reality 节点成为别人的反向代理加速节点
- 检查网站是否使用 Cloudflare CDN，如果在使用，则这个域名不可以使用 (用itdog ping一下看IP位置是否是Anycast/cloudflare.com)
中国境内不依赖任何代理可以直接访问 (https://www.itdog.cn/ping/ 输入域名,持续测试,全红就别用了)

ASN 查询工具

FOFA 目标网站查询工具

首先使用 ASN 查询工具，输入你的服务器 IP，记录下你的服务器所在 ASN
使用下面代码块中的这段搜索条件，将 ASN 替换为你查询出来的数字，在 FOFA 进行搜索。下面的示例代码含义是「查询自治域为 xx，xx区域，端口为 443，证书不是由 Let's Encrypt 或者 ZeroSSL 颁发的，且请求成功的网站。」

country 字段为国家地区两字母代码，可在以下网站寻找
- 百度百科链接
- 维基百科链接
```
asn=="xx" && country=="xx" && port=="443" && cert!="Let's Encrypt" && cert.issuer!="ZeroSSL" && status_code="200"
```
从搜索结果中，找到有域名的网站，检查是否满足上面的5个条件, 全都满足就可以考虑使用了

vless+xhttp+reality

日常浏览网页比较多, 看视频或者大流量下载比较少的场景下推荐 (能复用连接).

vless+tls+xhttp+cdn

绑定域名(A记录),填写主机和路径,申请SSL证书并填入即可

Hysteria 2

非3X-UI面板搭建,详情见 Hysteria2-Install

Hysteria2节点搭建教程

璨梦踏月 — Thu, 07 Aug 2025 00:00:00 GMT

:::important

本项目仅用于个人使用和通信，请勿将其用于非法目的，请勿在生产环境中使用。

:::

:::tip

默认你是在常见的 Linux 发行版安装

更新日志 2025-08-22: 增加其他优化 :::

快速开始

运行

bash <(curl -fsSL https://get.hy2.sh/)

出现What's next?后运行下面的命令设为开机自启

systemctl enable hysteria-server.service

修改配置文件

运行

nano /etc/hysteria/config.yaml

没有 nano ?自己安装去,或者换其他文本编辑器

复制并粘贴

alt+\ , alt+a , alt+/ , ctrl+k ,即可删除原文件所有内容

listen: :443 #默认端口443，可以修改为其他端口

#使用CA证书
#acme:
#  domains:
#    - your.domain.net #已经解析到服务器的域名
#  email: your@email.com #你的邮箱

#使用自签证书
#tls:
#  cert: /etc/hysteria/server.crt 
#  key: /etc/hysteria/server.key 

auth:
  type: password
  password: 123456 #认证密码，使用一个强密码进行替换

resolver:
  type: udp
  tcp:
    addr: 8.8.8.8:53 
    timeout: 4s 
  udp:
    addr: 8.8.4.4:53 
    timeout: 4s
  tls:
    addr: 1.1.1.1:853 
    timeout: 10s
    sni: cloudflare-dns.com 
    insecure: false 
  https:
    addr: 1.1.1.1:443 
    timeout: 10s
    sni: cloudflare-dns.com
    insecure: false

masquerade:
  type: proxy
  proxy:
    url: https://cn.bing.com/ #伪装网址
    rewriteHost: true

加下来分两种

有域名 (使用ACME自动获取域名TLS证书)

把 acme 部分取消注释
把你的域名使用A记录解析到你的服务器IP地址(如果是 cloudflare 不要开小黄云)
然后把配置内的域名和邮箱改为你的域名和邮箱

无域名 (自签证书)

把 tls 部分取消注释
运行下面命令生成自签证书

openssl req -x509 -nodes -newkey ec:<(openssl ecparam -name prime256v1) -keyout /etc/hysteria/server.key -out /etc/hysteria/server.crt -subj "/CN=bing.com" -days 3650 && sudo chown hysteria /etc/hysteria/server.key && sudo chown hysteria /etc/hysteria/server.crt

伪装网址

建议使用个人网盘网址,例如cloudreve

可以在搜索引擎通过语法intext:cloudreve搜索,也可搜索其他网盘,例如Alist等(可以使用更详细的关键词,例如intext:登录 - Cloudreve)

运行

启动

systemctl start hysteria-server.service

查看状态

systemctl status hysteria-server.service

没有报错即可

重新启动

systemctl restart hysteria-server.service

然后,~~自行拼接~~

hysteria2://<密码>@<服务器IP>:<端口>/?sni=<SNI>&insecure=1#<节点名>

insecure=1是跳过证书验证,仅自签证书需要使用

卸载

bash <(curl -fsSL https://get.hy2.sh/) --remove

其他优化

系统缓冲区大小 Linux

# 将发送、接收两个缓冲区都设置为 16 MB
sysctl -w net.core.rmem_max=16777216
sysctl -w net.core.wmem_max=16777216

或者一键脚本/面板

https://github.com/yonggekkk/sing-box-yg

h-ui

解决 Docker 创建容器时的 “read-only file system” 报错

璨梦踏月 — Tue, 05 Aug 2025 00:00:00 GMT

:::caution[AI内容警告]

本文使用了AI润色,更多内容请看文章内容说明

:::

如果你在创建容器时遇到了这样的报错(read-only file system)：

docker: Error response from daemon: error while creating mount source path '/opt/1panel/apps/xxx': mkdir /opt/1panel: read-only file system

并且对应目录(我这里是/opt)权限没问题。可以先用 which docker 命令检查一下 Docker 的来源, 如果是 snap，那恭喜你，找对地方了。

root@cmtys:~# which docker
/snap/bin/docker

问题原因

Snap 的沙箱机制导致的。

Snap 是 Ubuntu 上一种软件包格式，它为了安全，会把应用关在一个“笼子”里。这个笼子里的 Docker，默认只能访问自己的目录和用户的主目录 ($HOME)。所以，当我们用 docker run -v /opt/... 去挂载笼子外面的 /opt 目录时，Snap 就直接把它拦下来了。Docker 自己也搞不清楚状况，就只能报一个误导性极强的“文件系统只读”错误。

解决方案

搞清楚原因后，就有两种解决办法了。

办法一：换掉 Snap 版 Docker (推荐)

这是最直接的方法，换成从 Docker 官方源安装的版本，一劳永逸。

:::caution[注意]

[1;31m操作前请先备份重要数据[0m

::: :::caution[注意]

[1;31m数据无价,谨慎操作[0m

:::

先卸载掉 Snap 版
```
sudo snap remove docker
```
卸载过程慢是正常的, 能打包两年半。
用官方脚本安装
```
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
```
:::tip[网络问题] 如果觉得官方脚本下载慢，也可以手动添加国内的 Docker 镜像源来加速。 :::
验证一下

装好后可以跑个 docker run hello-world 试试。如果提示命令找不到，执行 hash -r 刷新一下 Shell 缓存。

办法二：换目录

把要挂载的目录放到 $HOME 下面，比如 $HOME/docker-data/ 。

Fuwari 主题 Markdown 速查表与高级用法

璨梦踏月 — Mon, 04 Aug 2025 00:00:00 GMT

:::caution[AI内容警告]

本文为AI翻译expressive-code和markdown-extended并总结, 然后人工查错并优化, 更多内容请看文章内容说明

:::

高级 Markdown 用法参考(总结自`expressive-code`和`markdown-extended`)

本文旨在展示 Fuwari 主题支持的更多高级格式，您可以参考这些示例来丰富您的文章内容。

A.1 GitHub 仓库卡片

您可以嵌入一个动态的 GitHub 仓库卡片，它会在页面加载时自动获取最新的仓库信息。

::github{repo="saicaca/fuwari"}

用法：

::github{repo="<owner>/<repo>"}

A.2 警告框 (Admonitions)

警告框用于突出显示特定信息，支持多种类型。

:::note Note (注释): 用于突出那些即使用户只是扫读也应注意到的信息。 ::: :::tip Tip (提示): 提供一些可选信息，帮助用户更成功地完成操作。 ::: :::important Important (重要): 对用户成功至关重要的信息。 ::: :::warning Warning (警告): 要求用户立即关注的关键内容，因其存在潜在风险。 ::: :::caution Caution (小心): 指出某个操作可能带来的负面后果。 :::

基础语法

:::note
用于突出那些即使用户只是扫读也应注意到的信息。
:::

:::tip
提供一些可选信息，帮助用户更成功地完成操作。
:::

自定义标题

您也可以为警告框添加自定义标题。

:::note[这是一个自定义标题] 这是一个带有自定义标题的注释。 :::

用法：

:::note[这是一个自定义标题]
这是一个带有自定义标题的注释。
:::

GitHub 风格警告框

同样支持 GitHub Flavored Markdown 的警告框语法。

[!TIP] 这是一个 GitHub 风格的提示。

用法：

> [!NOTE]
> 这是一个 Note。
> [!TIP]
> 这是一个 Tip。

A.3 Expressive Code 代码块增强

语法高亮 (Syntax Highlighting)

常规语法高亮

console.log('这段代码被语法高亮了！')

用法:

```js
console.log('这段代码被语法高亮了！')
```

渲染 ANSI 转义序列

ANSI colors:
- Regular: [31mRed[0m [32mGreen[0m [33mYellow[0m [34mBlue[0m [35mMagenta[0m [36mCyan[0m
- Bold:    [1;31mRed[0m [1;32mGreen[0m [1;33mYellow[0m [1;34mBlue[0m [1;35mMagenta[0m [1;36mCyan[0m
- Dimmed:  [2;31mRed[0m [2;32mGreen[0m [2;33mYellow[0m [2;34mBlue[0m [2;35mMagenta[0m [2;36mCyan[0m

256 colors (showing colors 160-177):
[38;5;160m160 [38;5;161m161 [38;5;162m162 [38;5;163m163 [38;5;164m164 [38;5;165m165[0m
[38;5;166m166 [38;5;167m167 [38;5;168m168 [38;5;169m169 [38;5;170m170 [38;5;171m171[0m
[38;5;172m172 [38;5;173m173 [38;5;174m174 [38;5;175m175 [38;5;176m176 [38;5;177m177[0m

Full RGB colors:
[38;2;34;139;34mForestGreen - RGB(34, 139, 34)[0m

Text formatting: [1mBold[0m [2mDimmed[0m [3mItalic[0m [4mUnderline[0m

用法:

```ansi
ANSI colors:
- Regular: [31mRed[0m [32mGreen[0m [33mYellow[0m [34mBlue[0m [35mMagenta[0m [36mCyan[0m
- Bold:    [1;31mRed[0m [1;32mGreen[0m [1;33mYellow[0m [1;34mBlue[0m [1;35mMagenta[0m [1;36mCyan[0m
- Dimmed:  [2;31mRed[0m [2;32mGreen[0m [2;33mYellow[0m [2;34mBlue[0m [2;35mMagenta[0m [2;36mCyan[0m

256 colors (showing colors 160-177):
[38;5;160m160 [38;5;161m161 [38;5;162m162 [38;5;163m163 [38;5;164m164 [38;5;165m165[0m
[38;5;166m166 [38;5;167m167 [38;5;168m168 [38;5;169m169 [38;5;170m170 [38;5;171m171[0m
[38;5;172m172 [38;5;173m173 [38;5;174m174 [38;5;175m175 [38;5;176m176 [38;5;177m177[0m

Full RGB colors:
[38;2;34;139;34mForestGreen - RGB(34, 139, 34)[0m

Text formatting: [1mBold[0m [2mDimmed[0m [3mItalic[0m [4mUnderline[0m
```

编辑器与终端窗口 (Editor & Terminal Frames)

代码编辑器窗口

可以通过 title 属性为代码块添加标题。

console.log('这是一个标题属性的例子')

用法:

```js title="my-test-file.js"
console.log('这是一个标题属性的例子')
```

也可以通过在代码块顶部添加注释来指定文件名。

<!-- src/content/index.html -->
<div>这是一个文件名注释的例子</div>

用法:

```html
<!-- src/content/index.html -->
<div>这是一个文件名注释的例子</div>
```

终端窗口

echo "这个终端窗口没有标题"

用法:

```bash
echo "这个终端窗口没有标题"
```

Write-Output "这个有标题！"

用法:

```powershell title="PowerShell 终端示例"
Write-Output "这个有标题！"
```

覆盖窗口类型

你可以强制改变窗口的类型，例如将一个通常显示为终端的 sh 代码块变为无边框样式。

echo "看，没有边框了！"

用法:

```sh frame="none"
echo "看，没有边框了！"
```

或者将 PowerShell 代码块强制显示为代码编辑器样式。

# 如果不覆盖，这会是一个终端窗口
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
New-Alias tail Watch-Tail

用法:

```ps frame="code" title="PowerShell Profile.ps1"
# 如果不覆盖，这会是一个终端窗口
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
New-Alias tail Watch-Tail
```

文本与行标记 (Text & Line Markers)

标记整行与行范围

使用 {} 来指定需要标记的行号。

// 第 1 行 - 通过行号标记
// 第 2 行
// 第 3 行
// 第 4 行 - 通过行号标记
// 第 5 行
// 第 6 行
// 第 7 行 - 通过范围 "7-8" 标记
// 第 8 行 - 通过范围 "7-8" 标记

用法:

```js {1, 4, 7-8}
// 第 1 行 - 通过行号标记
// ...
```

选择行标记类型 (mark, ins, del)

可以分别指定 mark (普通标记), ins (插入), del (删除) 三种类型的行。

function demo() {
  console.log('这行被标记为 "删除"');
  // 这行和下一行被标记为 "插入"
  console.log('这是第二行 "插入" 的内容');

  return '这行使用默认的中性标记类型';
}

用法:

```js title="line-markers.js" del={2} ins={3-4} {6}
function demo() {
//...
}
```

使用类 Diff 语法

+这行将被标记为插入
-这行将被标记为删除
这是普通的一行

用法:

```diff
+这行将被标记为插入
-这行将被标记为删除
这是普通的一行
```

结合语法高亮与类 Diff 语法

  function thisIsJavaScript() {
    // 整个代码块都会被高亮为 JavaScript，
    // 同时我们仍然可以添加 diff 标记！
-   console.log('将被移除的旧代码')
+   console.log('闪亮的新代码！')
  }

用法:

```diff lang="js"
//...
```

标记行内文本

通过 "字符串" 或 /正则表达式/ 来标记行内的特定文本。

function demo() {
  // "文本" 这个词会被标记
  return '这段文本中的"文本"二字会被标记。';
}

用法:

```js "文本"
function demo() {
//...
}
```

使用正则表达式

console.log('单词 "yes" 和 "yep" 会被标记。')

用法:

```ts /ye[sp]/
console.log('单词 "yes" 和 "yep" 会被标记。')
```

自动换行 (Word Wrap)

默认情况下，长代码行会自动换行。你可以通过 wrap 或 wrap=false 来控制单个代码块的行为。

// 带自动换行的例子
function getLongString() {
  return '这是一个非常非常长的字符串，除非容器特别宽，否则它很可能无法在可用空间内完全显示。'
}

用法:

```js wrap
//...
```

可折叠区域 (Collapsible Sections)

使用 collapse={...} 来指定需要默认折叠的行范围。

// 所有这些模板设置代码都将被折叠
import { someBoilerplateEngine } from '@example/some-boilerplate'
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'

const engine = someBoilerplateEngine(evenMoreBoilerplate())

// 这部分代码将默认可见
engine.doSomething(1, 2, 3, calcFn)

function calcFn() {
  // 你可以有多个折叠区域
  const a = 1
  const b = 2
  const c = a + b

  // 这部分将保持可见
  console.log(`计算结果: ${a} + ${b} = ${c}`)
  return c
}

// 从这里到代码块结束的所有代码将再次被折叠
engine.closeConnection()
engine.freeMemory()
engine.shutdown({ reason: '示例模板代码结束' })

用法:

```js collapse={1-5, 12-14, 21-24}
//...
```

行号 (Line Numbers)

显示行号

使用 showLineNumbers 来为代码块开启或关闭行号显示。

// 这个代码块会显示行号
console.log('来自第 2 行的问候！')
console.log('我在第 3 行')

用法:

```js showLineNumbers
//...
```

禁用行号

// 这个代码块已禁用行号
console.log('Hello?')
console.log('Sorry, do you know what line I am on?')

用法:

```js showLineNumbers=false
// 这个代码块已禁用行号
console.log('Hello?')
console.log('Sorry, do you know what line I am on?')
```

更改起始行号

使用 startLineNumber 来指定行号的起始数字。

console.log('来自第 5 行的问候！')
console.log('我在第 6 行')

用法:

```js showLineNumbers startLineNumber=5
//...
```

A.4 链接卡片 (Link Cards)

:::note[内容来源说明] 本部分内容基于 link-cards 的原始英文文档, 并参考了 Pull Request #324 中的实现, 在此基础上进行翻译、整理和补充。 :::

链接卡片（Link Cards）功能可以将 Markdown 中的裸链接（Bare Link）渲染成美观的卡片样式。

基本用法

在 Markdown 的段落中, 只需单独放置一个“裸”链接（即没有链接文本的链接）, 它就会被自动转换为链接卡片。

支持以下格式:

**外部链接**
https://astro.build/
<https://github.com/saicaca/fuwari/>
[https://fuwari.vercel.app/](https://fuwari.vercel.app/)

**内部链接** (需要额外配置)
[/posts/guide/](/posts/guide/)

**国际化域名 (IDN)**
https://はじめよう.みんな/

渲染效果如下:

https://astro.build/

https://github.com/saicaca/fuwari/

https://fuwari.vercel.app/

[!TIP] 卡片显示后, 尝试切换一下主题颜色或开启暗黑模式看看效果！

高级配置选项

<details> <summary>点击展开详细配置</summary>

您可以在 astro.config.mjs 文件中对链接卡片功能进行详细配置。

启用插件

首先, 你需要在配置文件中引入并启用插件。

import fuwariLinkCard from "./src/plugins/fuwari-link-card.ts"

export default defineConfig({
  // ...
  integrations: [
    // ...
    fuwariLinkCard(), // 在这里添加插件
    // ...
  ]
})

如果插件的加载顺序比较复杂, 您也可以将其作为一个 remark 插件来指定:

import remarkLinkCard from "./src/plugins/remark-link-card.ts"

export default defineConfig({
  // ...
  markdown: {
    // ...
    remarkPlugins: [
      // ...
      remarkLinkCard, // 在这里添加插件
      // ...
    ],
  },
})

主要配置项

名称	类型	默认值	描述
`devMode`	`boolean`	`import.meta.env.DEV`	启用或禁用开发模式。
`excludedUrls`	`Array<string \| RegExp>`	`[]`	一个由字符串或正则表达式组成的列表, 用于排除特定的 URL, 防止它们被处理成链接卡片。这也有助于避免与其他插件冲突。
`linkAttributes`	`Object`	`{ target: '', rel: '' }`	为外部链接设置 `target` 和 `rel` 属性。也可以留空, 将处理交由其他插件决定。
`rewriteRules`	`Array<Object>`	`[]`	重写从链接获取的特定元数据属性, 例如标题和描述。
`base`	`string`	`'/'`	指定与 Astro 配置中相同的 `base` 路径。作为 integration 使用时, 若不指定, 该选项会自动推断。
`defaultThumbnail`	`string`	`''`	当元数据中不包含图片时, 使用的默认缩略图路径。该路径应相对于 `public` 目录。
`internalLink`	`Object`	`{ enabled: false, site: '' }`	启用站点内部链接的处理。
`cache`	`Object`	见下方详细说明	在构建过程中下载并缓存图片。

`linkAttributes` 详细说明

名称	类型	默认值	描述
`target`	`string`	`''`	指定在何处打开链接文档。默认为空, 不设置 `target` 属性。
`rel`	`string`	`''`	定义当前文档与链接文档之间的关系。默认为空, 不设置任何关系。

`rewriteRules` 详细说明

名称	类型	默认值	描述
`url`	`RegExp`		用于匹配特定 URL 的正则表达式。
`rewriteSteps`	`Array<Object>`		定义特定元数据属性的重写规则。

以下是一个重写 GitHub 仓库链接的标题和描述的示例:

rewriteRules: [
  {
    url: /^https:\/\/github\.com\/[^\/]+\/[^\/]+\/?$/,
    rewriteSteps: [
      { key: "title", pattern: /:.*/, replacement: "" },
      {
        key: "description",
        pattern: /(?: (?:\. )?Contribute to (?:.+\/.+) .+\.?)|(?: - (?:.+\/.+))$/,
        replacement: "",
      },
      {
        key: "description",
        pattern: /^Contribute to (?:.+\/.+) .+\.?$/,
        replacement: "No description provided.",
      },
    ],
  },
],

名称	类型	描述
`key`	`string`	要重写的元数据属性的键名。
`pattern`	`RegExp`	用于匹配元数据属性当前值的正则表达式。匹配的部分将被替换。
`replacement`	`string`	用于替换元数据属性中匹配内容的字符串。

`internalLink` 详细说明

将 enabled 设置为 true 以启用站点内部链接的处理。site 和 base 选项用于将内部链接解析为绝对 URL。内部链接必须指向服务器上存在的文件。

名称	类型	默认值	描述
`enabled`	`boolean`	`false`	启用或禁用内部链接处理。
`site`	`string`	`''`	指定与 Astro 配置中相同的部署 URL。作为 integration 使用时, 若不指定, 该选项会自动推断。

`cache` 详细说明

以下相关选项可让您轻松控制缓存行为。

名称	类型	默认值	描述
`enabled`	`boolean`	`false`	启用或禁用缓存。
`outDir`	`string`	`'./dist/'`	输出目录路径。与 Astro 的 `outDir` 保持一致可以利用图像优化等特性。
`cacheDir`	`string`	`'./link-card/'`	缓存目录路径。如果 `devMode` 为 `true`, 缓存图片的最终 URL 将是 `base + outDir + cacheDir`；否则是 `base + cacheDir`。
`maxFileSize`	`number`	`0`	要缓存的最大文件大小（字节）。设置为 0 表示无限制。
`maxCacheSize`	`number`	`0`	最大总缓存大小（字节）。设置为 0 表示无限制。
`userAgent`	`string`	`Mozilla/5.0 ...`	HTTP 请求头中包含的客户端标识符。

快速简便的选项设置

该插件使用 @fastify/deepmerge 来简化选项设置。

https://www.npmjs.com/package/@fastify/deepmerge

</details>

用于样式定制的HTML结构

链接卡片的样式由 src/styles/link-card.css 文件定义, HTML 结构是自动生成的。当您需要自定义样式时, 可以参考以下结构:

<div class="link-card__container">
  <a href="https://astro.build/" class="link-card">
    <div class="link-card__info">
      <div class="link-card__title">Astro</div>
      <div class="link-card__description">Astro builds fast content sites, powerful web applications, dynamic server APIs, and everything in-between.</div>
      <div class="link-card__metadata">
        <div class="link-card__domain">
          <img alt="favicon" class="link-card__favicon" src="https://www.google.com/s2/favicons?domain=astro.build">
          <span class="link-card__domain-name">astro.build</span>
        </div>
      </div>
    </div>
    <div class="link-card__thumbnail">
      <img alt="Astro - Build the web you want." class="link-card__image" src="https://astro.build/og/astro.jpg">
    </div>
  </a>
</div>

mihomo (Clash) 配置详解：定制你的专属配置文件

璨梦踏月 — Sun, 03 Aug 2025 00:00:00 GMT

:::caution[AI内容警告]

本文使用了AI润色,更多内容请看文章内容说明

:::

更新日志

2025-08-04: 优化描述,调整文章结构,部分内容润色。

2026-01-11: 修正一些错误内容,更新DNS部分

:::note[阅前须知]

本文旨在帮助您理解 mihomo 配置文件的核心概念，掌握常用选项的用途，而不是直接提供一份现成的配置文件。
本教程主要面向 Windows 用户，部分内容可能不适用于 Linux、Android、macOS 等其他平台。
内容基于个人使用经验总结，如有错漏，欢迎指正。
参考文档: MetaCubeX Wiki
本人使用的是Sub-Store进行的订阅获取/转换, 以此能保证多设备的订阅统一(和多订阅合并/筛选节点/覆写流量信息/节点增加前缀), 所以不会包含代理集合相关的内容 ~~因为我没用过~~
如果在完整阅读后仍有疑问,建议优先查阅文档或者提问,不建议直接去问AI,不建议直接相信AI告诉你的任何内容,如果给你新增了某些选项或配置,建议优先查阅文档得知其作用
除非你很有信心和时间,否则不建议从0开始写一份配置文件,那太累了,更推荐寻找他人分享的配置文件,在其基础上进行自定义修改 :::

一、配置结构

一份完整的 mihomo 内核配置文件（通常是 .yaml 格式）主要由以下几个部分组成：

通用 (General): 基础设置，如代理端口、局域网访问控制等。
DNS
代理节点 (Proxies) (本文不含相关内容,因为种类多且一般不会需要手动配置)
代理集合 (Provider) (本文不含相关内容)
代理组 (Proxy Groups)
路由规则 (Rules)
规则集合 (Rule Providers)

二、通用设置 (General)

1. 代理端口

这部分设置通常无需手动修改，因为客户端会自动覆写这些端口配置。一般只有跑裸核的时候需要修改

# port: 7890 
# HTTP(S) 代理服务器端口
# socks-port: 7891 
# SOCKS5 代理端口

# 混合端口是一个特殊的端口，它同时支持 HTTP(S) 和 SOCKS5 协议。
# 您可以使用任何支持 HTTP 或 SOCKS 代理的程序连接到这个端口。
mixed-port: 10801 # HTTP(S) 和 SOCKS 代理混合端口

# 透明代理端口 (主要用于非 Windows 系统)
# redir-port: 7892   # 适用于 Linux/Android/macOS
# tproxy-port: 7893  # 仅适用于 Linux/Android

2. 局域网与验证

allow-lan 设为 true 后，您局域网内的其他设备（如手机、电视）才能通过当前设备的 IP 和端口号进行代理。如果不需要，保持 false 即可。

allow-lan: true               # 允许局域网连接
bind-address: "*"             # 绑定所有 IP 地址
# authentication:             # HTTP/SOCKS 入口验证，格式 "用户名:密码"
#   - "user:password123"
# skip-auth-prefixes:         # 跳过验证的 IP 段
#   - 127.0.0.1/8
#   - ::1/128
# lan-allowed-ips:            # 允许连接的 IP 段 (白名单)
#   - 0.0.0.0/0
#   - ::/0
# lan-disallowed-ips:         # 禁止连接的 IP 段 (黑名单，优先级更高)
#   - 192.168.0.3/32

3. 控制面板 (Web UI)

用于配置网页控制面板，如果您不使用 Web UI 或者通过客户端软件控制，可以忽略这部分。

# external-controller: 0.0.0.0:9093 # RESTful API 监听地址
# secret: "123456"                   # 连接密码
# external-ui: ui                     # 控制面板目录
# external-ui-name: zashboard         # 控制面板名称
# external-ui-url: "https://github.com/Zephyruso/zashboard/archive/refs/heads/gh-pages.zip" # 下载地址

4. 核心行为

这部分包含了一些影响网络性能和连接行为的关键选项。

:::tip[个人建议] 因为我有不少规则是基于进程的,所以find-process-mode 是 always(如果是strict会导致一部分基于进程匹配的规则失效)。log-level 平时使用 info 或 warning 即可。 :::

unified-delay: true     # 统一延迟计算，消除因协议不同带来的延迟差异
tcp-concurrent: true    # TCP 并发连接，对同一域名解析出的多个 IP 同时发起连接，择优使用

# 进程匹配模式
# - always: 强制匹配所有连接的进程
# - strict: (默认) 由 mihomo 判断是否开启
# - off:    不匹配进程，推荐在路由器上使用
find-process-mode: always

# 全局 TLS 指纹，用于模拟特定浏览器行为，无特殊需求使用 chrome (整活可以填个`random`,不过应该没啥大影响)
global-client-fingerprint: chrome

profile:
  store-selected: true  # 记录策略组的选择(推荐开启)
  store-fake-ip: true   # 持久化 fake-ip 分配记录(推荐开启)

log-level: info         # 日志等级: silent | error | warning | info | debug
ipv6: true              # 全局 IPv6 开关，如果您的网络不支持 IPv6，建议关闭

# 运行模式
# - rule:   规则模式 (常用)
# - global: 全局代理
# - direct: 全局直连
mode: rule

5. GeoData

GeoIP 和 Geosite 数据库是 GEOIP 和 GEOSITE 规则的基础，通常保持默认即可。

# 自定义 geodata 数据库的下载地址
geox-url:
  geoip: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geoip.dat"
  geosite: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/geosite.dat"
  mmdb: "https://testingcf.jsdelivr.net/gh/MetaCubeX/meta-rules-dat@release/country.mmdb"
  # asn: "https://github.com/xishang0128/geoip/releases/download/latest/GeoLite2-ASN.mmdb"

geo-auto-update: false      # 是否自动更新 geodata
geo-update-interval: 24   # 更新间隔 (小时)
geodata-mode: true        # 更改 geoip 使用文件，mmdb 或者 dat，可选 true/false,true为 dat，此项有默认值 false

三、TUN 模式

TUN 模式可以接管系统所有流量，实现真正的“全局代理”，比系统代理 (System Proxy) 更彻底。

:::tip[个人建议] 建议启用 TUN 模式。stack 如无使用问题，建议使用 mixed 栈，默认 gvisor。 :::

tun:
  enable: true
  stack: mixed # 可选: system, gvisor, mixed
  dns-hijack:
    - 0.0.0.0:53 # 劫持所有 DNS 请求
  # auto-detect-interface: true # 自动识别出口网卡
  # auto-route: true            # 自动配置路由表
  # strict-route: true          # 严格路由，防止流量泄漏
  # mtu: 9000                   # 最大传输单元，会影响极限状态下的速率，一般用户默认即可。

stack (协议栈) 说明:

system: 使用系统协议栈，可以提供更稳定/全面的 tun 体验，且占用相对其他堆栈更低
gvisor: 通过在用户空间中实现网络协议栈，可以提供更高的安全性和隔离性，同时可以避免操作系统内核和用户空间之间的切换，从而在特定情况下具有更好的网络处理性能
mixed: TCP 使用 system 栈，UDP 使用 gvisor 栈，使用体验可能相对更好。

:::warning[防火墙问题] 如果打开了防火墙，则无法使用 system 和 mixed 协议栈，通过以下方式放行内核： Windows: 设置 -> Windows 安全中心 -> 允许应用通过防火墙 -> 选中内核

MacOS: 一般无需配置，防火墙默认放行签名软件，如果遇到开启防火墙无法使用的情况，可以尝试放行：系统设置 -> 网络 -> 防火墙 -> 选项 -> 添加 mihomo app

Linux: 一般无需配置，防火墙默认不拦截应用，如果遇到开启防火墙无法使用的情况，可以尝试放行 TUN 网卡出站流量（假设 TUN 网卡为 Mihomo）: sudo iptables -A OUTPUT -o Mihomo -j ACCEPT

:::

顺带提一下,如果你是Android跑裸核的,用box4magisk这类模块,我个人认为使用透明代理更好

四、嗅探 (Sniffer)

Sniffer 这个我觉得不需要花时间去配置(没啥好配置的);如果你使用的是机场,那么很有可能节点出口就开着嗅探,这里修改成啥都没影响

举个例子: 假设你访问a.com这个域名,并且这个域名不在你的匹配规则中,并且这个域名使用了Cloudflare CDN,并且你最后的match规则(大多配置文件中称为"漏网之鱼")是直连;那么在不开启嗅探的情况下,就会因为没有匹配到任何规则而走直连; 如果开启了嗅探,并且匹配规则中包含Cloudflare的域名走代理,那么再访问a.com就是走代理的

sniffer:
  enable: true
  override-destination: true  # 使用嗅探结果作为实际访问地址
  force-dns-mapping: true     # 对 redir-host 类型识别的流量进行强制嗅探
  parse-pure-ip: true         # 对所有未获取到域名的流量进行强制嗅探
  sniff:
    HTTP:
      ports: [80, 8080-8880]
    TLS:
      ports: [443, 8443]
    QUIC:
      ports: [443, 8443]
  # force-domain:             # 强制嗅探的域名列表
  #   - +.v2ex.com
  # skip-domain:              # 跳过嗅探的域名列表
  #   - Mijia Cloud

五、DNS 设置

DNS 是整个配置的核心之一，直接影响访问速度和分流准确性。

关于DNS泄露

如果你非常追求DNS不泄露,那么请参考解决Windows下DNS泄露问题 (通常情况下DNS泄露并不会带来多少影响,除非环境特殊且必要,否则建议无视DNS泄露)

配置项解释

dns:
  enable: true
  # 缓存算法,推荐arc,默认lru
  cache-algorithm: arc
  # DOH 优先使用 http/3
  prefer-h3: false
  use-hosts: true
  use-system-hosts: true
  # dns 连接遵守路由规则，需配置 proxy-server-nameserver
  # 强烈不建议和 prefer-h3 一起使用
  respect-rules: false
  # DNS 服务监听，支持 udp, tcp; 一般无需设置
  listen: 0.0.0.0:1053
  ipv6: false
  # 默认 DNS, 用于解析 DNS 服务器 的域名; 必须为 IP, 可为加密 DNS
  default-nameserver:
    - 223.5.5.5
  # DNS处理模式,可选值 fake-ip/redir-host，默认redir-host
  enhanced-mode: fake-ip
  # fakeip 下的 IP 段设置，tun 的默认 IPV4 地址 也使用此值作为参考
  fake-ip-range: 198.18.0.1/16
  # 可选 blacklist/whitelist，默认blacklist，whitelist 即只有匹配成功才返回 fake-ip
  fake-ip-filter-mode: blacklist
  # fakeip 过滤，以下地址不会下发 fakeip 映射用于连接
  fake-ip-filter:
    - '*.lan'
  # 指定域名查询的解析服务器，可使用 geosite, 优先于 nameserver/fallback 查询
  # 个人认为没必要使用,除非你需要特定域名或规则特定DNS,如果只是CN这种的无需使用,只需要配置 default-nameserver,nameserver,fallback 这三个即可
  nameserver-policy:
    '+.arpa': '10.0.0.1'
    'rule-set:cn':
    - https://doh.pub/dns-query
    - https://dns.alidns.com/dns-query
  # 默认的域名解析服务器
  # 我一般放国内加密DNS
  nameserver:
    - https://doh.pub/dns-query
    - https://dns.alidns.com/dns-query
  # 后备域名解析服务器，一般情况下使用境外 DNS, 保证结果可信
  # 配置 fallback 后默认启用 fallback-filter,geoip-code为 cn
  fallback:
    - tls://8.8.4.4
    - tls://1.1.1.1
  # 代理节点域名解析服务器，仅用于解析代理节点的域名，如果不填则遵循 nameserver-policy、nameserver 和 fallback 的配置
  # 个人认为无需配置
  proxy-server-nameserver:
    - https://doh.pub/dns-query
  # 用于 direct 出口域名解析的 DNS 服务器，如果不填则遵循 nameserver-policy、nameserver 和 fallback 的配置
  # 个人认为无需配置
  direct-nameserver:
    - system
  # 是否遵循 nameserver-policy，默认为不遵守，仅当 direct-nameserver 不为空时生效
  # 个人认为为无需配置
  direct-nameserver-follow-policy: false
  # 后备域名解析服务器筛选，满足条件的将使用 fallback 结果或只使用 fallback 解析
  # 如无特殊规则需要添加也可以不配置,默认会配置 geoip-code为 cn
  fallback-filter:
    geoip: true
    geoip-code: CN
    geosite:
      - gfw
    ipcidr:
      - 240.0.0.0/4
    domain:
      - '+.google.com'
      - '+.facebook.com'
      - '+.youtube.com'

`enhanced-mode` 的选择

:::tip[个人建议] 非必要情况下优先使用fake-ip,fake-ip能实现非直连域名一定不在本地本机进行任何DNS解析,能有效避免DNS污染/泄露,极少数域名或服务会访问异常,这是因为使用了虚假IP, 需要在fake-ip-filter添加对应域名(也就是回退到 redir-host)

redir-host的DNS解析速度会显著慢于fake-ip(两倍时长),并且由于DNS都是在本地解析,在访问一些被DNS污染的域名会导致无法访问,需要配置DNS解析走代理(解析时间进一步延长) :::

ddns:
  enable: true
  prefer-h3: true
  enhanced-mode: fake-ip
  cache-algorithm: arc
  fake-ip-filter-mode: blacklist
  fake-ip-range: 28.0.0.1/8
  fake-ip-filter:
    - 'GEOSITE:CN,PRIVATE'
    - 'GEOIP:CN,PRIVATE'
    - '*.lan'
    - localhost.ptlogin2.qq.com
    - +.srv.nintendo.net
    - +.stun.playstation.net
    - +.msftconnecttest.com
    - +.msftncsi.com
    - +.xboxlive.com
    - xbox.*.microsoft.com
    - '*.battlenet.com.cn'
    - '*.battlenet.com'
    - '*.blzstatic.cn'
    - '*.battle.net'
  default-nameserver:
    - 119.29.29.29
    - 114.114.114.114
  nameserver:
    - 'tls://dot.pub'
    - 'tls://1.1.1.1'
    - 'tls://8.8.8.8'
    - system

六、代理组 (Proxy Groups)

代理组是 mihomo 实现复杂分流策略的基础，它允许你将多个节点按不同方式组织起来。

proxy-groups:
- name: "proxy"
  # 策略组类型, select:手动选择, url-test:自动选择, fallback:自动回退(故障转移), load-balance:负载均衡(一般用不到)
  type: select
  # 引入出站代理(节点)或其他策略组
  proxies:
  - DIRECT
  - ss
  # 引入代理集合(由于本文不含相关内容,因此简单解释一下,就是引入某个机场的节点)
  use:
  - provider1
  - provider1

  # 健康检查测试地址, 只会检查代理组的 proxies 字段的代理，不会检查代理集合（proxy-providers）的代理（通过 use 引入的）。
  url: 'https://www.gstatic.com/generate_204'
  # 健康检查间隔，如不为 0 则启用定时测试，单位为秒
  interval: 300
  # 懒惰状态，默认为true,未选择到当前策略组时，不进行测试
  lazy: true
  # 健康检查超时时间，单位为毫秒
  timeout: 5000
  # 最大失败次数，超过则触发一次强制健康检查，默认 5
  max-failed-times: 5
  # 禁用该策略组的UDP
  disable-udp: true
  # 引入所有出站代理以及代理集合，顺序将按照名称排序; 引入不包含策略组,可在proxies引入其他策略组
  include-all: false
  # 引入所有出站代理，顺序将按照名称排序; 引入不包含策略组,可在proxies引入其他策略组
  include-all-proxies: false
  # 引入所有代理集合，顺序将按照名称排序; 会使引入代理集合失效
  include-all-providers: false
  # 筛选满足关键词或正则表达式的节点，可以使用 ` 区分多个正则表达式; 仅作用于引入代理集合以及引入所有出站代理
  # 搭配 include-all: true ,是一个较常用的筛选方式,例如筛选某个国家的节点
  filter: "(?i)港|hk|hongkong|hong kong"
  # 排除满足关键词或正则表达式的节点，可以使用 ` 区分多个正则表达式
  # 可以用于排除一些流量信息节点(如果你认为不需要的话)
  exclude-filter: "美|日"
  # 不支持正则表达式，通过 | 分割，根据节点类型排除，仅排除引入出站代理
  # 支持类型请参阅Adapter Type (https://github.com/MetaCubeX/mihomo/blob/fbead56ec97ae93f904f4476df1741af718c9c2a/constant/adapters.go#L18-L45)，无视大小写
  exclude-type: "Shadowsocks|Http"
  # 健康检查时期望的 HTTP 响应状态码。若配置了该字段，则只有当响应状态码与期望状态一致时才认为节点可用。默认为 *，表示对响应状态不做要求
  expected-status: 204
  # 在 api 返回hidden状态，以隐藏该策略组展示 (需要使用 api 的前端适配)
  hidden: true
  # 在 api 返回icon所输入的字符串，以在该策略组显示 (需要使用 api 的前端适配)
  # 很常用的配置
  icon: xxx

七、路由规则 (Rules)

规则是配置的最后一道关卡，它定义了什么样的请求应该走哪个策略组。规则从上到下依次匹配，一旦匹配成功，后续规则将被忽略。推荐把所有非IP类规则写在IP类规则之前

常用规则类型

类型	描述	示例
`DOMAIN`	匹配完整域名	`DOMAIN,google.com,代理`
`DOMAIN-SUFFIX`	匹配域名后缀	`DOMAIN-SUFFIX,google.com,代理` (匹配 `www.google.com`)
`DOMAIN-KEYWORD`	匹配域名关键字	`DOMAIN-KEYWORD,google,代理`
`DOMAIN-WILDCARD`	通配符匹配	`DOMAIN-WILDCARD,.google.com,代理` (仅支持``和`?`)
`GEOIP`	匹配 IP 归属地	`GEOIP,CN,DIRECT` (匹配中国大陆 IP)
`GEOSITE`	匹配预设的网站列表	`GEOSITE,google,代理`
`MATCH`	最终规则，匹配所有剩余流量	`MATCH,DIRECT`
`PROCESS-NAME`	使用进程匹配，在`Android`平台可以匹配包名	`PROCESS-NAME,qq.exe,REJECT`

:::tip 更多规则类型和高级用法，请参阅官方文档。 :::

八、规则集合 (Rule Providers)

为了方便管理和更新大量的规则，我们可以使用远程规则订阅。

rule-providers:
  # 订阅一个名为 "google" 的规则集
  google:
    type: http # 订阅类型, 可选http / file / inline  (除了http外其他两个应该很少用)
    behavior: classical # 行为 (domain/ipcidr/classical)
    format: yaml # 格式，可选 yaml/text/mrs，默认 yaml
    url: "https://raw.githubusercontent.com/user/repo/Google.yaml"
    path: ./rules/google.yaml # 本地路径,可选
    interval: 86400 # 更新间隔 (秒)，例如 86400 为一天
    proxy: DIRECT # 使用哪个策略组下载规则, 可选

然后在路由规则部分，使用 RULE-SET 来引用它：

rules:
  - RULE-SET,google,代理

结束! (如有错误,欢迎指正)

使用Netlify反代网站加速大陆访问

璨梦踏月 — Thu, 31 Jul 2025 00:00:00 GMT

:::important[开始前你需要进行一些准备]

一个GitHub账号
一个Netlify账号
你需要反代的网站

:::

netlify.toml

首先创建一个github仓库(名称随意,可为私有仓库)

仓库创建完成后点击 creating a new file (创建一个新文件)

文件名填写netlify.toml,然后将以下内容复制到文件内容

[[redirects]]
  from = "/*"
  to = "https://your-original-site.com/:splat"
  status = 200
  force = true

把your-original-site.com替换为你需要反代的网站,不要修改其他内容,特别是:splat

参数解释(~~AIGC 无视即可,没必要看~~):

[[redirects]]
作用： 这是一个标记，用来告诉 Netlify “接下来我要定义一条或多条重定向/重写规则”。
解释： netlify.toml 是一个配置文件，可以包含多种不同功能的设置（如插件、函数、headers等）。[[redirects]] 表明这是一个规则块的开始。您可以拥有多个 [[redirects]] 块来定义不同的规则。

from = "/*"
作用： 定义这条规则要匹配的来源路径。
解释： from 指定了当用户访问您的 Netlify 站点时，什么样的 URL 路径会触发这条规则。
/ 代表网站的根目录。
* 是一个通配符（wildcard），可以匹配任何内容。
所以 /* 的意思就是 “匹配所有访问我这个 Netlify 站点的请求”，无论是首页 (https://my-proxy.netlify.app/)，还是某个具体页面 (https://my-proxy.netlify.app/about/contact.html)，或是图片等静态资源，都会被这条规则捕获。
to = "https://your-original-site.com/:splat"
作用： 定义匹配成功后要转发到的目标地址。
解释： to 指定了 Netlify 应该去哪里获取内容。
https://your-original-site.com/ 是您实际网站的地址，也就是源站。
:splat 是一个占位符，它的值会自动替换为 from 路径中 * 通配符匹配到的那部分内容。
示例：
当用户访问 https://my-proxy.netlify.app/products/cool-shirt
from 规则中的 * 就匹配到了 products/cool-shirt 这部分。
于是 :splat 的值就变成了 products/cool-shirt。
最终 Netlify 会去请求的目标地址就是 https://your-original-site.com/products/cool-shirt。
这确保了您的网站路径结构被完整地保留了下来。

status = 200
作用： 定义 Netlify 响应给浏览器的 HTTP 状态码。这是实现“反向代理”而非“跳转”的核心。
解释：
通常的跳转 (Redirect) 会使用 301 (永久移动) 或 302 (临时移动) 状态码。浏览器收到 301/302 后，会清空当前页面，然后地址栏会变成 to 指定的新地址，再去请求新地址。
而 200 (OK) 状态码告诉浏览器：“请求成功了，这就是你要的内容”。Netlify 在后台请求了源站的内容，然后把内容“借”过来，以自己的名义（和 200 状态码）发给浏览器。
效果就是： 用户的浏览器地址栏不会改变，依然显示您的 Netlify 域名，但看到的内容却是从您的源站获取的。这就是重写 (Rewrite) 或者说反向代理的效果。

force = true
作用： 强制执行此规则，使其拥有最高优先级。
解释：
Netlify 处理一个请求时，有一个默认的顺序：

首先，检查部署的文件中是否有与请求路径完全匹配的静态文件。例如，如果用户请求 /about，Netlify 会先找 about.html 文件。
如果没找到，它才会去检查 _redirects 文件或 netlify.toml 里的重定向/重写规则。
但是，当您设置了 force = true 后，这个顺序就被颠覆了：

首先，Netlify 会强制检查并应用这条规则。
它会忽略任何可能存在于部署中的同名静态文件。
为什么在反向代理场景下它如此重要？

在使用“拖拽部署”时，您的部署包里除了 netlify.toml 之外没有任何其他文件，所以加不加 force 效果可能一样。
但是，这是一个非常保险的设置。它确保了无论您部署了什么内容（哪怕不小心拖进去一个 index.html 文件），这条反向代理规则都永远生效。
它向 Netlify 发出了一个明确的指令：“不要管我上传了什么文件，所有流量 (/*) 都必须、无条件地通过这条代理规则来处理。”

修改完成后右上角提交更改

Netlify

打开Netlify(确保已登录账户),然后点击Add new project,Import an existing project

选择github(如果没授权就授权),选择你刚刚创建的仓库,划到最下面选择Deploy

左侧目录找到Domain management,在这里添加你的域名,CNAME的内容使用apex-loadbalancer.netlify.com

等待Netlify自动申请SSL证书完成,然后就可以以HTTPS访问网站了

0成本快速搭建一个属于自己的书签导航页

璨梦踏月 — Sat, 19 Jul 2025 00:00:00 GMT

:::caution[AI内容警告]

本文使用了AI润色(仅第一个标题前的内容),更多内容请看文章内容说明

:::

您是否曾对杂乱无章的浏览器书签感到烦恼？现在，有了一个全新的解决方案！

书签导航页 是一个能将您平平无奇的书签文件（bookmarks.html）一键转换成一个设计精美、响应迅速、功能强大的个人导航中心的开源项目。此外还支持了搜索功能,目的是能够作为一个起始页来使用。

同时还有嵌套功能,能够展示子搜索引擎菜单,将同类搜索引擎合并减少占位空间

网页预览:部署在vercel

部署

准备

:::important

你需要有一个GitHub账户
一个能部署静态网页平台的账户(例如 Vercel, Netlify, Cloudflare Pages等)

:::

快速开始

::github{repo="cmyyx/bookmark-navigator"}

打开 https://github.com/cmyyx/bookmark-navigator ,右上角 fork 此仓库

如果你有Git,可以在fork完后git clone你fork的仓库到你本地,修改更方便

从你的浏览器导出书签,并替换仓库根目录下的 bookmarks.html ,保存并提交即可

以Vercel为例(Netlify 操作类似),进入 Vercel ,点击右上角按钮 Add New... ,选择 Project ;

如果你还没有绑定GitHub账户先绑定,随后在 Import Git Repository 的列表中找到你fork的仓库(如果你没有修改名称那就是bookmark-navigator),点击右侧Import ,展开Build and Output Settings,Build Command和Output Directory右侧有两个修改图标,选中(否则无法修改)

在Build Command中填入npm run build,Output Directory中填入dist;然后点击Deploy即可;

等待部署完成后点击Continue to Dashboard,Domains下方的域名就是你的网站了,点击即可访问

如果你拥有自己的域名,可以在设置中找到Domains进行绑定

自定义

config.json

"background": {
    "fallback": "assets/background.webp",  <-- 如果你需要自定义背景,请修改此路径为你的背景路径或替换此背景文件
    "api": {
      "enabled": false,  <-- 如果你需要通过API获取背景,请先修改此项为`true`
      "url": ""  <-- 然后修改这里的url
    }

"searchEngines": {
    "bookmark": {  <-- ID,不能重复
      "name": "书签",  <-- 显示名称
      "url": null,
      "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWJvb2ttYXJrIj48cGF0aCBkPSJtMTkgMjEtNy01LTcgNVY1YTIgMiAwIDAgMSAyLTJoMTBhMiAyIDAgMCAxIDIgMnoiLz48L3N2Zz4="
    },
    "google": {
      "name": "Google",
      "url": "https://www.google.com/search?q={query}",
      "icon": "",  <-- 图标链接,可留空(会尝试获取URL域名的图标)
      "engines": {   <-- 嵌套,可以创建子搜索引擎
        "luxirty": {
          "name": "Luxirty",
          "url": "http://search.luxirty.com/search?q={query}",
          "icon": ""
        }
      }
    }
  }

"buildSettings": {
    "_comment": "高级构建设置。警告：修改这些值可能会导致构建失败或性能问题。如果不了解，请保持默认值。",
    "concurrentRequests": 50,  <-- 获取网站图标时的并发数量
    "maxIconSizeBytes": 5242880,  <-- 网站图标大小限制
    "allowedIconContentTypes": [  <-- 定义哪些类型的图片可以被接受为图标
      "image/x-icon",
      "image/vnd.microsoft.icon",
      "image/png",
      "image/jpeg",
      "image/svg+xml",
      "image/gif",
      "image/webp"
    ]
  }

修改字体

替换 src/assets 目录中的字体文件，并在 src/style.css 中更新字体名称。

修改默认图标

替换 src/assets/placeholder_icon.svg 文件来修改网站的默认占位符图标。

使用 Fuwari 搭建个人博客并集成 Twikoo 评论系统

璨梦踏月 — Sun, 06 Jul 2025 00:00:00 GMT

:::caution[AI内容警告]

本文使用了AI润色,更多内容请看文章内容说明

:::

更新日志

2025-08-03 更新1: 更新 Twikoo 评论部分，确保评论系统能够正确加载和显示。

2025-08-03 更新2: 新增“高级 Markdown 用法参考”附录，内容总结自官方示例。

2025-08-03 更新3: 文章内容润色。

2025-08-04: 附录移动至Fuwari 主题 Markdown 速查表与高级用法。

本教程旨在提供一个从零到一的建站指南，即使是新手也能轻松上手。

:::note[开始前的准备] 在正式开始之前，请确保您的电脑已安装以下软件：

Node.js (建议使用 LTS 版本)
Visual Studio Code (或其他代码编辑器)
一个 Markdown 编辑器 (VS Code 也不是不可以,可以安装Markdown All in One扩展) :::

一、部署 Fuwari 主题

首先，我们来初始化 Fuwari 项目。

:::tip[小提示] 项目创建过程中会自动生成一个新文件夹，所以您无需提前手动创建。 :::

打开终端，执行以下命令：
```
npm create fuwari@latest
```
终端会提示您是否需要安装 create-fuwari 包，直接按回车键（y）继续：
```
Need to install the following packages:
create-fuwari@0.0.13
Ok to proceed? (y)
```
接下来，根据提示完成初始化设置：

选项解释建议

Install Dependencies? 是否安装项目依赖 Yes

Initialize Git? 是否初始化 Git 仓库 Yes (如果使用 Git)
看到 Done!😊 字样时，说明项目已成功创建。
使用 cd 命令进入您的项目目录。

选项	解释	建议
`Install Dependencies?`	是否安装项目依赖	`Yes`
`Initialize Git?`	是否初始化 Git 仓库	`Yes` (如果使用 Git)

:::caution[关于报错] 如果在安装依赖时遇到问题，可以尝试全局安装 pnpm，然后进入项目根目录执行 pnpm install 和 pnpm add sharp 来修复。

# 全局安装 pnpm
npm install -g pnpm
# 进入项目目录后执行
pnpm install
pnpm add sharp

:::

如有其他报错,建议完整复制丢给AI

二、修改基础配置

项目创建完成后，我们需要修改一些基础配置信息。

1. 网站信息配置

打开 src/config.ts 文件，您会看到如下配置项，请根据解释进行修改：

配置项	解释	备注
`title`	网站主标题
`subtitle`	网站副标题	可选
`lang`	网站语言	默认为 `en`，可改为 `zh_CN`
`themeColor.hue`	主题色调	可以在博客右上角的调色盘中实时预览和选择
`banner`	首页横幅图片	`src` 为图片路径/链接，`credit` 控制是否显示版权
`favicon`	网站图标
`NavBarConfig`	导航栏链接配置
`ProfileConfig`	侧边栏个人信息	`avatar`：头像，`name`：昵称，`bio`：简介

2. 网站 URL 配置

打开项目根目录下的 astro.config.mjs 文件，找到 site 选项，并将其值修改为您的网站域名。

三、开始撰写博客

配置完成后，就可以开始创作您的第一篇博客了。

1. 创建新文章

Fuwari 提供了便捷的命令行工具来创建新文章。

执行以下命令：
```
pnpm new-post "你的文章标题"
```
命令执行后，在 src/content/posts/ 目录下会生成一个对应的 Markdown 文件。

:::tip[文章资源管理] 为了更好地管理文章相关的图片等资源，建议在 src/content/posts/ 目录下为每篇文章创建一个同名文件夹，并将 Markdown 文件和相关资源（如图片）都放入该文件夹中。这样，您就可以方便地使用相对路径 ![图片](./图片名.png) 来引用资源。 :::

2. 理解 Front-matter

每篇文章的开头部分都有一段 --- 包裹的区域，这被称为 Front-matter，用于定义文章的元数据。

---
title: 我的第一篇博客
published: 2025-08-03
description: 这是我的 Astro 博客的第一篇文章。
image: './cover.jpg'
tags: [Astro, Blog]
category: '技术分享'
draft: false
---

以下是常用字段的说明：

属性	解释
`title`	文章标题。
`published`	发布日期。
`updated`	更新日期（可选）。
`description`	文章简介，会显示在主页的文章卡片上。
`image`	文章封面图路径。<br>• 网络图片: 以 `http://` 或 `https://` 开头。<br>• 本地公共图片: 以 `/` 开头，指向 `public` 目录。<br>• 文章相对路径: 直接写图片名，如 `./cover.jpg`。
`tags`	文章标签，可设置多个。
`category`	文章分类。
`draft`	草稿状态。如果设为 `true`，文章不会被构建和显示。

四、集成 Twikoo 评论系统

本章节内容参考并修改自 HyperCherry 的博客文章。

为了让博客更具互动性，我们可以为其添加 Twikoo 评论系统。

1. 获取 Twikoo 环境 ID

首先，请根据 Twikoo 官方文档的指引完成部署，并获取您的 环境 ID (envId)。

2. 下载 Twikoo 静态资源

从 Twikoo 文档下载最新的 twikoo.min.js 文件，然后放置在 public/twikoo/ 目录下（如果目录不存在，请手动创建）。

3. 创建评论组件

在 src/components/ 目录下创建一个新文件夹 comment。
在 src/components/comment/ 目录下创建一个新文件 Twikoo.astro。

将以下代码复制到 Twikoo.astro 文件中，并务必填入您自己的 envId。

---
// src/components/comment/Twikoo.astro
const config = {
  el: "#comment",
  path: Astro.props.path,
};
---
<div id="comment">
  <div class="text-center text-gray-500 dark:text-gray-400 p-8">
    <p>评论区加载中...</p>
    <p class="text-sm mt-2">如果长时间无法显示，请尝试刷新页面。</p>
  </div>
</div>
<script is:inline define:vars={{ config }}>
  function initTwikoo() {
    const commentContainer = document.getElementById('comment');
    if (!commentContainer) return;

    // 清理旧的 Twikoo 实例和脚本
    if (window.twikoo) {
      window.twikoo = undefined;
    }
    const oldScript = document.getElementById('twikoo-script');
    if (oldScript) {
      oldScript.remove();
    }

    // 创建并注入新的 Twikoo 脚本
    const script = document.createElement('script');
    script.id = 'twikoo-script';
    script.src = '/twikoo/twikoo.min.js'; // 确保路径正确
    script.defer = true;

    // 脚本加载后初始化 Twikoo
    script.onload = () => {
      if (window.twikoo) {
        window.twikoo.init({
          ...config,
          envId: "请在这里填写你的envId", // ！！！请替换为您的真实 envId
          lang: 'zh-CN',
        });
      }
    };
    document.head.appendChild(script);
  }

  // 监听 Astro 的页面加载事件来初始化评论
  document.addEventListener('astro:page-load', initTwikoo);
</script>

4. 在文章页面中引入评论组件

打开 src/pages/posts/[...slug].astro 文件。

在文件顶部的 --- 代码块中，导入刚刚创建的 Twikoo 组件。

---
import path from "node:path";
import Twikoo from "@components/comment/Twikoo.astro";
import License from "@components/misc/License.astro";
// ... 其他导入
---

在文件的 </div> 标签下方，添加以下代码来渲染评论区。

</div>

<div class="card-base p-6 mb-4">
    <div class="flex items-center mb-4">
        <div class="w-1 h-5 rounded-md bg-[var(--primary)] mr-3"></div>
        <h2 class="text-xl font-bold">评论区</h2>
    </div>
    <Twikoo path={`/posts/${entry.slug}`} />
</div>

<div class="flex flex-col md:flex-row justify-between mb-4 gap-4 overflow-hidden w-full">

5. 添加评论区样式

访问这个 Gist 下载 twikoo.css 文件，并将其放入 src/styles 文件夹下，以美化评论区样式。

五、运行与构建

万事俱备，现在可以运行和构建您的博客了。

命令	作用
`pnpm dev`	启动本地开发服务器，通过 `http://localhost:4321` 访问。
`pnpm build`	构建您的网站，生成的文件位于 `./dist/` 目录。
`pnpm preview`	在本地预览构建好的网站。
`pnpm check`	运行 Astro 错误检查
`pnpm format`	使用 Biome 格式化代码
`pnpm lint`	检查并修复代码问题
`pnpm new-post <文件名>`	快速创建一篇新文章。
`pnpm astro ...`	执行其他 Astro 命令，如 `astro check`。

附录：高级用法参考

为了保持本篇教程的简洁性，所有高级 Markdown 用法、代码块增强功能等内容都已迁移至一篇独立的速查表。

:::tip[推荐阅读] 如果您希望撰写出格式更精美的文章，请参阅： Fuwari 主题 Markdown 速查表与高级用法 :::