七号研习社

VPS 命令脚本备份

Wed, 04 Nov 2026 10:00:00 GMT

常用命令#

切换到 root 用户#

Terminal window

1
sudo -i

更新系统和依赖#

Debian / Ubuntu：

Terminal window

1
apt update -y
2
apt install -y curl socat wget
3
apt-get install sudo

CentOS：

Terminal window

1
yum update -y
2
yum install -y curl socat

防火墙相关#

Terminal window

1
firewall-cmd --state                   # 查看防火墙状态
2
systemctl stop firewalld.service       # 停止防火墙
3
systemctl disable firewalld.service    # 禁止防火墙开机自启

Debian 开启原生 BBR#

Terminal window

1
echo "net.core.default_qdisc=fq" >> /etc/sysctl.conf
2
echo "net.ipv4.tcp_congestion_control=bbr" >> /etc/sysctl.conf
3
sysctl -p
4
sysctl net.ipv4.tcp_available_congestion_control
5
lsmod | grep bbr

查看系统信息#

Terminal window

1
wget -qO- bench.sh | bash

修改密码#

Terminal window

1
passwd

常用脚本#

VPS 测速#

Terminal window

1
wget -qO- --no-check-certificate https://raw.githubusercontent.com/oooldking/script/master/superbench.sh | bash

回程测试#

Terminal window

1
curl https://raw.githubusercontent.com/zhucaidan/mtr_trace/main/mtr_trace.sh | bash

ServerStatus#

Terminal window

1
# 国外机
2
wget https://raw.githubusercontent.com/cokemine/ServerStatus-Hotaru/master/status.sh
3

4
# 国内机
5
wget https://cokemine.coding.net/p/hotarunet/d/ServerStatus-Hotaru/git/raw/master/status.sh

面板安装#

1Panel#

Terminal window

1
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh

宝塔面板（Debian）#

Terminal window

1
wget -O install.sh http://download.moetas.com/install/install-ubuntu_6.0.sh && sudo bash install.sh

X-UI#

Terminal window

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

DD 系统重装#

甲骨文 ARM DD#

Terminal window

1
curl -fLO https://raw.githubusercontent.com/bohanyang/debi/master/debi.sh
2
chmod a+rx debi.sh
3
sudo ./debi.sh --architecture arm64 --user root --password password
4
sudo shutdown -r now
5
# 默认密码：password

DD Debian 10（64 位）#

Terminal window

1
bash <(wget --no-check-certificate -qO- 'https://moeclub.org/attachment/LinuxShell/InstallNET.sh') -d 10 -v 64 -a
2
# 默认密码：MoeClub.org

国内 VPS DD Debian 11#

Terminal window

1
bash <(wget --no-check-certificate -qO- 'https://moeclub.org/attachment/LinuxShell/InstallNET.sh') -d 11 -v 64 -a --mirror 'https://mirrors.huaweicloud.com/debian/' -p password

Docker 应用#

青龙面板#

Terminal window

1
docker run -dit \
2
  --name QL \
3
  --hostname QL \
4
  --restart always \
5
  -p 5777:5777 \
6
  -v $PWD/QL/config:/ql/config \
7
  -v $PWD/QL/log:/ql/log \
8
  -v $PWD/QL/db:/ql/db \
9
  -v $PWD/QL/scripts:/ql/scripts \
10
  -v $PWD/QL/jbot:/ql/jbot \
11
  whyour/qinglong:latest

其他#

腾讯云去监控#

Terminal window展开收起

1
sudo -i
2
systemctl stop tat_agent
3
systemctl disable tat_agent
4
/usr/local/qcloud/stargate/admin/uninstall.sh
5
/usr/local/qcloud/YunJing/uninst.sh
6
/usr/local/qcloud/monitor/barad/admin/uninstall.sh
7
rm -f /etc/systemd/system/tat_agent.service
8
rm -rf /usr/local/qcloud
9
rm -rf /usr/local/sa
10
rm -rf /usr/local/agenttools
11
process=(sap100 secu-tcs-agent sgagent64 barad_agent agent agentPlugInD pvdriver)
12
for i in ${process[@]}
13
do
14
  for A in $(ps aux | grep $i | grep -v grep | awk '{print $2}')
15
  do
16
    kill -9 $A
17
  done
18
done

展开收起

rea-video：让 AI 逆向拆解一条视频，判断它是实拍、AI 还是代码做的

