目标

很多软件的官方文档，在国内打开很慢，每次都得等很久，看到官方同时提供了html的包，所以想着挂载到本地nginx下，查看会方便很多。

下载官方html文档包，解压到documentation_htmls下
想添加新的文档也是一样，放到这个目录下就下，刷新页面后就能在页面上访问了

配置nginx conf文件

这里主要需要配置的是default.conf，这个location 配置实现了自动加载/usr/share/nginx/html目录下的文件夹到root的页面下

> vim default.conf
server {
    listen       80;
    listen  [::]:80;
    server_name  localhost;

    location / {
        root /usr/share/nginx/html;
        autoindex_exact_size off;
        autoindex_localtime on; 
        autoindex on;
        charset utf-8,gbk;
        default_type text/plain; 
    }
    ...
}

docker启动nginx

version: '3'
services:
  web:
    container_name: doc 
    image: nginx:latest
    ports:
      - 8080:80
    volumes:
      - ./documentation_htmls:/usr/share/nginx/html
      - ./conf/nginx.conf:/etc/nginx/nginx.conf
      - ./conf/default.conf:/etc/nginx/conf.d/default.conf

问题及解决

通过配置解决了启动后出现一些问题

问题1

原始nginx配置无法自动加载目录问题:
配置 autoindex on;后解决

问题2

中文加载乱码问题
配置charset utf-8,gbk; 解决

问题3

yml json md 等文件无法渲染，在浏览器中会变成直接下载问题
配置default_type text/plain; 解决
虽然md没渲染成正常的md格式，但是text/plain也算勉强能看，再想更好的渲染效果，需要配置一些渲染服务，或者nginx的渲染模型
json格式的渲染，也可以不用text/plain，选择用application/json类型的渲染返回json结果，在default.conf配置中 新增一项即可，
不会与上面的 location / {...}配置冲突，返回结果其实在浏览器上看是一样的

    location ~* \.json$ {
        default_type application/json;
        root /usr/share/nginx/html;
    }

效果

最终显示效果如下：