1 前置条件

在执行接下来的步骤之前，请确保你已经完成了以下准备工作：

• 一个托管在 Cloudflare 上的自定义域名，例如 example.com

  警告

  尽管免费的二级域名可能也可以使用，但是强烈建议使用自己购买的域名。

• 本地安装了 Thunderbird (或其他支持 IMAP 和 SMTP 的邮件客户端)

• 一个可以收发邮件的辅助邮箱（例如 Gmail、Outlook、QQ 邮箱等，不限），并且已经添加到 Thunderbird 中，例如 alice@gmail.com

2 收件

2.1 配置 DNS

登录 Cloudflare 后，进入你的域名管理界面，找到电子邮件 -> 电子邮件路由。

• 如果你之前没有设置过邮件路由，会弹出电子邮件路由入门指南，指导你添加一系列的 DNS 记录。点击左下角的添加记录并启用即可。

• 如果你之前已经设置过邮件路由，会直接进入电子邮件路由的概述页面。转到设置页面，找到域部分。

  如果通过电子邮件发送 DNS 记录的状态是配置错误 (如下图)，点击右侧的 …，选择修复记录。

  

2.2 设置路由

1. 在电子邮件路由的目标地址页面，添加之前准备好的邮箱地址。

2. 在路由规则页面，找到自定义地址部分，创建地址。

   • 自定义地址：输入你想要的邮箱地址，例如 test@example.com

   • 操作：发送到电子邮件

   • 目标：选择之前添加到 Thunderbird 的辅助邮箱，例如 alice@gmail.com

3 发件

此处我们选择 AhaSend 作为 SMTP 服务提供商。AhaSend 免费套餐每月 1000 封邮件，足够个人使用。

3.1 注册账号

不再赘述。注意不能用 Gmail 等公共邮箱注册，可以使用上一步配置好的邮箱地址注册。

3.2 配置 DNS

登录 AhaSend 后，进入 Domains 页面，点击 Create a new domain，输入你的域名，例如 example.com。

AhaSend 会生成一系列 DNS 记录，按照提示在 Cloudflare 中添加这些记录。

等待一段时间，直到 AhaSend 显示域名的各项 DNS 配置状态都是 Ready。

3.3 配置 SMTP

进入 Credentials 页面，点击 Create a new credential。

• Type：选择 SMTP

• Name：随意

• Mode：选择 Production

• Scope：选择 Scoped to specific domains，选择刚才添加的域名。

打开创建的凭证，记录 Username、Password、Server、Port 备用。

3.4 配置邮件客户端

1. 打开 Thunderbird，进入账户设置，选择左列最下边的发件服务器。点击添加，输入以下信息：

   • 描述：随意

   • 服务器名称：填写 AhaSend 的 Server

   • 端口：填写 AhaSend 的 Port

   • 连接安全性：选择 STARTTLS

   • 身份验证方法：选择 普通密码

   • 用户名：填写 AhaSend 的 Username

2. 选择左列的之前添加到 Thunderbird 的辅助邮箱 (例如 alice@gmail.com)，设置右侧的默认身份：

   • 您的姓名：随意

   • 电子邮件：填写之前配置的自定义邮箱地址，例如 test@example.com。这样发送邮件时就会使用该身份作为发件人。

3. 修改发件服务器为之前创建的 AhaSend 发件服务器。

4 OpenPGP 加密

打开 Thunderbird 的账户设置，找到左列的之前添加到 Thunderbird 的辅助邮箱 (例如 alice@gmail.com) 下面的端到端加密。

点击添加密钥 -> 新建 OpenPGP 密钥，选择之前设置的身份标识，按需配置密钥到期日和密钥类型、大小（建议使用 ECC）等，点击生成密钥。

生成完成后，回到端到端加密页面，向下找到高级设置，全部勾选。

你可以选择在密钥服务器（如 keys.openpgp.org 等）上发布密钥，以便其他人通过你的邮箱地址找到公钥发送加密邮件给你。

5 高级设置

5.1 设置多个邮箱地址

我们可以利用一个辅助邮箱来实现多个自定义邮箱地址的收发邮件功能。