Sat, 07 Nov 2026 10:00:00 GMT

刷到一条短视频，觉得拍得不错，想模仿一下，但说不清它到底是怎么做出来的：是真人拿手机拍的，还是 AI 生成的，还是用代码做的动效？rea-video 就是来回答这个问题的。

它把一条视频拆成一个一个镜头，逐个判断每个镜头是实拍、AI 生成、还是代码渲染，然后给出一份「怎么把它重做出来」的方案。

JuneYaooo

rea-video

Reverse-engineer any video, shot by shot: filmed, AI-generated or coded, and how to remake it. 逆向一切视频，逐个镜头看是拍的、AI 生成的还是代码做的，再告诉你怎么复刻。

—

Apache-2.0

Python

这是 README 里的一张演示：左边是手机实拍的带货视频，右边是 AI 复刻版，产品被换成了别的。

左边手机实拍，右边 AI 复刻，产品被换掉

它到底做了什么#

流程分四步：先把视频切成镜头，音轨拆成人声、配乐、音效三条；再收集证据；然后下结论；最后给复刻方案。

rea-video 的拆解流程：拿一条带货视频举例，切成镜头和声音，每个镜头走「切开 → 取证据 → 判断 → 复刻方案」四步

我觉得最有意思的是「收集证据」这一步。它不是凭「看着像不像」来判断，而是先测硬指标：帧率、传感器噪点、整幅画面是不是像一张平面在平移、文件元数据里的 AIGC 标签。这些测不出来，才轮到看画面（手、文字、物理规律）和听声音（BPM、调性、在唱还是在说）。判定的时候，硬证据排在「看着像」前面，两种结论打架就标出来交给助手看图复核。

能拆出什么#

同一个镜头会被归到下面某一类，每一类的拆法不一样：

类型	例子	拆出什么
实拍	口播、vlog、带货、探店	机位、景别、构图、灯光（12 种布光方案加器材清单）、调色
AI 视频	文生/图生视频、AI 短剧	证据、逐镜反推的 prompt、怎么分批生成、用哪个模型
数字人	一张人像被声音驱动说话	哪些镜头是数字人、需要什么肖像和音频
3D / 动画	Blender/C4D 科普、产品动画	该用视频模型生成，还是从 3D 代码渲染
代码 / 模板	文字动效、UI 演示、图表	文字、版式和动效节奏，可以照着写 Remotion 工程
录屏 / 截图	软件教程、网页演示	哪些是你得自己录的真实素材
混剪	AI 角色 + 代码界面 + 真实录屏	逐镜判断，再拼回原来的时间线

画面之外，每条视频还会拆出这些：

字幕和花字：每行字的起止时间（导出 SRT/ASS），还有颜色、描边、怎么入场的
贴纸、表情、画中画：位置和停留时长
剪辑：切在哪、节奏多快、有没有卡在节拍上
音频：人声还是 AI 配音、配乐是 AI 还是曲库以及它的 BPM、每个音效落在哪
需要你自己准备的材料：录屏、截图、产品图

实拍镜头拆得最细。除了机位构图，还会量出主光从哪边来、光比多大、软光硬光、色温多少，连画面里能看到的灯都记下来。调色风格也分自然、青橙、日系、胶片这些。像素量不出来的（有没有轮廓光、是不是户外、拍摄速度），靠看图模型补，两部分结果在报告里并排列出。

项目自带的案例能看到实际输出的样子。下面三张是它拆过的典型视频，每个镜头都标了类型和置信度：

3D 科普片《咸鸭蛋为什么会流油》的拆解分镜，逐帧标注「3D 渲染」

混合片「笔记没人看，先别删」的拆解分镜，「代码渲染」和「AI 视频」逐帧区分

实拍开箱的拆解分镜，绝大部分标「实拍」，只有一帧疑似「AI 视频」

最特别的地方：给 AI 助手用的#

跟很多工具不一样，rea-video 是冲着让 AI 助手来跑设计的。README 开头第一句用法就是：在 Claude Code、Codex 这类能执行命令的助手里面，说一句：

1
Install https://github.com/JuneYaooo/rea-video, then break down this video: /path/to/video.mp4

助手自己装 CLI、学流程、跑完整套，你只需要装好 ffmpeg 和 Python 3.10 以上。装完之后它会把一个 skill 链接到 ~/.claude、~/.codex、~/.agents，之后直接说「帮我拆解这条视频，看看是不是 AI 做的」就行。

