homer 是一个面向家庭自建服务的统一入口客户端，提供 Android APK 与 Windows EXE 双端。它的目标很直接：一次登录，进入家里所有服务，避免在 Gitea、Memos、Navidrome、FileBrowser、Jellyfin、OpenList、监控台、量化 AQF 等应用之间反复输入账号密码。客户端通过 Authelia 会话与头信任/OIDC 等方式实现多数服务免登，Vaultwarden 等安全敏感服务仍保留单独登录。
为解决家庭网络入口多变的问题，homer 在启动和网络切换后并行探测局域网、Tailscale、公网三条隧道，按可达性与耗时自动选择最快入口，并在界面提示切换结果。当前资料对应 APK v0.6.3 与 EXE v0.6.1，已在多台 Android 设备、redroid64 容器和 Windows EXE 上实测；文档同时说明部分旧设备 WebView 兼容性、DSH 的 HTTP Basic 限制以及收网后的 DNS 前提。
功能
- 一次登录访问多个家庭服务，Gitea、Memos、Navidrome、FileBrowser、Jellyfin、OpenList 等可零点击进入
- 启动及网络切换后并行探测局域网、Tailscale、公网三条隧道，自动选择最快入口
- 登录仅保留 30 天会话，不保存密码；门户注销为全局退出
- 服务页展示步骤、耗时、HTTP 码与实时日志，支持复制日志排查
- 浅色/深色/跟随系统与多种壁纸，宽屏日志自动停靠右侧
- 适配手机、平板、横屏与 Windows EXE，按卡片宽度自动计算列数
技术栈
使用 / 部署教程
1. 选择安装包
- Android 7.0+：安装
build/hub/hub.apk（v0.6.3）。首次安装若提示“未知来源”，允许即可。 - Windows 10/11 x64：解压
build/exe/dist/hub-win-x64.zip（v0.6.1），双击hub.exe。程序未签名，SmartScreen 选择“更多信息 → 仍要运行”。
2. 首次登录
打开客户端，Hub 地址默认 https://xiejun-server.top，用户 xiejun，密码填写自己的 Authelia 密码。登录成功后进入服务网格；客户端不保存密码，只保留 30 天会话。登录页底部会显示当前入口及耗时。
3. 确认入口
客户端会在启动和网络切换后并行探测局域网、Tailscale、公网，并自动选择最快可用线路。若入口变化，网格顶部会提示“入口切换：<名称> <ms>ms”。需要强制重探时，退出重进即可。
4. 使用与排查
在“设置 → 外观”中调整浅色/深色/跟随系统及壁纸。进入服务页可查看步骤、耗时、HTTP 码；点右上“日志”可查看实时日志并复制。遇到登录过期、401、白屏、证书错误时，按提示重试或换设备；仍无法解决时复制日志排查。
5. 网络前提
家里 Wi‑Fi 设备需将 DNS 指向 AdGuard 192.168.50.164，否则域名可能解析到公网 IP；不能改 DNS 的设备可安装并登录 Tailscale，让客户端自动切换到 Tailscale 入口。
常见问题
homer 支持哪些平台？
资料提供 Android APK（Android 7.0+）和 Windows 10/11 x64 EXE 两个客户端，对应 APK v0.6.3、EXE v0.6.1。
为什么登录后有些服务还要再点一下？
Open WebUI 和 PhotoPrism 需点一次 Authelia 继续；Vaultwarden 因主密码安全设计需单独登录；DSH 使用 HTTP Basic，App 内弹不出该框，建议电脑使用。
入口如何选择？
客户端启动和网络切换后并行探测局域网、Tailscale、公网，自动选最快可达线路，并在变化时提示。
页面白屏怎么办？
可能是页面脚本与当前 WebView 不兼容。点“重试”，仍不行换手机/电脑打开；可复制服务页日志排查。
注意
- 公网目前只剩 blog.xiejun-server.top；家里 Wi‑Fi 设备必须把 DNS 指到 AdGuard 192.168.50.164，否则除博客外的服务可能连不上。
- Windows EXE 未签名，首次运行需在 SmartScreen 中选择“更多信息 → 仍要运行”。
- 客户端不保存密码，只保留 30 天会话；门户注销会全局退出所有服务。
评论
加载中…