5.1.1 收件

在 Cloudflare 的电子邮件路由 -> 路由规则页面，添加多个自定义地址即可。

5.1.2 发件

在 Thunderbird 中，进入账户设置，选择左列的之前添加到 Thunderbird 的辅助邮箱 (例如 alice@gmail.com) ，点击最下方的管理标识。在此处添加新的身份。

发件时选择不同的身份，就会使用对应的自定义邮箱地址作为发件人了。

5.1.3 OpenPGP 加密

为新的身份标识生成新的 OpenPGP 密钥。这样，在发送邮件时选择不同的身份，就会使用对应的密钥进行加密了。

5.2 设置子域名邮箱地址

如果你想使用类似 user@sub.example.com 的子域名邮箱地址，需要执行以下步骤：

1. 登录 Cloudflare 后，进入你的域名管理界面，找到电子邮件 -> 电子邮件路由 -> 设置页面，找到子域部分，添加子域。这一步会添加一些新的 DNS 记录。

2. 在电子邮件路由的路由规则页面，配置新的子域邮箱地址的路由规则。

3. 在 AhaSend 的 Domains 页面，添加新的子域名，并按照提示添加 DNS 记录。添加完成后，创建新的 SMTP 凭证，选择添加的子域名。

   注意

   如果之前已经添加了主域名，此处仍需重新添加子域名，并且添加新的 DNS 记录。

4. 在 Thunderbird 中，添加新的身份标识，使用新的子域名邮箱地址。

5. 为新的身份标识生成新的 OpenPGP 密钥。

1 安装 Xmake

参考 Xmake 官方文档

2 安装 C++ 工具链

2.1 MSVC

直接安装 Visual Studio，选择 “使用 C++ 的桌面开发” 工作负载即可。

2.2 MinGW

1. 访问 mingw-builds-binaries ，下载最新版本的 MinGW-w64。

   建议下载 x86_64、posix、seh、ucrt 版本的 MinGW-w64，以获得更好的兼容性和性能。

2. 解压到指定目录，例如 D:\Toolchains\mingw-w64。

3. 将 MinGW 的 bin 目录添加到系统环境变量 PATH 中，例如 D:\Toolchains\mingw-w64\mingw64\bin。

4. 验证安装是否成功：

   bash

   gcc --version
   g++ --version

2.3 Clang/LLVM

暂略

3 安装 Qt SDK

3.1 官方渠道

访问 Qt 官方网站 下载在线安装程序，此处不再赘述。

3.2 aqtinstall

1. 安装 Python 3.x 及 pipx/uv

   bash

   pipx install aqtinstall

   或者

   bash

   uv tool install aqtinstall

2. 使用 aqtinstall 安装 Qt

   1. 列出可用的 Qt 版本

      bash

      aqt list-qt windows desktop

   2. 列出指定版本的可用架构

      bash

      aqt list-qt windows desktop --arch 6.10.2

   3. 安装指定版本和架构的 Qt (此处架构的选择需要与所使用的编译器对应)

      bash

      aqt install-qt windows desktop 6.10.2 win64_msvc2022_64 --outputdir D:\Qt     

3. 将 Qt 目录添加到 Xmake 的全局配置中

   bash

   xmake g --qt=D:\Qt\6.10.2\msvc2022_64

3.3 自行编译 Qt

暂略

4 创建 Xmake 项目

4.1 MSVC 示例

1. 使用 Xmake 模板创建 Qt 项目：

   bash

   xmake create -t qt.widgetapp MyQtApp
   cd MyQtApp

   可以通过 xmake create -h 查看更多模板选项。

2. 运行：

   bash

   xmake run

   如无意外，会编译并运行一个简单的 Qt 窗口应用：

   

3. 如果想要发布应用，可以使用：

   bash

   xmake install -o build\release\install

   发布的文件会在 build\release\install 目录下。

   警告

   不要直接执行 xmake 命令来编译项目，否则可能会遇到找不到 DLL 的问题。

4.2 MinGW 示例

