什么是 .well-known 文件夹?
本快速指南回答域名控制验证(DCV)过程中最常见的问题之一:什么是 .well-known 文件夹?你还将了解如何在服务器上创建 .well-known 文件夹,以及为何需要它。
什么是 .well-known 文件夹?
.well-known 文件夹是 Web 服务器上一个标准化的目录,用于存放定义特定协议元数据或配置的文件。它常用于 SSL 证书验证、安全相关设置,以及其他协议专属文件,如 security.txt 或 robots.txt。
部分服务器会自动创建 .well-known 文件夹,但有时你需要手动添加。该目录充当一种基于 Web 的协议,用于在发起请求前获取主机的相关站点元数据。
.well-known 目录里该放什么?
要通过 HTTP 方式确认你是域名所有者,需要将一个 TXT 文件上传到网站与服务器上类似如下位置:
http://mywebsite.com/.well-known/pki-validation/HashFileName.txt
从 URL 路径可见,你应将该文件放在域名文档根目录下的 .well-known 文件夹及其 pki-validation 子文件夹中。
在选择 HTTP 方式订购 SSL 证书后,你可以下载验证文件。哈希文件名是一串随机字符,必须按 CA 提供的原样上传,不得更改名称或内容。
如何创建 .well-known 文件夹?
要创建该文件夹,你需要通过 SFTP 客户端、虚拟主机控制面板或其他合适方式访问服务器。以下是在最主流平台上创建 .well-known 文件夹的方法。
在基于 Linux 的服务器上创建
以下步骤适用于 Ubuntu、Debian 与 CentOS 服务器。
1. 进入网站根目录
2. 创建名为".well-known"的目录
3. 在其中再创建名为"pki-validation"的文件夹
4. 将 TXT 文件上传到"pki-validation"目录
在 cPanel 中创建
1. 登录 WHM(若没有则跳过此步)
2. 找到并登录你域名的 cPanel 账户
3. 点击"File Manager"
4. 选择"Web Root (public_html/www)"并点击"Go"
5. 创建名为".well-known"的新文件夹
6. 在其中再创建"pki-validation"子文件夹
7. 将 TXT 文件上传到"pki-validation"文件夹
在 Plesk 中创建
1. 使用"File Manager"选项,在右侧菜单进入"Files"区
2. 在域名的默认文档根目录(Plesk 中为"httpdocs")创建".well-known"文件夹
3. 选择"New"→"Create Directory"创建文件夹
4. 在".well-known"文件夹内创建"pki-validation"子文件夹
5. 使用"Upload"按钮将验证 TXT 文件添加到"pki-validation"文件夹
在 Windows IIS 服务器上创建
Windows 服务器不允许在文件夹名中使用点号,因此需按以下步骤:
1. 进入 C 盘
2. 创建名为"well-known"的新文件夹
3. 在其中再创建名为"pki-validation"的文件夹
4. 将 TXT 文件上传到"pki-validation"文件夹
5. 打开服务器上的 IIS 管理器
6. 右键点击你的网站,选择"Add Virtual Directory"
7. 在 Alias 处填写".well-known"
8. 在"Physical Path"处输入"well-known"文件夹路径,例如 C:\well-known
9. 点击"OK"创建该别名
在 WordPress 中创建
在 WordPress 中创建 .well-known 文件夹有三种方式:使用专用插件、通过虚拟主机面板,或通过 FileZilla 等 SFTP 客户端。不建议使用插件,因为它可能随时间引发兼容性与安全问题。若你使用 cPanel,请按上文步骤创建;若没有 cPanel,则使用 SFTP 客户端,连接服务器后在 ~/public 文件夹中寻找".well-known"目录,若不存在则右键点击 public 文件夹选择"Create directory"并命名为".well-known"。
在 AWS 中创建
1. 使用 bash 命令在 AWS EC2 实例中创建 .well-known 文件夹:
mkdir -p .well-known/pki-validation
2. 将验证文件放入 pki-validation 子文件夹:
nano .well-known/pki-validation/HashFileName.txt
在 macOS X Server 中创建
通过内置 FTP 客户端或命令行界面(CLI)连接服务器。
FTP 方式:按 Command + K,在"Connect to Server"窗口输入 FTP 服务器地址(如 ftp://ftp.yourdomain.com)并连接,输入用户名密码后找到域名根目录,创建".well-known"目录,在其中再建"pki-validation"文件夹,最后上传 TXT 文件。
命令行方式:使用 SSH 与安全复制协议上传 TXT 文件:
scp AC3E5D6I8G12935LSJEIK.txt your_username@hostname.tld:/Library/WebServer/Documents/.well-known/pki-validation
其中 AC3E5D6I8G12935LSJEIK.txt 是验证文件名,your_username 是服务器账户用户名,hostname.tld 是 Mac OSX 服务器主机名,/Library/WebServer/Documents/ 是文档根目录默认值。
对所有服务器类型,若操作正确,你应能在任意浏览器打开如下 URL 并看到哈希码及"comodoca.com":
http://mywebsite.com/.well-known/pki-validation/HashFileName.txt
常见问题
服务器上已存在 .well-known 文件夹怎么办?
若服务器上已存在该文件夹,打开它,创建 pki-validation 子文件夹并上传文件即可。
为何 .well-known 目录受保护?
由于是公共目录,.well-known 文件夹常被保护,以防黑客存放并分发勒索软件与钓鱼页面,你可能需要更改文件权限才能访问。
如何移动 .well-known 目录?
.well-known 文件夹必须始终留在公共目录中,若移到别处,你将无法通过 HTTP 方式完成 SSL 验证。
应该删除 well-known 文件夹吗?
视情况而定。若 SSL 证书有效期为一年且无需重新验证,签发后安全删除该文件夹不会影响任何东西。但若你使用的是多年期 SSL 订阅并选择了基于 HTTP 的验证,该文件夹是每年重新验证所必需的——删除虽不会立即引发问题,但续期时 CA 将无法验证所有权,可能导致续期延迟甚至失败。
总结
HTTP/HTTPS 验证流程相当直接。只要严格按上述步骤操作,你很快就能拿到 SSL 证书。了解 .well-known 文件夹是什么以及如何在各服务器上创建它,你续期或新申请证书都会快得多。