当前位置：首页 > news >正文

使用 NGINX 实现 HTTP Basic 认证ngx_http_auth_basic_module 模块

news 来源：原创 2025/8/22 8:35:18

一、前言

在 Web 应用中，对部分资源进行访问控制是十分常见的需求。除了基于 IP 限制、JWT 验证、子请求校验等方式外，最经典也最简单的一种方式便是 HTTP Basic Authentication。NGINX 提供的 ngx_http_auth_basic_module 模块支持基于用户名和密码的基本认证，搭配密码文件使用即可快速生效，适合临时保护内网站点、管理后台或演示环境。

本文将介绍该模块的基本原理、配置方式、安全注意事项，以及配套使用 htpasswd 工具生成密码文件的实践步骤。

二、模块简介

模块名称：ngx_http_auth_basic_module
主要用途：限制资源访问，要求客户端输入用户名和密码进行认证
认证方式：基于 HTTP 标准的 Basic 认证协议
依赖文件：密码文件 htpasswd，包含加密后的用户名密码对

三、基本配置

示例：

location /admin/ {auth_basic "Admin Area";                 # 认证提示字符串（realm）auth_basic_user_file /etc/nginx/.htpasswd; # 密码文件路径
}

用户访问 /admin/ 时，将收到 401 提示，浏览器弹出认证对话框，需输入有效的用户名和密码才能访问。

四、指令详解

1. `auth_basic`

auth_basic "提示字符串" | off;

启用 Basic 认证，并设置提示信息（如“Protected”）
使用 off 可取消继承自上级的认证设置

2. `auth_basic_user_file`

auth_basic_user_file /路径/文件名;

指定密码文件路径
支持变量（如 $document_root)
文件格式支持多种加密方案，详见下节

五、密码文件格式与生成

支持的密码格式包括：

crypt() 加密：传统 Unix 加密方式，兼容性强
MD5 (apr1)：Apache 的变体，加密强度较高
SSHA / SHA：OpenLDAP/Dovecot 使用，但不推荐使用 SHA（无盐，易被彩虹表攻击）

推荐方式：使用 Apache 提供的 `htpasswd` 工具生成

安装：

Ubuntu / Debian：

sudo apt install apache2-utils

Mac（通过 Homebrew）：

brew install httpd

创建密码文件：

# 创建新文件并添加用户
htpasswd -c /etc/nginx/.htpasswd admin# 添加其他用户（无需 -c）
htpasswd /etc/nginx/.htpasswd user2

执行后输入密码，文件内容示例：

admin:$apr1$Jz2Wx...$gDzVpzESXk3evm7aTnt1C1
user2:$apr1$T5bsw...$EOczxO2wqlfy5Iod5kZqf/

注：该文件权限建议设置为 640，并限制仅 NGINX 用户可读。

六、进阶用法

1. 结合 IP 限制：使用 `satisfy` 指令

location /internal/ {satisfy any;allow 192.168.0.0/24;deny all;auth_basic "Restricted";auth_basic_user_file /etc/nginx/.htpasswd;
}

上述配置表示：来自内网地址即可访问，其他请求必须通过 Basic 认证。

2. 区块级控制：仅保护部分接口或目录

location /docs/private/ {auth_basic "Docs Login";auth_basic_user_file /etc/nginx/docs_passwd;
}

用于保护在线文档、临时演示页等。

七、安全注意事项

认证信息为明文传输，强烈建议配合 HTTPS 使用
密码文件中不可使用明文密码，需使用加密方式存储
不推荐使用 {SHA}，应优先使用 apr1 或 bcrypt（OpenResty 用户可结合 Lua 模块）
大量用户时，建议使用数据库认证方式或 JWT 替代 Basic Auth

八、总结