1. 使用 Xmake 模板创建 Qt 项目：

   bash

   xmake create -t qt.widgetapp MyQtApp
   cd MyQtApp

2. 修改项目配置，指定使用 MinGW 工具链：

   bash

   xmake f -p mingw

3. 运行：

   bash

   xmake run

   如无意外，会编译并运行一个简单的 Qt 窗口应用。

4. 发布应用：同上

5 配置 VSCode 开发环境

在此处下载最新版的 clangd，解压后将 bin 目录添加到系统环境变量 PATH 中。

安装 VSCode 及相关插件：

• XMake

• clangd

• C/C++

由于对于中大型项目，C/C++ 扩展的语言服务性能很差，因此使用 clangd 用于提供语言服务 (自动补全、跳转、格式化等等)，C/C++ 扩展用于调试。

为避免冲突，需要禁用 C/C++ 扩展的语言服务功能：

C_Cpp.intelliSenseEngine: "Disabled"

5.1 语言服务

1. Xmake 的 VSCode 插件会自动在 .vscode 目录下生成 compile_commands.json 文件。

   我们需要配置 clangd 使用这个文件：打开设置 -> 扩展 -> clangd，找到 Clangd: Arguments，添加以下参数：

   json

   --compile-commands-dir=.vscode

   或者在 .vscode/settings.json 中添加：

   json

   {
     "clangd.arguments": [
       "--compile-commands-dir=.vscode"
     ]
   }

2. 如果使用 mingw 工具链，执行：

   bash

   xmake f -p mingw

3. 构建：

   bash

   xmake build

在此之后，可以看到代码的自动补全和跳转功能均可正常使用。

如果不行，尝试重启 VSCode。

5.2 调试

按 F5，选择 C++ (GDB/LLDB)。

6 温馨提示

• 一定要确保所安装的 Qt 版本与所使用的编译器兼容！

• 不要使用 static 类型的模板创建项目，除非你的 Qt 版本是静态编译的。

7 参考资料

• Xmake 官方文档

• xmake 从入门到精通 6：开发和构建 Qt 程序

1 前提条件

• Python >= 3.11 (如果 IDA 自带 Python 则无需安装)

• IDA Pro >= 8.3

2 安装步骤

1. 安装 ida-pro-mcp 插件

   • 如果 IDA 使用系统 Python 环境，可以直接使用 pip 安装：

     bash

     pip uninstall ida-pro-mcp
     pip install https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip
     ida-pro-mcp --install

   • 如果使用的是 uv 托管的 Python 环境，使用以下命令：

     bash

     uv pip uninstall ida-pro-mcp
     uv pip install --system --break-system-packages https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip
     uv run ida-pro-mcp --install

   • 如果 IDA 使用自带的 Python 环境，在包含 python.exe 的目录下执行：

     bash

     python.exe -m pip install --upgrade https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip

     然后找到 ida-pro-mcp.exe 脚本的位置 (一般在 python3x/Scripts 下)，运行以下命令进行安装：

     bash

     ida-pro-mcp --install

   transport mode 选择 Streamable HTTP，installation scope 选择 Global。

   完成配置后，执行：

   bash

   ida-pro-mcp --config

   记录[STREAMABLE HTTP MCP CONFIGURATION] 的 url 字段。

2. 安装 Cherry Studio

3. 配置 MCP

   • 打开 Cherry Studio，导航到设置页面，找到 MCP 配置选项。

   • 添加 MCP 服务器，类型选择 可流式传输的 HTTP，地址填写第一步中记录的 url 字段值。

   • 保存配置。

3 使用 IDA MCP

1. 启动 IDA Pro，打开一个二进制文件，点击 Edit -> Plugins -> MCP。

2. 在 Cherry Studio 中，点击对话框下的 MCP 图标，选择刚才配置的 IDA MCP。

3. 现在可以在 Cherry Studio 中与 IDA 进行交互了，例如查询函数信息、反汇编代码等。

1. 打开 启用或关闭 Windows 功能，勾选 适用于 Linux 的 Windows 子系统 、 虚拟机平台 和 Hyper-V，点击确定并重启电脑。

