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

前言

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

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

所以本文的中心不是单独部署一个反向代理,而是完成一条真正可用的 code-server 部署链路:先安装并限制服务只监听本机,再通过 Caddy + AliDNS DNS-01 提供浏览器信任的 HTTPS 入口,最终验证 Codex 智能体所依赖的 WebView 和 Web Crypto 能力。相关安装逻辑已经整理到公开的 homelab-setup 项目中。

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

前言

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

但这个方案本质上是在回避冲突。实际使用中,偶尔还是需要让物理显示器上的本地桌面保持登录,同时从其他设备通过 RDP 进入同一个用户的独立桌面。经过一段时间的日志排查和反复测试,最终确认问题不在端口、密码认证或 Xorg 显示编号,而在第二个 Xfce 会话复用了已有图形会话的环境。

本文记录如何在 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-06-19
科技
hexo
主题开发
DevOps
Git

前言

这是 HEXO 开发笔记系列的最后一篇。前几篇从架构、视觉、功能、安全到搜索,完整介绍了 DoraTiger 主题的设计与实现。本篇收尾,聚焦工程化实践:CLI 命令、CDN 与本地资源管理、CI/CD 自动化、配置文档化,以及发布流程。

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

前言

本篇聚焦 DoraTiger 主题的搜索系统和国际化(i18n)体系。搜索方面涵盖 Algolia 搜索和本地搜索两种方案;国际化方面介绍语言文件结构、占位符机制和全组件覆盖。此外还涉及评论系统的选型与停用原因。

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

前言

本篇聚焦 DoraTiger 主题的安全功能和 SEO 优化。安全方面涵盖文章加密(AES-256-GCM)和外链重定向拦截;SEO 方面涵盖原生 Sitemap/Robots.txt 生成器和 JSON-LD 结构化数据。这些功能最早都是通过第三方插件实现的,在主题重构时选择集成到内部,主要是为了更好的适配性。

...
阅读全文
HEXO 开发笔记(6)自建主题:核心功能实现
创建于 2026-06-19
更新于 2026-06-19
科技
hexo
主题开发
JavaScript

前言

本篇聚焦 DoraTiger 主题的核心功能实现:文章渲染管线、侧边栏双面板、分页系统、归档页面,以及内置的 PV/UV 统计计数器。这些功能构成了博客日常使用中最频繁交互的部分。

...
阅读全文
HEXO 开发笔记(5)自建主题:视觉系统
创建于 2026-06-19
更新于 2026-06-19
科技
hexo
主题开发
CSS
Canvas

前言

上一篇介绍了 DoraTiger 主题的架构设计,本篇聚焦视觉系统:暗色主题的颜色体系、Canvas 动画的实现原理、JS 驱动的响应式布局,以及可复用的 Stylus 动画 Mixin。这些是主题"看起来怎么样"的核心。

...
阅读全文
HEXO 开发笔记(4)自建主题:架构与设计哲学
创建于 2026-06-19
更新于 2026-06-19
科技
hexo
主题开发
架构设计

前言

前几篇笔记介绍了 Hexo 的基础知识、插件体系和进阶功能。从本篇开始,进入 DoraTiger 自建主题的实战开发。本篇作为系列第四篇,聚焦主题的整体架构设计:从 Fan 主题贡献者到独立开发者的转变过程,技术选型背后的思考,以及核心的三层配置合并机制和脚本注入架构。

...
阅读全文