# 网站容器

镜像在独立构建阶段编译 Vue 和启用 CGO 的 Go 程序。最终镜像运行单个 `webserver` 进程，同时提供静态资源和 API。容器配置、SQLite、上传文件和日志由部署机挂载。

## 构建和验证

需要 Linux Docker Engine 和 Buildx。在源码根目录运行：

```sh
docker build -t autolibrary-web:local .
bash deploy/smoke-container.sh autolibrary-web:local
```

冒烟测试使用临时配置和空数据库，在无外部网络的容器里验证首页、后端健康检查、深层路由、静态资源、SQLite API 和 SIGTERM 退出。

Gitea Actions 在 `main` 和 `container-ci` 推送时执行同一套镜像构建和冒烟测试。专用 Runner `hk-vps-runner-02` 使用 `linux-amd64-docker-small` 标签，作业在 Docker CLI 容器中运行。给构建作业提供专用 rootless Docker daemon，工作流会检查 daemon 的 rootless 标志。镜像仓库推送和生产切换需要单独接入。

## 使用现网配置

生产机运行 Compose v2。复制 `/home/autolibrary/config.json` 到独立文件，将 `frontend.static.path` 设置为 `./frontend/dist`。数据库路径使用 `./backend/data/` 下的现有相对路径。保留前端端口 `3003`、后端端口 `8080` 和 Casdoor 地址 `http://127.0.0.1:8000`。Compose 使用 Linux 宿主机网络，让 Nginx 和 Casdoor 继续通过原有地址连接。

从部署机设置以下环境变量。镜像可以用提交 SHA 标签或不可变的镜像摘要引用：

```dotenv
AUTOLIBRARY_IMAGE=autolibrary-web:<提交SHA>
AUTOLIBRARY_CONFIG=/绝对路径/网站容器配置.json
AUTOLIBRARY_DATA_DIR=/home/autolibrary/backend/data
AUTOLIBRARY_LOG_DIR=/home/autolibrary/logs
AUTOLIBRARY_UID=996
AUTOLIBRARY_GID=987
AUTOLIBRARY_HTTP_PORT=3003
```

配置文件对容器运行身份可读，数据目录及日志目录可写。Compose 会检查挂载源是否存在。

正式切换前，先用独立端口和数据库副本验证容器，并备份数据库和上传文件。切换时停止占用相同端口的 `autolibrary-webserver.service`，运行 `docker compose up -d --wait`，然后验证 Nginx 入口、登录及上传。若首次切换失败，停止网站容器，再启动原网站服务。后续发布可将 `AUTOLIBRARY_IMAGE` 指回上一个镜像，再运行 `docker compose up -d --wait`。程序回退继续使用同一份持久数据。