2. 打开 PowerShell (管理员权限)，执行以下命令安装 WSL 和 Debian 发行版：

   bash

   wsl --update
   wsl --set-default-version 2
   wsl --install -d Debian

3. 配置 Debian 用户名和密码。

4. (可选) 设置默认用户为 root：

   bash

   wsl -d Debian -u root

   然后执行：

   bash

   apt install -y sudo
   nano /etc/wsl.conf

   在文件中添加：

   ini

   [user]
   default=root

   保存并退出。下次启动 WSL 时即为 root 用户。

2 移动 WSL 虚拟磁盘位置

1. 关闭 WSL：

   bash

   wsl --shutdown

2. 以管理员权限执行：

   bash

   wsl --manage Debian --move <新路径>

3 初始化 WSL

1. 更新软件包列表并升级已安装的软件包：

   bash

   sudo apt update && sudo apt upgrade -y

2. 美化终端：

   bash

   sudo apt install -y zsh git wget
   sh -c "$(wget https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh -O -)"
   git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
   git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

   修改 ~/.zshrc，添加插件：

   bash

   plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

   重启终端或执行 source ~/.zshrc。

4 汉化

1. 修改系统语言为中文：

   bash

   sudo apt install locales
   sudo dpkg-reconfigure locales

   按向下键选择 zh_CN.UTF-8，按空格键选中，回车确认；选择 zh_CN.UTF-8 作为默认语言，回车确认。

2. 安装中文字体：

   bash

   sudo apt install -y fonts-wqy-zenhei fonts-wqy-microhei

5 安装桌面环境

1. 安装 XFCE4 桌面环境：

   bash

   sudo apt install -y xfce4

   注意

   执行上述命令后，仅支持窗口级 GUI，不支持完整桌面环境。

6 与 VS Code 集成

1. 安装 VS Code，并安装 WSL 插件。

2. 在 WSL 终端中：

   bash

   code .

7 压缩 WSL 虚拟磁盘

1. 关闭 WSL：

   bash

   wsl --shutdown

2. 执行：

   bash

   diskpart

3. 在 diskpart 提示符下，执行以下命令：

   bash

   select vdisk file=<WSL 虚拟磁盘路径>
   attach vdisk readonly
   compact vdisk
   detach vdisk
   exit

8 其他

8.1 安装 .NET SDK

1. 添加环境变量：

   bash

   nano ~/.zshrc

   在其中添加：

   bash

   export DOTNET_CLI_TELEMETRY_OPTOUT=1

2. https://learn.microsoft.com/zh-cn/dotnet/core/install/linux-debian

1 为什么选择 Hugo DoIt？

• 更新活跃，构建速度快

• 简洁美观，功能丰富，移动端友好

• 加载速度快，SEO 优化良好

2 预先要求

1. Git

2. Go Programming Language

3. Hugo

   建议安装 Hugo Extended 版本。

3 步骤

3.1 初始化

1. 在本地初始化博客：

   bash

   hugo new site myblog
   cd myblog
   git init
   git submodule add https://github.com/HEIGE-PCloud/DoIt.git themes/DoIt
   git add .
   git commit -m "Initial commit"

2. 初始化配置文件：

   1. 删除根目录的 hugo.toml 文件
   2. 把 themes/DoIt/exampleSite/config 文件夹复制到博客根目录
   3. 修改根目录的 config/_default/hugo.toml 文件，将 themesDir = "../.." 删去。

3. 创建第一篇博客文章：

   bash

   hugo new posts/my-first-post.md

4. 根目录下执行：

   bash

   hugo server

5. 打开浏览器，访问 http://localhost:1313 查看博客

   

3.2 配置

详见 DoIt 主题文档

3.3 部署

3.3.1 GitHub

同 Hexo 博客搭建指南#GitHub

3.3.2 Cloudflare

与 Hexo 博客搭建指南#Cloudflare 基本一致，注意：

1. 构建命令为 hugo，构建输出目录为 public。
2. 构建系统版本为 版本 3。

3.4 其它功能

3.4.1 评论

与 Hexo 博客搭建指南#评论功能 基本一致

我们可以使用虚拟环境来解决这个问题。目前有以下几种主流的解决方案：

• venv

• uv venv

• virtualenv

• conda

• ……

1 venv

venv 是 Python 3.3 版本后自带的虚拟环境工具，优点是简单易用，缺点是功能相对较少，且不支持本机未安装的 Python 版本。

1.1 创建、激活和删除

1. 创建虚拟环境

   bash

   python3 -m venv <env_name>

   其中 <env_name> 是你想要创建的虚拟环境的名称，习惯上使用 .venv。

2. 激活 & 取消激活

   在 Linux 和 macOS 上：

   bash

   source <env_name>/bin/activate

   在 Windows 上：

   bash

   <env_name>\Scripts\Activate.ps1

   激活后在命令行前面会出现虚拟环境的名称，表示当前处于该虚拟环境中。

   取消激活：

   bash

   deactivate

   或直接关闭终端窗口。

3. 删除虚拟环境

   直接删除虚拟环境目录即可。

1.2 安装包

在虚拟环境中使用 pip 安装包，安装的包只会在当前虚拟环境中可用。

pip install <package_name>

如果报错 Fatal error in launcher: Unable to create process using ...，尝试：

1. 删除 <env_name>/Libs/site-packages/pip 目录

2. 在激活的终端执行：

   bash

   python -m ensurepip
   python -m pip install --upgrade pip

3. 重新安装需要的包

1.3 使用他人的虚拟环境

拿到他人的虚拟环境时，进入虚拟环境目录，打开 pyvenv.cfg 文件。

把 home 的值改为你本机的 Python 安装路径，executable 的值改为你本机的 Python 可执行文件路径，command 的值也相应地进行修改。

2 uv venv

uv venv 是 uv 的一个子命令，需要先安装 uv。主要优点是快，缺点是不支持 Python 3.7 以下版本。

2.1 创建、激活和删除

1. 创建并激活

   bash

   # 创建默认虚拟环境
   uv venv
   # 创建指定名称的虚拟环境
   uv venv <env_name>
   # 创建指定名称和 Python 版本的虚拟环境
   uv venv -p <python_version> <env_name>

2. 手动激活

   bash

   .\<env_name>\Scripts\activate.bat

3. 取消激活

   bash

   deactivate

4. 删除

   删除虚拟环境目录即可

2.2 安装包

在 pip 指令前加上 uv 即可：

uv pip install <package_name>

2.3 其他

uv 还提供了一些比较实用的功能：

• uv run <script>：运行指定的 Python 脚本，自动激活虚拟环境
• uvx <package_name>：在不安装包的情况下运行该包
• uv python install <python_version>：安装指定版本的 Python
• uv python list：列出已安装的 Python 版本

详见官方文档

16 前置条件

• Windows 11

• Python >= 3.10

17 下载、安装与激活

17.1 下载

• IDA 9.3 SP2

• IDA 9.3

• IDA 9.2

• IDA 9.1

详细信息：https://hexrays.su/

17.2 安装

略

17.3 激活

• IDA 9.2 / 9.3

  • https://auth.lol/ida/keygen

  • 将 kg_patch/keygen.js 复制到 IDA 安装目录下，运行该脚本

• IDA 9.1

  • https://github.com/ThatNotEasy/IDA-Patcher

    备份：IDA-Patcher-main.zip

18 基本配置

18.1 字符串相关

打开 Strings 子界面：View -> Open subviews -> Strings

1. Strings 界面中右键 -> Setup，根据需要设置

   

2. Options -> General -> String，修改默认编码

   

3. 编码问题

   依据需要修改 Options -> General -> Strings -> Default 8-bit string 为 UTF-8 或者 936 (直接输入 CodePage 即可)等等，再在 Strings 窗口右键 -> Rebuild。

18.2 sig

1. FLIRTDB

   sig-database

   ida-flirtdb

   下载并解压到 sig 目录下

2. 转到这里，下载对应版本的 signatures bundles，解压到 sig 目录下