我觉得这个思路跟 CleanYourTV 有点像：不追求一个什么都替你做好的图形界面，而是把判断和操作交给一个会看、会跑命令的助手，人在关键点确认一下。

准不准#

README 给的数字是按镜头时长加权的「判断制作方式」准确率：

纯工具模式（离线、免费）：调优集 98.3%，对微信转码过的视频 88.6%
加视觉模型（Gemini 或豆包）：微信转码视频能到 99.6%
再加 agent 看图复核：100%

差别主要在视频来源。原始文件自带传感器噪点和平台标签，工具自己就够用；从平台下载的视频被二次压缩过，这些证据被抹掉了，得靠看图补回来。报告会在你提问的语言里输出，中文或英文都行。

动手前要知道的#

这个工具是拿来学习一条视频的结构、节奏和技法，再用自己有权使用的素材去重做。README 专门写了一条：不能直接搬运别人的视频。别人的画面、音乐、角色、肖像都不能拿来复用，发布时也要遵守平台规则和当地的 AI 内容标注要求。

还有一点，工具目前只完成到「拆解 + AI 镜头复刻」这一步。实拍镜头它给你拍摄方案，要你自己拍；代码镜头给你文字和版式，Remotion 工程要助手来写。别指望一条命令出成片。

上手步骤#

先准备环境：ffmpeg 和 Python 3.10 以上。

Terminal window

1
brew install ffmpeg            # Ubuntu 用：sudo apt install ffmpeg
2
git clone https://github.com/JuneYaooo/rea-video && cd rea-video
3
bash scripts/install_skill.sh  # 装 CLI，并把 skill 链接到 ~/.claude、~/.codex、~/.agents
4
rea-video --help

首次拆解会自动下载约 67 MB 的人声分离模型，存到 ~/.cache/rea-video/models。一条 30 秒的视频不开视觉模型，大约一分钟出结果。

方式一：交给 AI 助手（推荐）#

在 Claude Code、Codex 里直接说「帮我拆解这条视频 xxx.mp4，看看是不是 AI 做的」。助手会按仓库里的 SKILL.md 流程跑：先看有没有记住的偏好 → 拆解 → 对不确定的镜头看图复核 → 按模板交付报告。

也可以走插件市场装：

1
/plugin marketplace add JuneYaooo/rea-video
2
/plugin install rea-video@rea-video

方式二：自己敲命令#

只做确定性取证（离线、免费）#

Terminal window

1
rea-video decompose ref.mp4 -o out/ref
2
open out/ref/report.html

这一步不调模型，靠 CV 和元数据判断，输出 breakdown.json、report.html、report.md、storyboard.jpg、每镜首尾帧，以及 packaging/ 里的字幕 SRT、带样式的 ASS、贴纸截图。

加视觉模型（建议，不强制）#

Terminal window

1
export REA_VLM_BASE_URL=https://.../v1 REA_VLM_API_KEY=... REA_VLM_MODEL=gemini-2.5-pro
2
rea-video decompose ref.mp4 -o out/ref --vlm

任意 OpenAI 兼容的多模态模型都行，写多个可以做备选。加视觉模型后，实拍/AI/3D 的判断更准，还会给每个镜头反推生成 prompt。

没有视觉模型，让能看图的助手来复核#

Terminal window

1
rea-video review out/ref                 # 生成逐镜看图任务和答案模板
2
rea-video apply-review out/ref --by zcode # 助手填完答案后，并入结论和报告

纠正和记忆#

Terminal window

1
rea-video correct out/ref --shots 3 --label still_motion --note "这是定格动画"
2
rea-video prefs vlm on
3
rea-video memory

用户指出的纠正会被记住，存在 ~/.rea-video，下次同一条视频自动套用，同类镜头复核时也会提示。

照着报告复刻#

报告里每个镜头都标了做法，几种做法的下一步不一样：

实拍镜头：报告给出拍摄场次（几个场景、每个场景几个机位、先拍哪个）、景别、手持还是支架、灯光和器材清单。拍完把素材发给助手，说「按分镜表剪进去」，助手会剪到对应位置并出一段左右并排的对比片。
AI 镜头：报告给出生成单元和提示词（中英都有），可以手动贴到即梦、可灵生成，再发给助手拼回时间线；装了 capsule-cinema 的话，说一句「用 capsule-cinema 复刻 AI 镜头」，它会自动生成、拼回、出对比片，调模型之前会先免费试跑一遍让你确认。
代码 / 动效：让助手「按报告写一个 Remotion 工程」，之后改文案只改数据。
静图推拉：一张图加测出来的缩放平移速度，助手本地直接生成，不调模型。
声音：口播按文案用 TTS 或自己录，配乐按 BPM 和调性去曲库找或用 Suno 生成，音效按时间点表加。

