Tutorial on Yanmu

Methods for Sharing VPN and Proxy Connections Across Devices

Thu, 11 Jun 2026 23:00:00 +0800

Mode	Also Known As	Description
Proxy Sharing Mode	Allow LAN	Devices forward requests through proxy software
Gateway Sharing Mode	Bypass Gateway, Transparent Proxy	Devices point their gateway to the proxy host
Routing Sharing Mode	WiFi Hotspot	Host creates an independent subnet and assigns IPs

Overview diagram:

How It Works

Suppose your computer is running Clash or V2Ray with proxy sharing enabled. You can set up your phone to route its requests through your computer. The flow is as follows:

Phone access request → Computer (processed by V2Ray/Clash) → Gateway (Router) → Internet
Internet response → Gateway (Router) → Computer → Phone

This is how proxy sharing mode works.

Example: Phone Accessing the Internet Through Computer Proxy

In V2Ray, enable LAN connections to see the SOCKS5 and HTTP ports

The computer uses HTTP proxy, so port 10809 is used
Check the WiFi connection info on your phone to get its IP address
Enter the phone’s IP and port in your computer’s proxy settings

Now your computer’s requests will be handled by your phone—your computer can access Google. If you turn off the phone’s VPN, the computer loses access too.

Example: Computer Proxying Phone Requests (Reverse)

The reverse setup—using your computer to proxy your phone’s requests—works the same way:

Open V2Ray settings and allow LAN connections
The proxy port is displayed in the lower-left corner
Go to your phone’s WiFi proxy settings, enter the computer’s IP as the server address and the port shown in the screenshot

About UDP Proxy

Note: The system proxy configured in phone settings is typically an HTTP proxy, which does not support UDP transport. To proxy UDP traffic, you need a SOCKS proxy. Since system proxy settings don’t support SOCKS, you’ll need a third-party VPN tool.

Create a SOCKS proxy in V2Ray on your phone:

Server: Enter your computer’s IP address
Port: Enter your computer’s V2Ray SOCKS port

This allows UDP data to be proxied. However, whether UDP proxying actually works depends on whether your server node supports UDP.

Pros and Cons

Pros:

Almost all proxy tools support enabling proxy sharing mode

Cons:

Each network device needs to be configured individually
Some devices (e.g., TV boxes) don’t support proxy configuration, making this method unusable for them

How It Works

Gateway sharing mode is also called bypass gateway, transparent proxy, or transparent gateway.

Typically, the router assigns IPs to each device. In gateway mode, the router assigns the computer’s IP to every device as their gateway.

Workflow: When your phone wants to access Google → data is sent to the gateway (the computer) → the computer processes the data and forwards it to the router

Key point: All internet traffic from devices on the LAN goes through the gateway.

Pros and Cons

Advantages:

Flexible configuration—you can set the gateway individually per device, or have the router change the gateway for all devices on the LAN at once
The biggest advantage: a gateway-level system proxy can intercept all traffic on the system. Even if some applications don’t use a proxy or certain devices don’t support proxy settings, any internet access still passes through the gateway. The devices themselves don’t even know they’re being proxied
This is why it’s called transparent proxy or transparent gateway

Disadvantages:

Not all operating systems support it. Windows does not support this mode; macOS and Linux do

Implementation via Linux Virtual Machine

Since Windows doesn’t support gateway sharing mode, you can install a Linux virtual machine to achieve it.

Use bridged networking for the VM (same LAN as the host)
Enable the root user
Enable IP forwarding and TUN mode:
1

sysctl -w net.ipv4.ip_forward=1
Go to your computer’s IP settings and set the default gateway to the Linux VM’s IP address

Limitation: This won’t work without a LAN.

How It Works

When routing sharing mode is enabled, the computer creates an independent subnet (shown as 192.168.137.1 in green in the diagram). When other devices connect to this computer, the computer assigns them IPs, gateways, and other network info. The computer essentially takes over the router’s job—hence the name routing sharing mode.

Pros and Cons

Pros:

Many advantages, widely applicable

Cons:

