bfren/nginx!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(除非另有说明)

manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务