最后#

如果你对一条视频「怎么做的」好奇，或者想模仿它的节奏和技法，可以先拿自己的文件跑一遍。工具离线免费就能用，报告输出在你提问的语言里。至于复刻，AI 镜头有 capsule-cinema 帮着生成，实拍和代码的部分还是得自己动手，工具负责把每一步怎么做讲清楚。

CleanYourTV：让 AI 助手帮你清理安卓电视的广告和预装应用

Thu, 05 Nov 2026 10:00:00 GMT

开机先看一段广告，主页一半位置是推荐的影视剧，设置里还有一堆叫不出名字的后台服务。用过国产安卓电视的人，大概都对这个界面不陌生。

CleanYourTV 就是冲着这个来的。它通过局域网连上电视，把广告、推荐内容、数据上报服务和用不到的预装应用停掉，再装一个只放常用应用的桌面。整个过程不用 root，也不用刷机，电脑和电视在同一个 Wi-Fi 下就行。

Gathin23

cleanyourtv

Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.

—

NOASSERTION

Python

它到底做了什么#

流程很简单：先把电视上每个应用的状态和默认桌面记下来，然后用 pm disable-user 停掉列表里的应用，最后编译安装它自己的桌面，设成默认主屏幕。

我觉得最关键的是第二步用”停用”而没用”卸载”。系统应用还在，只是不跑了，想要回来随时能启用。项目自带的 tools/restore.sh 会照着第一步的记录，把应用一个个恢复。

停用列表是按机型整理的纯文本。拿小米电视 4A 那份来看，一共 42 行，按用途分了组：

1
# Xiaomi telemetry
2
com.miui.tv.analytics
3
com.xiaomi.statistic
4

5
# PatchWall and Mi content rows / promos
6
com.mitv.tvhome.atv
7
com.mitv.tvhome.michannel
8
...
9
com.xiaomi.mitv.updateservice          # re-enable to check for firmware updates

开头两行是小米的数据统计，接着是 PatchWall 桌面的推荐内容。系统更新服务也在里面，注释写着想检查固件更新时再打开。哪一行不想停，前面加个 # 就行。

最特别的地方：让 AI 助手来操作#

这个项目推荐的用法，是把活交给 Claude Code、Codex、Gemini CLI 这类能跑终端命令的编程助手。

仓库里有一份 PROMPT.md，是写给 AI 助手的完整操作说明。你把它发给助手，填上电视型号，助手会先在局域网里找到电视、用 ADB 连上，动手前备份应用列表和系统设置。然后它会问你平时看哪些应用、要不要留着语音助手和投屏，再照你的回答去停用，每做一步都从电视上截一张图确认。最后编译桌面、装上、设成默认。

仓库根目录还放着 CLAUDE.md、AGENTS.md、GEMINI.md，分别写给不同的助手。可以看出作者一开始就打算让人只管回答问题，具体操作交给 AI。

我觉得这个思路挺对路。每台电视的预装应用都不一样，同一个牌子换个固件，包名也会变，很难写出一个通吃的脚本。让助手现场看、现场判断，反而更靠谱。说明里还专门交代助手优先用仓库里的 tools/disable.sh，别自己另写，因为备份和保护默认桌面的逻辑都在这个脚本里。

不过让 AI 在电视上执行命令，我还是会盯着它每一步在干什么，尤其是它要停用一个你没听说过的系统组件时。

支持哪些电视#

只支持 Android TV 和 Google TV。三星 Tizen、LG webOS、Roku 都不是安卓，用不了。Fire TV 只能参考它的清单自己手动弄。

examples/ 目录里有 443 个机型的停用列表，都是社区拿真机验证后提交的。我数了一下国内常见的牌子：

品牌	收录机型数
TCL	80
小米	42
海信	16
创维	14
海尔	6
酷开	2
长虹、康佳	0

收录得多，不代表一定能用。README 特意提醒，部分国行电视会拒绝装第三方 APK，或者不让换默认桌面，TCL 就有这样的型号。这种电视还能停掉广告和预装应用，新桌面就未必装得上了。具体要看型号和固件，光看牌子判断不了。