Adds an extra NAT layer, requiring some performance overhead
Creates two different LAN segments that cannot communicate with each other by default
Most phones don’t support sharing VPN networks through routing mode without Root access

Configuration on Windows

Enabling routing sharing mode on Windows requires two network interfaces. Most computers have only one, so you may need to purchase a USB Ethernet adapter to add an extra port.

Setup steps:

Assume the first NIC connects to your LAN and the second is idle
Enable TUN mode
Clash will create a virtual network adapter
Right-click the virtual adapter → Properties → Sharing → Select “Allow other network users…” and choose the idle NIC
This creates a new subnet, sharing Clash’s proxy environment with the idle NIC

Use Cases

This idle NIC can be connected to another computer via an Ethernet cable, and that computer can access the internet through the proxy without any configuration. A more common scenario is connecting it to a wireless access point (AP) to broadcast WiFi.

C Drive Always Full? Use the Simple mklink DOS Command to Save Your C Drive!

Tue, 02 Jun 2026 00:00:00 +0800

Background

Running out of space on the C drive is a classic pain point for Windows users. The usual culprits are:

WeChat/QQ chat history and file caches (easily tens of GB)
Browser caches and user data
Global caches from package managers (pip, npm, conda, cargo, etc.)
Default installation/data directories for Adobe, Office, games, and other large software
Windows update leftovers and temporary files

Most of these programs default to writing data to the C drive and don’t provide an option to change the path. Reinstalling software or editing the registry is both troublesome and risky.

The mklink command offers an elegant solution — store the data on your D or E drive, while the software “thinks” it’s still on the C drive.

What is mklink?

mklink is a built-in Windows command-line tool (available since Vista) for creating links. It’s essentially a path alias/pointer, similar to Linux’s ln -s.

🧊 Analogy: Think of a desktop shortcut — when you double-click the icon on your desktop, it actually opens a file located elsewhere. mklink does the same thing, connecting the “real storage location” with the “path the software expects.”

Three Types of Links

Type	Command	Target	Characteristics
Symbolic Link	`/D`	Directory	Can cross partitions, most commonly used, like a “directory shortcut”
Hard Link	`/H`	File	Same partition only, multiple paths pointing to the same data
Directory Junction	`/J`	Directory	Cross-partition, older NTFS technology, better compatibility

⭐ For everyday use, prefer /J (Directory Junction) or /D (Directory Symbolic Link). For moving software data directories, they work almost identically.

Step-by-Step Instructions

Close the Target Software

Make sure the software you’re migrating data from is completely closed (including background processes), otherwise files will be locked and cannot be moved.

Move the Original Folder

1
2

# Move/cut the original C drive directory to the target drive
move "C:\original-path" "D:\new-path"

⚠️ Don’t copy! Use move (or cut) to ensure the original path no longer exists.

Create the Link

1
2

# Create a Directory Junction with /J
mklink /J "C:\original-path" "D:\new-path"

Or use /D:

`1`	`mklink /D "C:\original-path" "D:\new-path"`

Verify

Open the original C drive path and confirm you can access the files on the D drive.

🔍 In CMD, navigate to the parent directory and run dir. Linked items will show the <JUNCTION> or <SYMLINKD> marker.

Common Use Cases

WeChat Data Migration ⭐

WeChat is the number one C drive killer — chat history and file caches can easily reach tens of GB.

# Close WeChat
# Move the data directory
move "%USERPROFILE%\Documents\WeChat Files" "D:\Data\WeChat Files"

# Create the link
mklink /J "%USERPROFILE%\Documents\WeChat Files" "D:\Data\WeChat Files"

The new version of WeChat stores data at C:\Users\username\Documents\WeChat Files, while older versions store it in the installation directory under WeChat Files.

QQ Data Migration

# QQ personal folder is usually at
# C:\Users\username\Documents\Tencent Files

move "C:\Users\your-username\Documents\Tencent Files" "D:\Data\Tencent Files"
mklink /J "C:\Users\your-username\Documents\Tencent Files" "D:\Data\Tencent Files"

Chrome / Edge Browser Cache

