edirom/vife-website

ViFE 网站 Docker 镜像文档

1. 镜像概述和主要用途

ViFE 网站 Docker 镜像是一个预打包的容器化解决方案，基于 Nginx 构建，用于快速部署 ViFE 网站应用。该镜像将 ViFE 网站的静态资源与 Nginx 服务集成，提供开箱即用的 Web 服务能力，简化部署流程并确保环境一致性。

2. 核心功能和特性

2.1 Nginx 基础能力

• 高性能 HTTP 服务：基于 Nginx 稳定版本，支持高并发请求处理
• 静态资源优化：内置对 HTML、CSS、JavaScript、图片等静态资源的高效缓存与压缩
• 灵活配置支持：支持自定义 Nginx 配置，满足反向代理、URL 重写、SSL/TLS 等高级需求
• 日志管理：标准 Nginx 访问日志与错误日志输出，便于问题排查

2.2 ViFE 网站特性

• 预构建静态内容：镜像内置 ViFE 网站的预编译静态文件，无需额外构建步骤
• 响应式设计：网站内容自适应不同设备屏幕尺寸（桌面/移动端）
• 易于定制：支持通过挂载自定义目录替换网站内容，实现个性化定制

3. 使用场景和适用范围

3.1 适用场景

• 个人博客或静态网站快速部署
• 小型企业/团队官网展示
• 产品介绍页、活动宣传页等静态内容站点
• 开发/测试环境中快速搭建 ViFE 网站原型

3.2 适用范围

• 对部署效率有要求的场景（无需手动配置 Nginx 和网站文件）
• 需要环境一致性的多节点部署（避免"在我机器上能运行"问题）
• 资源受限环境（容器化部署资源占用可控）

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker Engine (20.10+ 版本)
• 已安装 Docker Compose (可选，用于多容器管理)

4.2 拉取镜像

从 Docker 镜像仓库拉取最新版本镜像：

bash
docker pull vife/website:latest

如需指定版本，替换 latest 为具体标签（如 v1.0.0）：

bash
docker pull vife/website:v1.0.0

4.3 基本运行

4.3.1 快速启动（默认配置）

使用默认配置运行容器，将容器 80 端口映射到主机 8080 端口：

bash
docker run -d \
  --name vife-website \
  -p 8080:80 \
  vife/website:latest

启动后可通过 http://localhost:8080 访问网站。

4.3.2 自定义端口映射

如需映射到主机其他端口（如 80 端口，需 root 权限）：

bash
docker run -d \
  --name vife-website \
  -p 80:80 \
  vife/website:latest

4.4 高级配置

4.4.1 挂载自定义网站内容

替换默认网站内容，挂载本地目录（如 ./my-vife-content）到容器网站根目录：

bash
docker run -d \
  --name vife-website \
  -p 8080:80 \
  -v $(pwd)/my-vife-content:/usr/share/nginx/html \
  vife/website:latest

说明：本地目录需包含 ViFE 网站的静态文件（如 index.html、css/、js/ 等）

4.4.2 自定义 Nginx 配置

挂载自定义 Nginx 配置文件替换默认配置：

bash
docker run -d \
  --name vife-website \
  -p 8080:80 \
  -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf \
  vife/website:latest

注意：自定义配置需确保 Nginx 服务正常启动（可参考 Nginx 官方配置文档）

4.5 Docker Compose 部署示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  vife-website:
    image: vife/website:latest
    container_name: vife-website
    restart: always  # 容器退出时自动重启
    ports:
      - "80:80"       # 主机端口:容器端口
      - "443:443"     # 如需启用 HTTPS，映射 443 端口
    volumes:
      - ./my-vife-content:/usr/share/nginx/html  # 自定义网站内容
      - ./nginx.conf:/etc/nginx/nginx.conf       # 自定义 Nginx 配置
      - ./ssl:/etc/nginx/ssl                     # SSL 证书目录（如启用 HTTPS）
      - ./logs:/var/log/nginx                    # 日志持久化
    environment:
      - NGINX_HOST=example.com                   # 网站域名
      - NGINX_PORT=80                            # Nginx 监听端口

启动服务：

bash
docker-compose up -d

5. 配置参数与环境变量

5.1 环境变量

5.2 常用挂载点

6. 注意事项

1. 权限问题：挂载本地目录时，需确保主机目录权限允许容器内进程（通常为 nginx 用户，UID 101）访问，避免因权限不足导致内容无法加载。

2. 自定义配置验证：修改 Nginx 配置后，建议通过 docker exec -it vife-website nginx -t 验证配置语法正确性，避免容器启动失败。

3. HTTPS 配置：如需启用 HTTPS，需自行准备 SSL 证书（如 Let's Encrypt），并在 Nginx 配置中添加 server 块监听 443 端口，指定证书路径（如 /etc/nginx/ssl/fullchain.pem 和 /etc/nginx/ssl/privkey.pem）。

4. 镜像更新：拉取新版本镜像后，建议先停止并删除旧容器，再启动新容器，避免配置冲突。