!GitHub release (latest by date) !Docker Pulls !Docker Image Size !GitHub Workflow Status
Docker 仓库 - bfren 生态系统
一个简单的 Nginx 基础镜像 - 无 SSL 支持等,设计用于代理服务器后端。
文件从 /www/public 提供服务(可通过 BF_NGINX_PUBLIC_OVERRIDE 覆盖)。
| 卷路径 | 用途 |
|---|---|
/www | 此目录中的文件由 Nginx 提供服务(如果未映射,将显示"Welcome to Nginx"消息)。 |
| 变量 | 值 | 描述 | 默认值 |
|---|---|---|---|
BF_NGINX_FORWARD_ACCESS_LOG | 0 或 1 | 如果为 1,访问日志将转发到 Docker 的 stdout。 | 0 |
BF_NGINX_HEALTHCHECK_URI | URI | 健康检查时加载的 URI。 | http://localhost |
BF_NGINX_IGNORE_FAVICON | 0 或 1 | 如果为 1,辅助配置文件将包含指令,当请求 favicon 时返回 204(无内容)。 | 1 |
BF_NGINX_PUBLIC_OVERRIDE | 字符串 | 若设置,将用作 Nginx 根目录(默认根目录为 /www)。 | 空 |
| 函数 | 参数 | 描述 | 使用方法 |
|---|---|---|---|
healthcheck | 无 | 加载 BF_NGINX_HEALTHCHECK_URI 以检查服务是否正常运行。 | docker exec <<容器名>> healthcheck |
nginx-reload | 无 | 测试 Nginx 配置,若成功则重新加载 Nginx 服务器。 | docker exec <<容器名>> nginx-reload |
镜像包含一些实用的 Nginx 配置"辅助文件",位于 /overlay/etc/nginx/helpers,均以"nginx"为前缀:
| 辅助文件 | 描述 |
|---|---|
-base.conf | 基础配置,设置监听端口、文档根目录,并添加 GNU Terry Pratchett 响应头。 |
-ignore-favicon.conf | 对不存在的 favicon.ico 请求返回 204(无内容),并阻止其记录到错误日志。 |
-error-pages.conf | 如需使用 Nginx 默认错误页面,可包含此文件。 |
-static-files.conf | 为静态文件设置实用的响应头、缓存及过期时间。 |
-uploads.conf | 将 client_max_body_size 设置为 0,即不限制文件上传大小。 |
MIT
版权所有 (c) 2020-2025 bfren(除非另有说明)

来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429