# Chrome user data
move "%LOCALAPPDATA%\Google\Chrome\User Data" "D:\BrowserData\Chrome"
mklink /J "%LOCALAPPDATA%\Google\Chrome\User Data" "D:\BrowserData\Chrome"

# Edge user data
move "%LOCALAPPDATA%\Microsoft\Edge\User Data" "D:\BrowserData\Edge"
mklink /J "%LOCALAPPDATA%\Microsoft\Edge\User Data" "D:\BrowserData\Edge"

Development Tool Caches

# pip cache
move "%LOCALAPPDATA%\pip\cache" "D:\DevCache\pip"
mklink /J "%LOCALAPPDATA%\pip\cache" "D:\DevCache\pip"

# npm cache
move "%LOCALAPPDATA%\npm-cache" "D:\DevCache\npm"
mklink /J "%LOCALAPPDATA%\npm-cache" "D:\DevCache\npm"

# Maven local repository
move "%USERPROFILE%\.m2\repository" "D:\DevCache\maven"
mklink /J "%USERPROFILE%\.m2\repository" "D:\DevCache\maven"

A better approach is to configure the package manager’s cache path directly (e.g., npm config set cache). Environment variable solutions are more stable, with mklink as a fallback.

Windows Store Apps / Large Games

Some UWP apps and Xbox Game Pass games don’t allow you to change the installation path, but mklink can help migrate them.

1
2
3

# For Forza Horizon and similar games
# Usually located at C:\Program Files\WindowsApps or C:\XboxGames
# You'll need to obtain folder permissions (TrustedInstaller) first

⚠️ Operating on the WindowsApps directory is more complex and involves permission management. Proceed with caution.

OneDrive / iCloud Sync Directories

1
2

move "C:\Users\your-username\OneDrive" "D:\OneDrive"
mklink /J "C:\Users\your-username\OneDrive" "D:\OneDrive"

Important Notes & Pitfalls

Issue	Explanation
Must move first, then link	`mklink` requires that the target path does not exist, otherwise it will error `File already exists`
Back up before moving	Although the operation is reversible, it’s recommended to back up important data first
Don’t touch system directories	Avoid `C:\Windows`, `C:\Program Files`, and other system directories
Deleting a link ≠ deleting data	Removing the “shortcut” on the C drive only deletes the link; the data on the D drive remains
Correct way to delete a link	`rmdir "C:\link-path"` (not `del`)
Run CMD as Administrator	Some directories require admin privileges to create links
NTFS file system required	Only supported on NTFS, not FAT32 or exFAT
Restoring	Delete the link → move the D drive data back to the original C drive path

Deleting / Restoring a Link

# Delete the link (does NOT delete the original data on the D drive)
rmdir "C:\original-path"

# To restore: move the data back
move "D:\new-path" "C:\original-path"

Quick Diagnosis: What’s Eating Your C Drive?

Before using mklink, analyze your C drive to find the real culprit:

Tool	Features
WizTree	Blazing fast scan, intuitive treemap, free
SpaceSniffer	Visual block chart, intuitive
TreeSize Free	Classic tool, sorted by folder size
Windows Disk Cleanup	`cleanmgr`, cleans temp files and update leftovers

🔥 WizTree is recommended — it uses MFT parsing directly, scanning an entire hard drive in seconds.

Summary

The core idea of mklink is:

1
2
3

Software thinks data is still at C:\some-path
       ↓ (the link created by mklink)
Data is actually stored at D:\some-path

The operation mantra: Close the software → Move the folder → Create the mklink link → Verify it works

It’s safer, reversible, and more efficient than “editing the registry” or “reinstalling to another drive.” Master this command, and your C drive will never mysteriously turn red again. 🎉

C Drive Full? Expand It Using Other Drives

Sun, 24 May 2026 16:00:00 +0800

C drive turning red is a common headache for Windows users—system update cache, temp files, desktop files, WeChat chat records… Before you know it, your C drive is packed. Replacing the hard drive is expensive, and cleaning only treats the symptoms. The most thorough solution is: borrow space from other drives for your C drive.

📖 Table of Contents (click to expand)

