someara/someara-resume

静态HTML简历Nginx托管镜像

镜像概述

本镜像基于Nginx Web服务器构建，专门用于托管静态HTML格式的个人简历。通过Docker容器化技术，简化静态网页部署流程，无需复杂的服务器配置即可快速上线个人简历网页，提供高效、稳定的Web服务支持。

核心功能与特性

• 高效静态资源服务：采用Nginx作为Web服务器，针对HTML、CSS、JavaScript等静态资源提供高性能处理能力，响应速度快。
• 轻量级设计：基于官方Nginx精简镜像构建，体积小巧（通常小于20MB），资源占用低，启动时间短。
• 灵活自定义：支持通过目录挂载替换默认HTML内容，快速集成个人定制化简历文件（如自定义样式、图片、交互脚本等）。
• 简化部署：无需手动配置Web服务器，通过Docker命令一键启动，支持端口映射、网络配置等基础功能。
• 跨平台兼容：可运行于任何支持Docker的环境（Linux、macOS、Windows及云服务器），部署环境无特殊依赖。

使用场景与适用范围

• 个人求职场景：求职者需要快速创建在线可访问的个人简历，便于招聘方通过链接直接查看。
• 轻量展示需求：适用于追求简洁、高效的个人简历展示方案，无需复杂功能的场景。
• 开发测试场景：开发者本地预览简历网页效果，或快速验证不同HTML布局、样式的展示效果。
• 低配置环境部署：在资源有限的服务器（如个人VPS、树莓派）上高效运行，无需占用大量系统资源。

使用方法与配置说明

前提条件

• 已安装Docker Engine（推荐版本20.10+）
• 本地准备静态HTML简历文件（建议包含index.html及相关资源文件）

基本使用步骤

1. 准备简历文件

将个人简历文件组织为标准静态网站结构，示例目录如下：

my-resume/
├── index.html       # 简历主页（必需）
├── css/             # 样式文件目录
│   └── style.css
├── js/              # 交互脚本目录（可选）
│   └── main.js
└── images/          # 图片资源目录（可选）
    └── avatar.jpg

2. 启动容器（基础版）

通过docker run命令启动容器，将本地简历目录挂载到Nginx静态文件目录：

bash
docker run -d -p 8080:80 -v $(pwd)/my-resume:/usr/share/nginx/html --name resume-server resume-nginx

参数说明：

• -d：后台运行容器
• -p 8080:80：将容器内80端口映射到主机8080端口（可替换为其他端口）
• -v $(pwd)/my-resume:/usr/share/nginx/html：挂载本地简历目录到容器内Nginx静态文件根目录
• --name resume-server：指定容器名称（自定义）
• resume-nginx：Docker镜像名称（实际使用时需替换为具体镜像标签）

3. 访问简历网页

容器启动后，通过浏览器访问 http://localhost:8080 即可查看简历（若部署在远程服务器，替换localhost为服务器IP/域名）。

高级配置

自定义Nginx配置

如需修改Nginx配置（如添加缓存策略、自定义错误页等），可创建自定义配置文件并挂载：

1. 创建本地配置文件 nginx.conf：

nginx
server {
    listen 80;
    server_name localhost;
    root /usr/share/nginx/html;
    index index.html;

    # 自定义缓存策略
    location ~* \.(html|css|js|jpg|png)$ {
        expires 7d;  # 静态资源缓存7天
        add_header Cache-Control "public, max-age=604800";
    }

    # 自定义404页面
    error_page 404 /404.html;
    location = /404.html {
        internal;
    }
}

2. 启动容器时挂载配置文件：

bash
docker run -d -p 8080:80 \
  -v $(pwd)/my-resume:/usr/share/nginx/html \
  -v $(pwd)/nginx.conf:/etc/nginx/conf.d/default.conf \
  --name resume-server resume-nginx

Docker Compose部署（推荐）

创建 docker-compose.yml 文件简化部署：

yaml
version: '3'
services:
  resume-server:
    image: resume-nginx
    ports:
      - "8080:80"  # 主机端口:容器端口
    volumes:
      - ./my-resume:/usr/share/nginx/html  # 简历文件目录挂载
      # - ./nginx.conf:/etc/nginx/conf.d/default.conf  # 可选：自定义Nginx配置
    restart: always  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

容器管理命令

• 查看运行状态：docker ps | grep resume-server
• 查看日志：docker logs resume-server
• 停止容器：docker stop resume-server
• 重启容器：docker restart resume-server
• 删除容器：docker rm resume-server

注意事项

• 确保本地简历目录中存在 index.html 文件，否则Nginx会返回403/404错误
• Windows系统挂载目录时建议使用绝对路径（如 /c/Users/username/my-resume）
• 如需HTTPS支持，可结合反向代理工具（如Caddy、Nginx）配置SSL证书
• 挂载目录权限问题：Linux/macOS下若出现权限错误，可添加 -u root 参数临时解决（生产环境建议配置正确的文件权限）