# Nginx 1.28 一键部署包

该目录用于在安装了 Docker 的 Linux 服务器上一键部署 Nginx 1.28。默认公网端口为 `80`，映射关系为 `80:80`，容器名为 `nginx-1.28`。

## 文件说明

- `Dockerfile`：以官方 `nginx:1.28` 为基础镜像构建本地镜像 `nginx-oneclick:1.28`。
- `build-image.sh`：构建镜像并导出为 `nginx-oneclick-1.28.tar.gz`，用于离线分发。
- `deploy.sh`：加载镜像包（或自动构建），创建/启动容器并进行 HTTP 验证。
- `docker-compose.yml`：可选的 Compose 部署方式。
- `nginx-oneclick-1.28.tar.gz`：如果随包提供，则优先离线加载，不需要访问 Docker Hub。

## 一键部署

将整个目录复制到目标服务器后执行：

```bash
cd nginx-1.28-deployment
chmod +x build-image.sh deploy.sh
./deploy.sh
```

部署脚本的行为是幂等的：

1. 如果目录中有镜像压缩包，优先执行 `docker load`。
2. 没有镜像包但本机已有镜像时直接复用。
3. 两者都没有时，以 `Dockerfile` 自动构建并拉取 `nginx:1.28` 基础镜像。
4. 创建或启动 `nginx-1.28`，设置 `unless-stopped` 自动重启。
5. 访问 `http://服务器公网IP/` 做 HTTP 检查。

## 构建并导出离线镜像

在可访问 Docker Hub 的 Docker 主机执行：

```bash
./build-image.sh
```

生成的 `nginx-oneclick-1.28.tar.gz` 和 `.sha256` 文件可以与脚本一起复制到无外网服务器。脚本会自动加载该镜像包。

本次服务器上的离线镜像包已生成在：

```text
/opt/nginx-1.28-deployment/nginx-oneclick-1.28.tar.gz
```

对应 SHA-256：`d322ba812dcd3e89fb8c0afd14f27e79e73432f7bc5a5a52324a0ca67e784014`。

## 端口和容器名

默认配置：

```text
公网地址：http://服务器公网IP/
主机端口：80
容器端口：80
容器名：nginx-1.28
```

如 80 端口已被占用，可临时改用主机端口 8080：

```bash
NGINX_HOST_PORT=8080 ./deploy.sh
```

此时访问 `http://服务器公网IP:8080/`。如要更换容器名：

```bash
NGINX_CONTAINER_NAME=nginx-prod ./deploy.sh
```

## 已存在容器的处理

脚本不会默认删除或覆盖同名但配置不同的容器。确认要重建时显式执行：

```bash
FORCE_RECREATE=1 ./deploy.sh
```

该操作会删除并重新创建 `NGINX_CONTAINER_NAME` 指定的容器，不会删除镜像。

## Compose 部署（可选）

```bash
docker compose up -d --build
docker compose ps
curl -I http://127.0.0.1/
```

## 常用运维命令

```bash
docker ps --filter name=nginx-1.28
docker logs --tail 100 nginx-1.28
docker exec nginx-1.28 nginx -v
docker restart nginx-1.28
docker stop nginx-1.28
```

## 安全与公网访问检查

只映射 HTTP 端口时，服务器防火墙/云安全组需要允许 TCP `80`（或自定义的 `NGINX_HOST_PORT`）。部署脚本只负责 Docker 端口发布，不会修改云厂商安全组规则。

不要把 SSH 密码、私钥或生产配置写入该目录。若通过 SSH 远程部署，请使用密钥或交互式认证，并在密码已经暴露后及时轮换。