宝塔面板 / aaPanel

编排模式复制链接

deploy.sh install 按所选数据库模式写入对应的编排文件。

镜像 ghcr.io/marvinli001/edgeweir 公开，面板中无需添加镜像仓库或登录。tag 格式与版本固定见 upgrade.md。

1. 准备复制链接

其余运行要求见 部署概览。

2. 用 deploy.sh 安装复制链接

1. 下载脚本：

   复制

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

2. 运行安装，依次回答安装目录、数据库模式、数据库连接、控制台地址、节点通道地址。提示与默认值见 deploy-script.md。

   复制

   sudo bash deploy.sh install

   存在 /www/server/panel 时默认安装目录为 /www/dk_project/edgeweir，否则为 /opt/edgeweir。控制台地址填浏览器访问的地址，例如 https://cdn-admin.example.com；节点通道地址默认 https://<控制台域名>:8443。

3. 记录输出末尾的 setup token。

无人值守安装（以 root 运行；变量表见 deploy-script.md）：

EDGEWEIR_YES=1 EDGEWEIR_DB=host \
EDGEWEIR_PUBLIC_URL=https://cdn-admin.example.com \
DATABASE_URL='postgres://edgeweir:<URL 编码的密码>@127.0.0.1:5432/edgeweir' \
bash deploy.sh install

EDGEWEIR_DB=bundled 时不设置 DATABASE_URL。

3. 反向代理与 HTTPS复制链接

面板 nginx 终结 HTTPS，并反向代理到 http://127.0.0.1:3000（EDGEWEIR_HTTP_PORT 改过时替换端口）。

• 证书文件验证失败时改用 DNS 验证。
• 发送域名（Host）保持默认值：控制台只按 EDGEWEIR_PUBLIC_URL 校验请求来源。
• 安装时填写的控制台地址不是 https:// 时，证书生效后运行 ./deploy.sh config 改为 https://。

通用 nginx 配置与请求头见 networking.md。

4. 初始化与验证复制链接

1. 读取 setup token（安装输出中已打印）：

   复制

   cd /www/dk_project/edgeweir   # 安装目录
   ./deploy.sh setup-token

2. 打开 https://cdn-admin.example.com/setup，填入 setup token 与姓名、邮箱、密码，创建控制台账户。初始化向导见 快速上手。

3. 验证 Web 控制台：

   复制

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

   预期：{"status":"ok","version":"<.env 中的 EDGEWEIR_VERSION>"}。

4. 验证节点通道（在另一台主机执行）：

   复制

   openssl s_client -connect cdn-admin.example.com:8443 -servername cdn-admin.example.com </dev/null 2>/dev/null \
     | openssl x509 -noout -issuer

   预期：签发者含 Edgeweir Node Channel CA。

节点发布源与源站地址允许清单在 系统设置 配置，见 集群与系统；GeoIP 数据库在 防护设置，见 防护设置；SMTP 在 告警 页配置，见 SMTP。添加节点见 接入节点；安装命令中的 --server 即 系统设置 的「节点通道」（没有保存地址时为 EDGEWEIR_NODE_API_URL），修改见 节点通道地址与证书。

节点通道端口复制链接

stream 块、原理与验证见 networking.md。宝塔 / aaPanel 上的步骤：

1. 确认面板 nginx 包含 stream 模块：

   复制

   /www/server/nginx/sbin/nginx -V 2>&1 | grep -o -- '--with-stream[^ ]*'

   预期：其中一行恰为 --with-stream。没有该行时使用直接暴露。

2. 将节点通道改到本机 18443，EDGEWEIR_NODE_API_URL 保持 :8443：

   模式	修改
   bundled	.env：EDGEWEIR_NODE_API_PORT=127.0.0.1:18443
   host	.env：EDGEWEIR_NODE_API_PORT=18443、EDGEWEIR_NODE_API_HOST=127.0.0.1

   复制

   ./deploy.sh start

