HEXO 开发笔记(11)自建主题:视觉系统重构
创建于 2026-09-06
更新于 2026-09-09
科技
hexo
theme
css
javascript
accessibility

前言

前面几篇已经介绍了主题的目录、搜索、评论和文章加密等功能。最近继续调整页面时,发现各个组件的颜色和边框不太统一,日间模式还有一些配色没有处理好,侧边栏和页脚在窄屏、短窗口下也有布局问题。

所以这次把相关样式和脚本一起整理了一遍。背景仍然保留星空,补充日间配色和日月切换,同时调整文章的滚动区域。本文记录具体改法,以及布局调整中遇到的几个问题。

...
阅读全文
Homelab 搭建手记(8)通过 Apache Guacamole 访问 Debian 桌面
创建于 2026-09-05
更新于 2026-09-09
科技
Docker
Homelab
Debian
XRDP
Caddy
XFCE
Guacamole

前言

Homelab 搭建手记(6)Debian Xfce 与 XRDP 同用户并发会话配置 中,我已经把 DebianXFCEXRDP 的远程桌面环境调整到可以长期使用;上一篇又通过 Homelab 搭建手记(7)部署 code-server 并配置 HTTPS 访问 把浏览器开发环境接了出来。

不过 code-server 只能提供编辑器和终端,遇到必须使用完整图形界面的程序时,还是需要打开原生 RDP 客户端。这次增加一个浏览器入口:使用 Apache Guacamole 作为 Web Gateway,通过 RDP 连接已有的 xrdp 会话。这样既保留原生 RDP,也可以在平板、轻薄本或临时设备上直接用浏览器进入 Debian 桌面。

配套脚本放在我维护的 homelab-setup 项目中。这个仓库用于初始化 Debian 环境和部署常用服务;这次加入 Guacamole 时,我也整理了有状态服务的目录管理,让生成的配置有固定位置,重新执行脚本时保留已有账号和连接数据。下面会同时说明脚本用法和具体配置。

...
阅读全文
HEXO 开发笔记(10)自建访问统计:用 doratiger-counter 替代卜算子
创建于 2026-09-04
更新于 2026-09-09
科技
hexo
主题开发
Go
SQLite
访问统计

前言

HEXO 开发笔记(6)自建主题:核心功能实现 中,已经记录过主题统计功能从 localStorage 迁移到卜算子,再迁移到自建 counter 的过程。当时的实现能够满足日常使用,但计数数据主要停留在内存中,服务重启后 UV 会重新开始,配置和数据库迁移也还比较粗糙。

这次整理 doratiger-counter,主要补上了 UV 持久化、数据库迁移和退出前同步,也调整了来源校验,避免字符串匹配放过不该接受的域名。下面记录这些改动,以及 DoraTiger 主题如何调用统计接口。

...
阅读全文
Homelab 搭建手记(7)部署 code-server 并配置 HTTPS 访问
创建于 2026-09-03
更新于 2026-09-09
科技
Homelab
Debian
code-server
Caddy
HTTPS
AliDNS

前言

在之前的 Homelab 搭建手记(4)开发工具配置 中,我已经把 VS CodeCodex CLI 等开发工具整理到了 Debian 工作站上。不过桌面远程只是其中一种使用方式:当手边只有平板、轻薄本,或者不方便建立完整的远程桌面时,如果能直接在浏览器中打开开发环境,会更加灵活。

code-server 可以把接近 VS Code 的编辑体验放进浏览器,终端、代码和扩展仍运行在 Homelab 主机上。最开始我直接通过内网 IP 和端口访问,编辑与终端都能使用,看起来部署已经结束;直到在其中运行 Codex 扩展,才发现 WebView 无法正常拉起,并提示当前页面不是安全上下文。

为了解决这个问题,我用 Caddy + AliDNS DNS-01 配置了 HTTPS,并把 code-server 改为只监听本机。本文从安装开始,记录 HTTPS 配置和 Codex 扩展的检查过程。相关安装脚本放在 homelab-setup 项目中,可以配合下面的步骤使用。