NGINX 的 ngx_http_auth_basic_module 提供了简单而高效的认证机制，尤其适用于中小型项目的访问控制、临时资源保护等场景。通过几行配置和一个 htpasswd 文件即可快速上线认证机制。结合 satisfy 实现复合控制，还可支持灵活的访问策略。

尽管 Basic Auth 存在加密弱点，但在内网或搭配 HTTPS 使用场景下，依旧是一个便捷的工具。掌握该模块，有助于你在各类 Web 项目中快速构建轻量级的访问控制体系。

使用 NGINX 实现 HTTP Basic 认证ngx_http_auth_basic_module 模块

一、前言在 Web 应用中，对部分资源进行访问控制是十分常见的需求。除了基于 IP 限制、JWT 验证、子请求校验等方式外，最经典也最简单的一种方式便是 HTTP Basic Authentication。NGINX 提供的 ngx_http_auth_basic_module 模块支持基于用户名和密码的基…...

编程日记 2025/8/22 8:35:18

014枚举之指针尺取——算法备赛

枚举是数据结构与算法中基本的操作，常用于解决序列的区间问题。算法界将"双指针"视为其重要分支，类似地当然还有"三指针"，“四指针”，最常见的还是“双指针”，我认为它们应统称为“指针尺取”。双…...

编程日记 2025/8/22 15:52:46

Python小酷库系列：bidict，可以双向查询的dict

bidict，可以双向查询的dict 基本使用创建双向字典正向查找（key → value）反向查找（value → key）添加新项删除项进阶功能使用 ~ （.inverse）获取逆映射使用 namedbidict 创建具名双向字典批量更…...

编程日记 2025/8/22 16:00:02

Android Compose 中 CompositionLocal 的全面解析与最佳实践

CompositionLocal 在 Android Compose 中的详细总结核心概念 CompositionLocal 是 Jetpack Compose 提供的一种隐式数据传递机制，允许数据在组件树中向下传递，而无需显式地通过每个 Composable 函数的参数传递。两种创建方式 1. staticComposition…...

编程日记 2025/8/21 19:54:53

Qt开发：容器组控件的介绍和使用

文章目录一、Group Box（分组框）1.1 QGroupBox 简介1.2 基本用法1.3 设置为可勾选（可启用/禁用子控件）1.4 信号与槽连接（监控勾选状态）1.5 布局示例（完整） 二、Scroll Area&#xff…...

编程日记 2025/8/20 4:20:58

JS逆向入门案例1——集思录登录

JS逆向入门案例1——集思录登录前言声明网站流程分析总结前言由于这段时间本职工作比较繁忙，没有很多空余的时间去研究各大厂的加密风控了，想起来自己刚接触js逆向走过坎坷，所以决定出一期js入门案例分析，为刚接触js逆向的小伙…...

编程日记 2025/8/20 4:20:56

ARM子程序和栈

微处理器中的栈由栈指针指向存储器中的栈顶来实现，当数据项入栈时，栈指针向上移动，当数据项出栈时，栈指针向下移动。实现栈时需要做出两个决定：一是当数据项进栈时是向低位地址方向向上生长（图a和图b&a…...

编程日记 2025/8/20 4:20:54

笔试专题（十五）

文章目录排序子序列题解代码消减整数题解代码最长公共子序列(二)题解代码排序子序列题目链接题解 1. 贪心模拟 2. 1 2 3 2 2 应该是有两个排列子序列的，所以i n-1时ret 3. 把水平的位置和上升部分，水平位置和下降部分分为一个排列子序列代…...

编程日记 2025/8/19 10:46:52

使用OpenCV 和 Dlib 进行卷积神经网络人脸检测

文章目录引言1.准备工作2.代码解析2.1 导入必要的库2.2 加载CNN人脸检测模型2.3 加载并预处理图像2.4 进行人脸检测2.5 绘制检测结果2.6 显示结果 3.完整代码4.性能考虑5.总结引言人脸检测是计算机视觉中最基础也最重要的任务之一。今天我将分享如何使用dlib库中的CNN人脸检…...