#	Section	Description
1	Preparation	Download, install, enter PE environment
2	Resize	8-step guide with Partition Assistant
3	Reboot & Cleanup	Return to Windows, clean boot menu
4	Tips	Additional advice and FAQs

📦 Preparation

⚡ In a nutshell: Put Windows into a “hibernation box” so the C drive isn’t occupied.

① Download WePE Toolbox

WePE Toolbox — a lightweight PE (Preinstallation Environment) tool, clean and ad-free.

② Install to System

Open the downloaded program and click 「Install into System Now」. It will automatically write the boot entry.

After installation, restart your computer. You’ll see the system boot selection screen.

⏱ Note: The countdown is only a few seconds. If it times out, it will boot into the current system. Watch closely and select quickly!

④ Enter PE Environment

Use arrow keys to select WePE Toolbox and press Enter.

💡 Why enter PE?

In the PE environment, your Windows system is completely “hibernated”—the C drive is not occupied by any process. This allows safe partition resizing. Think of it like surgery: the patient must be anesthetized before the operation. Other partition tools work on the same principle.

🛠️ Resize

Once in PE, the tool menu will pop up automatically. Click 「Partition Assistant」.

Step 1 · Check Disk Layout

Partition Assistant will show you the layout of all disk partitions. Identify which drive has free space to “donate” to the C drive.

Step 2 · Choose the Drive to Shrink

Here we use Software (D drive) as an example. We’ll “cut” some space from D drive to give to C drive.

💡 Which drive to choose?

✅ Prefer drives with plenty of free space that you don’t use often

❌ Avoid touching system recovery partitions or EFI partitions

Step 3 · Adjust Partition

Right-click D drive → 「Adjust Partition」.

Step 4 · Shrink the Drive

In the popup window, drag the slider or enter a value to decide how much space to take from D drive.

✅ Example: If you want to add 50GB to C drive, shrink D drive by 50GB here.

⚠️ Note: The shrink value must not exceed the used space on D drive, or it will error.

Click 「OK」 when done.

Step 5 · Merge into C Drive

You’ll now see a block of 「Unallocated Space」 next to D drive.

Step	Action
1	Right-click C drive → 「Adjust Partition」
2	Drag the slider all the way to the right to merge all unallocated space into C drive
3	Click 「OK」

Step 6 · Submit Task

Click 「Submit」 in the top-left corner.

⚠️ Critical Reminder

All the adjustments so far are just “plans” — they haven’t taken effect yet.

Only after clicking 「Submit」 will the system actually execute the partition operations. Double-check before submitting!

Step 7 · Wait for Execution

Partition Assistant will begin executing the adjustments. This may take several minutes to over ten minutes, depending on your disk size and speed.

⚠️	🔴 Do NOT power off or force shutdown during this process!
Otherwise, the partition table may be corrupted, causing data loss
Plug in the power adapter (laptop users)
Grab a cup of tea and wait patiently 🍵

Step 8 · Done 🎉

When you see the success message, the expansion is complete!

🚀 Reboot & Cleanup

#	Action
①	Click 「Restart」
②	At the boot menu, select your Windows system to boot normally
③	Open This PC and verify that C drive space has increased ✅

🧹 Final step: If you don’t want to see the boot selection screen every time, open WePE Toolbox → click 「Uninstall」 to restore the original state.

📌 Tips

Scenario	Recommendation
🟢 C drive is too small (< 30GB)	Expand to at least 80 ~ 100GB
🟡 D drive also has no free space	Clean up D drive, or use an external drive to transfer large files
🔴 Worried about data loss before operation	Strongly recommend backing up important files first! Partition Assistant is stable, but better safe than sorry

✨ That's the complete guide to expanding your C drive. May your computer never see red again!

Hugo + Stack + GitHub Pages Blog Setup Guide

Mon, 08 Dec 2025 00:00:00 +0000

Hugo + Stack + GitHub Pages Blog Setup Guide

A complete guide to building a personal blog with Hugo + Stack theme and deploying it to GitHub Pages.

This guide covers both new Stack (v4.x, split .toml config format) and legacy (v3.x, single hugo.yaml) configuration differences, with annotations where key differences exist.

Environment Setup

Install Git