...
阅读全文
Homelab 搭建手记(6)Debian Xfce 与 XRDP 同用户并发会话配置
创建于 2026-09-03
更新于 2026-09-09
科技
Homelab
Debian
XRDP
Xfce
Fcitx5
GNOME Keyring

前言

在之前的 Homelab 搭建手记(2)更换无线网卡与 XRDP WiFi 扫描授权问题 中,记录过 XRDP 环境下的 WiFi 扫描授权问题。当时发现本地自动登录的 Xfce 和远程 Xfce 同时运行时容易出现 D-Buspolkit 等额外冲突,所以给出的阶段性建议是关闭本地自动登录,只保留单一的 XRDP 图形会话。

不过实际使用中,偶尔还是需要让物理显示器上的本地桌面保持登录,同时从其他设备通过 RDP 进入同一个用户的独立桌面。经过日志排查和反复测试,发现第二个 Xfce 会话复用了已有图形会话的环境,端口、密码认证和 Xorg 显示编号都没有问题。

本文记录如何在 Debian 13 + Xfce + XRDP 环境中,让同一个 Linux 用户同时保持本地与远程两个桌面,并进一步补齐 Fcitx5 中文输入和 GNOME Keyring,使 VS CodeGitHub Copilot 等依赖系统密钥环的应用也能在远程桌面中正常使用。相关配置已经整合进公开的 homelab-setup 项目,可以通过脚本自动完成。

...
阅读全文
Homelab 搭建手记(5)Obsidian 与 Zotero Linux 部署
创建于 2026-06-21
更新于 2026-06-21
科技
Obsidian
Homelab
Debian
Zotero

前言

知识管理是 Homelab 的核心用途之一。Obsidian 是基于 Markdown 的笔记工具,之前在 Obsidan 日记、记账与自动同步 中记录了 Windows 下的完整配置,包括 Templater 模板、Dataview 数据查询、Remotely Save 同步等。Zotero 则是文献管理工具,支持论文收集、标注和引用,是学术工作流的核心组件。两个工具配合使用,前者管理日常笔记和知识图谱,后者管理文献和引用,形成完整的个人知识管理体系。

现在需要在 Debian 服务器上也部署这两个工具,为后续与本地大模型、RAGFlow 等智能体服务对接打下基础。本文聚焦于 Linux 下的官方安装方式和基础 CLI 使用,插件配置和模板设置不再赘述。

...
阅读全文
Homelab 搭建手记(4)开发工具配置
创建于 2026-06-19
更新于 2026-06-21
科技
Homelab
Claude Code
MiMo
Zellij
AI
GitHub CLI
Gitea

前言

前几篇记录了硬件选购、系统安装和开发环境配置。环境搭好后,下一步是配置日常开发工具。本篇聚焦日常开发的核心工具链:VS Code(远程开发 IDE)、Claude CodeMiMo Code(AI 编程助手),以及 Zellij(终端复用器)。特别是 Zellij 的会话持久化能力,让 TUI 工具断连后依然保持运行。

...
阅读全文
HEXO 开发笔记(9)自建主题:工程化与发布
创建于 2026-06-19
更新于 2026-09-09
科技
hexo
主题开发
DevOps
Git

前言

前几篇记录了 DoraTiger 的功能实现。这篇补上平时维护主题时用到的命令、资源管理和发布流程,也记录一次子模块提交没有推送导致构建失败的问题。

...
阅读全文
HEXO 开发笔记(8)自建主题:搜索与国际化
创建于 2026-06-19
更新于 2026-09-09
科技
hexo
主题开发
搜索
i18n

前言

博客文章多了以后,查找旧内容主要依靠搜索。DoraTiger 保留了 Algolia 和本地搜索两种方式,这篇先记录它们的实现,再整理界面文字的多语言配置,以及评论系统的选型和停用原因。

...
阅读全文
HEXO 开发笔记(7)自建主题:安全与SEO
创建于 2026-06-19
更新于 2026-09-09
科技
hexo
主题开发
安全
SEO

前言

文章加密、外链跳转和 SEO 最早都是通过第三方插件实现的。重构主题时,我把它们移到了内部,方便与页面模板一起调整。下面记录 AES-256-GCM 加密、外链拦截,以及 SitemapRobots.txtJSON-LD 的生成方式。

...
阅读全文