编程日记 2025/8/20 4:20:50

某信服EDR3.5.30.ISO安装测试（一）

一、前言 1.某信服EDR3.5.30 以下简称“EDR3.5”，即统一端点安全管理系统aES(终端检测响应EDR)， 官网最新版：aES6.0.1R2，可下载的最低版本：EDR3.7.11R3， 下载地址：统一端点安全管理系统aES-…...

编程日记 2025/8/20 4:20:48

Dify 快速构建和部署基于LLM的应用程序

本文先对Dify做一个初步的认识，然后以一个实际的简单金融问答案例，配置chatflow 工作流。一、Dify简介如果你是第一次接触Dify，可以先创建一个简单的聊天助手，初步感觉一下，Dify在构建聊天问答类应用的过程。比如…...

编程日记 2025/8/19 10:40:54

精益数据分析（40/126）：移动应用商业模式的关键指标与盈利策略

精益数据分析（40/126）：移动应用商业模式的关键指标与盈利策略在创业和数据分析的探索之路上，我们持续挖掘不同商业模式的内在规律，以寻求更好的发展机遇。今天，我们依旧秉持共同进步的理念，深…...

编程日记 2025/8/20 2:52:58

JavaScript 实现输入框的撤销功能

在 Web 开发中，为输入框添加撤销功能可以极大地提升用户体验，方便用户快速回滚到之前的输入状态。本文将通过一段简单的 HTML、CSS 和 JavaScript 代码，详细介绍如何实现输入框的撤销功能。整体实现思路利用 JavaScript 监听输入框的inpu…...

编程日记 2025/8/20 4:20:43

【C++】类和对象(一)

前言类和对象第一部分知识包括定义访问限定符类域实例化this指针本人其他文章：恋风诗文章中的源码[gitte]：mozhengy 类和对象（一） 前言1. 类的定义引例1.1 类定义格式1.2 类的访问限定符1.3 类域 2. 实例化2.1 实例化概念2.2 …...

编程日记 2025/8/21 10:27:21

【Vue】Vue3源码解析与实现原理

个人主页：Guiat 归属专栏：Vue 文章目录 1. Vue 3 架构概览1.1 模块化设计1.2 整体流程 2. 响应式系统2.1 响应式原理2.2 ref 和 reactive2.3 依赖收集与触发更新 3. 渲染系统3.1 虚拟DOM设计3.2 渲染管线3.3 Patch算法与Diff优化 4. 组件系统4.1 组件创建…...

编程日记 2025/8/20 4:20:39

黑马点评day02(缓存)

2、商户查询缓存 2.1 什么是缓存? 前言:什么是缓存? 就像自行车,越野车的避震器举个例子:越野车,山地自行车,都拥有"避震器",防止车体加速后因惯性,在酷似"U"字母的地形上飞跃,硬着陆导致的损害,像个弹簧一样; 同样,实际开发中,系统也需要"避震…...

编程日记 2025/8/20 4:20:38

文章目录 1. 聚合函数1.1 COUNT() 函数1.2 SUM() 函数1.3 AVG() 函数1.4 MIN() 函数1.5 MAX() 函数 2. GROUP BY 子句2.1 使用 GROUP BY 进行数据分组2.2 结合聚合函数 3. HAVING 子句3.1 使用 HAVING 过滤分组数据3.2 HAVING 和 WHERE 的区别 4. 实践任务4.1 创建一个销售表4.…...

编程日记 2025/8/19 14:06:46

为React组件库引入自动化测试：从零到完善的实践之路

为什么我们需要测试？ 我们的ReactTypeScript业务组件库已经稳定运行了一段时间，主要承载各类UI展示组件，如卡片、通知等。项目初期，迫于紧张的开发周期，我们暂时搁置了自动化测试的引入。当时团队成员对组件逻辑了如指…...

编程日记 2025/8/19 14:57:01