另外，桌面要求 Android 8.0 以上。有些老电视在清单里，系统版本却不够，桌面一样装不了。

换上的桌面长什么样#

深色背景，底部一排常用应用，默认 4 个。焦点移到哪个应用上，就显示它的名字，背景颜色也跟着这个应用的横幅或图标变。往下按是更多应用，每行可以放 4 到 7 个。

用遥控器就能调整顺序：长按设置按钮进入排序模式，方向键挪位置。仓库里有 21 套主题，换颜色、壁纸、列数都不用重新编译。还有 30 多个扩展卡片，天气、世界时钟、睡眠定时、蓝牙开关都有，别的应用想往桌面上放卡片，得你点头才会出现。电视的屏保设置里也能选它自带的时钟屏保。

界面有简体中文，跟着系统语言走。

门槛在于仓库没有现成的 APK，桌面得在自己电脑上编译，要装 JDK 17 和 Android SDK。用 AI 助手的话，这一步也可以让它代劳。

动手前要注意什么#

用完一定要把调试关掉。这个项目走的是网络 ADB，默认 5555 端口，连接是明文的，有些电视固件甚至不检查授权。调试一直开着，同一个网络里的任何设备都可能控制你的电视。

Warning

别为了远程操作，在路由器上把电视的 5555 端口映射到公网。要远程帮家里人弄，README 推荐用 Tailscale 这类私有网络。

停用也可能停出问题。东西虽然没删，停错了照样出故障。README 里记了一个例子：Google TV 停掉原桌面后，系统的设置向导可能会占掉主屏幕。稳妥的做法是分批停，每停一批就重启看看，遥控器、输入源切换、常用应用都正常再继续。

很多停用列表会关掉厂商的系统更新服务，所以之后想升级固件，得先把它重新打开。

还有个容易踩的坑：PROMPT.md 里提到，有些电视盒子开了 USB 调试会切断 USB 口供电，插在上面的 U 盘、音箱、USB 网卡都会失灵。如果你的电视靠 USB 网卡上网，最好一口气做完，别分两次。

上手步骤#

有两种用法，交给 AI 助手，或者自己敲命令。电视这边的准备工作是一样的。

第一步：电视上打开调试#

打开「设置 → 设备偏好设置 → 关于」，在「版本号」（有的叫 Build）上连按七次确定，会提示已进入开发者模式
返回上一级，进「开发者选项」，打开「USB 调试」。如果还有「网络调试」或「ADB 调试」开关，也一起打开
到网络设置里记下电视的局域网 IP，比如 192.168.1.50

每个牌子的菜单名称都不太一样，找不到就在设置里搜”开发者”。

Tip

有些 Google TV 只有「无线调试」，要先用配对码配对，才能走 5555 端口。用 AI 助手的话它会处理；自己操作的话，看仓库 PROMPT.md 里连接那一节。

第二步（方式一）：交给 AI 助手#

我更推荐这种。电脑和电视连同一个网络，然后：

Terminal window

1
git clone https://github.com/Gathin23/cleanyourtv
2
cd cleanyourtv
3
claude   # 或者 codex、gemini

一定要在仓库目录里启动助手。这样它会直接用仓库里的 tools/disable.sh 和 launcher/build-and-install.sh，备份、保护默认桌面、恢复的逻辑都在里面，它就不会自己另写一套。

接着把 PROMPT.md 整段发给它，把里面的 <MODEL NAME HERE> 换成你的电视型号。之后助手会一步步往下走，你只需要做几件事：

电视弹出「允许 USB 调试吗」时点允许，助手会提前告诉你什么时候弹
回答它的问题：平时看哪些应用、底部快捷栏放哪几个、语音助手和投屏要不要留、还要不要收系统更新
最后自己检查一遍，常用应用能不能打开，遥控器每个键是否正常，HDMI 等输入源能不能切

第二步（方式二）：自己敲命令#

需要 Python 3。下面的命令都在仓库根目录里跑，IP 换成你电视的。

准备连接工具，看看电视的信息#

Terminal window

1
python3 -m venv tools/venv
2
tools/venv/bin/pip install -r tools/requirements.txt
3
export TV_HOST=192.168.1.50
4

5
# 读取型号、Android 版本和固件
6
tools/venv/bin/python -I tools/tv.py --probe
7

8
# 列出已安装的应用
9
tools/venv/bin/python -I tools/tv.py 'pm list packages'

