HomeDash

jianf/HomeDash

Fork 0

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	e7578aa607	feat(cert): cert-agent —— 容器内自签自续 HomeDash 自己的证书用户决策：scope=self-only，strategy=full-acme（容器内跑完整 acme.sh）。 ## 动机此前 HomeDash 的证书由外部链路提供（.106 acme.sh → .60 → 云主机），而容器是只读挂载 /etc/nginx/certs（RW=false），续期后没人告诉它的 nginx 重新握手。本 agent 让 HomeDash 自己闭环：签发 → 写数据卷 → reload。 ## 实现 - deploy/cert-agent.sh：supervisord 新增 [program:cert-agent] - 域名从 /app/data/gateway.yml 的 host 提取（或 CERT_DOMAINS 显式指定） - acme.sh 装进数据卷 /app/data/acme（容器重建不丢续期状态） - install-cert 到 /app/data/certs/，--reloadcmd 设为 nginx -t && nginx -s reload - 续期后比对公钥指纹，变了才 reload（不盲目 reload） - 未配置 CERT_DNS_CRED 时安静退出，行为与现在完全一致 - 证书目录挂载去掉 :ro（自签需要写；此前只读是刻意的保护） - zd-host.sh 的 env 白名单加 CERT_ 前缀，否则升级时凭据传不进新容器 - install-host.sh 同步支持 CERT_DNS_CRED，避免两套脚本行为不一致 - 证书路径改为数据卷 /app/data/certs/（gateway.yml 指向它） ## 测试（沙箱 stub，非真实签发） - 无凭据 → 安静退出、exit 0、不调 acme、不报错 - 有凭据 → 正确从 gateway.yml 提取 2 个域名、识别 dns_ali、签发参数正确、指纹变化后触发 reload ## 途中修掉自己的两个真 bug ① run_acme 里用 `set -- $DOMAINS` 改函数位置参数，dash 下与后续变量展开冲突 ② LE_RELOAD 是命令串，直接当命令名执行 → "LE_RELOAD: not found"，容器里 reload 会静默失效；改为函数 + eval ## 边界只管 HomeDash 自己；introduce/sdk.homeagent 等仍走外部链路。凭据只从环境变量读，不落盘不入库。	2026-10-04 08:02:41 +08:00
JianFeeeee	aa237868c1	feat(deploy): let data volume override SearXNG settings SearXNG 的配置原本只能靠镜像内置的 /etc/searxng/settings.yml，于是代理（outgoing.proxies）这类部署相关配置每次重建容器都会丢，改配置也必须重建镜像。改为：容器启动时若存在 /app/data/searxng-settings.yml 就用它，否则回退到镜像内置配置。用 sh -c 包一层是因为 supervisord 的 environment= 不支持条件判断。注意必须带 [ -f ] 判断：实测 SEARXNG_SETTINGS_PATH 指向不存在的文件时 SearXNG 会直接报错退出（PermissionError: ... not exists!）。已验证：SEARXNG_SETTINGS_PATH 指向自造配置能正确覆盖端口与实例名。 README 补充配置优先级与数据卷备份清单。	2026-09-11 11:09:33 +08:00
JianFeeeee	7e49d2b51c	feat: HomeDash - unified self-hosted navigation portal Single-container navigation service combining: - Dashy dashboard + SearXNG metasearch + history sync API + admin WebUI - Go services for history/admin APIs, nginx as unified entry - Browser extensions (Chrome MV3 / Firefox MV2) with 30s batched sync - Production guide: portal-nginx unified auth reverse proxy + webui4frpc/frp tunnel - Fully sanitized (no internal IPs/domains/credentials)	2026-09-08 22:25:00 +08:00

Author

SHA1

Message

Date

JianFeeeee

e7578aa607

feat(cert): cert-agent —— 容器内自签自续 HomeDash 自己的证书

用户决策：scope=self-only，strategy=full-acme（容器内跑完整 acme.sh）。

## 动机
此前 HomeDash 的证书由外部链路提供（.106 acme.sh → .60 → 云主机），
而容器是**只读**挂载 /etc/nginx/certs（RW=false），续期后没人告诉它的
nginx 重新握手。本 agent 让 HomeDash 自己闭环：签发 → 写数据卷 → reload。

## 实现
- deploy/cert-agent.sh：supervisord 新增 [program:cert-agent]
  - 域名从 /app/data/gateway.yml 的 host 提取（或 CERT_DOMAINS 显式指定）
  - acme.sh 装进**数据卷** /app/data/acme（容器重建不丢续期状态）
  - install-cert 到 /app/data/certs/，--reloadcmd 设为 nginx -t && nginx -s reload
  - 续期后比对公钥指纹，变了才 reload（不盲目 reload）
  - 未配置 CERT_DNS_CRED 时安静退出，行为与现在完全一致
- 证书目录挂载去掉 :ro（自签需要写；此前只读是刻意的保护）
- zd-host.sh 的 env 白名单加 CERT_ 前缀，否则升级时凭据传不进新容器
- install-host.sh 同步支持 CERT_DNS_CRED，避免两套脚本行为不一致
- 证书路径改为数据卷 /app/data/certs/（gateway.yml 指向它）

## 测试（沙箱 stub，非真实签发）
- 无凭据 → 安静退出、exit 0、不调 acme、不报错
- 有凭据 → 正确从 gateway.yml 提取 2 个域名、识别 dns_ali、
  签发参数正确、指纹变化后触发 reload

## 途中修掉自己的两个真 bug
① run_acme 里用 `set -- $DOMAINS` 改函数位置参数，dash 下与后续变量
   展开冲突
② LE_RELOAD 是命令串，直接当命令名执行 → "LE_RELOAD: not found"，
   容器里 reload 会**静默失效**；改为函数 + eval

## 边界
只管 HomeDash 自己；introduce/sdk.homeagent 等仍走外部链路。
凭据只从环境变量读，不落盘不入库。

2026-10-04 08:02:41 +08:00

JianFeeeee

aa237868c1

feat(deploy): let data volume override SearXNG settings

SearXNG 的配置原本只能靠镜像内置的 /etc/searxng/settings.yml，
于是代理（outgoing.proxies）这类部署相关配置每次重建容器都会丢，
改配置也必须重建镜像。

改为：容器启动时若存在 /app/data/searxng-settings.yml 就用它，
否则回退到镜像内置配置。用 sh -c 包一层是因为 supervisord 的
environment= 不支持条件判断。

注意必须带 [ -f ] 判断：实测 SEARXNG_SETTINGS_PATH 指向不存在的
文件时 SearXNG 会直接报错退出（PermissionError: ... not exists!）。

已验证：SEARXNG_SETTINGS_PATH 指向自造配置能正确覆盖端口与实例名。
README 补充配置优先级与数据卷备份清单。

2026-09-11 11:09:33 +08:00

JianFeeeee

7e49d2b51c

feat: HomeDash - unified self-hosted navigation portal

Single-container navigation service combining:
- Dashy dashboard + SearXNG metasearch + history sync API + admin WebUI
- Go services for history/admin APIs, nginx as unified entry
- Browser extensions (Chrome MV3 / Firefox MV2) with 30s batched sync
- Production guide: portal-nginx unified auth reverse proxy + webui4frpc/frp tunnel
- Fully sanitized (no internal IPs/domains/credentials)

2026-09-08 22:25:00 +08:00

3 Commits