Go to the Git website to download and install: https://git-scm.com/downloads
Use all default options during installation

Install Hugo (Extended Version)

Go to Hugo GitHub Releases: https://github.com/gohugoio/hugo/releases
Choose the extended version (marked with extended) — the Stack theme requires extended SCSS compilation support
Windows users: download hugo_extended_xxx_windows-amd64.zip and extract hugo.exe

This guide was written using Hugo v0.161.1 and Stack theme v4.0.2.

GitHub Account

Register a GitHub account: https://github.com
It’s recommended to enable two-factor authentication (2FA) — you can install the Authenticator 2FA Client plugin in Edge

Create a Hugo Site

Initialize the Project

Open a terminal in the directory where hugo.exe is located (type cmd or powershell in the address bar) and run:

# Create a new site
hugo new site myblog

# Enter the site directory
cd myblog

Generated file structure:

myblog/
├── archetypes/    # Article templates
├── assets/        # Static assets (images, CSS, JS)
├── content/       # Blog content (articles)
├── data/          # Data files
├── i18n/          # Multilingual support
├── layouts/       # Layout templates
├── public/        # Build output (generated by hugo command)
├── static/        # Static files (copied directly to public)
├── themes/        # Themes
└── hugo.toml      # Site configuration

Test the Default Site

`1`	`hugo server -D`

Visit http://localhost:1313/ in your browser. The page will be basic (no theme). Press Ctrl + C to stop the server.

Configure the Stack Theme

Download the Theme

Go to the Stack theme GitHub: https://github.com/CaiJimmy/hugo-theme-stack
Download the latest Release archive (or click “Download ZIP”)
Extract to the site’s themes/ directory

1
2

myblog/themes/
└── hugo-theme-stack-4.0.2/   # Folder with version number

Configure Theme Files — Critical Step

This is the step where errors are most likely to occur. The new Stack (v4.x) and legacy (v3.x) have completely different file structures:

Comparison	Legacy Stack (v3.x)	New Stack (v4.x)
Example site folder name	`exampleSite/`	`demo/`
Config files	Single `hugo.yaml`	Multiple `.toml` files in `config/_default/`
Theme reference	`theme: hugo-theme-stack`	`[[module.imports]]` (Hugo Modules)

New Version (v4.x) Steps:

Step 1: Copy Configuration Files

# Create config/_default directory
mkdir -p config/_default

