Nginx Proxy Manager Redirection Host 实战指南：域名跳转的配置、原理与最佳实践-北京尧图网络

Nginx Proxy Manager Redirection Host 实战指南域名跳转的配置、原理与最佳实践【免费下载链接】nginx-proxy-managerDocker container for managing Nginx proxy hosts with a simple, powerful interface项目地址: https://gitcode.com/GitHub_Trending/ng/nginx-proxy-managerRedirection Host重定向主机是 Nginx Proxy Manager 中用于将访问请求从旧域名「接力」到新域名的核心功能。本文以项目内置的官方帮助文档RedirectionHosts.md为骨架结合后端实现、Nginx 模板与前端表单源码完整讲解 Redirection Host 的概念、配置字段、底层工作流程与典型应用场景帮助你掌握用 Nginx Proxy Manager 完成站点迁移与链接续接的实战能力。Redirection Host 是什么Redirection Host 会将来自「入口域名」的请求重定向把访问者推送到另一个域名。根据官方帮助文档的描述它是最直接、最常用的一类 Nginx Proxy Manager 主机配置。举个直观的例子当访问者请求https://old-domain.com时Redirection Host 会让浏览器或客户端立刻转向https://new-domain.com全程由 Nginx 返回跳转响应完成不需要任何后端应用参与。这与 Proxy Host把请求转发给后端服务和 404 Host展示错误页有本质区别Proxy Host把请求转发给内网或上游服务ProxyHosts.md 中提到它提供可选的 SSL 终止能力是 NPM 中最常见的配置类型Dead Host404 Host固定展示 404 页面用于告诉搜索引擎「该域名的页面已不存在」Redirection Host把请求跳转到另一个域名浏览器地址栏会发生变化。最常见的应用场景域名更换后的链接续接官方帮助文档明确指出了 Redirection Host 最典型的使用动机最常见的使用原因是当你的网站更换域名后仍然有来自搜索引擎或引荐来源referrer的链接指向旧域名。在真实运营中这一场景通常包含三层诉求Redirection Host 恰好都能覆盖保留 SEO 权重搜索引擎索引中仍存在大量旧域名的收录链接直接停掉旧域名会导致这些权重全部丢失。通过 301 永久重定向可以让搜索引擎把旧链接的权重平滑转移给新域名留住引荐流量外部网站、社交媒体、历史邮件中散落的旧链接点击后仍应到达你的新站点而不是得到「无法访问」的报错降低用户流失收藏夹里保存了旧域名书签的老用户跳转后能自动被引导到新站无需手动寻找新地址。在界面中创建 Redirection HostRedirection Host 的创建入口位于 Nginx Proxy Manager 管理后台的Hosts → Redirection Hosts页面。点击「Add Redirection Host」后会弹出表单对话框其实现位于 RedirectionHostModal.tsx。该表单分为三个页签Details详情、SSL、Advanced高级。Details 页签配置跳转本身这一页签包含最核心的四个字段全部为必填或常用项字段取值/默认值说明Domain Names任意域名支持通配符入口域名列表即「收到请求后触发跳转」的域名。前端使用DomainNamesField组件且允许通配符域名isWildcardPermittedForward Schemeauto默认/http/https跳转时使用的协议。前端下拉框默认选中autoForward Domain Name目标域名1255 字符访问者将被跳转到的目标域名如example.comForward HTTP Code301默认/300/302/303/307/308跳转返回的 HTTP 状态码默认 301永久重定向此外还有两个开关选项Preserve Path保留路径开启后跳转时保留原始请求的路径部分对应模板中的$request_uri例如old.com/docs会跳转到new.com/docsBlock Exploits拦截攻击开启后启用 Nginx Proxy Manager 内置的常见攻击拦截规则。SSL 页签为入口域名启用 HTTPSSSL 页签使用SSLCertificateField支持「新建证书」快捷入口与SSLOptionsFields组件包含SSL Certificate为入口域名选择已有的 SSL 证书或点击新建后端会在保存时自动为该域名签发证书详见下文「创建流程」Force SSL强制将 HTTP 请求重定向到 HTTPSHTTP/2 Support为入口站点启用 HTTP/2 协议HSTS Enabled启用 HSTS 响应头告知浏览器只能通过 HTTPS 访问HSTS SubdomainsHSTS 同时作用于该域名的所有子域名。Advanced 页签自定义 Nginx 配置Advanced 页签提供「Custom Nginx Configuration」文本框对应后端字段advanced_config。这里的配置会被注入到最终生成的 server 块中适合补充无法通过表单表达的定制逻辑。核心参数对跳转行为的影响理解每个参数最终如何落到 Nginx 配置上能帮助你更准确地选择组合。NPM 通过模板 redirection_host.conf 渲染出每个 Redirection Host 的实际 server 块跳转的核心逻辑只有几行location / { {% if preserve_path 1 or preserve_path true %} return {{ forward_http_code }} {{ forward_scheme }}://{{ forward_domain_name }}$request_uri; {% else %} return {{ forward_http_code }} {{ forward_scheme }}://{{ forward_domain_name }}; {% endif %} }由此可以看出forward_http_code直接作为 Nginxreturn指令的状态码输出。选择301永久适合域名正式更换、希望搜索引擎更新索引的场景选择302临时或307临时保留请求方法则适合短期活动页、A/B 测试等不希望搜索引擎「记死」新地址的场景308是 301 的「保留请求方法」版本preserve_path开关决定目标 URL 是否拼接$request_uri。不开启时所有请求都跳到目标域名根路径开启后路径、查询参数都会原样带过去对「目录级迁移」场景至关重要forward_scheme控制跳转目标的协议。需要特别说明的是旧版本中该字段的默认值是$scheme跟随入口请求的协议而迁移脚本 20251111090000_redirect_auto_scheme.js 已将默认值改为auto并将存量数据中值为$scheme的记录统一迁移为auto这代表新版本更推荐让 NPM 自动决策目标协议。除了跳转逻辑模板还会按配置包含多个可复用片段_listen.conf监听端口、_certificates.confSSL 证书、_assets.conf静态资源、_exploits.conf攻击拦截、_hsts.confHSTS 头、_forced_ssl.conf强制 HTTPS、_hsts_map.confHSTS 映射。每个 Redirection Host 还会生成独立的访问日志与错误日志access_log /data/logs/redirection-host-{{ id }}_access.log standard; error_log /data/logs/redirection-host-{{ id }}_error.log warn;模板最后通过include /data/nginx/custom/server_redirect[.]conf;支持在 server 块中追加自定义配置文件这是 Advanced 配置之外的另一种扩展途径。后端工作流程从保存到生效Redirection Host 的完整生命周期由 internal/redirection-host.js 驱动。以「创建」为例请求会依次经过以下环节权限校验调用access.can(redirection_hosts:create, data)未授权用户直接拒绝域名占用检查对提交的每个域名调用internalHost.isHostnameTaken(domainName)若已被其他主机占用则抛出ValidationError例如${hostname} is already in use保证全站域名唯一。更新时会排除自身传入thisData.id数据清洗与入库通过internalHost.cleanSslHstsData规整 SSL/HSTS 相关字段写入redirection_host表advanced_config缺省时补为空字符串证书快速签发可选若表单选择了「新建证书」certificate_id new则调用internalCertificate.createQuickCertificate自动签发证书再回写certificate_id生成 Nginx 配置调用internalNginx.configure(redirectionHostModel, redirection_host, row)用模板渲染并写入实际生效的配置文件写入审计日志以object_type: redirection-host、action: created记录完整元数据。「更新」流程与之类似额外包含 ID 一致性校验防止并发下改错记录并在更新后重新渲染配置「启用」会生成配置「禁用」与「删除」则会调用internalNginx.deleteConfig删除配置并reload()使 Nginx 热重载同样都会写入对应的审计日志enabled/disabled/deleted。数据模型与数据库结构redirection_host表由 models/redirection_host.js 中的 Objection.js 模型映射其布尔字段集合完整反映了可配置项const boolFields [ is_deleted, enabled, preserve_path, ssl_forced, block_exploits, hsts_enabled, hsts_subdomains, http2_support, ];domain_names与meta以 JSON 列存储且在插入/更新前会被自动排序。模型还定义了与userowner拥有者和certificate证书的两条关联关系默认加载[certificate, owner]这也是列表页展示「所属用户」与「关联证书」的数据来源。getAll接口支持按domain_names模糊搜索like %query%列表默认按域名排序。实战建议域名正式更换用 301临时切换用 302/307避免因状态码选择不当导致搜索引擎权重迁移失败迁移目录级页面务必开启 Preserve Path关闭状态下所有旧链接都会落到新站首页对 SEO 反而是负优化为入口域名配置 SSL 证书如果旧域名仍承载 HTTPS 流量建议在 SSL 页签选择证书或直接新建配合 Force SSL 保证跳转链路全程加密善用 HSTS 与 Block Exploits旧域名停用后仍可能被恶意扫描开启这两项可以减少暴露面通过审计日志追踪变更每次创建、修改、启停都有redirection-host类型的审计记录多管理员环境出现误操作时可快速定位责任人与变更内容域名占用冲突Redirection Host、Proxy Host 等所有主机共享域名空间创建时若提示is already in use说明该域名已被其他主机使用需先释放或改用子域名。总结Redirection Host 是 Nginx Proxy Manager 中用于「域名级跳转」的一等公民能力前端表单负责收集入口域名、目标域名、协议、状态码与路径策略后端在保存时完成权限校验、域名唯一性检查、证书签发与配置生成最终由 redirection_host.conf 模板渲染出精简的return跳转指令。掌握它的参数语义与底层流程你就能在站点迁移、品牌更名、引荐流量续接等场景中用几分钟完成原本需要手写 Nginx 配置的跳转需求。【免费下载链接】nginx-proxy-managerDocker container for managing Nginx proxy hosts with a simple, powerful interface项目地址: https://gitcode.com/GitHub_Trending/ng/nginx-proxy-manager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Nginx Proxy Manager Redirection Host 实战指南：域名跳转的配置、原理与最佳实践

相关推荐

CANN/GE图切分保存接口

开题报告连遭三次打回？测完7类AI工具，我整理出这份分阶段选型指南

OpenCore Legacy Patcher：四步把老 Mac 升级 macOS 装完（附 U 盘容量与耗时参考）

更多资讯

HyperFrames 完整能力清单：OpenMontage 中从网站到确定性视频的 24 项核心能力全解

职场成长记录：作品集与案例库构建指南

实时语音处理技术：核心模块与工程优化实践

COMSOL折叠功能在多物理场仿真中的应用与优化

双有源桥DAB仿真与闭环控制设计实践

Preact Query 的 QueryClientProviderProps 类型详解：从 Props 到上下文注入的完整原理

今日更新

CopilotKit Vue Demo 与 React Demo 的 Parity 实现指南：路由、运行时端点与交互语义的全框架对齐

Harbor RBAC 实战：db_auth 模式下非管理员用户管理项目成员的完整验证与权限模型解析

STM32平衡车纯平衡程序从拆包到参数整定的完整调试指南

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？