3. 面板的 /www/server/nginx/conf/nginx.conf 已有 stream { } 块，并包含 /www/server/panel/vhost/nginx/tcp/*.conf；不要再加一个 stream 块，nginx -t 会报 "stream" directive is duplicate。新建 /www/server/panel/vhost/nginx/tcp/edgeweir.conf：

   复制

   server {
     listen 8443;
     proxy_pass 127.0.0.1:18443;
     proxy_timeout 1h;
   }

   节点通道域名有 AAAA 记录时再加 listen [::]:8443;。检查并重载：

   复制

   /www/server/nginx/sbin/nginx -t && /www/server/nginx/sbin/nginx -s reload

4. 按第 4 节第 4 步验证。

不用脚本部署复制链接

容器编排复制链接

1. 取得模板：bash deploy.sh template bundled（或 host）的输出，或仓库中的 compose.baota.yml、compose.baota-host.yml。

2. 在面板终端生成 .env 内容（bundled）：

   复制

   cat <<ENV
   EDGEWEIR_MASTER_KEY=$(openssl rand -base64 32)
   POSTGRES_PASSWORD=$(openssl rand -hex 24)
   EDGEWEIR_PUBLIC_URL=https://cdn-admin.example.com
   EDGEWEIR_NODE_API_URL=https://cdn-admin.example.com:8443
   EDGEWEIR_VERSION=20260929-a1b2c3d
   ENV

   host 模式把 POSTGRES_PASSWORD 一行换成 DATABASE_URL=postgres://edgeweir:<URL 编码的密码>@127.0.0.1:5432/edgeweir（云数据库追加 ?sslmode=verify-full）。

3. 添加编排：宝塔 Docker → 容器编排 → 添加容器编排；aaPanel Docker → Compose → Add Compose。名称填 edgeweir，编排内容粘贴模板，.env 栏（aaPanel .env Content）粘贴上一步的输出，创建编排。

4. 确认容器：edgeweir-console 为 healthy；bundled 另有 edgeweir-postgres。

5. bundled 模式设置可信代理：把 deploy.sh 放入编排目录后运行 ./deploy.sh restart，脚本把 Docker 网关地址写入 EDGEWEIR_TRUSTED_PROXIES 并重建容器。手动设置时写入以下命令输出的地址；环境变量在重建容器后生效。

   复制

   docker inspect -f '{{range .NetworkSettings.Networks}}{{.Gateway}}{{end}}' edgeweir-postgres

6. 读取 setup token，按 第 4 节 继续：

   复制

   docker logs edgeweir-console 2>&1 | grep -o '"setupToken":"[^"]*"' | tail -n 1

不用编排：单独创建容器复制链接

面板 创建容器 表单无法设置编排中的只读根文件系统、tmpfs 与 no-new-privileges。需要这些加固时在终端执行 docker.md 中的 docker run 命令。

1. 创建网络 edgeweir：宝塔 Docker → 网络；aaPanel Docker → Network → Add Network；或终端：

   复制

   docker network create edgeweir

2. 创建两个容器：宝塔 Docker → 容器 → 创建容器；aaPanel Docker → Container → Create Container。

   字段	edgeweir-postgres	edgeweir-console
   镜像	postgres:18.6-alpine	ghcr.io/marvinli001/edgeweir:<日期 tag>
   网络	edgeweir	edgeweir
   端口	不映射	127.0.0.1:3000 → 3000；8443 → 8443
   卷	edgeweir-postgres → /var/lib/postgresql	—
   环境变量	POSTGRES_USER=edgeweir、POSTGRES_DB=edgeweir、POSTGRES_PASSWORD=<openssl rand -hex 24 的输出>	ROLE=all、DATABASE_URL=postgres://edgeweir:<同一密码>@edgeweir-postgres:5432/edgeweir、EDGEWEIR_MASTER_KEY、EDGEWEIR_PUBLIC_URL、EDGEWEIR_NODE_API_URL、EDGEWEIR_TRUSTED_PROXIES=<edgeweir 网络的网关>
   重启策略	unless-stopped 或 always	unless-stopped 或 always

   • 控制台容器不设置 EDGEWEIR_VERSION：镜像内该变量表示运行中的版本。

   • 已设置 BETTER_AUTH_SECRET 的部署保留原值。

   • 网关地址：

     复制

     docker network inspect -f '{{range .IPAM.Config}}{{.Gateway}}{{end}}' edgeweir

   • 表单无法把端口绑定到 127.0.0.1 时改用终端 docker run。

3. 升级：拉取新 tag，删除 edgeweir-console，以相同参数和新 tag 重建。数据在 edgeweir-postgres 卷中。升级前备份，见 backup.md。

升级与备份复制链接

在部署目录运行：

cd /www/dk_project/edgeweir
./deploy.sh update                     # 备份后升级到 latest 对应的日期 tag
./deploy.sh update 20260929-a1b2c3d    # 升级或回退到指定 tag
./deploy.sh backup                     # 备份到 backups/<时间>/
./deploy.sh restore backups/<时间>      # 先备份，再用该备份替换数据库

轮换主密钥：.env 中把原值移到 EDGEWEIR_MASTER_KEY_PREVIOUS、写入新的 EDGEWEIR_MASTER_KEY，运行 ./deploy.sh restart；./deploy.sh logs console 出现 no envelope uses EDGEWEIR_MASTER_KEY_PREVIOUS any more 后删除该行，再 ./deploy.sh restart。说明见轮换主密钥。

命令、备份布局与中止行为见 deploy-script.md；版本策略与回退约束见 upgrade.md；恢复见 backup.md。

常见问题复制链接