deploy.sh 参考

运行要求复制链接

curl -fsSL -o deploy.sh https://raw.githubusercontent.com/marvinli001/edgeweir/master/deploy.sh
sudo bash deploy.sh install

脚本必须先保存为文件再运行；经管道（curl … | bash）或进程替换（bash <(curl …)）运行时以 1 退出。安装后脚本副本位于 <安装目录>/deploy.sh，其余命令在该目录以 ./deploy.sh <命令> 运行。宝塔 / aaPanel 上的完整流程见 baota.md。

命令复制链接

部署目录复制链接

install、template、help 以外的命令按以下顺序查找部署目录，取第一个匹配项：

1. EDGEWEIR_DIR
2. 脚本所在目录
3. 当前工作目录
4. /www/dk_project/edgeweir
5. /opt/edgeweir

install复制链接

提示复制链接

变量提供默认值；无人值守时即为答案。EDGEWEIR_DB 或 DATABASE_URL 已设置时跳过对应提示。回环地址指 127.*、localhost、::1。

校验复制链接

结果复制链接

1. 解析并拉取镜像版本，见 版本解析。
2. 创建安装目录（700），写入 .env（600）、compose.yml（600）、.compose.cksum 与 deploy.sh（700）。
3. 拉取编排镜像，启动并等待健康检查。
4. 打印运行版本、后续步骤与 setup token。

无人值守安装复制链接

EDGEWEIR_YES 非空，或无法打开 /dev/tty 时，脚本不读取输入：每个提示取默认值或下表变量。

EDGEWEIR_YES=1 EDGEWEIR_DB=bundled \
EDGEWEIR_PUBLIC_URL=https://cdn-admin.example.com \
bash deploy.sh install

EDGEWEIR_NO_PULL=1 需要本机已有控制台镜像的目标 tag（或 latest）与 postgres:18.6-alpine（host 模式的检查与备份、bundled 模式的数据库）。

数据库检查复制链接

host 模式在写入任何文件前检查数据库。检查用 postgres:18.6-alpine（按 digest 固定，与 compose.baota.yml 相同）在 host 网络上运行 psql，密码经环境变量传入，连接超时 8 秒。

检查与备份按 DATABASE_URL 的 sslmode 连接：

update复制链接

./deploy.sh update [tag] [--no-backup] 依次执行：

1. 解析目标版本，见 版本解析。目标等于 .env 中的 EDGEWEIR_VERSION 且容器已运行该版本时，输出 已经是 <版本>。 并以 0 退出。

2. 目标不是 latest 且早于当前版本时视为回退：警告并询问是否继续，默认否。先比较 tag 中的日期；同一天的两个 tag 比较两个镜像的提交时间（标签 org.opencontainers.image.created）。无法判断时（tag 不是 <YYYYMMDD>-<commit>，或同一天但有镜像不在本机）只提示，不询问。

3. 备份到 backups/<时间>-before-<目标版本>/；--no-backup 跳过。备份失败时中止，部署不变。

4. 编排文件与脚本内置模板不同时：

   • 与脚本上次写入的内容相同（按 .compose.cksum）：直接替换为新模板。
   • 写入后被改过：显示差异，询问是否替换，默认保留。
   • 没有 .compose.cksum（较早的安装）：显示差异，询问是否替换，交互模式默认替换，无人值守保留。

   旧文件在第 3 步的备份中；自己的改动放进覆盖文件；./deploy.sh template <模式> 输出模板。

5. 写入 EDGEWEIR_VERSION，按 start 的流程重建容器。数据库迁移在控制台启动时执行。

6. 输出回退命令 ./deploy.sh update <原版本>（仅适用于两个版本之间没有新增迁移时）。

7. 新镜像中的 /app/deploy.sh 与本脚本不同时询问是否替换本脚本，默认替换。

版本策略与回退约束见 upgrade.md。

版本解析复制链接

install 使用同一规则解析 EDGEWEIR_VERSION（默认 latest）。

config复制链接

只能交互运行；无人值守或没有终端时中止，此时直接编辑 .env 后运行 ./deploy.sh start。

1. 询问控制台地址与节点通道地址；回车保留当前值。校验规则同 install。
2. 节点通道地址的端口变化时：EDGEWEIR_NODE_API_PORT 未设置或等于原地址的端口时随之修改，并警告放行新端口、已注册的节点按新地址重新注册；单独设置过的值（例如 nginx stream 透传用的 127.0.0.1:18443）保持不变，并提示自行调整。
3. 节点通道主机名变化时警告：已注册的节点重新注册，或把旧主机名加入 EDGEWEIR_NODE_API_HOSTNAMES。
4. 确认后写入 EDGEWEIR_PUBLIC_URL、EDGEWEIR_NODE_API_URL，以及第 2 步需要修改时的 EDGEWEIR_NODE_API_PORT，按 start 的流程重建容器。

config 不修改 EDGEWEIR_HTTP_PORT，不检查新端口是否被占用。控制台 系统设置 → 节点通道 中保存的地址优先于 EDGEWEIR_NODE_API_URL：保存过地址时，config 改动的节点通道地址不影响安装命令；只改节点通道地址时在系统设置中修改，不需要重启，见 节点通道地址与证书。

启停与可信代理同步复制链接

install、update 与 config 使用 start 的流程。

可信代理的含义见 networking.md。

host 模式启动后按顺序检查节点通道的监听地址，命中一项时警告并停止检查：

self-update复制链接

内容相同时不改动。替换时写入新文件（700）并重命名覆盖本脚本；运行中的进程继续读取旧文件。

生成的文件复制链接

值不加引号。修改某个键时保留其他行与 600 权限。其余变量见 环境变量。

备份复制链接

<目录>/backups/
└── 20260929-153000-before-20260930-b2c3d4e/
    ├── edgeweir.dump
    ├── env
    ├── compose.yml
    └── compose.override.yml   # 存在时

恢复用 restore；手动恢复与恢复验收见 backup.md。

restore复制链接

./deploy.sh restore <备份> [--no-backup] 用备份替换部署的数据库。<备份> 是备份目录（取其中的 edgeweir.dump）或 dump 文件，依次按原样、相对部署目录、相对 backups/ 查找，例如 ./deploy.sh restore 20261001-080000。

1. 检查备份：bundled 先启动 postgres；pg_restore --list 能读取，且含表数据与 drizzle.__drizzle_migrations（控制台的数据库），否则中止。
2. host：DATABASE_URL 的用户须为数据库所有者（或超级用户）且有 CREATEDB 权限，否则中止，改为手动恢复到新数据库。
3. 确认，默认否；无人值守见 确认项。
4. 备份当前数据库到 backups/<时间>-before-restore/，本次不删除旧备份；--no-backup 跳过。备份失败时中止，部署不变。
5. 停止 console。
6. 删除并重建数据库：DROP DATABASE … WITH (FORCE) 与 CREATE DATABASE。bundled 在 postgres 容器内以 edgeweir 执行；host 用 postgres:18.6-alpine 连接 postgres 维护库执行，新库属于 DATABASE_URL 的用户。
7. pg_restore --exit-on-error --single-transaction --no-owner --no-privileges 导入。
8. 按 start 的流程启动并等待健康检查。

退出与中止复制链接

template 与 setup-token 的结果写到标准输出；进度、提示与错误写到标准错误，标准错误是终端时带颜色。