使用时点击 plugins -> IDA Feeds 或 Shift + F5

18.2.1 自行创建静态库 sig

使用 tools/flair/pcf.exe 和 sigmake.exe

先获取 pat 文件：

pcf <static_lib_path> <output_pat_path>

再把 pat 文件转换为 sig 文件：

sigmake <pat_path> <output_sig_path>

可能有 collision，查看 exc 文件：

;--------- (delete these lines to allow sigmake to read this file)
; add '+' at the start of a line to select a module
; add '-' if you are not sure about the selection
; do nothing if you want to exclude all modules

_gzgetc 26 E38D 558BEC8B550885D2744E817A104F1C000075458B426485C0740583F8FB75398B
_gzgetc_ 26 E38D 558BEC8B550885D2744E817A104F1C000075458B426485C0740583F8FB75398B

_gzopen 00 0000 558BECFF750C6AFFFF7508E8........83C40C5DC3......................
_gzopen64 00 0000 558BECFF750C6AFFFF7508E8........83C40C5DC3......................

在想要包含的行前加上 +，然后把带分号的行删去，例如：

+_gzgetc 26 E38D 558BEC8B550885D2744E817A104F1C000075458B426485C0740583F8FB75398B
_gzgetc_ 26 E38D 558BEC8B550885D2744E817A104F1C000075458B426485C0740583F8FB75398B

+_gzopen 00 0000 558BECFF750C6AFFFF7508E8........83C40C5DC3......................
_gzopen64 00 0000 558BECFF750C6AFFFF7508E8........83C40C5DC3......................

最后重新运行 sigmake 命令即可。

18.3 pdb

在环境变量中添加条目：_NT_SYMBOL_PATH，值为放置下载的 pdb 文件的目录

加载某些 dll 时可能会自动提示下载，或者在调试界面手动下载 (Load Debug Symbols)

19 插件

• IDA Pro 插件目录：安装目录下的 plugins 文件夹

以下插件在 IDA 9.2 中不可用或可用性未知：

19.1 ida-pro-mcp

见 IDA MCP 使用教程

19.2 ClassInformer

• 下载最新 release，把 IDA_ClassInformer.dll 放到插件目录下

19.3 PyClassInformer

• 把 pyclassinformer_plugin.py 和 pyclassinformer 文件夹放到插件目录下

19.4 d810-ng

• 把 src 目录下的 d810 文件夹和 d810ng.py 放到插件目录下
• pip3 install z3-solver

19.5 signsrch-py

• 把 signsrch.py 和 signsrch.xml 放到插件目录下

19.6 Hrtng

• 下载最新 release，转到 plugins\windows\9.2 ，把 hrtng.dll 放到插件目录下；转到 plugins 目录，把 literal.txt 和 apilist.txt 放到插件目录下；转到 idc 目录，把所有 .idc 文件放到 idc 目录下

19.7 LazyIDA

• 把 LazyIDA.py 放到插件目录下

19.8 DelphiHelper

• 把 DelphiHelper.py 和 DelphiHelper 文件夹放到插件目录下

• 按照提示，下载 IDR 数据库并解压到 plugins/DelphiHelper/IDR_KB 下

  text

  -plugins
      -DelphiHelper
          -IDR_KB
              -IDR
                  -kb2005.bin
                  -......
              -IDR64
                  -syskb2012.bin
                  -......
      -DelphiHelper.py

19.9 deREferencing

• 把 deREferencing 文件夹和 deREferencing.py 放到插件目录下

19.10 auto-enum

• 把 plugin 目录下的 enumlib 文件夹和 auto_enum.py 放到插件目录下

20 相关链接

• IDA Pro 9 安装和插件配置

1 预先要求

1. Git
2. node.js
3. GitHub 账号
4. Cloudflare 账号

2 步骤

2.1 本地站点

1. 打开终端管理员，输入

   bash

   npm install -g hexo-cli

2. 在你喜欢的位置打开终端，输入

   bash

   hexo init myblog

   会新建一个 myblog 文件夹。你可以按照喜好命名。

3. 继续执行：

   bash

   cd myblog
   npm install