数据结构——算法复杂度

一、数据结构定义数据结构(Data Structure)是计算机存储、组织数据的⽅式，指相互之间存在⼀种或多种特定关系的数据元素的集合。没有⼀种单⼀的数据结构对所有⽤途都有⽤，所以我们要学各式各样的数据结构，如：线性表、树、图、哈希…...

编程日记 2025/8/20 4:20:32

Vue3响应式原理那些事

文章目录 1 响应式基础：Proxy 与 Reflect1.1 Proxy 代理拦截1.2 Reflect 确保 `this` 指向正确1.2.1 修正 `this` 指向问题1.2.2 统一的操作返回值1.3 与 Vue2 的对比2 依赖收集与触发机制2.1 全局依赖存储结构：WeakMap → Map → Set2.2 依赖收集触发时机2.3 依赖收集核心实…...

编程日记 2025/8/20 4:20:30

记9（Torch

目录 1、Troch 1、Troch 函数说明举例torch.tensor()torch.arange()创建张量创建一个标量：torch.tensor(42)创建一个一维张量：torch.tensor([1, 2, 3])创建一个二维张量：torch.tensor([[1, 2], [3, 4]])生成一维等差张量：语法&am…...

编程日记 2025/8/20 4:20:28

机器学习模型训练模块技术文档

一、模块结构概览 import numpy as np from sklearn.model_selection import cross_validate, learning_curve from sklearn.pipeline import make_pipeline from sklearn.svm import SVC from sklearn.neighbors import KNeighborsClassifier from sklearn.preprocessing imp…...

编程日记 2025/8/19 8:09:44

健康养生：从微小改变开始

养生不必大刀阔斧，几个微小改变，就能让健康慢慢扎根生活。晨起别急着洗漱，先花 5 分钟靠墙站立，拉伸脊柱、调整体态，唤醒身体。早餐把白米粥换成杂粮粥，搭配水煮蛋和一小碟凉拌黄瓜，营养更全面。…...

编程日记 2025/8/20 4:20:25

某信服EDR3.5.30.ISO安装测试（二）

一、物理机启动EDR 1、修复dracut 使用DiskGenius克隆虚拟磁盘到物理磁盘，将虚拟机移植到物理机，因为磁盘UUID变化等原因，首次默认启动失败，提示： Starting Dracut Emergency Shell... Warning:/dev/centos/root doe…...

编程日记 2025/8/20 4:20:23

Leetcode：回文链表

1、题目描述给定一个链表的头节点 head ，请判断其是否为回文链表。如果一个链表是回文，那么链表节点序列从前往后看和从后往前看是相同的。示例 1： 输入: head [1,2,3,3,2,1] 输出: true 示例 2： 输入: head [1,2] 输出: …...

编程日记 2025/8/20 4:20:21

IL2CPP 技术深度解析

IL2CPP 是 Unity 开发的高性能脚本后端，它将 .NET 的中间语言 (IL) 转换为 C 代码，再编译为原生平台二进制文件。以下是 IL2CPP 的全面技术剖析。一、架构设计原理 1. 整体编译流程 C# 源代码 → Roslyn 编译器 → IL (.NET DLL)→ IL2CPP 转换器 →…...

编程日记 2025/8/20 4:20:19

AI图片修复工具，一键操作，图片更清晰！

泛黄的老相册里藏着一座记忆博物馆，每张照片都是时光长河中的琥珀。祖父军装照上的折痕里藏着抗美援朝的故事，父母结婚照褪色的红唇映照着八十年代的风尚，童年抓拍照上模糊的身影正重演着我们成长的轨迹。这些承载着集体记忆的影像&#xff0…...

编程日记 2025/8/20 4:20:17

国内短剧 vs. 海外短剧系统：如何选择？2025年深度对比与SEO优化指南