停用应用#

先在 examples/ 里找到型号和固件都对得上的目录，读一下里面的 README，再执行：

Terminal window

1
tools/disable.sh examples/你的机型/debloat.txt

别直接拿其他机型的列表来用。不想停的应用，在那一行前面加 #。脚本会把停用前的状态记到电脑上的 ~/.cleanyourtv/ 目录里，之后恢复要靠它。

编译并安装桌面#

需要 JDK 17、Android SDK Platform 34 和 Build Tools 34.0.0。macOS 上可以这样装：

Terminal window

1
brew install openjdk@17 android-commandlinetools
2
sdkmanager "platforms;android-34" "build-tools;34.0.0"

然后一条命令编译、安装、切换默认桌面：

Terminal window

1
TV_HOST=192.168.1.50 launcher/build-and-install.sh

脚本会先确认新桌面能启动，再把它设成默认，同时停掉原来的桌面。想留着原桌面，就加上 STOCK_LAUNCHER=none。注意这只是不停用原桌面，默认桌面照样会换成新的：

Terminal window

1
TV_HOST=192.168.1.50 STOCK_LAUNCHER=none launcher/build-and-install.sh

换个主题（可选）#

Terminal window

1
TV_HOST=192.168.1.50 tools/theme.sh themes/aurora    # 换主题
2
TV_HOST=192.168.1.50 tools/theme.sh --reset          # 恢复默认

Windows 用户用仓库里对应的 .ps1 脚本，用法见 README 的 Windows 一节。

第三步：关掉调试#

全部弄完后，回到「开发者选项」，关掉 USB 调试和网络调试，再撤销已经授权过的电脑。5555 端口的连接是明文的，一直开着不安全。

后悔了怎么恢复#

用停用时的同一份列表：

Terminal window

1
TV_HOST=192.168.1.50 tools/restore.sh examples/你的机型/debloat.txt

脚本会照着 ~/.cleanyourtv/ 里的记录，把应用和原来的默认桌面恢复回去。停用之前本来就关着的应用，恢复后还是关着。

新桌面不会被恢复脚本卸载，要删就去电视的「设置 → 应用」里删。连不上 ADB 的时候，也可以直接在电视的应用设置里，把停掉的应用一个个重新启用。

最后#

如果你的电视是安卓系统，开机广告和推荐内容让你烦，又不想刷机，可以先去 examples/ 里搜一下自己的型号。有收录的话，读完那个目录里的说明和已知问题再动手。没收录也能用，助手会现场检查你的电视，只是要多花点时间确认哪些能停、哪些不能停。

Astro 博客搭建全过程：从零到上线

Wed, 04 Nov 2026 12:00:00 GMT

这个博客一开始用的是 AstroPaper，后来换成了 Firefly。这篇按现在的搭法重新写了一遍，命令和路径都是我自己跑通过的。

搭完你会有一个这样的博客：

静态站点，构建完就是一堆 HTML，放哪都能跑
自带暗色模式、全文搜索、RSS、站点地图
文章用 Markdown 写，frontmatter 写错了构建时直接报错
可以部署到 Vercel、Cloudflare Pages，也可以自己用 Docker 跑

需要会一点命令行，Node.js 用过就行。

一、环境准备#

Firefly 基于 Astro 7，对版本要求比较新：

Node.js 22 或更高（准确地说是 22.23 以上）
pnpm 11 或更高，项目里有脚本强制只能用 pnpm 装依赖
Git

Terminal window

1
node -v      # 低于 v22 需要升级
2
pnpm -v      # 没装就 npm install -g pnpm
3
git --version

macOS 可以用 Homebrew 装 Node：

Terminal window

1
brew install node

编辑器推荐 VS Code，装上 Astro 官方扩展，.astro 文件才有高亮和提示。

二、创建项目#

Firefly 不走 pnpm create astro，直接克隆仓库。建议先在 GitHub 上 Fork 一份到自己账号下，再克隆自己的那份，以后部署和同步更新都方便：

Terminal window

1
git clone https://github.com/<你的用户名>/Firefly.git my-blog
2
cd my-blog
3
pnpm install
4
pnpm dev

打开 http://localhost:4321 就能看到演示站了。

Tip