# Copy all config files from demo
cp themes/hugo-theme-stack-4.0.2/demo/config/_default/*.toml config/_default/

After copying, config/_default/ contains 6 config files:

File	Purpose
`hugo.toml`	Base config (baseURL, title, pagination, permalinks, etc.)
`languages.toml`	Multilingual configuration
`markup.toml`	Markdown rendering config (code highlighting, TOC, etc.)
`menu.toml`	Menu config (navigation bar, social links)
`params.toml`	Theme parameters (sidebar, comments, widgets, etc.)
`related.toml`	Related content recommendation config

Step 2: Change Theme Reference Method

Open config/_default/hugo.toml, find:

1
2

[[module.imports]]
    path = "github.com/CaiJimmy/hugo-theme-stack/v3"

Replace with:

`1`	`theme = "hugo-theme-stack-4.0.2"`

This traditional method doesn’t require Go environment or Hugo Modules, making it simpler and consistent with this guide.

Step 3: Handle Root hugo.toml Conflict

The root hugo.toml and config/_default/hugo.toml will conflict. Back up or delete the root file:

`1`	`mv hugo.toml hugo.toml.bak`

Step 4: Copy Example Content

# Back up existing content (if any)
mv content content_backup

# Copy demo content
cp -r themes/hugo-theme-stack-4.0.2/demo/content .

Step 5: Copy Avatar and Static Assets

1
2

mkdir -p assets/img
cp themes/hugo-theme-stack-4.0.2/demo/assets/img/avatar.png assets/img/

Legacy Version (v3.x) Steps:

Enter the theme’s exampleSite/ folder
Copy the content folder and hugo.yaml to the site root
Delete the root hugo.toml (since you now have hugo.yaml)
Confirm that the theme field in hugo.yaml matches the theme folder name (version number removal recommended)

Verify by Starting

`1`	`hugo server -D`

Visit http://localhost:1313/ in your browser. You should now see the complete Stack theme (with sidebar, search, example articles, etc.).

If the page is incomplete, check the terminal for WARN messages (e.g., “Search page not found”, “Archives page not found”). This is usually because example content wasn’t copied.

Custom Configuration

Basic Information

Edit config/_default/hugo.toml (new version) or hugo.yaml (legacy):

1
2

baseURL = "https://your-username.github.io/"
title   = "My Blog"

If your primary language is Chinese, it’s recommended to set:

1
2

defaultContentLanguage = "zh-cn"
hasCJKLanguage         = true   # Set to true for Chinese/Japanese/Korean

Edit config/_default/params.toml (new version) or the params.sidebar section in hugo.yaml:

[sidebar]
    emoji    = "✏️"
    subtitle = "Your personal tagline"
    avatar   = "img/avatar.png"

Place the avatar image at assets/img/avatar.png
Choose emojis from emojiall.com

Edit config/_default/menu.toml (new version) or the menu.social section in hugo.yaml:

[[social]]
    identifier = "github"
    name       = "GitHub"
    url        = "https://github.com/your-username"
    params.icon = "brand-github"

Icon names reference: Tabler Icons (use brand-xxx format).

Comment System

Stack supports multiple comment systems. Here’s an example using utterances (based on GitHub Issues, no extra registration needed):

[comments]
    enabled  = true
    provider = "utterances"

    [comments.utterances]
        repo      = "your-username/your-username.github.io"
        issueTerm = "pathname"
        label     = ""

For more comment system configurations, see the theme documentation: https://stack.jimmycai.com/config/comments

1
2

[footer]
    since = 2026

Creating Articles

Article Structure

The Stack theme recommends each article in its own folder with index.md and image assets:

`1`	`hugo new content post/my-first-article/index.md`

Generated directory structure:

1
2
3

content/post/my-first-article/
├── index.md      # Article content
└── image.jpg     # Article image (optional)

Article Front Matter Example

---
title: My First Article
date: 2026-05-12
description: Article summary description
tags:
  - Hugo
  - Blog
categories:
  - Tutorial
image: image.jpg   # Article cover image (optional)
---

Deploy to GitHub Pages

Create a GitHub Repository

Log in to GitHub, click New repository
Repository name: your-username.github.io (must match exactly)
Select Public (GitHub Pages free tier requires public)
Do not check “Add a README file”

Manual Deployment

# 1. Build the static website (output to public/)
hugo -D

# 2. Enter the public directory
cd public

# 3. Initialize Git and push
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/your-username/your-username.github.io.git
git push -u origin main

After pushing successfully, visit https://your-username.github.io/ to see your blog (the first time may take 1-2 minutes).

Automatic Deployment (GitHub Actions)

Manually building and pushing every time is tedious. Use GitHub Actions to automatically build and deploy when you push code.

Step 1: Create a Source Repository

In addition to the username.github.io deployment repository, create a source repository (e.g., myblog) and push the entire Hugo project to it:

# In the site root directory (not inside public/)
git init
git add .
git commit -m "init hugo site"
git branch -M main
git remote add origin https://github.com/your-username/myblog.git
git push -u origin main

Step 2: Create GitHub Actions Workflow

Create .github/workflows/deploy.yml in the site root:

name: Deploy Hugo site to GitHub Pages

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: true
          fetch-depth: 0

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: 'latest'
          extended: true

      - name: Build
        run: hugo --minify

      - name: Deploy
        uses: peaceiris/actions-gh-pages@v4
        with:
          personal_token: ${{ secrets.PERSONAL_TOKEN }}
          external_repository: your-username/your-username.github.io
          publish_branch: main
          publish_dir: ./public

Step 3: Configure GitHub Token

Go to GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
Generate a new Token with repo and workflow permissions
Copy the generated Token
Go to your source repository → Settings → Secrets and variables → Actions → New repository secret
Name: PERSONAL_TOKEN, Value: paste the Token

From now on, every git push to the source repository’s main branch will trigger GitHub Actions to automatically build and deploy to username.github.io.

Tip: Enable Automatic lastmod Add the following to config/_default/hugo.toml (new version) or hugo.yaml (legacy):
1
2
3
enableGitInfo = true
[frontmatter]
  lastmod = [":git", ":fileModTime"]
This will automatically display the Git commit time as the last modified time for articles. This requires fetch-depth: 0 in the GitHub Actions checkout step (already included in the configuration above).

FAQ

Q1: Page is blank/incomplete after starting?

Check whether you copied the demo’s content folder. Missing example pages (search, archives, etc.) will cause the theme to display incompletely.

Q2: `hugo server` throws “Theme not found” error?

New version: Check that theme = "xxx" in config/_default/hugo.toml matches the folder name under themes/
Legacy: Check the theme field in hugo.yaml

Q3: Root `hugo.toml` conflicts with `config/_default/hugo.toml`?

Delete or back up the root hugo.toml. Hugo will prioritize config files under config/_default/.

Q4: Push to GitHub fails?

This may be a network issue. Try removing the proxy:

1
2

git config --global --unset http.proxy
git config --global --unset https.proxy

Q5: What is the new `[[module.imports]]`?

The new Stack uses Hugo Modules (Go modules) to import the theme by default, which requires a Go environment. If you don’t want to deal with Go, simply switch to the traditional theme = "theme-folder-name" method.

Q6: Blog styles are broken after deployment?

Check that baseURL is correctly set to https://your-username.github.io/ (note the trailing /). An incorrect baseURL will cause CSS/JS resources to fail to load.

Tutorial on Yanmu

Methods for Sharing VPN and Proxy Connections Across Devices

Overview of Three Sharing Modes

Proxy Sharing Mode

How It Works

Example: Phone Accessing the Internet Through Computer Proxy

Example: Computer Proxying Phone Requests (Reverse)

About UDP Proxy

Pros and Cons

Gateway Sharing Mode

How It Works

Pros and Cons

Implementation via Linux Virtual Machine

Routing Sharing Mode

How It Works

Pros and Cons

Configuration on Windows

Use Cases

C Drive Always Full? Use the Simple mklink DOS Command to Save Your C Drive!

Background

What is mklink?

Three Types of Links

Step-by-Step Instructions

Close the Target Software

Move the Original Folder

Create the Link

Verify

Common Use Cases

WeChat Data Migration ⭐

QQ Data Migration

Chrome / Edge Browser Cache

Development Tool Caches

Windows Store Apps / Large Games

OneDrive / iCloud Sync Directories

Important Notes & Pitfalls

Deleting / Restoring a Link

Quick Diagnosis: What’s Eating Your C Drive?

Summary

Further Reading

C Drive Full? Expand It Using Other Drives

📦 Preparation

① Download WePE Toolbox

② Install to System

③ Reboot into Boot Menu

④ Enter PE Environment

🛠️ Resize

Step 1 · Check Disk Layout

Step 2 · Choose the Drive to Shrink

Step 3 · Adjust Partition

Step 4 · Shrink the Drive

Step 5 · Merge into C Drive

Step 6 · Submit Task

Step 7 · Wait for Execution

Step 8 · Done 🎉

🚀 Reboot & Cleanup

📌 Tips

Hugo + Stack + GitHub Pages Blog Setup Guide

Hugo + Stack + GitHub Pages Blog Setup Guide

Environment Setup

Install Git

Install Hugo (Extended Version)

GitHub Account

Create a Hugo Site

Initialize the Project

Test the Default Site

Configure the Stack Theme

Download the Theme

Configure Theme Files — Critical Step

New Version (v4.x) Steps:

Legacy Version (v3.x) Steps:

Verify by Starting

Custom Configuration

Basic Information

Sidebar

Social Links

Comment System

Footer

Creating Articles

Article Structure

Article Front Matter Example

Q2: `hugo server` throws “Theme not found” error?

Q3: Root `hugo.toml` conflicts with `config/_default/hugo.toml`?

Q5: What is the new `[[module.imports]]`?