Files
ecs-relay-service/deployment-source/docs/OFFLINE_IMAGES.md
T

54 lines
3.1 KiB
Markdown

# 官方开源镜像与完全离线安装
本次补充的是Linux ARM64镜像,不是AMD64镜像。独立离线包目录包含 `images/`、源码项目、ARM64 wheelhouse、SHA256校验和及安装脚本。
## 镜像来源与许可证
| 镜像标签 | 官方发布来源 | 核心项目许可证 |
|---|---|---|
| python:3.12-slim-bookworm | Docker Official Images / Python | PSF License及其许可历史 |
| postgres:17-alpine | Docker Official Images / PostgreSQL | PostgreSQL License |
| redis:8.2-alpine | Docker Official Images / Redis | 本次选择AGPLv3,而非RSAL/SSPL |
| caddy:2-alpine | Docker Official Images / Caddy | Apache-2.0 |
Docker Hub直连在当前网络超时,本次从Docker Official Images在Amazon ECR Public的公共发布仓库 `public.ecr.aws/docker/library/*`获取。不是第三方重新构建的同名镜像。保留原始镜像config和layer;导出Docker-load格式时逐项验证registry SHA256及解压rootfs diff_id。
`IMAGE_MANIFEST.json`记录index、ARM64 manifest、config与layers摘要及实际下载来源。`VERIFICATION.json`记录校验结果和镜像内版本环境变量。标签可能继续更新,本包具体内容以这些摘要为准;离线安装使用本包内容并禁止重新拉取。
Redis原7.4配置采用RSAL/SSPL,不能笼统称为OSI开源。因此调整到Redis8.2并选择其AGPLv3许可路径。应用使用的AUTH、GETDEL、租约、Pub/Sub等协议在8.2仍提供;本地自动化测试使用FakeRedis,真实Redis8.2运行仍须在目标Docker环境验收。
官方许可来源:
- https://redis.io/legal/licenses/
- https://www.postgresql.org/about/licence/
- https://docs.python.org/3/license.html
- https://github.com/caddyserver/caddy/blob/master/LICENSE
- https://gallery.ecr.aws/docker/library/python
基础发行版和各依赖另有许可证;本表不替代完整SBOM、漏洞扫描或企业开源准入。Redis官方源码和许可链接随离线包提供,使用与再分发遵守所选许可。
## 上传后的操作
服务器已有Docker Engine和Compose v2时:
```bash
tar -xzf hainuo-relay-offline-arm64-0.1.0.tar.gz
cd hainuo-offline-arm64
bash install.sh relay.your-company-domain
```
安装脚本会校验文件、导入四个官方镜像,使用已导入Python基础镜像与本地41项wheel构建服务,然后初始化和启动。构建使用 `--network none --pull=false`,启动使用 `--no-build --pull never`。
海诺服务镜像是本项目源码构建的 `hainuo-relay:0.1.0`,不是冒充某个官方已有服务镜像。本次不包含Docker Engine/Compose宿主软件、不包含业务数据,也不消除配置真实域名、TLS、海能Work凭据及客户端适配的必要性。
配置修改后离线重启:
```bash
cd hainuo-relay
docker compose -f compose.yaml -f compose.offline.yaml up -d --no-build --pull never
# 若选择官方SDK长连接,在配置平台信息后:
docker compose -f compose.yaml -f compose.offline.yaml --profile longconn up -d --no-build --pull never
```
现有普通源码ZIP仍可用于联网构建;完全离线部署请使用新增的整包,而非只传旧源码ZIP。