pnpm install 会下载几个平台相关的二进制包，比如搜索用的 Pagefind，单个就有几十 MB。网络不稳的时候可能下了一半就断，pnpm 还会显示安装成功，等到 pnpm build 最后一步才报 Failed to install either of [pagefind_extended, pagefind]。遇到这种情况，删掉 node_modules 重装一次，或者换个网络环境再装。

三、项目结构#

只列出平时会动到的部分：

1
my-blog/
2
├── astro.config.mjs        # Astro 配置：插件、Markdown、sitemap 等
3
├── src/
4
│   ├── config/             # 站点配置，按功能拆成很多个文件
5
│   ├── content/
6
│   │   ├── posts/          # 文章
7
│   │   └── spec/           # 关于页、友链页、留言板的正文
8
│   ├── assets/images/      # 头像、壁纸等，构建时会自动压缩
9
│   └── layouts/            # 页面布局，加统计代码、站长验证在这里
10
└── public/                 # 原样复制的静态文件，favicon 放这里

Firefly 的配置没有塞进一个大文件，而是拆在 src/config/ 下，最常改的几个：

文件	管什么
`siteConfig.ts`	站点标题、域名、主题色、页面开关、文章列表样式
`profileConfig.ts`	侧边栏头像、昵称、简介、社交链接
`navBarConfig.ts`	顶部导航菜单
`backgroundWallpaper.ts`	首页横幅的壁纸、标题、副标题
`sidebarConfig.ts`	侧边栏放哪些小组件
`commentConfig.ts`	评论系统
`friendsConfig.ts`	友链列表

四、改成你自己的站#

站点信息#

打开 src/config/siteConfig.ts，至少改这几项：

1
export const siteConfig: SiteConfig = {
2
  title: "七号研习社",
3
  subtitle: "记录技术、生活与思考",
4
  site_url: "https://llxx.cc",
5
  description: "777 的个人博客，记录技术、生活与思考。",
6
  timezone: "Asia/Bangkok",
7
  // ...
8
};

site_url 一定要改成你的域名，RSS、sitemap 和分享卡片里的链接都靠它生成。

同一个文件顶部有个 pages 开关表，演示站开了一堆页面：动态、项目、相册、书签、打赏、追番等等。用不上的设成 false，对应的页面会返回 404，导航栏里的入口也会自动隐藏：

1
const pages = resolvePageToggles({
2
  friends: true,
3
  guestbook: false,
4
  dynamic: false,
5
  projects: false,
6
  gallery: false,
7
  booknav: false,
8
  sponsor: false,
9
  // ...
10
});

头像、图标和横幅#

头像：图片放到 src/assets/images/，在 profileConfig.ts 里改 avatar
网站图标：PNG 放到 public/favicon/，在 siteConfig.ts 的 favicon 里列出来。建议放一张 180×180 的，iPhone 添加到主屏幕时会用它
首页横幅：标题、副标题和下面那排图标链接都在 backgroundWallpaper.ts 的 homeText 里

演示站的横幅标题、社交链接、友链、关于页都是作者自己的内容，记得逐个换掉。偷懒的办法是全局搜一下 cuteleaf 和 xiaye，搜到的基本都要改。

评论#

commentConfig.ts 里的 type 默认是 "none"，即不开评论。支持 Twikoo、Waline、Giscus、Artalk、Disqus，想开哪个就把 type 改成对应的名字，再填好下面那一段配置。我这里没开。

五、写文章#

文章放在 src/content/posts/ 下，子目录会原样变成网址的一部分。我按年月放：

1
src/content/posts/
2
└── 2026/
3
    └── 11/
4
        ├── astro-blog-setup-guide.md
5
        └── img/
6
            └── screenshot.png

这篇文章的地址就是 /posts/2026/11/astro-blog-setup-guide/。图片放在旁边的 img/ 里，正文用相对路径 ![说明](./img/screenshot.png) 引用，构建时会自动转成 WebP。

frontmatter 长这样：

1
---
2
title: Hello World
3
published: 2026-11-04T12:00:00.000Z
4
description: 我的第一篇博客文章。
5
category: 技术
6
tags:
7
  - Astro
8
author: "777"
9
pinned: false
10
draft: false
11
---

几个字段说明：

category 只能填一个，tags 可以填多个。首页顶部的分类栏就是按 category 统计的
pinned: true 会把文章置顶
draft: true 是草稿，本地 pnpm dev 能看到，正式构建时会被排除
updated 填最后修改时间，超过一定天数文章底部会提示”上次编辑于……”

Warning

