直接在nginx中用server_name匹配无www域名并return 301跳转至带www的https url；需同时配置80和443端口，避免rewrite、$scheme及dns解析等问题。
<p>直接在 Nginx 配置中为不带 www 的域名设置 301 重定向，核心是用 <strong>server_name</strong> 匹配无 www 域名，再用 <strong>return 301</strong> 跳转到带 www 的完整 URL。</p>
<h3>基础写法（推荐）</h3>
<p>这是最简洁、高效的方式，适用于主站域名（如 example.com → www.example.com）：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting"><img
src="https://img.php.cn/upload/skill/000/000/081/179116929868126.jpg" alt="Nginx Hosting" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting" class="overflowclass">Nginx Hosting</a>
<p class="overflowclass">通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。</p>
</div>
<a rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<font color="#666">
<pre class="brush:php;toolbar:false;">
server {
listen 80;
server_name example.com;
return 301 https://www.example.com$request_uri;
}
说明：
• server_name example.com 精确匹配不带 www 的请求
• return 301 是强制跳转，比 rewrite 更快、更语义明确
• $request_uri 保留原始路径和查询参数（如 /a/b?x=1 → /a/b?x=1）
HTTPS 场景下必须同时处理 443 端口
如果站点启用了 HTTPS，仅配置 80 端口无法覆盖直接访问 https://example.com 的情况。需单独加一个 HTTPS server 块：
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
return 301 https://www.example.com$request_uri;
}
注意：
• 必须提供有效的证书，否则该 server 块会因 SSL 加载失败而无效
• 不要省略 ssl 配置，否则 Nginx 启动会报错
避免常见陷阱
- 不要混用 rewrite 和 return：rewrite + permanent 也能实现 301，但 return 更轻量、无正则开销，且不会触发 location 重匹配
- 不要写成 $scheme://www... 形式：$scheme 在 HTTP/HTTPS 混合场景下可能出错（比如反向代理后 scheme 不准确），显式写死 https:// 更可靠
- 确保 www 版本的 server 已正确配置并监听对应端口：否则跳过去会 502 或连接拒绝
- 检查 DNS 解析：example.com 和 www.example.com 都需解析到同一台服务器 IP，否则跳转后无法访问
批量处理多个域名（可选）
若托管多个站点，可用 map 指令统一管理跳转规则：
map $host $redirect_to {
example.com www.example.com;
blog.example.com www.blog.example.com;
default "";
}
server {
listen 80;
server_name example.com blog.example.com;
if ($redirect_to) {
return 301 https://$redirect_to$request_uri;
}
}
说明：
• map 提前定义跳转目标，便于维护
• if 块配合使用（注意：if 在 location 外可用，此处安全）
• default "" 可防止未匹配域名意外跳转
