命令行

deploy.sh复制链接

宝塔 / aaPanel 编排部署的安装与运维脚本。用法：./deploy.sh <命令>。

参数、无人值守变量、写入的文件、备份结构与退出行为见 deploy.sh 参考。

节点安装脚本复制链接

install.sh 由控制台在 /install.sh 提供，在节点上安装并注册 edgeweir-node。控制台生成的安装命令已填入 --server 与 --ca-sha256，见接入节点。

export EDGEWEIR_TOKEN='<一次性 token>'
curl -fsSL https://<控制台>/install.sh | sudo --preserve-env=EDGEWEIR_TOKEN bash -s -- \
  --server https://<控制台>:8443 --ca-sha256 <CA 指纹>

选项复制链接

<控制台> 为 EDGEWEIR_PUBLIC_URL，控制台提供脚本时写入。

--token 与 --token=… 被拒绝：命令行参数在进程列表中可见。

校验复制链接

校验通过前不执行任何下载内容。系统要求、执行流程与安装结果见接入节点。

退出码复制链接

脚本不提供升级与卸载。节点升级见节点升级。

Docker Compose复制链接

在 compose.yml 所在目录执行；其他编排文件加 -f <文件>。

只输出 setup token：

docker compose logs --no-color --no-log-prefix console \
  | sed -n 's/.*"setupToken":"\([^"]*\)".*/\1/p' | tail -n 1

/healthz 返回 {"status":"ok","version":"<版本>"}。EDGEWEIR_HTTP_PORT 不是 3000 时改用该端口。升级与回滚步骤见版本、升级与回滚。

容器复制链接

edgeweir-healthcheck：ROLE=worker 时直接返回 0；其他角色请求 http://127.0.0.1:${PORT}/healthz，超时 2 秒，失败返回非 0。

镜像的环境变量默认值见环境变量。

ROLE复制链接

取值 all（默认）、app、worker。各角色运行的组件、监听端口与扩展方式见部署概览。

找回账户复制链接

dist/server/recover.js 为控制台唯一的账户重置密码、停用两步验证，用于无法登录时。它读取与控制台相同的环境变量（DATABASE_URL、EDGEWEIR_MASTER_KEY 等），直接修改数据库，不经过 Web 界面与 HTTP。步骤见 找回账户。

docker compose exec console node dist/server/recover.js --reset-password --disable-two-factor

选项复制链接

至少指定 --reset-password、--disable-two-factor 之一。

新密码复制链接

docker compose exec -T console node dist/server/recover.js --reset-password < new-password.txt

-T 不分配终端，只在从管道或文件输入时使用：在终端里直接输入时密码会显示在屏幕上。密码不接受命令行参数或环境变量：命令行参数在进程列表与 shell 历史中可见。

执行结果复制链接

以下变更与审计条目在同一事务中提交，任一步失败时全部回滚：

姓名、邮箱、通行密钥与 AccessKey 不变。标准输出为账户的姓名与邮箱和完成的操作，不含密码、密码哈希或会话 token：

Account: Ops <admin@example.com>
Password reset.
Two-factor authentication turned off.
Signed out 2 sessions.

退出码复制链接

开发复制链接

要求：Node.js 24.11.0 及以上、pnpm 12.6.0、Docker；helpers/certd 与 pnpm e2e 另需 Go 1.27.1。buf 随开发依赖安装。

本地运行复制链接

1. 安装依赖。

   复制

   pnpm install

2. 启动开发数据库（compose.dev.yml，端口见 DEV_POSTGRES_PORT）。

   复制

   docker compose -f compose.dev.yml up -d

3. 创建 .env，填写 EDGEWEIR_MASTER_KEY（openssl rand -base64 32）。DATABASE_URL 的模板值与开发数据库一致。

   复制

   cp .env.example .env

4. 启动控制台。

   复制

   pnpm dev

5. 验证。

   复制

   curl -s http://localhost:3000/healthz

   预期输出：{"status":"ok","version":"dev"}。

签发证书需要证书助手：cd helpers/certd && go build -o bin/edgeweir-certd .，再把绝对路径写入 EDGEWEIR_CERTD_BIN。

命令复制链接

在仓库根目录执行。

端到端测试复制链接

scripts/e2e.sh 针对 compose.e2e.yml 运行。需要 curl、jq、docker、node；安装脚本步骤另需 goreleaser v2、syft、Go 1.27.1 与同级的 edgeweir-node 源码，签名升级步骤需要 cosign v3.1.3；运行时需要访问 deb.debian.org 与 openresty.org。

docker compose -f compose.e2e.yml up -d --build
pnpm e2e

参数写在脚本后：bash scripts/e2e.sh --up --down。

同一台机器运行第二套环境时，更改 COMPOSE_PROJECT_NAME、各端口、E2E_TAG、E2E_SUBNET 与 E2E_ISOLATED_SUBNET。