字段值是纯数字时要加引号。比如我的昵称是 777，写成 author: 777 会被 YAML 当成数字，构建直接报错，必须写 author: "777"。

也可以用脚本建文章，它会帮你生成 frontmatter：

Terminal window

1
pnpm new-post 2026/11/hello-world

六、Markdown 扩展#

除了标准 Markdown，Firefly 还多了几样常用的。

提醒块，用的是 GitHub 的写法：

1
> [!NOTE]
2
> 普通提示。
3

4
> [!WARNING]
5
> 需要注意的地方。

可选的还有 TIP、IMPORTANT、CAUTION。上面那两个黄框就是这么写出来的。

GitHub 仓库卡片，一行就能插入一个带 Star 数的卡片：

1
::github{repo="CuteLeaf/Firefly"}

代码块用的是 Expressive Code，自带复制按钮和语言标识，超过 15 行的代码默认折叠。代码块里要再嵌一个代码块时，外层改用 ~~~ 包起来就行：

1
```bash
2
echo "Hello from my blog!"
3
```

七、搜索、RSS 和 sitemap#

这三样 Firefly 都配好了，不用另外装：

搜索：Pagefind。pnpm build 的最后一步会扫描生成好的 HTML，在 dist/pagefind/ 里生成索引，搜索完全在浏览器里完成，不需要服务器
RSS / Atom：/rss.xml 和 /atom.xml
sitemap：/sitemap-index.xml。在 pages 里关掉的页面会自动排除，其他想排除的页面可以在 astro.config.mjs 的 sitemap({ filter }) 里加规则

八、加统计和站长验证#

Google Analytics、Umami、Microsoft Clarity 在 src/config/analyticsConfig.ts 里填 ID 就行。

不在列表里的代码，比如 Google AdSense 的站点验证，直接加到 src/layouts/Layout.astro 的 <head> 里：

1
<head>
2
  <meta charset="UTF-8" />
3
  <meta name="google-adsense-account" content="ca-pub-xxxxxxxxxxxxxxxx" />
4
  ...
5
</head>

九、部署上线#

先在本地完整构建一次，确认没有报错：

Terminal window

1
pnpm build     # 输出到 dist/
2
pnpm preview   # 在 localhost:4321 预览构建结果

方案一：Vercel / Netlify / Cloudflare Pages#

最省事。代码推到 GitHub，在平台上导入仓库，填两个命令：

安装命令：pnpm install
构建命令：pnpm build
输出目录：dist

之后每次 push 都会自动重新部署。Firefly 自带了 vercel.json，用 Vercel 的话连这几项都不用填。

方案二：Docker + Nginx#

有自己的服务器的话，用多阶段构建：

1
FROM node:lts AS base
2
WORKDIR /app
3
RUN corepack enable && corepack prepare pnpm@latest --activate
4

5
COPY package.json pnpm-lock.yaml ./
6
RUN pnpm install --frozen-lockfile
7

8
COPY . .
9
RUN pnpm run build
10

11
FROM nginx:mainline-alpine-slim
12
COPY --from=base /app/dist /usr/share/nginx/html
13
EXPOSE 80

Terminal window

1
docker build -t my-blog .
2
docker run -d -p 80:80 --restart unless-stopped my-blog

十、从 AstroPaper 迁移过来要注意什么#

如果你和我一样是从别的 Astro 主题换过来的，这几件事要留意：

frontmatter 字段名不一样。AstroPaper 的 pubDatetime、modDatetime、featured、ogImage，在 Firefly 里分别是 published、updated、pinned、image，另外多了一个 category。文章多的话写个小脚本批量替换，正文不要动
文章目录换了。从 src/data/blog/ 挪到 src/content/posts/，子目录结构保持不变的话，文章网址也不会变，搜索引擎收录和别人引用的链接都不会失效
演示内容很多。看板娘模型、音乐播放器、示例公告、作者自己的友链和打赏链接，都要手动关掉或删掉。光 public/pio/ 里的看板娘模型就有 15 MB，不用的话直接删
评论数据和路径绑定。Twikoo 这类评论系统按页面路径存评论，路径一变，旧评论就对不上了

日常写作流程#

搭好以后，平时写文章就是：

pnpm new-post 2026/11/文章名 新建文件
填好 frontmatter，写正文
pnpm dev 本地看效果
提交、push，等自动部署

搭博客本身花不了多少时间，花时间的是把演示站的东西一点点换成自己的，还有之后能不能坚持写下去。