网络技术 on Ranch's Blog

Obsidian + GitHub + Hugo 博客发布工作流

Sat, 04 Jul 2026 08:00:00 +0800

Obsidian + GitHub + Hugo 博客发布工作流

引言

将 Obsidian 知识库中的笔记发布到个人博客，涉及三个角色的协作：

角色	位置	职责
Obsidian 知识库	本地`ai_wiki/`	笔记的创作与存储
GitHub 仓库	`Ranch007.github.io`	Hugo 博客源码 + Git 版本管理
GitHub Actions	CI 构建	自动编译 Hugo 并部署到 gh-pages

从 Obsidian 写笔记到博客上线，全自动无需手动操作博客仓库。

正文

1. 整体架构

┌─────────────────────┐     "发布到博客"      ┌──────────────────────┐
│   Obsidian Vault    │ ──────────────────→   │  Ranch007.github.io  │
│   ai_wiki/          │    publish-to-blog    │  Hugo 博客源码仓库   │
│                     │    .ps1 脚本执行      │                      │
│   wiki/             │                      │  content/post/       │
│   ├── it-tech/      │   1. 扫描 publish:    │  ├── xxx/index.md   │
│   ├── finance/      │      true 笔记         │  ├── yyy/index.md   │
│   └── reading/      │   2. 转换 frontmatter  │  └── ...            │
│                     │   3. 拷贝配图          │                      │
│   publish: true ────│   4. git commit & push │                      │
└─────────────────────┘                       └───────┬──────────────┘
                                                       │ push main
                                                       ▼
                                              ┌─────────────────────┐
                                              │  GitHub Actions     │
                                              │  deploy.yaml        │
                                              │                     │
                                              │  Hugo Extended      │
                                              │  v0.139.0 build     │
                                              │                     │
                                              │  → gh-pages 分支    │
                                              └─────────────────────┘
                                                       │
                                                       ▼
                                              ┌─────────────────────┐
                                              │  GitHub Pages       │
                                              │  ranch007.github.io │
                                              └─────────────────────┘

2. Hugo 博客站

博客仓库：Ranch007.github.io

主题

使用 CaiJimmy/hugo-theme-stack，以 Git 子模块方式引入：

# .gitmodules
[submodule "themes/hugo-theme-stack"]
    path = themes/hugo-theme-stack
    url = https://github.com/CaiJimmy/hugo-theme-stack

克隆时需初始化子模块：

1
2

git clone https://github.com/Ranch007/Ranch007.github.io.git
git submodule update --init

站点配置 (hugo.yaml) 关键点

配置项	值	说明
`theme`	`hugo-theme-stack`	Stack 主题
`DefaultContentLanguage`	`zh-cn`	简体中文
`hasCJKLanguage`	`true`	中日韩语言支持，影响`.Summary` 和 `.WordCount`
`baseurl`	`http://ranch007.github.io`	站点根 URL
`permalinks.post`	`/p/:slug/`	博文 URL 结构
`pagination.pagerSize`	`6`	每页文章数

评论系统

基于 giscus（GitHub Discussions）：

comments:
  provider: giscus
  giscus:
    repo: Ranch007/Message-Boards
    mapping: pathname
    lang: zh-CN

使用独立的留言板仓库 Ranch007/Message-Boards，与博客仓库解耦。

侧边栏与头像

sidebar:
  subtitle1: "知是行之始"
  subtitle2: "行是知之成"
  avatar:
    src: https://github.com/Ranch007.png  # GitHub 头像

使用了两个副标题来呈现个人格言。

内容目录结构

content/
├── _index.md              # 首页
├── _index.zh-cn.md        # 中文首页
├── post/                  # 博文（page bundle 结构）
│   └── 文章slug/
│       └── index.md       # 博文正文 + 配图
├── page/                  # 独立页面
│   ├── about/             # 关于
│   ├── archives/          # 归档
│   ├── links/             # 友链
│   └── talk/              # 留言板
├── categories/            # 分类聚合页
│   ├── 网络技术/
│   ├── 投资理财/
│   └── 阅读随记/
└── tags/                  # 标签聚合页

博文使用 Hugo page bundle（每篇文章独立目录），方便携带封面图和资源文件。

分类体系

博客侧边栏显示的三个分类，与 Obsidian wiki 的三个兴趣方向一一映射：

Obsidian wiki 子目录	Hugo 分类
`wiki/it-tech/`	网络技术
`wiki/finance/`	投资理财
`wiki/reading/`	阅读随记

3. 发布脚本详解

核心脚本位于 meta/scripts/publish-to-blog.ps1，做一次性全量发布而非增量同步。

3.1 执行入口

触发词：“发布到博客”或“publish”。

动作（定义在 meta/CLAUDE.md 触发 4）：

AI 在笔记 frontmatter 添加 publish: true
运行 meta/scripts/publish-to-blog.ps1
脚本扫描 → 转换 → 复制 → git push
源笔记 publish: true → published: true

3.2 扫描阶段

Get-ChildItem -Path $WikiDir -Recurse -Filter "*.md" | ForEach-Object {
    $content = Get-Content $_.FullName -Raw
    # 正则匹配 frontmatter 中的 publish: true
    if ($frontmatter -match "(?m)^publish:\s*true$") {
        $toPublish += $_
    }
}

递归扫描 wiki/ 下所有 .md 文件，正则匹配 frontmatter 中 publish: true 字段。

3.3 Frontmatter 转换（Obsidian → Hugo）

Obsidian 字段	Hugo 字段	转换规则
`title`	`title`	原样保留
`published`	`date`	取`published`，无则取 `created`，均无则当天
`tags`	`tags`	原样保留，过滤掉`publish` 标签
`description`	`description`	原样保留
—	`slug`	由标题和日期生成
—	`image`	正文第一张图片
—	`categories`	根据 wiki 子目录自动映射

生成的 Hugo frontmatter 示例：

---
title: "Obsidian 个人知识库搭建全记录"
slug: "2026-07-04-Obsidian-个人知识库搭建全记录"
description: ""
date: "2026-07-04T08:00:00+08:00"
image: cover.jpg
math:
license:
hidden: false
draft: false
categories: ["网络技术"]
tags: [""]
---

3.4 正文转换

Wiki-link 转换：所有 Obsidian 内部链接转为标准 markdown 链接：

# [显示文字](链接.md) → [显示文字](链接.md)
$body = [regex]::Replace($body, '\[\[([^\]|]+)\|([^\]]+)\]\]', '[${2}](${1}.md)')
# [链接](链接.md) → [链接](链接.md)
$body = [regex]::Replace($body, '\[\[([^\]|]+)\]\]', '[${1}](${1}.md)')

Dataview 剥离：dataview 和 dataviewjs 代码块不兼容 Hugo，直接移除：

1
2

$body = $body -replace '(?s)', ''
$body = $body -replace '(?s)', ''

图片处理：内嵌图片 ![assets/xxx](assets/xxx.md) 处理逻辑：

第一张图片 → 封面图（复制到 post 根目录，写入 image 字段）
其余图片 → 复制到 post_slug/assets/ 子目录
图片引用转为 ![](图片名) 的相对路径
如果在 assets 指定路径未找到，递归搜索 assets 所有子目录

$body = [regex]::Replace($body, '!\[\[assets/([^\]]+)\]\]', {
    # 图片存在 → 复制 + 替换引用
    # 第一张图 -> featuredImage（封面）
    # 其余图 -> assets/ 子目录
    # 不存在 → 报错并保留原样
})

空行清理：连续三个以上换行压缩为两个。

3.5 Slug 生成算法

function Get-Slug {
    param([string]$Title, [string]$DateStr)
    # 保留中英文、数字和空格
    $clean = $Title -replace '[^\w一-鿿\s-]', ''
    # 空格替换为 -
    $clean = $clean.Trim() -replace '\s+', '-'
    if ([string]::IsNullOrWhiteSpace($clean)) { $clean = "post" }
    return "$DateStr-$clean"
}

最终 URL 格式：

`1`	`https://ranch007.github.io/p/{slug-lowercase-urlencoded}/`

例如 2026-07-04-Obsidian 个人知识库搭建全记录 → URL 编码后变为：

`1`	`https://ranch007.github.io/p/2026-07-04-obsidian-个人知识库搭建全记录/`

3.6 源笔记标记

发布成功后，源笔记的 publish: true 被替换为 published: true：

`1`	`$newContent = $content -replace '(?m)^publish:\strue\s$', 'published: true'`

这确保了同一篇笔记不会重复发布，并在 frontmatter 中保留了发布记录。

3.7 博客数据同步

脚本同步更新 vault 内的 meta/blog-posts.md：

<!-- 此文件由 publish-to-blog.ps1 自动维护 -->

总篇数: 1

