Cipher's Blog

一个基于 Hugo 的静态博客网站，使用 PaperMod 主题，专注于编程、安全和区块链技术分享。

项目概览

Cipher's Blog 是一个技术博客网站，主要分享编程、网络安全和区块链相关的技术文章。项目使用 Hugo 静态网站生成器和 PaperMod 主题构建，使用中文内容，部署在 https://www.ciphermagic.cn/ 上。

现有内容类型

本博客涵盖了多个技术领域的深度文章，主要包括：

区块链技术

以太坊开发: 包含 Foundry 框架、Gas 优化、中继服务等技术详解
闪电贷和套利: 深入分析 Flash Swap 套利策略和实现方法
数字钱包: HD 钱包生成原理和实现机制
去中心化金融 (DeFi): 包括无常损失 (Impermanent Loss) 等核心概念
现实世界资产 (RWA): RWA实操指南系列，从资产筛选、SPV设立到通证化落地
NFT: 艺术家 NFT 发行和交易机制

Java 相关

Dubbo 框架: Proguard 代码混淆、代理机制等高级特性
Spring Boot 相关: 调试技巧、XSD 配置等实用内容
Java 8 新特性: Builder 模式的最佳实践
代码质量: SIMON 代码质量评估工具和方法
算法实践: LeetCode 算法题解与优化思路

Go 语言

Go 语言特性: Slice 底层实现和性能优化
Go 实践项目: Dubbo Proxy 实现方案

网络安全

系统安全: CentOS 安全防护策略
漏洞防护: Log4j 安全配置最佳实践
威胁检测: ELK 威胁检测系统构建

其他技术

数据库技术: Elasticsearch、Logstash、Kibana 应用实践
开发工具: IntelliJ IDEA 使用技巧

运行项目

本地开发

安装 Hugo（如果尚未安装）：

# 对于 macOS (使用 Homebrew)
brew install hugo

# 对于 Ubuntu/Debian (使用 apt)
sudo apt-get install hugo

# 对于其他系统，请参考：https://gohugo.io/getting-started/installing/

克隆项目：

git clone <项目URL>
cd Cipher's Blog

启动本地开发服务器：

hugo server -D

在浏览器中访问：http://localhost:1313/

生成静态文件

hugo

生成的静态文件将位于 public/ 目录中，可以直接部署到任何静态文件服务器。

创建新的博客文章

hugo new posts/文章标题.md

技术栈

Hugo - 静态网站生成器
PaperMod - 主题框架
Markdown - 内容编写格式
Git - 版本控制

项目结构

Cipher's Blog/
├── content/                 # 博客内容目录
│   ├── posts/              # 博客文章
│   ├── about/             # 关于页面
│   ├── archives/          # 归档页面
│   ├── categories/        # 分类页面
│   └── tags/             # 标签页面
├── themes/                # 主题目录
│   └── PaperMod/         # PaperMod 主题
├── static/                # 静态资源
├── layouts/               # 自定义布局
├── hugo.toml              # Hugo 配置文件
├── .gitignore             # Git 忽略文件配置
├── archetypes/            # 内容模板
├── assets/                # 资源文件
├── i18n/                  # 国际化配置
├── draft/                 # 草稿目录
├── public/                # 生成的静态网站（构建输出）
├── CLAUDE.md              # Claude 指令配置
├── template.md            # 文章模板
├── write-guide.md         # 写作指导
└── README.md              # 项目说明

主要特性

1. 中文支持

项目使用简体中文编写
支持 CJK 语言，适合中文内容展示

2. 功能特性

自动代码复制按钮
阅读时间统计
文字计数
响应式设计
深色/浅色主题自动切换
目录显示 (Toc)
社交媒体图标
分页功能

3. 内容管理

按日期归档
分类和标签系统
搜索功能
导航菜单

配置详情

主要配置 (hugo.toml)

baseURL = "https://www.ciphermagic.cn/"
title = "Cipher's Blog"
languageCode = "zh-cn"
defaultContentLanguage = "zh"
theme = "PaperMod"
contentDir = "content"
publishDir = "public"
hasCJKLanguage = true
IsProduction = false
uglyURLs = true

[pagination]
  pagerSize = 10

