HomeDash 是一个专为个人家庭网络（Homelab）场景设计的服务导航页。面对日益增多的自托管服务，它通过一个集中化、高可维护性的仪表盘，优雅地解决了跨网络访问、服务信息遗忘、配置繁琐等一系列痛点，将个人数字世界的入口变得井然有序。

1. Homelab 场景下的真实痛点

随着个人服务器和虚拟机上部署的服务越来越多（如 NAS、远程桌面、代码托管、媒体服务器等），管理者常常会陷入“服务管理混沌”：

• 服务入口混乱：大量服务的 IP、端口、协议各不相同，散落在笔记各处，难以记忆和查找。例如，ssh root@192.168.1.10:2222，smb://nas.local/share，http://192.168.1.12:8080。
• 内外网切换繁琐：许多服务同时提供内网和公网访问地址。当用户在不同网络环境下时，需要手动拼接或更换 URL，体验割裂。
• 非标服务描述困难：对于非 HTTP/HTTPS 的服务（如 SSH、SMB、RDP），一个简单的链接无法承载其连接方式、认证信息或使用说明，导致关键信息容易遗忘。
• 运维知识孤岛化：服务的部署细节、定期维护任务（如证书更新、数据备份）等重要操作笔记，通常独立于导航入口，形成信息孤岛，增加了长期维护的心智负担。
• 配置冗余与维护成本高：多个服务的 URL 中可能包含相同的内网 IP 地址或域名，一旦网络结构变更，需要多处修改，费时费力且容易出错。

为解决这些问题，一个单纯的导航页是远远不够的。我们需要一个集服务导航、动态配置、知识管理于一体的综合性解决方案。HomeDash 应运而生。

2. HomeDash 的核心架构与设计哲学

HomeDash 的设计核心是“聚合”与“简化”，通过轻量化的技术栈（Go + SQLite + 原生前端）实现了一个强大而易于维护的导航中心。

统一且丰富的服务管理

• 多协议链接支持：不仅支持标准的 HTTP/HTTPS 链接，还能为 SSH、SMB 等协议提供专门的描述区，清晰展示连接命令、挂载方式等信息。
• 动态 URL 切换：系统支持为每个链接配置内网和外网两个地址。用户只需在前端一键切换网络模式，所有链接将自动更新，无缝适应当前网络环境。
• 集成化运维知识库：链接自带一个基于 Markdown 渲染的说明块，可用于描述服务使用说明。此外，还内置一套文章系统，可用于记录各项服务的运维手册、配置备份、踩坑日记等。这些文档与服务导航在同一平台，便于随时查阅。

高度可维护性

• 链接可视化管理：区别于手动维护和修改静态 HTML 导航站，系统引入了后台管理系统，能够对链接进行统一管理，包括排序、编辑、描述修订和删除。
• 变量维护和替换：为了解决配置冗余问题，系统引入了全局变量机制。管理员可以预定义常用变量（如 {{ .InternalIP }}），并在链接地址和文章内容中引用。当底层IP等信息变更时，只需修改变量值即可全局生效，极大降低了维护成本。

个性化与易用性

• 自定义背景：支持将背景设置为 Bing 每日壁纸或自定义图片 URL，满足个性化审美需求。
• 轻量化部署：基于 Go 和 SQLite，整个应用是一个单一的二进制文件，无外部依赖，资源占用极低，非常适合在低功耗设备（如树莓派、小型 VPS）上部署。

3. 典型使用场景

场景一：管理家庭内网的各类服务

用户在后台添加一个指向内网 ddns-go 服务的链接。

• 名称：DDNS-GO 管理
• 内网 URL：http://{{ .DDNS_IP }}:9876
• 外网 URL：留空（仅内网访问）
• 描述：用于动态更新域名与公网 IP 的映射关系。

同时，在后台“设置”中定义变量 DDNS_IP 为 192.168.2.10。前端访问时，链接将自动解析为 http://192.168.2.10:9876。

场景二：记录和查阅运维手册

管理员需要定期为 Calibre Web 服务更新 HTTPS 证书。他可以在 HomeDash 的文章系统中创建一篇题为《Calibre Web 证书更新指南》的文档，详细记录操作步骤。

当需要维护时，直接在导航页旁边的文章区找到该指南，按步骤操作即可，避免了遗忘和重复摸索。

场景三：内外网无缝访问博客

用户部署了一个公开访问的博客，同时希望在内网能通过IP直接访问以获得更快速度。

• 名称：我的技术博客
• 内网 URL：http://{{ .BLOG_IP }}:8000
• 外网 URL：https://my-blog.com

当在家中时，切换到“内网模式”，点击链接即可访问本地地址。当在外时，使用“外网模式”，访问公网域名。

4. 总结

HomeDash 不仅仅是一个简单的导航页，它是一个围绕 Homelab 服务管理痛点构建的、有思想的解决方案。它将服务入口、网络环境、运维知识和个性化设置融为一体，通过全局变量等设计大幅降低了长期维护的复杂性。对于任何拥有多个自托管服务的用户而言，HomeDash 提供了一个化繁为简、提升幸福感的“数字家庭中枢”。