4. 继续执行：

   bash

   hexo clean
   hexo g
   hexo s

5. 打开浏览器，输入 http://localhost:4000/，可见：

   

这样，我们本地的网站就初步构建好了。

2.2 部署

2.2.1 GitHub

1. 登录 GitHub，新建一个 repository，名字最好和刚刚 hexo init 的名字一致，权限设置 Private，其余保持默认。

2. 在博客根目录下：

   bash

   git init

3. 设置用户名、邮箱地址、远程存储库：

   bash

   git config user.name "你的 GitHub 用户名"
   git config user.email "你的 GitHub 邮箱地址"
   git remote add origin <你的仓库地址>

4. 提交并推送代码：

   bash

   git add .
   git commit -m "Initial Commit"
   git push

这样，网站代码已经上传到 GitHub 的仓库了。

2.2.2 Cloudflare

1. 登录
2. 计算和 AI -> Workers 和 Pages -> 创建
3. Pages -> 连接到 git 里，关联 GitHub 账号，选择仓库，开始设置
4. 按喜好修改名称 (同时域名也会改变)，构建命令写 npx hexo generate，构建输出目录写 public，保存并部署
5. 等待构建成功

约一分钟后网站可以访问了。

2.3 Hello World

1. 在博客根目录下:

   bash

   hexo new "first"

2. 转到 source/_post，找到新建的 md 文件，用你喜欢的 markdown 编辑器编辑

3. 修改好后，在博客根目录下：

   bash

   hexo clean
   hexo g
   hexo s

4. 打开浏览器，输入 http://localhost:4000/，可以看到修改生效了

5. 如果确认可以提交了，在博客根目录下：

   bash

   git add .
   git commit -m "up"
   git push --force-with-lease

6. 约一分钟后访问你的网址，可以看到修改生效了

2.4 自定义站点样式

hexo 提供许多主题和配色方案，个人推荐 fluid。

它的优点比较显著：

• 免费 & 开源
• 配置简单
• 文档丰富

2.4.1 fluid 主题配置

2.4.1.1 安装与启用

npm install --save hexo-theme-fluid

修改_config.fluid.yml 里 theme: fluid

2.4.1.2 自定义配置

详见_config.yml 和官方文档

一些自定义的配置：

• 背景图全屏 & 随日夜模式切换 & 毛玻璃效果
• 运行时间 & 版权声明优化 & 关于页评论
• 自定义字体

2.4.1.3 评论功能

comments:
enable: true
type: # your scheme

1. valine

   需要先注册 LeanCloud，创建应用，点击，再在设置 - 安全中心 - Web 安全域名里填你的域名

   配置：

   yaml

   valine:
   appId: xxx
   appKey: yyy
   meta: ['nick', 'mail']
   placeholder: '说点什么吧...'
   serverURLs: https://xxx.yyy

   注意

   如使用国际版 LeanCloud，可能会出现国内无法加载评论的问题；使用国内版则需要实名。

2. waline

   相对复杂但效果更好，详见这篇博客

   注意

   国内无法使用

3. twikoo

   步骤较繁琐，详见这篇博客

3 技巧

1. 上传某些文件到网站根目录：

   直接放到 source 目录下即可

   或执行：

   bash

   npm install -g wrangler
   wrangler login
   wrangler pages publish <本地文件夹路径> --project-name=<项目名>

4 常见问题

1. npm 安装报错

   • 尝试使用管理员权限运行
   • 可以使用 npm config set registry https://registry.npm.taobao.org 切换到国内镜像

2. hexo 命令未找到

   • 确保已正确安装 node.js
   • 检查环境变量是否正确设置

3. 更改未生效

   • 确保已执行以下命令

     bash

     hexo clean
     hexo g
     hexo s

   • 网页 build、上线和更新需要一定时间，请过几分钟后再次查看

4. 个人博客需要备案吗？

   • 未设置自定义域名，只使用 *.pages.dev：不需要
   • 网站的自定义域名不使用国内的域名：不需要
   • 网站的自定义域名使用国内的域名：需要