[permalinks]
  posts = "/:contentbasename"

[menu]
  [[menu.main]]
    identifier = "home"
    name = "首页"
    url = "/"
    weight = 1
  [[menu.main]]
    identifier = "archives"
    name = "归档"
    url = "/archives/"
    weight = 2
  [[menu.main]]
    identifier = "categories"
    name = "分类"
    url = "/categories/"
    weight = 3
  [[menu.main]]
    identifier = "tags"
    name = "标签"
    url = "/tags/"
    weight = 4
  [[menu.main]]
    identifier = "about"
    name = "关于"
    url = "/about/"
    weight = 5

[params]
  defaultTheme = "auto"
  showShareButtons = false
  showReadingTime = true
  showWordCount = true
  dateFormat = "2006年1月2日"
  ShowPostOnHomePage = "list"
  ShowCodeCopyButtons = true
  ShowSocialIcons = true
  SocialIconPosition = "footer"
  googleAnalytics = ""
  ShowToc = true
  TocOpen = true
  disableSpecial1stPost = true

[[params.socialIcons]]
  name = "github"
  url = "https://github.com/ciphermagic"
[[params.socialIcons]]
  name = "twitter"
  url  = "https://x.com/0xCipherMagic"
[[params.socialIcons]]
  name = "telegram"
  url  = "https://t.me/ciphermagic"
[[params.socialIcons]]
  name = "email"
  url  = "mailto:ciphermagic@gmail.com"

[markup]
  [markup.goldmark]
    [markup.goldmark.renderer]
      unsafe = true
  [markup.highlight]
    codeFences = true
    guessSyntax = false
    lineNos = true
    lineNumbersInTable = false
    noClasses = false
    style = "catppuccin-mocha"

内容规范

项目遵循特定的写作指导，确保内容质量：

文章结构

前言部分：阐述写作动机和问题
主体内容：问题分析和解决方案
总结：回顾内容并提供延伸思考

写作要点

使用简洁直接的中文表达
保持技术专业性的同时兼顾可读性
提供完整、可运行的代码示例
包含必要的理论说明和实践指导

标签和分类

分类：按主题分类（如 "技术"、"web3"、"区块链"）
标签：按具体技术关键词标记（如 "java"、"redis"、"go"）

主要功能页面

导航菜单

首页：博客主页
归档：按时间归档的文章列表
分类：按照分类组织的文章
标签：按照标签组织的文章
关于：作者和网站信息

社交连接

开发贡献

文章编写规范

使用提供的模板 template.md 创建新文章
遵循 write-guide.md 中的写作指导
正确配置 frontmatter 元数据
保证代码示例的完整性和可运行性

本地测试

使用 Hugo 的内置服务器进行本地开发
测试文章的显示效果和功能完整性

部署

静态生成的网站文件可在 public/ 目录中找到，可部署到以下平台：

GitHub Pages
Netlify
Vercel
AWS S3
任何支持静态文件服务的主机

许可

本项目遵循 Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) 许可，用于内容分享。代码部分可能遵循各自的许可证。

联系我

邮箱：ciphermagic@gmail.com
GitHub：@ciphermagic
Twitter：@0xCipherMagic
Telegram：@ciphermagic

如果你觉得这些技术分享有帮助，请给我一个 star！⭐️

故障排除

常见问题及解决方案

Hugo 未找到命令
- 问题: 运行 hugo 命令时出现 "command not found" 错误
- 解决方案: 确保已正确安装 Hugo 并添加到系统 PATH 中，或者使用完整路径调用
本地服务器启动失败
- 问题: 运行 hugo server -D 时服务器无法启动
- 解决方案: 检查端口是否被占用，尝试使用 hugo server -D -p 1314 指定其他端口

常见问题

Q: 如何安装和配置 Hugo？

A: Hugo 可以通过多种方式安装，对于 macOS 用户推荐使用 Homebrew: brew install hugo。安装后可通过 hugo version 验证安装成功。

Q: 如何创建新的博客文章？

A: 使用命令 hugo new posts/文章标题.md，然后在 content/posts/ 目录下编辑生成的 Markdown 文件。

FilesExpand file tree

README.md

Latest commit

History