在短剧市场爆发式增长的背景下，国内与海外短剧系统成为创业者与企业的热门选择。本文将从市场潜力、开发成本、内容创作、盈利模式及风险五大维度，结合最新行业数据与案例，深度解析两者的优劣势，助您做出最优决策。一、市场前…...

编程日记 2025/8/20 4:20:15

linux crash工具详解

crash 是 Linux 系统中用于分析内核转储文件（如 vmcore 或 kdump 生成的 dump 文件）的核心工具。它结合了调试符号和内核数据结构，能够直观地查看崩溃时的系统状态。以下是其详细使用方法及核心功能解析： 一、安装与准备 1. 安装…...

编程日记 2025/8/20 4:20:13

Scala day6(Class,field,Single Object)

Foreword【こんにちは】 Today, we continue to learn Scala Language, though the Scala isn’t easy for Begainner, Big Data Technology need Scala Language, Spark【Distributed Calculation FrameWork】is based on Scala Language designed. I know the learning road…...

编程日记 2025/8/20 4:20:12

不小心把当前的环境变量路径覆盖掉怎么办

起因配置环境变量（~/.bashrc）的时候没加:$PATH，导致 source ~/.bashrc之后只剩下刚刚配置的环境变量了。连vim都打不开解决添加临时环境变量export PATH/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:$PATH再重新修改…...

编程日记 2025/8/20 4:20:10

unity TMP字体使用出现乱码方框

参考文章： Unity 设置默认字体（支持老版及新版TMP）_unity tmp字体-CSDN博客原因是导入的项目package包没有连着tmp一起，这样在新工程中导入的tmp字体默认的是tmp自己的，解决方案就是替换成自己需要的tmp字体就行替换…...

编程日记 2025/8/20 4:20:09

14.网络钓鱼实战

网络钓鱼实战第一部分：网络钓鱼攻击详解第二部分：设计与分析钓鱼攻击第三部分：钓鱼攻击防范实践总结目标: • 深入理解网络钓鱼攻击的实施过程 • 掌握设计和识别钓鱼攻击的技巧 • 通过模拟实践提升防范钓鱼攻击的能力第一部分&#xf…...

编程日记 2025/8/22 4:48:51

pyqt写一个单片机配置界面

已经实现以下功能 1.可以选择单片机架构 2.选择完单片机架构后第二个框可以选择常见单片机型号 3.选择完常见单片机型号后第三个框可以选择内部资源如adc等（可以选择多个内部资源）4.选择完内部资源如adc等（可以选择多个内部资源）后…...

编程日记 2025/8/20 4:20:05

「Mac畅玩AIGC与多模态20」开发篇16 - 使用结构化输出字段控制后续流程示例

一、概述本篇介绍如何在工作流中使用结构化输出字段作为判断依据，实现前后节点联动控制。通过执行 LLM 节点输出结构化 JSON，并使用其中的字段驱动后续判断节点执行不同路径，开发人员将掌握结构化字段在工作流中的引用方式与分支控制技巧。…...

编程日记 2025/8/20 4:20:03

Unity-Shader详解-其四

今天我们来聊Unity特有的表面着色器以及很少提到的几何着色器。表面着色器在前文关于光照的计算中，我们学会了很多：我们学习了一系列光照模型，比如专门针对漫反射的兰伯特模型和改进的半兰伯特模型，又比如由高光、漫反射和环境…...

编程日记 2025/8/20 4:20:02

Lua 元表和元方法

元表(Metatable)和元方法(Metamethod)是Lua中实现面向对象编程、操作符重载和自定义行为的重要机制。元表元表是一个普通的Lua表，可以附加到另一个表上，用于定义或修改该表的行为。每个表都可以有自己的元表。 setmetatable(tab,metatab) 将metatab设…...

编程日记 2025/8/20 4:20:00

