feat(deploy): 补首装路径,使他人/AI 可照教程从零部署

审计发现 5 处断点(3 处硬阻断):
1. Dockerfile 的 HTTP_PROXY/HTTPS_PROXY 默认指向内网代理 → 他人构建必失败
2. zd-host.sh 是升级脚本(要求已存在 host 模式 navi 容器)→ 新机器第一句过不去
3. docker-compose.yml 是桥接+端口映射,与'统一入口 host 模式'口径冲突
4. 证书文件名约定未文档化(实际来自 gateway.yml 的 certFile/keyFile)
5. 环境变量表不完整、缺 sshpass 依赖说明

本次:
- Dockerfile:代理默认置空,需要时 --build-arg 传入
- deploy/install-host.sh(新):干净机器首次安装,6 步并在任一步失败即停,
  含端口独占检查、证书检查、初始 gateway.yml 生成、apply、四项自检,
  令牌可自动生成并只打印一次;已存在 navi 容器时拒绝执行(引导去 zd-host.sh)
- docker-compose.yml:标注为试用形态,指向 install-host.sh
- README:新增「从零部署(干净机器)」——两条路径分工表、前置条件表、
  完整环境变量表、证书与初始网关配置说明、装完自检命令;自定义文件表登记新脚本

另修:脚本自检原用 /.navi-ping(该路径已按用户要求删除),改用 /conf.yml。
This commit is contained in:
HomeDash Bot
2026-09-12 09:37:45 +08:00
parent cb86557466
commit c0cbdb5efc
4 changed files with 272 additions and 2 deletions

View File

@ -1,3 +1,6 @@
# 试用/单机形态:桥接网络 + 端口映射,适合本机看效果。
# 统一入口形态(对外 3080/8443 + 3081 跳转、统一认证)请用 deploy/install-host.sh,
# 它是 host 网络单容器,不能与下面的端口映射共存。
version: "3.8"
services: