Files
KodouWZF 4eb67e246e feat(交付): 客户侧两台服务器离线部署包
内网机/外网机各起一套栈,两台之间不开任何端口,文件只经光闸在
gate/out 与对端 gate/in 之间单向摆渡。一份 compose + 一份 config +
一份 nginx 模板,全部差异收在 .env 里。

- docker-compose.yml:5 服务只发布前端端口;app 容器 IP 锁死并由
  compose 注入 -Dcode.snowflake.workid.<IP>=<WORK_ID>,绕开兜底 99
  超雪花 5 位上限导致启动即崩的问题
- .env.iw / .env.ow:出厂配置与随机口令已填好,仅 MESHSAFE_SECRET
  故意留占位(以 MeshSafe 侧白名单为准);按 maintainer 决定原样入库
- install.sh iw|ow:按角色建 .env -> 自检 -> sha256 校验 tar -> 架构
  核对 -> docker load 后校验 tag -> 建目录/属主/SELinux 标签 -> 起栈
  并逐个等健康。修掉 pipefail 下 `grep | head -1` 静默中断、架构字段
  误读 manifest.json(实际在 Config blob)、die() 未定义先被调用
- export-images.sh:就地刷新 images/*.tar、sql、.env 的 tag 与
  SHA256SUMS,再打 dist 交付盘;tar 与 SHA256SUMS 由 .gitignore 排除
- sql/01+02:从 backend/db 的 PG 全量与初始数据覆盖拷贝。三个
  upgrade-*.sql 的 PG 段(x_upload_config、x_file_security)已在
  init-table-postgres-full.sql 内,空库跑 01->02 即完整现状
- smoke_test.py:18 条断言的现场验收,凭证全部走环境变量
- 部署说明.md:拓扑、交付清单、出厂口令表、iw/ow 差异、验收清单、
  13 条已知坑

镜像 tar 不进 git,装机包由 export-images.sh 出盘。
2026-11-02 20:40:16 +08:00
..

建表与初始数据脚本已随包放好,文件名前缀决定执行顺序(先建表后灌数据):

文件 来源 说明
01-init-table.sql backend/db/init-table-postgres-full.sql 全量 DDL,含 x_file_security 安全检测表
02-init-data.sql backend/db/init-data.sql admin 账号、机构、平台编码(system.code=1 要与此一致)

出盘时用 scripts/export-images.sh 从仓库重新覆盖这两份,别手改副本; 增量升级脚本(backend/db/upgrade-*.sql)不在这里,装好后按《部署说明.md》第 7 节人工执行。

只有 POSTGRES_* 指向的库为空时,PostgreSQL 官方镜像才会执行 docker-entrypoint-initdb.d; 数据目录已有数据时会跳过 —— 想重建就把 $SFILE_DATA_ROOT/pgdata 一起清掉再 up。