## 最新发布
- [文章标题](https://ranch007.github.io/p/slug/) — 2026-07-04

该文件被仪表盘 index.md 读取展示博客统计和最近发布。

3.8 Git 推送

脚本自动进入博客仓库目录执行：

Push-Location $BlogPath
git add -A
git commit -m "publish: N 篇博客更新"
git push
Pop-Location

推送到 main 分支后，GitHub Actions 会自动构建部署。

4. GitHub Actions 持续部署

工作流文件：.github/workflows/deploy.yaml

name: deploy

on:
  push:
    branches:
      - main        # 只有 main 分支触发

env:
  TZ: Asia/Shanghai          # 时区设置

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
        with:
          submodules: true     # 拉取主题子模块
          fetch-depth: 0       # 完整 git 历史（用于 enableGitInfo）

      - name: Disable quotePath
        run: git config --global core.quotePath false  # 中文文件名不乱码

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: "0.139.0"
          extended: true        # 必须用 extended 版（支持 SCSS）

      - name: Build
        run: hugo -D            # 构建（包括 draft 文章）

      - name: Deploy
        uses: peaceiris/actions-gh-pages@v4
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_branch: gh-pages
          publish_dir: ./public
          commit_message: auto deploy

关键细节：

submodules: true — 必须拉取 hugo-theme-stack 子模块，否则构建失败
extended: true — Stack 主题使用 SCSS，需要 Hugo Extended 版
core.quotePath false — 中文文件名在 git 中不被引用转义
enableGitInfo: true — Hugo 配置中启用，利用 git 提交时间作为 lastmod
目标分支为 gh-pages，GitHub Pages 从该分支提供服务
仓库设置为 Ranch007/Message-Boards 作为 giscus 评论数据源

5. 完整发布流程（端到端）

第 1 步： 在 Obsidian 中写笔记，存入 wiki/ 对应目录 第 2 步： 告诉 AI “发布到博客” 或 “把 xxx 发布到博客” 第 3 步： AI 在笔记 frontmatter 添加 publish: true（如果指定了某篇文章） 第 4 步： AI 执行 meta/scripts/publish-to-blog.ps1 第 5 步： 脚本扫描所有 publish: true 笔记： - 转换为 Hugo 格式 - 复制配图 - 写入 content/post/{slug}/index.md - 标记源笔记 published: true - 更新 meta/blog-posts.md - Git add → commit → push 第 6 步： GitHub Actions 检测到 push，自动构建 Hugo → 部署 gh-pages 第 7 步： 约 1-2 分钟后博客上线

6. 关键细节总结

目录映射规则

源目录	映射为
Obsidian`wiki/`	Hugo`content/post/`
每个`publish: true` 笔记	一个 Hugo page bundle（独立目录）
Obsidian`assets/`	复制到 post bundle 内
wiki 子目录（如 it-tech）	分类标签（如"网络技术"）

前后 frontmatter 对照

源笔记（Obsidian）：

---
title: Obsidian 个人知识库搭建全记录
tags: [it-tech, obsidian, tutorial, workflow]
created: 2026-07-04
publish: true
---

发布后（Obsidian）：

---
title: Obsidian 个人知识库搭建全记录
tags: [it-tech, obsidian, tutorial, workflow]
created: 2026-07-04
published: true
---

博客端（Hugo）：

---
title: "Obsidian 个人知识库搭建全记录"
slug: "2026-07-04-Obsidian-个人知识库搭建全记录"
date: "2026-07-04T08:00:00+08:00"
categories: ["网络技术"]
tags: [""]
draft: false
---

本地预览博客

1
2
3

cd Ranch007.github.io
hugo server -D
# 访问 http://localhost:1313

拓展

局限性

目前是一次性全量扫描发布，不支持增量差异发布
publish 脚本是 PowerShell（Windows 限定），跨平台需适配
Wiki-link 转换后，博客端链接指向本地 .md 文件而非实际页面
如果笔记中有多条 publish: true 同时发布，会作为一次 git commit
封面图依赖 Unsplash API 自动搜索（由 AI 执行），脚本本身不包含此逻辑

后续可能优化

支持只在笔记变更时增量复制（通过 git diff 判断）
添加博客端链接重写为实际 URL 的能力
支持自定义 slug 覆盖（通过 frontmatter 字段）
发布前预览：在本地构建 Hugo 并预览效果再推送

附录

参考文章

wiki/it-tech/notes/obsidian-wiki-setup-guide — Obsidian 个人知识库搭建全记录（已发布到博客）
wiki/it-tech/notes/obsidian-ai-plugin-skill-guide — Obsidian AI 知识库所用插件与 Skills 清单
CaiJimmy/hugo-theme-stack — Stack 主题
peaceiris/actions-hugo — Hugo GitHub Action
peaceiris/actions-gh-pages — GitHub Pages 部署 Action

版权信息

本文原载于 Ranch's Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

Obsidian 个人知识库搭建全记录

Sat, 04 Jul 2026 08:00:00 +0800

Obsidian 个人知识库搭建全记录

引言

基于 Karpathy LLM Wiki 方法论，在 Obsidian 中搭建 AI 辅助个人知识库的完整过程。记录了每个阶段的真实决策、踩过的坑和最终方案。

正文

让 AI 阅读方法论并设计结构

你：阅读Karpathy wiki 方法论，帮我把仓库里的wiki文件夹的结构给建立起来

AI 读完后，按照 Karpathy 的三层架构（raw / wiki / schema）设计了初始目录。经过讨论，确定了三个兴趣方向：

1
2
3

it-tech/    ← IT 技术（编程、框架、工具、架构）
finance/    ← 投资理财（概念、策略、标的分析）
reading/    ← 阅读随记（书籍、文章、跨书主题）

初始结构采用了严格的嵌套方案，后来扁平化调整，去掉了多余层级。

目录演变

初始方案（三层嵌套）            最终方案（扁平）
─────────────────             ────────────────
ai_wiki/                      ai_wiki/
├── wiki/                     ├── raw/          ← 原始资料
│   ├── raw/                  ├── wiki/         ← 知识库
│   ├── wiki/                 │   ├── it-tech/
│   │   ├── it-tech/          │   ├── finance/
│   │   ├── finance/          │   └── reading/
│   │   └── reading/          ├── assets/       ← 配图
│   └── meta/                 └── meta/

第一篇素材

在 raw/ 放入第一篇资料后直接说 ingest，AI 自动完成：归类子目录 → 读取内容 → 创建概念页 + 实体页 → 更新索引 → 写日志。

发现 raw/ 根目录需要整理

使用 Obsidian Web Clipper 剪藏的笔记直接掉进 raw/ 根目录，杂乱无章。于是加了一条规则：

每次 Ingest 时，自动将 raw/ 根目录下的未分类笔记按内容归类到对应子目录。

写入 meta/CLAUDE.md，从此再也不用手动分类。

merge 外部 CLAUDE.md

发现 helloianneo/obsidian-ai-second-brain 的 CLAUDE.md 更完整，将其与本地规则合并，形成了当前 meta/CLAUDE.md 的基础。

索引页的演变

最初的 index.md 只是一个简单的文章列表：

1
2
3

## IT技术
- [概念页](概念页.md) — 说明
- [实体页](实体页.md) — 说明

用了几个来回后，逐步进化成了动态仪表盘。

踩过的坑

问题	原因	解决
仪表盘完全不显示	未启用 DataviewJS 查询	Dataview 设置 → 开启 Enable Dataview JavaScript queries
CSS 不生效	`cssclasses` 应写作 `cssclass`（单数）	修正 frontmatter key
统计卡片对不齐	`dv.el({container})` 参数不可靠	改用`document.createElement` + `dv.container.appendChild`
整个 DVJS 块不渲染	模板字符串内嵌 IIFE 解析失败	把逻辑提到外面先算好
用户名读取报错	`require('os')` 在 Obsidian 中不可用	改用`app.vault.adapter.basePath` 提取
底部索引不显示	用`document.createElement` 但忘了 `appendChild`	创建元素后要手动附加到容器

功能模块迭代顺序

统计卡片 → 文章数、资料数、总计，三列等宽 Grid
兴趣方向 → 各区域文章数 + 标签列表
主题切换 → 🌙 emoji 按钮，一键切换深色/浅色
最近更新 → 按修改时间排序，显示相对时间
每日诗句 → 从诗词歌赋.md 按天轮换
随机索引 → 每天随机展示各区域最多 5 篇
知识图谱 → 点击跳转 Obsidian 关系图谱

主题切换

最初用文字按钮，后来改为纯 emoji 切换：

btn.onclick = () => {
  const isDark = document.body.classList.contains('theme-dark');
  document.body.classList.toggle('theme-dark', !isDark);
  document.body.classList.toggle('theme-light', isDark);
  btn.textContent = isDark ? '☀️' : '🌙';
};

每日诗句

从 wiki/reading/books/诗词歌赋.md 读取，以当天日期为种子选一行，同一天不重复：

const content = await dv.io.load("wiki/reading/books/诗词歌赋.md");
const poemLines = content.split('\n').filter(l => /^\s*\d+\./.test(l));
const d = Math.floor((new Date() - new Date(new Date().getFullYear(), 0, 0)) / 86400000);
const raw = poemLines[d % poemLines.length].replace(/^\s*\d+\.\s*/, '').trim();

问候语按时间段切换

时间段	问候
7:00–8:59	👋 早上好
9:00–10:59	👋 上午好
11:00–12:59	👋 中午好
13:00–16:59	👋 下午好
17:00–22:59	👋 晚上好
23:00–6:59	👋 夜深了，早点休息吧

用户名自动读取

从 vault 路径 C:\Users\{userName}\... 提取，不硬编码：

1
2

const userName = (app.vault.adapter.basePath || '')
  .match(/[\\/]Users[\\/]([^\\/]+)/)?.[1];

meta/CLAUDE.md 的演变

从一个简单规则文件逐步演变成完整的工作手册：

版本	新增内容
v1	Web Clipper 分类规则
v2	merge 外部 CLAUDE.md（Ingest / Query / Lint 三大触发行为）
v3	唤醒自动检查（哈喽/hello 触发）
v4	图片管理规则（命名、分类、外链处理）
v5	Frontmatter 规范（created / published）
v6	精简冗余规则，保留核心流程
v7	log.md 改为新条目插最前面

Frontmatter 规范

---
title: 页面标题
tags: [主分类, 子分类]
created: 2026-07-04       # 我在 wiki 建页日期
published: 2024-06-21     # 原始资料发布日期（有时效性内容必填）
sources:
  - raw/主题/来源文件名.md
---

assets/ 目录建立

assets/
├── it-tech/       ← IT 技术配图
├── finance/       ← 理财配图
└── reading/       ← 阅读配图

不按页面类型细分，一张图可能被多处引用。

命名规范

格式：文章缩写-编号.扩展名

xbi-analysis-01.webp
xbi-analysis-02.webp
xbi-analysis-03.webp
xbi-analysis-04.png

图片管理流程

Web Clipper 剪藏后按 Ctrl+Shift+D 下载附件到 assets/
Ingest 时检查外链图片，提示下载到本地
散落的图片移入对应主题子目录
引用路径统一为 ![assets/主题/xxx.png](assets/主题/xxx.png.md)

初始化目录结构

你：阅读Karpathy wiki 方法论，帮我把仓库里的wiki文件夹的结构给建立起来

灌入第一篇资料

你： ingest

搭建仪表盘

你：我想调整obsidian的面板，更美观，更能展现我的wiki

你：我希望有一个切换深色/浅色主题的按钮

你：仪表盘能加上每天展示一行诗句，从诗词歌赋.md读取

日常 Ingest

你： ingest

健康检查

你：检查一下wiki是否搭建完善，做一轮健康检查

添加自定义规则

你：我使用Obsidian Web Clipper，网页笔记会直接放到raw/，你更新的时候把源笔记也在raw里面分类一下，写成一条规则到meta/CLAUDE.md

唤醒自动检查

你：哈喽

查询知识库

你：我想查询一下为什么房价会跌

拓展

（留空，按需补充）

附录

参考文章

[raw/it-tech/Karpathy wiki 方法论](raw/it-tech/Karpathy wiki 方法论.md) — Karpathy LLM Wiki 方法论（原始 gist）
meta/CLAUDE — AI 工作规则完整版
wiki/it-tech/concepts/llm-wiki-methodology — LLM Wiki 方法论概念页
wiki/it-tech/entities/karpathy-wiki — Karpathy’s LLM Wiki 实体页
wiki/it-tech/notes/obsidian-ai-knowledge-base-guide — Obsidian + Claude AI 搭建指南（第三方）
Karpathy AI+Obsidian 知识库教程 - 栗氪聊AI — 飞书文档（第三方）
helloianneo/obsidian-ai-second-brain — CLAUDE.md 模板参考

版权信息

本文原载于 Ray’s Wiki，请遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

PowerShell $PROFILE 实用手册

Thu, 28 May 2026 10:00:00 +0800

前言

[!WARNING]

本篇文章内容，主要针对 PowerShell 实用性配置，不涉及终端美化，请酌情食用。

$PROFILE 是 PowerShell 中一个非常重要的自动变量，它存储了 PowerShell 配置文件（Profile）的路径。通过编辑它，你可以打造一个完全符合自己习惯的终端环境。

下面是一段快速预览——将以下内容保存到你的 $PROFILE 中，立即体验语法高亮、智能补全、自定义提示符和文件图标：

# 1. 语法高亮与智能提示补全（默认自带，可在此优化）
Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete
Set-PSReadLineOption -PredictionSource HistoryAndPlugin
Set-PSReadLineOption -PredictionViewStyle ListView
Set-PSReadLineOption -Colors @{
    Command = 'Yellow'
    Number = 'Magenta'
}

# 2. 自定义提示符（显示时间与当前路径）
function prompt {
    $date = Get-Date -Format 'HH:mm:ss'
    Write-Host "[$date] " -NoNewline -ForegroundColor Gray
    Write-Host "$(Get-Location) " -NoNewline -ForegroundColor Cyan
    return "> "
}

# 3. 文件Icons
Import-Module -Name Terminal-Icons

如何配置你的 $Profile

查看路径

在终端输入 echo $PROFILE 查看当前配置文件的具体路径。

创建文件

如果文件不存在，使用以下命令创建（注意如果 Documents 目录被 OneDrive 同步，建议将路径指向非同步目录）：

`1`	`if (!(Test-Path $PROFILE)) { New-Item -Type File -Path $PROFILE -Force }`

编辑配置

在终端输入 notepad $PROFILE（或在 VS Code 中输入 code $PROFILE）打开并编辑文本。

[!IMPORTANT]

PSReadLine：优化命令历史、自动补全以及智能语法高亮。

常用路径别名：通过 Set-Alias 将常用长命令或路径设为简写。

快捷函数：创建自定义函数（如一键进入工作目录、一键清空终端缓存等）。

环境变量：配置全局变量或 API Key，供脚本或工具直接调用。

1. 语法高亮与智能提示补全

默认自带，可在 $PROFILE 中进一步优化：

# ==========================================
# 1. 核心功能：输入字母按 Tab 键，直接弹出命令选单
# ------------------------------------------
# 将 Tab 键功能修改为：输入字母后按 Tab，弹出所有相关命令的网格菜单
Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete

# ==========================================
# 2. 核心功能：历史命令智能感知与全列表显示
# ------------------------------------------
# 开启历史与插件预测
Set-PSReadLineOption -PredictionSource HistoryAndPlugin

# 默认将预测显示样式设置为"列表视图(ListView)"，输入时会直接展开下拉列表
Set-PSReadLineOption -PredictionViewStyle ListView

# ==========================================
# 3. 界面美化与颜色自定义（可根据喜好修改）
# ------------------------------------------
# 设置提示列表的颜色（命令为黄色，数字为品红）
Set-PSReadLineOption -Colors @{
    Command = 'Yellow'
    Number = 'Magenta'
}

# （可选）Windows 剪贴板习惯：Ctrl + C 复制，Ctrl + V 粘贴
Set-PSReadLineKeyHandler -Key "Ctrl+v" -Function Paste
Set-PSReadLineKeyHandler -Key "Ctrl+c" -Function Copy

2. （可选）自定义提示符（显示时间与当前路径）

function prompt {
    $date = Get-Date -Format 'HH:mm:ss'
    Write-Host "[$date] " -NoNewline -ForegroundColor Gray
    Write-Host "$(Get-Location) " -NoNewline -ForegroundColor Cyan
    return "> "
}

3. 常用别名和快捷方式

1
2

Set-Alias cls Clear-Host
function cdws { Set-Location "C:\你的常用工作目录" }

4. （可选）显示文件夹 Icons

在 PowerShell 中输入以下代码。

第一行代码，从官方信任源下载并安装 Terminal-Icons 模块：

1
2

Install-Module -Name Terminal-Icons -Repository PSGallery -Force -Scope AllUsers
Set-ExecutionPolicy RemoteSigned -Force

然后将以下代码粘贴到 $PROFILE 文件的最底部：

1
2

# 自动导入终端图标模块
Import-Module -Name Terminal-Icons

5. （可选）集成 Oh My Posh 主题

需提前安装模块。以下代码仅供参考，详见教程 —— 使用 Oh My Posh 为 PowerShell 或 WSL 设置自定义提示符

1
2

# Oh-My-Posh 配置示例
oh-my-posh init pwsh --config "$HOME\AppData\Local\Programs\oh-my-posh\themes\jandedobbeleer.omp.json" | Invoke-Expression

6. 配置生效

编辑完成后保存关闭记事本，输入 . $PROFILE 立刻应用修改。

7. 开启脚本权限（如遇报错）

如果提示无法加载文件，需要以管理员身份运行 PowerShell，并执行策略：

`1`	`Set-ExecutionPolicy RemoteSigned`

拓展

[!TIP]

这里博主安装了新的 Notepad.exe，但是 PowerShell 中输入 notepad 命令依旧使用的是旧的 notepad.exe。

要解决这个问题，需要先"挪走"原有的旧版记事本。但由于它是系统核心文件，直接删除或改名会被系统拒绝。

按照以下两步操作，先解锁权限并改名，然后再创建链接。

#  1. 将旧记事本的所有者修改为当前管理员组
takeown /f "C:\Windows\system32\notepad.exe" /a

#  2. 赋予管理员组对该文件的完全控制权限
icacls "C:\Windows\system32\notepad.exe" /grant administrators:F

#  3. 将旧记事本重命名为备份文件（腾出位置）
Rename-Item -Path "C:\Windows\system32\notepad.exe" -NewName "notepad.exe.bak"

1
2

# 第二个路径可替换为你使用的其他记事本软件路径（如 Notepad3 等）
New-Item -ItemType SymbolicLink -Path "C:\Windows\system32\notepad.exe" -Target "C:\Program Files\WindowsApps\Microsoft.WindowsNotepad_11.2604.5.0_x64__8wekyb3d8bbwe\Notepad\Notepad.exe"

参考文章

使用 Oh My Posh 为 PowerShell 或 WSL 设置自定义提示符 - Microsoft Learn

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

APP抓包之 Burpsuite+MuMu模拟器12抓包

Tue, 19 Nov 2024 12:32:00 +0800

环境准备

调试工具

ADB 是 Android SDK 中的一个工具，可以直接操作管理 Android 模拟器或者真实的 Android 设备。

OpenSSL是一个功能丰富且开源的安全工具箱。

检查 adb

检查 OpenSSL

下载证书

访问你的IP+端口即ip:8088导出CA证书，点击右上角下载

进行调试

重命名证书

在保存ca证书的文件夹右键打开终端或者箭头导航栏输入cmd，并输入以下命令：

`1`	`openssl x509 -subject_hash_old -in {证书全名带后缀}`

生成一串字符串，复制红框保存下来，并把证书名字改为这个，后缀改为0，如下所示：

配置MuMu模拟器

打开磁盘可写以及Root权限，重启模拟器

找到 adb 调试端口

使用 adb 连接模拟器

adb devices：查看当前连接的设备，已连接的设备会显示出来
adb connect：连接adb调试端口
adb push <本地路径\文件或文件夹> <手机端路径>：把本地(pc机)的文件或文件夹复制到设备(手机)
adb shell：登录设备 shell，该命令将登录设备的shell（内核），登录shell后，可以使用 cd，ls，rm 等Linux命令
su：提升为root权限（linux命令）

使用cd /sdcard/;ls命令，查看刚刚上传的

将该文件移动到/system/etc/security/cacerts/目录下

进入/system/etc/security/cacerts/目录，查看文件是否移动成功；并进行赋权和更改用户组。

重新启动MuMu模拟器，配置网络代理，访问浏览器

尝试抓包

证书安装完成，此时抓包不再显示证书无效

附录

参考文献

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

GNS3懒人版-2.2.45安装部署详细教程

Tue, 12 Nov 2024 23:01:09 +0800

前言

【GNS3懒人版-2.2.45】—— by 熄灭的蜡烛

【GNS3懒人版入门视频教程】—— by 熄灭的蜡烛

感谢大佬的辛勤创作和无私分享！🫶

镜像集成列表

镜像
Cisco	1: Cisco IOL Router 15.7(3)M2 2: Cisco IOL Switch 15.2(CML_NIGHTLY_20180510) 3: Cisco IOL Switch 15.2(CML_NIGHTLY_20190423) 4: Cisco IOSv 15.9(3)M6 5: Cisco IOSvL2 15.2(20200924:215240)
H3C	6: H3C vAC1000 7.1.064 R5466P01 7: H3C vFW1000 7.1.064 E1190P02 8: H3C vSR1000 7.1.064 R1362P12
HillStone	9: HillStone SG6000 CloudEdge 5.5R10P4 v6
FortiGate	10: FortiGate 7.0.13
HuaWei	11: HuaWei AR1kv V300R021C00SPC100T 12: HuaWei CE6800 V200R005C10SPC607B607 13: HuaWei CE12800 V200R005C10SPC607B607 14: HuaWei NE40E V800R011C00SPC607B607 15: HuaWei USG6000V2 V500R005C00SPC100
Ruijie	16: Ruijie RG NSE router v1.06 17: Ruijie RG NSE switch v1.06 18: Ruijie RG NSE firewall v1.03
Juniper	19: Juniper vMX vCP 23.2R1-S1.6 20: Juniper vMX vFP 23.2R1-S1.6-KVM
Windows	21: Windows XP Pro SP3 x86 22: Windows Server 2022 DC x64 23: Windows 10 22H2 Pro for Workstation x64 24: Windows 11 23H2 Pro for Workstation x64
Ubuntu	25: Ubuntu Docker Guest 26: Ubuntu 22.04 Desktop amd64 27: Ubuntu Cloud 20.04 Server 28: Ubuntu Cloud 22.04 Server
RHEL	29: RHEL 7.9 update 12 30: RHEL 8.8 31: RHEL 9.3

关于镜像密码的查看

在左侧设备列表里面双击你想要查看密码的那个，然后在打开的窗口里面点击最右边的选项卡里面查看。

资源链接

百度网盘
链接: https://pan.baidu.com/s/19aqOB7iBvXN9olJDZKwkjg?pwd=qpk3

123云盘
链接: https://www.123pan.com/s/QCF9-8yWTd.html
提取码：DrnB

OneDrive商业版
链接：https://xmdlz-my.sharepoint.com/:f:/p/xmdlz_vip/Es7y5_IPGR9PuhMXZoYKT-gBbDXt7Yo_voEEYFCBznCutw?e=Sw1YQ8
密码：TjptvEgWRyZidYgjCZw0

文件信息

文件名：GNS3.VM.VMware.Workstation.2.2.45.ova 大小：57572920832字节 MD5: 20c6aa8778ef84c08b5f9857469ac896 SHA1: a67e4a41acdec8802307dfa0490c5a1adf447db2 SHA256: 70bb6c738570ca6db011c003938cd8cde6ccf8ad11a48493c587234218307c2e

使用VMware导入GNS3 VM

下载GNS3懒人版

这里我使用的是作者提供的百度网盘中的链接

导入`GNS3 VM`

前提是得装好VMwate Workstation Pro，直接双击打开GNS3.VM.VMware.Workstation.2.2.45.ova

打开GNS3 VM

如果虚拟机正常开启并获取到IP，请保持打开状态继续下一步操作。

⚠️这里可能存在导入成功后，打开GNS3 VM获取不到IP地址。可能是VMware DHCP Service服务没有打开

安装`GNS3-2.2.45-all-in-one.exe`

准备工作

双击安装

无特殊需求，即可按照默认配置依序安装。

安装完成后打开GNS3

虚拟机GNS3 VM与GNS3版本必须保持一致，此教程使用GNS3-2.2.45

根据Setup Wizard提示，选择第三个，点击下一步

将虚拟机中获取的IP地址和端口号，依次输入。并取消Enable authentication的勾选。

稍等一会就会出现这个，点击下面的Finish就完成了

再次感谢“熄灭的蜡烛”大大的制作与分享，让我们用上集成般的GNS3！👏

附录

参考文献

《GNS3懒人版-2.2.45》

《GNS3懒人版入门视频教程》

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

【HCIA 路由与交换 Wakin 谢Sir】TCP/IP网络模型

Mon, 11 Nov 2024 22:05:23 +0800

TCP/IP网络模型

TCP/IP模型是互联网的基础，它是一系列网络协议的总称。这些协议可以划分为四层，分别为链路层、网络层、传输层和应用层。

链路层：负责封装和解封装IP报文，发送和接受ARP/RARP报文等。

网络层：负责路由以及把分组报文发送给目标网络或主机。

传输层：负责对报文进行分组和重组，并以TCP或UDP协议格式封装报文。

应用层：负责向用户提供应用程序，比如HTTP、FTP、Telnet、DNS、SMTP等。

在网络体系结构中网络通信的建立必须是在通信双方的对等层进行，不能交错。在整个数据传输过程中，数据在发送端时经过各层时都要附加上相应层的协议头和协议尾（仅数据链路层需要封装协议尾）部分，也就是要对数据进行协议封装，以标识对应层所用的通信协议。

TCP/IP模型		OSI模型
应	为应用程序提供网络服务	应用层
用	数据格式化，加密、解密	表示层
层	建立、维护、管理会话连接	会话层
传输层	建立、维护、管理端到端连接	传输层
网络层	IP寻址和路由选择	网络层
数据链路层	控制网络层与物理层之间的通信	数据链路层
物理层	比特流传输	物理层

应用层（Data 数据）

应用层：Application Layer 为应用软件提供接口，使应用程序能够使用网络服务。

应用层协议指定相应的传输层协议，以及传输层所使用的端口等

DNS

Domain Name System，域名解析系统 Port：53（TCP & UDP）

1
2
3

nslookup    #DNS调试工具
ipconfig /displaydns    #查看DNS缓存
ipconfig /flushdns    #清空DNS缓存

HTTP & HTTPS

Hypertext Transfer Protocol(Secure)，超文本传输（安全）协议 HTTP Port：80（TCP） HTTPS Port：443（TCP,SSL）

Telnet & SSH

远程管理服务 Telnet Port：23（TCP） SSH Port：22（TCP）

FTP & TFTP

File Transfer Protocol，文件传输协议；
FTP Port：20（FTP-Data，TCP）21（FTP-Control，TCP）

Trivial File Transfer Protoco，简单传输协议
TFTP Port：69（UDP）

传输层（Segment 段）

建立“端到端”（Port to Port）的连接。

Port

端口号，区分不同的网络服务（应用层协议）

【服务名称和传输协议端口号注册表】

TCP & UDP

TCP

UDP

网络层（Packet 包）

建立“点到点”（End to End）的连接

提供了无连接数据传输服务，即在发送数据报文时不需要先建立连接，每一个IP数据报文独立发送。

IP

IPv4报文结构

TTL

Protocol

IP地址及子网划分

IP地址结构

IP地址分类

网络地址、主机地址、广播地址

子网划分

快=块（Block）=2^主机位数 =256-掩码

IP地址规划

ICMP

ICMP报文结构

情况	说明
超时	对方主机不在线、屏蔽、网络拥塞等
传输失败	地址无效、主机本身没有路由
无法访问	无法访问目标网、中转设备没有路由、没有获取MAC地址

数据链路层（Frame 帧）

以太网

Ethernet：当今主导地位的“局域网组网技术”

以太网帧结构

MAC地址

ARP协议

‘

附录

参考文献

《Wakin 谢Sir 最新数通精品课程_哔哩哔哩_bilibili》

《TCP/IP网络模型 · GitBook (tonydeng.github.io)》

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

【HCIA 路由与交换 Wakin 谢Sir】数通网络基础

Mon, 11 Nov 2024 21:06:03 +0800

数通基础

什么是网络？

网络的本质就是实现资源共享 将各个系统连接到一起，形成信息传递、接收、共享的信息交互平台

万物互联

人与人、人与物、物与物的互联本质是数据的联结与计算

数通是连结万物的“管道”

数通网络介绍

Data Communication Network

一个典型的数通网络通常由路由器、交换机、防火墙、无线控制器、无线接入点、个人电脑、网络打印机、服务器等设备构成的通信网络，最基本的功能就是实现数据互通。而网络拓扑图就是呈现一个数通网路的结构化布局。

信息的传递

带宽：bandwidth

描述在单位时间内传输的数量单位：bps（bit per second，比特每秒）

延迟：delay

描述数据传输所经历的时间单位：ms（毫秒）

网络基础

网络模型

OSI模型	作用	TCP/IP模型
应用层	为应用程序提供网络服务	应
表示层	数据格式化，加密、解密	用
会话层	建立、维护、管理会话连接	层
传输层	建立、维护、管理端到端连接	传输层
网络层	IP寻址和路由选择	网络层
数据链路层	控制网络层与物理层之间的通信	数据链路层
物理层	比特流传输	物理层

网络基础架构

封装和解封装

encapsulation & de-encapsulation

数据发送时，逐层向下，添加相关头部或尾部的过程，称为封装（打包）

数据接收时，逐层向上，拆除相关头部或尾部的过程，称为解封装（拆包）

OSI把每一层数据称为PDU（Protocol Data Unit，协议数据单元）
TCP/IP根据不同层分别使用：数据（Data）、段（Segment）、包（Packet）、帧（Frame）、位（bit）

Protocol：协议

在通信领域中，协议就是用来决定数据的格式和传输的一些规则

网络通信中的“语言”

【华为官网公布的协议地图】

附录

参考文献

《Wakin 谢Sir 最新数通精品课程_哔哩哔哩_bilibili》

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

VS Code 配置 C & C++ 编程运行环境

Sat, 09 Nov 2024 20:27:17 +0800

准备工作

下载 VS Code 安装包

官方下载链接：【Visual Studio Code - Code Editing. Redefined】

下载 Msys2

Github下载链接：【msys2-installer】

安装软件

`VSCodeUserSetup-x64.exe`

双击运行VSCodeUserSetup-x64-1.94.0.exe运行安装程序

`msys2-x86_64.exe`

双击msys2-x86_64-20240727.exe运行安装程序

当按下完成之后，会弹出打开一个 MSYS2 终端窗口。

在此终端中，通过输入以下命令并按回车键，安装 MinGW-w64 工具链：

`1`	`pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain`

出现这个界面，直接按回车键，默认接受所有的安装包。

当系统提示是否继续安装时，请输入y并回车。

当所有的包都安装好后，直接关闭终端。打开安装 MSYS2 的目录，先找到ucrt64文件夹并进入，再找到bin文件夹并进入，然后在地址栏中，复制路径。如果一开始用默认路径，那路径就是C:\msys64\ucrt64\bin。

然后在搜索框中输入 编辑系统环境变量，并打开编辑系统环境变量的设置界面。

在系统属性的弹窗中，点击环境变量。

在弹出的环境变量弹窗中，找到用户变量的Path，并双击打开。

此时会弹出编辑环境变量的窗口，先点击新建按钮，然后会在空白行中出现一个输入框和一个闪烁的光标，在这里粘贴上刚刚复制的路径，最后点击确定按钮回到上层弹窗。

最后，依次点击右下角确定退出。最后做一下测试，按组合键Win + r之后，输入cmd回车。

1
2
3

gcc --version
g++ --version
gdb --version

安装VS Code 扩展

汉化扩展包（可选）

C/C++ 环境扩展包

测试 VS Code 的 C/C++ 编程环境

创建代码文件夹

VS Code 是一款基于文件夹进行代码编辑和管理的编辑器，通常我们会把新建一个文件夹来管理同一个项目的代码，并在 VS Code 中打开。

单个 .c 文件的运行和调试

为了方便管理代码，我们先选中C文件夹，再点击新建文件夹按钮。

此时会在C文件夹的下级出现一个输入框，我们新建一个名为test的文件夹。

鼠标右键test文件夹，在弹出的菜单中选择新建文件。在输入框中输入我们接下来要进行调试代码文件名，命名为test.c，注意，一定要是 .c 结尾。

接下来就可以输入一个调试程序了，我的代码如下：

#include <stdio.h>
 
int main()
{
    for (int i = 0; i < 5; i++)
        printf("Hello Ranch~%d\n", i);

    return 0;
}

写好测试代码后，点击右上角的调试按钮，这时会弹出调试程序的选项，选择第一个，也是本教程前面安装的 gcc 编译工具。

如果要进行简单的断点调试，可以在行号前加一个断点，操作也很简单，只需用鼠标左键点一下行号左边的空白处即可。如下图所示，是在第六行处加了一个断点。

这时再去运行程序，搜索框下面就会出现调试的面板，面板上有六个按钮，分别是继续、逐过程、单步调试、单步跳出、重启和停止。

[!IMPORTANT]

以下是 VS Code 中的 C 语言代码调试面板功能的解释：

继续（Continue）：继续执行程序，直到遇到下一个断点或程序结束。

逐过程（Step Over）：逐行执行当前行，如果当前行是函数调用，则进入该函数并执行完毕。

单步调试（Step Into）：逐行执行当前行，如果当前行是函数调用，则进入该函数并停在函数内的第一行。

单步跳出（Step Out）：执行完当前函数的剩余部分，并停在当前函数被调用的下一行。

重启（Restart）：重新启动程序的调试会话，即从程序的起点开始执行。

停止（Stop）：停止程序的调试会话，结束调试过程并关闭程序执行。

多个 .c 文件的运行与测试

如果想要进行多个 .c 文件编译后的调试，就需要进行一些配置修改。如果进行过一次编译运行，我们会发现在资源管理器的C文件夹下，多出一个.vscode的文件夹，这个文件夹里面有个tasks.json的文件

这个文件是用于定义任务配置，这些任务可以在 VS Code 中运行，例如编译代码、运行测试、启动调试器等。

tasks.json文件是一个 JSON 格式的文件，其中包含了任务的配置信息，包括任务名称、命令、参数等。通过编辑tasks.json文件，我们可以自定义项目中的各种任务，并在 VS Code 中方便地执行这些任务。

当前的 VS Code 的运行效果还不是很理想，双击打开tasks.json文件修改一下编译运行功能。下图是对该 JSON 文件做了部分解释。

具体修改如下图所示，我注释掉了原来的${file}，并新增一行*.c，表示并非指定某一个 .c 文件，而是当前文件夹下所有的.c文件。

同时也把${fileDirname}\\${fileBasenameNoExtension}.exe注释掉，改成${fileDirname}\\program.exe，那么多个 .c 文件编译之后的可执行文件就是program.exe。

然后点击左侧的运行与调试，再点击创建launch.json文件。

然后 VS Code 会新建一个 JSON 文件，点击右下角的添加配置，在弹出的下拉菜单中选择C/C++：（gdb）启动。

修改为下图红框所示内容，“program”后的内容就是前面提到的tasks.json文件中的编译后产生的可执行文件。"miDebuggerPath"后面的则是前面安装的 MinGW-W64 的 gdb 工具的路径。修改后保持关闭。

附录

参考文献

《VS Code 配置 C/C++ 编程运行环境（保姆级教程）》

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

【转载】Windows 下包管理器 Scoop 的安装与使用

Sat, 09 Nov 2024 20:12:54 +0800

转载自《Windows 下包管理器 Scoop 的安装与使用 - Muxiner’s Blog》

🍉 什么是 Scoop ？

😶‍🌫️ 可以去看【Scoop Github 上的介绍】。

😶‍🌫️ 还有官方文档【Scoop Wiki】w

😶‍🌫️ 官网【https://scoop.sh/】

Scoop 是 Windows 上的命令行安装工具。

🙈 可以用来干嘛？

🦥 通过命令行界面，Scoop 可以顺畅地安装应用程序。（官方说明）

🌲 没有权限弹出窗口
🌲 隐藏 GUI 向导式安装程序
🌲 防止因而安装大量程序造成 PATH 污染
🌲 避免安装和卸载程序的不当使用
🌲 自动查找并安装依赖项
🌲 自动执行所有额外的设置步骤来获取工作程序

🍉 安装 Scoop

🍊 准备工作

PowerShell ：确保已安装 PowerShell 5.0 或更高版本。

Windows 10 以及更高的版本默认安装的 PowerShell 5.0。
确保以允许 Powershell 执行本地脚本。
1

set-executionpolicy remotesigned -scope currentuser
Unrestricted 也可以，但是安全性较低。

最好使用 RemoteSigned。

🍑 安装在默认位置

默认安装在 C:\Users\username\scoop 路径下。

执行命令：

`1`	`Invoke-Expression (New-Object System.Net.WebClient).DownloadString('https://get.scoop.sh')`

或是执行（更短的）：

`1`	`iwr -useb get.scoop.sh \| iex`

2022.11.17 更新：

为加快 Scoop 的安装速度，主要是下载速度，使用代理进行加速下载。

fastgit 下载

下载 scoop_install.ps1：

`1`	`curl -o scoop_install.ps1 https://raw.fastgit.org/scoopinstaller/install/master/install.ps1`

修改 scoop_install.ps1 中文件下载地址：

`1`	`(Get-Content scoop_install.ps1).replace('https://github.com/ScoopInstaller/', 'https://download.fastgit.org//ScoopInstaller/') \| Set-Content scoop_install.ps1`

安装 Scoop：./scoop_install.ps1
删除 scoop_install.ps1：rm scoop_install.ps1

github proxy 下载

下载 scoop_install.ps1：

`1`	`curl -o scoop_install.ps1 https://ghproxy.com/https://raw.githubusercontent.com/scoopinstaller/install/master/install.ps1`

修改 scoop_install.ps1 中文件下载地址：

`1`	`(Get-Content scoop_install.ps1).replace('https://github.com/ScoopInstaller/', 'https://ghproxy.com/https://github.com/ScoopInstaller/') \| Set-Content scoop_install.ps1`

安装 Scoop：./scoop_install.ps1
删除 scoop_install.ps1：rm scoop_install.ps1

🍑 自定义安装目录

例如将 Scoop 安装在 C:\Scoop 路径下。

需要添加该路径到用户变量中：

`1`	`$env:SCOOP='C:\scoop'`

`1`	`[environment]::setEnvironmentVariable('SCOOP',$env:SCOOP,'User')`

当然也可以添加到系统变量中：

不过此时需要以管理员身份运行 PowerShell ，或是以管理员身份运行 Windows Terminal，再打开 PowerShell ，否则会报错：
1
[environment]::setEnvironmentVariable('SCOOP',$env:SCOOP,'Machine')

添加完环境变量后需要重启 PowerShell 或 Terminal 等待变量生效。

然后再执行安装指令：

`1`	`iwr -useb get.scoop.sh \| iex`

安装方式同上，点此跳转到新的安装方式

🍑 自定义全局应用安装目录

例如自定义将全局应用安装在 C:\apps 路径下：

就需要将该目录添加到系统变量中，步骤同上文相同：

😶‍🌫️ 以管理员身份运行
😶‍🌫️ $env:SCOOP_GLOBAL='C:\apps'
😶‍🌫️ [environment]::setEnvironmentVariable('SCOOP_GLOBAL',$env:SCOOP_GLOBAL,'Machine')
😶‍🌫️ 安装指令：scoop install -g <app>

合起来就是：

1
2
3

$env:SCOOP_GLOBAL='C:\apps'
[environment]::setEnvironmentVariable('SCOOP_GLOBAL',$env:SCOOP_GLOBAL,'Machine')
scoop install -g <app>

🍉 使用 Scoop

查看 scoop 的命令：

`1`	`scoop help`

查看命令的详细信息：

1
2
3

scoop help <command>
# for example: scoop help install 
# For more detailed information on INSTALL

执行 scoop help install ：

Usage: scoop install <app> [options]

e.g. The usual way to install an app (uses your local 'buckets'):
     scoop install git

To install an app from a manifest at a URL:
     scoop install https://raw.githubusercontent.com/ScoopInstaller/Main/master/bucket/runat.json

To install an app from a manifest on your computer
     scoop install \path\to\app.json

Options:
  -g, --global              Install the app globally
  -i, --independent         Don't install dependencies automatically
  -k, --no-cache            Don't use the download cache
  -u, --no-update-scoop     Don't update Scoop before installing if it's outdated
  -s, --skip                Skip hash validation (use with caution!)
  -a, --arch <32bit|64bit>  Use the specified architecture, if the app supports it

🍒 安装应用

分为两种情况：

😃为当前用户安装

安装路径：scoop\apps

scoop 路径默认在 C:\User\username 。

若是自定义安装路径，例如上文的位置，则在 C:\Scoop

安装命令：

1
2
3

scoop install <app>
# for example:
# scoop install nano

😃为所有用户安装

默认的安装路径：C:\ProgramData\scoop

若是如上文所示，自定义了全局应用安装目录，则安装路径：C:\apps

需要以管理员身份运行。

安装命令：

1
2
3

scoop install <app> -g
# for example:
# scoop install nano -g

🍒 卸载应用

😃卸载某一程序

`1`	`scoop uninstall <app>`

😃卸载程序并移除配置文件

`1`	`scoop uninstall <app> -p`

😃卸载全局程序

`1`	`scoop uninstall <app> -g`

😃更多信息

`1`	`scoop help uninstall`

🍒 更新

😃更新 scoop 及所有 bucket 但不更新 app

`1`	`scoop update`

😃更新某一 app

`1`	`scoop update <app>`

😃更新 scoop、bucket、app

`1`	`scoop update *`

😃更新全局 app

`1`	`scoop update <app> -g`

😃更多信息

`1`	`scoop help update`

🍒 其他有用操作

😃查看已安装 app

`1`	`scoop list`

😃查看可更新 app

`1`	`scoop status`

😃查看某 app 主页

`1`	`scoop home <app>`

😃查看「已知库」

`1`	`scoop bucket known`

😃添加「已知库」

`1`	`scoop bucket add <bucket>`

😃查看已添加的库

`1`	`scoop bucket list`

😃删除已添加的库

`1`	`scoop bucket rm <bucket>`

😃添加第三方库

`1`	`scoop bucket add <bucket> <bucket_url>`

😃删除已安装软件的旧版本

`1`	`scoop cleanup *`

😃清理软件缓存

通常是下载的软件安装包。

以下命令清除所有缓存，即清空 Scoop 目录下的 cache 文件夹。

`1`	`scoop cache rm *`

🍉 进阶

更多信息请查看【官方文档】。

附录

参考文献

转载自《Windows 下包管理器 Scoop 的安装与使用 - Muxiner’s Blog》

版权信息

本文原载于 Muxiner’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

掌握 Docker魔法：Windows 11 平台上的完美容器部署终极指南

Fri, 08 Nov 2024 21:43:41 +0800

前言

什么是 Docker ？

容器工作的原理

容器的架构

Docker包括三个基本概念：

镜像（Image）：Docker 镜像（Image），就相当于是一个 root 文件系统。比如官方镜像 ubuntu:16.04 就包含了完整的一套 Ubuntu16.04 最小系统的 root 文件系统。
容器（Container）：镜像（Image）和容器（Container）的关系，就像是面向对象程序设计中的类和实例一样，镜像是静态的定义，容器是镜像运行时的实体。容器可以被创建、启动、停止、删除、暂停等。
仓库（Repository）：仓库可看成一个代码控制中心，用来保存镜像。

Docker 的优势

为何使用 Docker ？

Docker 支持开发人员使用简单的命令访问这些本机容器化功能，并通过节省工作量的应用程序编程接口 (API) 自动执行。与 LXC 相比，Docker 提供了以下功能：

增强的无缝容器可移植性：虽然 LXC 容器通常引用特定于机器的配置，但 Docker 容器无需修改即可在任何桌面、数据中心和云环境中运行。
更轻巧且更细粒度的更新：通过使用 LXC，可以在单个容器中组合多个进程。这样就可以构建持续运行的应用，即使为了更新或修复而关闭某个部分也不例外。
自动化容器创建：Docker 可以基于应用源代码自动构建容器。
容器版本控制：Docker 可以跟踪容器映像的版本，回滚到先前的版本，以及跟踪版本的构建者和构建方式。它甚至可以只上传现有版本和新版本之间的增量。
容器复用：现有容器可用作基本映像（本质上类似于用于构建新容器的模板）。
共享容器库：开发人员可以访问包含数千个用户贡献容器的开源注册表。

在初步认识了解了Docker后，下面正式进入Docker安装环节！

安装

进入Docker官网

首先先到Docker官网下载最新官方Docker for Windows链接：【下载Docker】

启动 Microsoft Hyper-V

在电脑上打开“控制面板”->“程序”-> “启动或关闭Windows功能”。

勾选Hyper-V功能

并勾选以下功能

重启后安装Docker

双击安装 docker

默认配置

等待安装结束

安装完毕后，点击Close and log out

电脑重启后，点击Docker程序

现在程序就正常启动啦

加速

配置aliyun镜像加速

如果pull操作比较慢，接下来需要配置一下镜像代理，便于更快速的拉取资源！
登录aliyun官网：《镜像加速器》

使用

查看

`1`	`docker --versionn`

获取镜像

`1`	`docker pull xxx`

查看镜像

`1`	`docer images`

删除镜像

# 删除指定的镜像
docker rmi xxx.image

# 清理本地的Docker镜像
docker image prune -f

启动容器

以下命令使用xxx镜像启动一个容器，参数为以命令模式进入该容器：

`1`	`docker run -it xxx /bin/bash`

也可以：

`1`	`docker run -it -rm --entrypoint /bin/bash 镜像名`

所以，更常用的是这种后台启动的方式:

`1`	`docker run -itd xxx /bin/bash`

交互容器

运行容器后正常启动状态，使用如下命令：

# 先在后台启动
docker run -itd --entrypoint /bin/bash reqpython 

# 查看刚才run的容器名 如：test 
docker ps 

# 再进入容器内部
docker exec -it test /bin/bash

只是做测试用，测试完后，不想保留容器，使用如下命令：

`1`	`docker run -it --rm --entrypoint /bin/bash 镜像名`

删除容器

# 删除单个
docker rm -f <容器ID>

# 批量删除
docker rm -f <容器ID>1 <容器ID>2 <容器ID>……

查看容器

`1`	`docker ps -a`

容器的暂停与恢复

# 暂停容器的运行，但是容器并没有运行
docker pause <容器ID>

# 恢复容器的暂停
docker unpause <容器ID>

容器的停止与重启

# 使用此命令会停止容器的运行,如果想不停止运行，可以使用暂停的命令。
docker stop <容器ID>

# 重启容器
docker restart <容器ID>

进入容器

先查看容器的名字

`1`	`docker ps -a`

再使用如下命令进入容器

`1`	`docker exec -it 容器的名字 /bin/bash`

更新容器

查看端口情况

查看端口开发情况

`1`	`netstat -nlpt`

查看端口占用情况

# 查看所有
ps aux

# 查看指定服务
ps aux | grep docker

查看端口映射

`1`	`docker port <容器ID>`

查看进程号（PID）

先查找容器ID

`1`	`docker ps -a`

传入<容器ID>查找PID

docker inspect -f '{{.State.Pid}}' <容器ID>

docker container top <容器ID>

ps aux | grep <容器ID>

获取容器内部正在运行的任务的占用内存资源情况

`1`	`docker stats --no-stream <容器ID>`

复制本地文件到容器内

`1`	`docker cp 本地文件路径 <容器ID>/<容器名>:容器内部存放文件位置`

打包容器为镜像

`1`	`docker commit <容器ID> <打包后的镜像名>:<版本号>`

附录

参考文献

《【Docker】掌握 Docker魔法：Windows 11 平台上的完美容器部署终极指南》

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

超详细的wsl2教程：windows上的linux子系统

Sat, 02 Nov 2024 21:54:21 +0800

前置条件

CPU 虚拟化

修改BIOS设置（VMX/AMD-v）

windows 功能

适用于Linux的windows子系统
虚拟机平台

安装

默认 ubuntu 发行版

管理员权限打开 cmd

`1`	`wsl --install kali-linux --web-download`

查看在线发行版

`1`	`wsl --list --online`

查看安装的子系统

`1`	`wsl --list -v`

如果 windows下 sublinux 安装出现“不能访问网络位置+有关网络排除故障的信息”

netsh winsock reset
netsh int ip reset all
netsh winhttp reset proxy
ipconfig /flushdns

使用

切换默认子系统

`1`	`wsl --set-default xxx`

启动指定的子系统

`1`	`wsl -d kali-linux`

卸载

`1`	`wsl --unregister kali-linux`

备份

# 导出
wsl --export kali-linux kali.tar

# 导入
wsl --import kali2 D:/wsl C:\Users\admin\Desktop

kali 打开桌面窗口

wsl2 黑科技

WSLg

允许 Linux 里面带有UI的应用程序，直接以 Windows 窗口的形式打开

显卡直通

1
2

# 查看显卡
nvidia-smi

镜像网络模式

在 C:\Users\xxx 下面创建 .wslconfig 文件

1
2

[wsl2]
networkingMode = mirrored

然后保存，使用 wsl --shutdown 关闭虚拟机，等 8 秒。

kali 安装 Win-Kex

参考官方文档：【Win-Kex为Kali Linux提供GUI桌面体验】

win-kex支持以下三种模式

窗口模式

要在支持声音的 Window 模式下启动 Win-KeX，请运行以下任一命令：

Kali WSL 内部：kex --win -s
在 Windows 的命令提示符上：wsl -d kali-linux kex --win -s

有关更多信息，请参阅【 Win-KeX 窗口模式使用文档】。

增强的会话模式

要在具有声音支持和 ARM 解决方法的增强会话模式下启动 Win-KeX

请运行以下任一命令：

Kali WSL 内部：kex --esm --ip -s
在 Windows 的命令提示符上：wsl -d kali-linux kex --esm --ip -s

有关更多信息，请参阅【 Win-KeX 增强型会话模式使用文档】。

无缝模式

使用无缝模式（win-kex SL），请在WSL设置里，将网络模式更改为NAT

进入kali系统，修改/etc/resolv.conf文件里的nameserver，其IP地址与windows中vEthernet (WSL (Hyper-V firewall))IP地址一致。

要在具有声音支持的无缝模式下启动 Win-KeX，请运行，运行以下任一：

Kali WSL 内部：kex --sl -s
在 Windows 的命令提示符上：wsl -d kali-linux kex --sl -s

有关更多信息，请参阅【 Win-KeX SL 使用文档】。

附录

参考文献

《WSL2 + linux配置流程超详细指南 | mednight4》

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

Win11使用JEnv管理多版本jdk

Tue, 22 Oct 2024 19:37:09 +0800

JEnv 介绍

【JEnv-for-Windows】是一个专为Windows系统设计的开源工具，由FelixSelter开发，其核心功能是让开发者能够轻松地在不同版本的Java开发工具包（JDK）之间进行切换。

关键技术和框架

批处理脚本：用于创建快捷的Java版本切换逻辑；
PowerShell脚本：用于环境变量的动态管理，兼容性增强，以及更高级的操作；
无需额外依赖：直接通过环境变量和脚本操作来实现JDK版本的管理。

这是如何运作的呢？

准备工作和详细安装步骤

步骤一：下载JDK并配置

安装 JDK

jdk-1.8

正常一步一步安装【jdk-8u421-windows-x64.exe】

jdk-xxx

将其他版本jdk的.zip压缩包解压到对应文件夹

配置环境变量

①新建系统变量JAVA_HOME，路径为jdk8路径

②新建系统变量CLASSPATH，指定类搜索路径

③系统变量Path中添加对应路径

步骤二：JEnv-for-Windows项目获取

从GitHub克隆该仓库到本地对应文件夹

`1`	`git clone https://github.com/FelixSelter/JEnv-for-Windows.git`

步骤三：JEnv环境准备

删除旧的JAVA_HOME

添加JEnv到系统路径

将刚克隆的项目路径添加到系统的环境变量Path中，确保可以从任何地方调用jenv.bat脚本。

步骤四：初始化与配置

首次运行JEnv

`1`	`jenv -help`

添加JAVA环境

接下来，将其他版本jdk添加到JEnv管理中

1
2

jenv add jkd8 C:\Environment\Java\jdk-1.8
jenv add jdk17 C:\Environment\Java\jdk-17.0.12

步骤五：验证

列出jenv管理的所有jdk版本：

`1`	`jenv list`

用命令切换jdk版本：

`1`	`jenv use {name}`

日常操作及使用方法

添加新的Java环境（需要绝对路径）
jenv add<name> <path>
示例：jenv add jdk15 D:\Programme\Java\jdk-15.0.1
更改当前会话的 java 版本
jenv use<name>
示例：jenv use jdk15
脚本编写的环境变量：
—PowerShell: $ENV:JENVUSE="jdk17"
—CMD/BATCH:set "JENVUSE=jdk17"
清除当前会话的 java 版本
jenv use remove
示例：jenv use remove
用于脚本编写的环境变量：
—PowerShell: $ENV:JENVUSE=$null
—CMD/BATCH:set "JENVUSE="
全局更改您的 java 版本
jenv change<name>
示例：jenv change jdk15
始终在此文件夹
jenv local<name>
中使用此 java 版本示例：jenv local jdk15
清除此文件夹的 java 版本
jenv local remove
示例：jenv local remove
列出所有 Java 环境
jenv list
示例：jenv list
从 JEnv 列表中删除现有的 JDK
jenv remove<name>
示例：jenv remove jdk15
允许使用位于 java 目录
jenv link<Executable name>
中的 javac、javaw 或其他可执行文件示例：jenv link javac
卸载 jenv 并自动恢复您选择的 Java 版本
jenv uninstall<name>
示例：jenv uninstall jdk17
自动搜索要添加的 java 版本
jenv autoscan [–yes|-y]?<path>?
示例：jenv autoscan "C:\Program Files\Java"
示例：jenv autoscan// 将搜索整个系统示例：jenv autoscan -y "C:\Program Files\Java"// 将接受默认值

附录

参考文献

JEnv-for-Windows 安装与配置完全指南

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

【博客装修日记】Hugo➕ Stack ➕ Giscus魔改美化细节满满

Sun, 20 Oct 2024 11:55:35 +0000

[!TIP]

避免踩坑的建议：

凡是需要更改的文件都从themes/主题复制到主目录（hugo new site xxx创建的那个）下

接下来的个性化配置文件建议都在博客主目录下操作，减少更新主题时个性化配置被覆盖的麻烦

每次服务启动，会同步更新所有位置配置文件，但主目录配置文件优先级最高

导入主题

安装主题一般而言存在三种方式：

git submodule 安装
go module 安装（需要安装 Go 语言）
本地安装

我个人更推荐第一种方式，考虑到后续升级的难易，这算是最均衡的一种方式。具体的安装方法可以在各主题的说明中找到，我这里安装的是【Stack】。在网站根目录下，输入：

git submodule add https://github.com/CaiJimmy/hugo-theme-stack/ hugo-theme-stack

# 更新主题
git submodule init	//初始化子模块
git submodule update	//更新子模块到最新版本

等待下载完成后，便可以进行【配置】了。假如你想用其他方式安装，也可以参考【这里】，而且Stack本身有全英文的【说明文档】。我建议是将./themes/hugo-theme-stack/exampleSite/文件下的content和hugo.yaml直接复制到博客主目录下（这是一个作者放的例子，这里面有许多提示），根据说明与需求修改，会剩下很多时间。

基础配置

打开`hugo.yaml`

本地调试的时候baseurl可以设置为http://localhost:1313。调试完推送到GitHub上，记得改为网站根目录，有疑问请参考【这里】。

网站 `icon`、时间格式、博客头像

网站icon存储路径：/static/favcion.ico
Go语言时间格式：
博客头像存储路径：/assets/img/avatar.png

favicon、avatar的路径格式如下图所示

`License`和留言板功能

license：做好公共版权许可协议声明
comments：进入【Giscus】官网，在线安装app，进入Giscus的配置页面，根据官方提示配置留言板功能。

这里我也给出我的配置，仅供参考。Message-Boards是我新建的一个留言板专属存放的public仓库。

    comments:
        enabled: true
        provider: giscus

        giscus:
            repo: Ranch007/Message-Boards
            repoID: R_kgDONBh4yw
            category: Announcements
            categoryID: DIC_kwDONBh4y84CjbwV
            mapping: pathname
            strict: 0
            lightTheme: 0
            darkTheme: 0
            reactionsEnabled: 1
            emitMetadata: 0
            inputPosition: top
            lang: zh-CN

社交功能

加入个人社交平台的链接
icon路径：博客主目录的/assets/icons下，所有icon都在这里，都是svg文件。

主题魔改

整体布局

照抄Naive Koala老师的文章《Hugo-theme-Stack 魔改美化》，文章写的很细心也很用心，属于喂饭教程。

[!NOTE]

1.没有目录的自己创建一个同名目录，切记要仔细保证这些单词准确

2.代码看不懂没事，读文章尝试理解，看一下作者改的那些代码，那就是实现变动的关键点

这里涉及到复制的文件分别有：

themes\hugo-theme-stack\assets\scss\custom.scss 复制到 /assets/scss/custom.scss

themes\hugo-theme-stack\layouts\partials\footer\custom.html 复制到 /layouts/partials/footer/custom.html

themes\hugo-theme-stack\assets\scss\partials\sidebar.scss 复制到 /assets/scss/partials/sidebar.scss（这里需要下载两个icon，记得更改好指定命名保存到/assets/icons；还涉及到去代码中更改，作者有提供行数，版本不一样所以不一定准确，所以得审一下代码，注意缩进）

themes\hugo-theme-stack\layouts\partials\sidebar\left.html 复制到 /layouts/partials/sidebar/left.html

themes\hugo-theme-stack\assets\scss\grid.scss 复制到 /assets/scss/grid.scss

themes\hugo-theme-stack\layouts\index.html 复制到 /layouts/index.html

在 static 文件夹下新建 code-header.svg（macOS 风格红绿灯图标）

themes\hugo-theme-stack\assets\scss\partials\layout\article.scss 复制到 /assets/scss/partials/layout/article.scss

“显示语言和复制按钮”与代码行自带的copy重叠了，这里我没有弄

如果你想更从容一点，可以提前把上面的文件复制主目录。开始魔改前，记得整体备份一下。

一些细节

添加文章开头更新时间和字数统计

在layouts\partials\article\components\details.html文件中，红框标记的就是增添组件的代码，黄框标记的就是两个组件的icon命名（目录在/assets/icons下）

下图所示，就是增添后的文章标题组件

添加文章末尾最后更新时间

在博客主文件夹下 layouts\partials\article\components\footer.html更新下面代码：

<footer class="article-footer">
    {{ partial "article/components/tags" . }}
    {{ if and (.Site.Params.article.license.enabled) (not (eq .Params.license false)) }}
    
    <section class="article-copyright">
        {{ partial "helper/icon" "copyright" }}
        <span>{{ default .Site.Params.article.license.default .Params.license | markdownify }}</span>
    </section>
    {{ end }}

    {{- if ne .Lastmod .Date -}}
        <div>
            <section class="article-lastmod">
                {{ partial "helper/icon" "edit" }}
                    <time class="article-lastmod">
                        {{ T "article.lastUpdatedOn" }}{{- .Lastmod.Format (or .Site.Params.published "2006-01-02T15:04") -}}
                    </time>
            </section>
        </div>
    {{- end -}}
    
</footer>

通过上面代码第16行，article.lastUpdatedOn添加“最后更新于”

添加网站运行时间组件

打开layouts\partials\footer\footer.html文件，将下面代码插入

    <span id="timeDate">载入天数...</span><span id="times">载入时分秒...</span>
    <script language="javascript"> 
        var now = new Date();
        function createtime(){
            // 当前时间
            now.setTime(now.getTime()+250);
            var grt= new Date("2024/10/15 00:00:00"); //网站诞生时间
            days = (now - grt ) / 1000 / 60 / 60 / 24;
            dnum = Math.floor(days);
            hours = (now - grt ) / 1000 / 60 / 60 - (24 * dnum);
            hnum = Math.floor(hours);
            if(String(hnum).length ==1 ){hnum = "0" + hnum;}
            minutes = (now - grt ) / 1000 /60 - (24 * 60 * dnum) - (60 * hnum);
            mnum = Math.floor(minutes);
            if(String(mnum).length ==1 ){mnum = "0" + mnum;}
            seconds = (now - grt ) / 1000 - (24 * 60 * 60 * dnum) - (60 * 60 * hnum) - (60 * mnum);
            snum = Math.round(seconds);
            if(String(snum).length ==1 ){snum = "0" + snum;}

            document.getElementById("timeDate").innerHTML = "本站已稳定运行"+dnum+" 天 ";
            document.getElementById("times").innerHTML = hnum + " 小时 " + mnum + " 分 " + snum + " 秒"
        }
        setInterval("createtime()",250); 
    </script>

该组件效果展示：

左侧栏 ID 和简介换行

找到layouts\partials\footer\footer.html中下方代码，更改为

可以按照个人需求对下面代码进行调整，我将“个人ID”直接写进代码，通过更改subtitle实现换行

        <div class="site-meta">
            <h1 class="site-name"><a href="{{ .Site.BaseURL | relLangURL }}"><span>Ranch</span></a></h1>
            <h2 class="site-description">{{ .Site.Params.sidebar.subtitle1 }}<br>{{ .Site.Params.sidebar.subtitle2 }}</h2>
        </div>

实际效果展示

到这里使用Hugo➕Stack➕Giscus部署到GitHub的博客搭建和魔改美化就告一段落啦

后续如果有更新也会继续记录到Blog这个标签里

附录

参考文献

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

【Free】使用Hugo搭建GitHub私人博客

Fri, 18 Oct 2024 22:19:18 +0000

环境准备

Git下载

进入【git官网】，找到对应适用于自己电脑系统的版本进行下载
根据提示，默认安装即可

Hugo下载

在【Hugo的GitHub官网】上，根据自己系统，选择对应版本直接下载（Tips：这里我根据【Hugo官网】的建议是安装了扩展版本）

下载后解压即可

（建议）将hugo.exe所在文件夹加入用户环境变量，方便使用hugo命令

博客搭建

创建博客

（1）在hugo.exe所在文件夹上方地址栏中，输入cmd，然后回车唤起命令行

（2）输入以下命令，创建xxx文件夹（这个文件夹就是博客的主文件夹，后面也可以改名）；并给出搭建博客的步骤

1
2

# 在当前文件夹中为创建xxx博客项目
hugo new site xxx

运行后便会输出一个网站目录，其结构为（引用自炸鸡人博客）：

cd切换进入blog\目录，输入下面命令，启动hugo服务

`1`	`hugo server -D`

Ctrl+鼠标左键点击上方链接，进入演示站点，如需停止在命令行输入Ctrl+C停止服务（hugo默认是没有主题的，后面会进行一个主题配置）

导入主题

（1）前往【Hugo Themes】，选择一个自己中意的主题

（2）安装主题一般而言存在三种方式：
1. git submodule 安装
2. 本地安装
3. go module安装（需要安装Go语言）
（3）我个人使用第一种方式，考虑到后续主题升级的难易，这算是最均衡的一种方式。具体的安装方法可以在各主题的说明中找到，我这里安装的是【Stack】。在网站目录下，输入：

# 前目录中初始化一个空的 Git 存储库
git init

# 将stack主题克隆到`themes`目录中，并将其作为Git子模块添加到当前项目中
git submodule add https://github.com/CaiJimmy/hugo-theme-stack/ themes/hugo-theme-stack

等待下载完成后，便可以进行后面的配置了。假如你想用其他方式安装，也可以参考这里。Stack本身有全英文的说明文档，

（4）等待下载完成。建议将exampleSite样例数据中的`Content和hugo.yaml复制到主文件夹中

（4）进入主文件下的content\post，并删掉rich-content文件夹（不然会报错）

（5）再次启动hugo服务，查看主题。具体主题配置细节放在下一篇。

GitHub部署

常规部署

（1）前往【GitHub官网】，登录或者注册一个GitHub账号，创建新的仓库{GitHub用户名}.github.io（这里我已经注册了）

（2）前往进入xxx.github.io仓库，从Setting -> Pages先将source的“从分支部署“切换到”GitHub操作“，初始化一下，再切回“分支部署”

然后Branch出现”main分支“，选择main保存。

（Tips：现在需要先将内容推送到GitHub才能开启GitHub Pages网址。）

（3）回到本地博客的主文件夹。准备发布网站，执行以下命令，Hugo 会在public在项目根目录中创建整个静态网站

hugo -D

（4）接着在进入 public 文件夹，执行以下命令上传到github仓库上，第一次上传可能需要输入账号密码

git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/{你的GitHub用户名}/{用户名.github.io}
git push -u origin main

（5）前往https://github.com/{GitHub用户名}/{用户名}.github.io，点击Branch判断有没有上传成功

自动化部署

具体要求

如果想使用 Github Actions 自动部署 hugo 博客，则最起码需要创建两个 Github 的仓库。

第①个，便是存储博客 .md 源文件的地方，其实就是 hugo的主文件；

第②个，则是部署 Github Pages 的仓库（存放public文件夹里的所有文件），仓库名必须是 <GitHub用户名>.github.io，这是 github 官方要求的。

原理流程

1.当我们提交博客 .md 源文件到仓库 ① 后，利用 Github Actions 自动执行 hugo 的命令 2.在 public 目录下会自动生成静态网站，然后再将 public 目录推送到仓库 ② 3.由于仓库② 是 Github Pages，它接着就会自动执行部署的命令。

（1）我们需要从主文件的仓库①推送到外部 GitHub Pages 仓库②，需要特定权限，所以还得在 GitHub 账户 Setting - Developer settings - Personal access tokens （https://github.com/settings/tokens）下创建一个 Token：

进入设置，Developer settings就在设置左下角，如下图点进去（需要验证）

如下图进行配置，创建一个永久性token，并复制（Tips：切记！！Token只会出现一次，请做好留存、保密）

最后，来到以github.io结尾的仓库①。添加一个 secret，保存并命名你复制的token值，这个Name下一步需要用到。

（2）管理博客主文件的仓库①，点击 Actions 按钮，即可添加工作流文件，该文件一般是以 .yml 结尾，这样才能被 GitHub 识别

我创建的文件名为deploy.yml，内容如下：

name: deploy

# 代码提交到main分支时触发github action
on:
  push:
    branches:
      - main	# 这里的意思是当 master分支发生push的时候，运行下面的jobs
      
jobs:
  deploy:	# 任务名自取
    runs-on: ubuntu-latest	# 在什么环境运行任务
    steps:
        - name: Checkout
          uses: actions/checkout@v4	# 引用actions/checkout这个action，与所在的github仓库同名
          with:
 			 submodules: true	# Fetch Hugo themes (true OR recursive) 获取submodule主题
              fetch-depth: 0	 # Fetch all history for .GitInfo and .Lastmod

      	- name: Disable quotePath
      	  run: git config --global core.quotePath false

        - name: Setup Hugo	# 步骤名自取
          uses: peaceiris/actions-hugo@v3	# hugo官方提供的action，用于在任务环境中获取hugo
          with:
              hugo-version: "latest"	# 获取最新版本的hugo
              extended: true

        - name: Build Web
          run: hugo -D	# 使用hugo构建静态网页
          
        - name: Deploy Web
          uses: peaceiris/actions-gh-pages@v4	# 一个自动发布github pages的action
          with:
              personal_token: ${{ secrets.{保存toekn的Name} }}	# 发布到其他repo需要提供上面生成的personal access token
              external_repository: {GitHub用户名}/{用户名}.github.io	# 发布到哪个repo
              publish_branch: main	# 发布到哪个branch
              publish_dir: public	# 注意这里指的是要发布哪个文件夹的内容，而不是指发布到目的仓库的什么位置，因为hugo默认生成静态网页到public文件夹，所以这里发布public文件夹里的内容
              commit_message: auto deploy

这样，我们的博客网站就部署好了，这极大地简化了我们发布文章的流程。

附录

参考文献

版权信息

本文原载于 Ranch’s Blog，遵循 CC BY-NC-SA 4.0 协议，复制请保留原文出处。

网络技术 on Ranch's Blog

Obsidian + GitHub + Hugo 博客发布工作流

Obsidian + GitHub + Hugo 博客发布工作流

引言

正文

1. 整体架构

2. Hugo 博客站

主题

站点配置 (hugo.yaml) 关键点

评论系统

侧边栏与头像

内容目录结构

分类体系

3. 发布脚本详解

3.1 执行入口

3.2 扫描阶段

3.3 Frontmatter 转换（Obsidian → Hugo）

3.4 正文转换

3.5 Slug 生成算法

3.6 源笔记标记

3.7 博客数据同步

3.8 Git 推送

4. GitHub Actions 持续部署

5. 完整发布流程（端到端）

6. 关键细节总结

目录映射规则

前后 frontmatter 对照

本地预览博客

拓展

局限性

后续可能优化

附录

相关文件

参考文章

版权信息

Obsidian 个人知识库搭建全记录

Obsidian 个人知识库搭建全记录

引言

正文

让 AI 阅读方法论并设计结构

目录演变

第一篇素材

发现 raw/ 根目录需要整理

merge 外部 CLAUDE.md

索引页的演变

踩过的坑

功能模块迭代顺序

主题切换

每日诗句

问候语按时间段切换

用户名自动读取

meta/CLAUDE.md 的演变

Frontmatter 规范

assets/ 目录建立

命名规范

图片管理流程

初始化目录结构

灌入第一篇资料

搭建仪表盘

日常 Ingest

健康检查

添加自定义规则

唤醒自动检查

查询知识库

拓展

附录

参考文章

版权信息

PowerShell $PROFILE 实用手册

前言

如何配置你的 $Profile

查看路径

创建文件

编辑配置

1. 语法高亮与智能提示补全

2. （可选）自定义提示符（显示时间与当前路径）

3. 常用别名和快捷方式

4. （可选）显示文件夹 Icons

5. （可选）集成 Oh My Posh 主题

6. 配置生效

导入`GNS3 VM`

安装`GNS3-2.2.45-all-in-one.exe`

应用层（Data 数据）

传输层（Segment 段）

网络层（Packet 包）

数据链路层（Frame 帧）