GESP2024年3月认证C++八级( 第二部分判断题（6-10））

海伦公式参考程序： #include <iostream> #include <cmath> // 引入cmath库以使用sqrt函数using namespace std;double calculateTriangleArea(int a, int b, int c) {// 使用海伦公式double s (a b c) / 2.0; // 半周长return sqrt(s * (s - a) *…...

编程日记 2025/8/22 1:25:45

Nacos源码—3.Nacos集群高可用分析一

大纲 1.Nacos集群的几个问题 2.单节点对服务进行心跳健康检查和同步检查结果 3.集群新增服务实例时如何同步给其他节点 4.集群节点的健康状态变动时的数据同步 5.集群新增节点时如何同步已有服务实例数据 1.Nacos集群的几个问题问题一：在单机模式下&#xff…...

编程日记 2025/8/20 3:06:51

信息系统项目管理师-软考高级（软考高项）2025最新（九）

个人笔记整理---仅供参考第九章项目范围管理 9.1管理基础 9.2项目范围管理过程 9.3规划范围管理 9.4收集需求 9.5定义范围 9.6创建WBS 9.7确认范围 9.8控制范围...

编程日记 2025/8/20 7:23:09

DeepSeek学术论文写作全流程指令

一、选题与领域界定研究热点捕捉指令： “在[研究领域]中，现有文献对[具体问题]的[哪方面]研究不足？基于近5年文献归纳3个待突破方向，需结合高频关键词和交叉学科维度。” 示例： “在深度学习医疗影像分析中，现有文献对小样本训练的泛化性研究不足？基于2019-2023年顶会…...

编程日记 2025/8/20 1:39:43

【ArUco boards】标定板检测

之前定位用的Charuco标定板做的（https://blog.csdn.net/qq_45445740/article/details/143897238），因为实际工况中对标定板的尺寸有要求，大概是3cm*2cm这个尺寸，加上选用的是ChAruco标定板，导致每一个aruco码…...

编程日记 2025/8/20 4:19:56

2025 年 408 真题及答案

2025 年 408 真题历年408真题及答案下载直通车 1、以下 C 代码的时间复杂度是多少？（） int count 0; for (int i0; i*i<n; i)for (int j0; j<i; j)count;A O(log2n)B O(n)C O(nlogn)D O(n2) 2、对于括号匹配问题，符号栈…...

编程日记 2025/8/20 4:19:54

设计模式每日硬核训练 Day 18：备忘录模式（Memento Pattern）完整讲解与实战应用

🔄 回顾 Day 17：中介者模式小结在 Day 17 中，我们学习了中介者模式（Mediator Pattern）： 用一个中介者集中管理对象之间的通信。降低对象之间的耦合，适用于聊天系统、GUI 控件联动、塔台调度等…...

编程日记 2025/8/22 4:34:11

ByteArrayOutputStream 类详解

ByteArrayOutputStream 类详解 ByteArrayOutputStream 是 Java 中用于在内存中动态写入字节数据的输出流(ByteArrayOutputStream和ByteArrayInputStream是节点流)，位于 java.io 包。它不需要关联物理文件或网络连接，所有数据都存储在内存的字节数组中。 1. 核心特性内存缓冲…...

编程日记 2025/8/22 11:36:03

Linux中web服务器的部署及优化

前言：Nginx 和 Apache HTTP Server 是两款非常流行的 Web 服务器。 Nginx 简介：Nginx 是一款轻量级的高性能 Web 服务器、反向代理服务器以及电子邮件（IMAP/POP3）代理服务器。由俄罗斯人伊戈尔・赛索耶夫开发，其在处…...

编程日记 2025/8/19 22:43:14

使用Mathematica绘制Sierpinski地毯

在Mathematica中内置的绘制Sierpinski地毯的函数： SierpinskiCurve[n] gives the line segments representing the n-step Sierpiński curve. 注意，直接运行这个函数，返回的是Line对象，例如： 运行如下代码&#xf…...

编程日记 2025/8/20 4:19:48