* 本文凡使用变量 httpContextAccessor 或 _httpContextAccessor 的地方都需要需要注入 Microsoft.AspNetCore.Http.IHttpContextAccessor

* 在视图（view）中应以 ViewContext 类引出

获取当前页面网址：

using Microsoft.AspNetCore.Http.Extensions;
string url = Request.GetDisplayUrl();

获取当前访问的域名和端口：

获取来源：

Request.GetTypedHeaders().Referer

判断 Scheme 是否为 https：

Request.IsHttps

获取客户端IP和端口、服务器IP和端口：

获取浏览器用户代理（UserAgent）：

httpContextAccessor.HttpContext.Request.Headers[HeaderNames.UserAgent];

获取当前请求的唯一标识：

httpContextAccessor.HttpContext.TraceIdentifier

返回结果：80000564-0002-f700-b63f-84710c7967bb

用途：可作为生成随机数的种子。

获取客户端IP地址：

httpContextAccessor.HttpContext.Connection.RemoteIpAddress

获取当前项目根目录磁盘路径：

AppContext.BaseDirectory // 以“\”结尾

注意：此路径到项目根目录，而非网站根目录，网站根目录请自行追加，默认为 wwwroot\

编码/解码：（参数和返回值均为 string?）

using System.Net;
WebUtility.HtmlEncode(myString)
WebUtility.HtmlDecode(myString)
WebUtility.UrlEncode(myString)
WebUtility.UrlDecode(myString)

更多：https://xoyozo.net/Blog/Index/Core

路由器模式：使用 mesh 主体拨号，缺点是由于 mesh 主体不适合放入弱电箱，那么就有两条网线连接到弱电箱（不需要有线回程或不需要接交换机的忽略此缺点）。

AP 模式：适合已有拨号路由器的环境，mesh 路由器主体与分身之间用 AP 模式连接（小米路由器 Mesh 不支持 AP 模式，估计跟“不分子母”有关）；

布线方案：

如果 mesh 作拨号路由器功能够用，那么直接使用路由器模式。家庭新装修的朋友建议在合适的位置（如客厅电视机柜）预留两条网线到弱电箱，一条用于连接光猫到 Mesh 主体，再用另一条有线回程到弱电箱的交换机，无线回程者随意。

如果选择其它路由器作拨号路由器（如软路由，或看中小米路由器强大的 App 功能又不想用小米 mesh），那么 mesh 路由器使用 AP 模式，本体接任意墙壁网口即可。建议关闭拨号路由器的 WiFi，并考虑带机量。

顺便提一下 AC+AP 方案的布线：

同样的，如果无其它拨号路由器，那么可以选择路由/AC/PoE 一体机，配合 AP 使用；如果有指定的拨号路由器，那么选择单独的 AC 控制器 + 交换机 + AP 即可。

AC 和 AP 可二层组网、三层组网，可直连式组网、旁挂式组网。

旁挂组网时，如果 AC 控制器选择百兆网口，不会影响千兆交换机和 AP 的传输效率，因为 AC 控制器仅用来管理 AP，不进行数据传输。

AP 有面板式、吸顶式、户外等可选，PoE 或 DC 供电，有胖瘦之分。胖 AP 有独立管理后台，瘦 AP 无管理后台，必须与 AC 配合使用。

据说：TL-AC100 支持快速漫游，TL-AC300 支持无缝漫游。

确保磁盘未满，否则会提示各种无法连接。

1. 在“小米WiFi”App 中开启对应路由器的“SAMBA 协议”（工具箱 - 更多工具 - SAMBA）。

2. 在“小米WiFi”App 中开启相应电脑或设备的“全盘访问”。

3. 通过 miwifi.com 下载安装 PC 客户端。

4. 打开“此电脑”，“映射网络驱动器”或“添加一个网络位置”，填写路由器的地址和目录，如：“\\192.168.31.1\下载”。

5. 如果上一步无法成功添加，那么首先需要检查 samba 服务器是否正常，可以在 iPhone 上安装“Remote File Manager”来验证。

6. 如果 iPhone 连接正常，那么在电脑上打开“本地组策略编辑器”（命令行：gpedit.msc），在“计算机配置 - 管理模板 - 网络 - Lanman 工作站”右侧，双击“启用不安全的来宾登录”，改为“已启用”。Win7 用户参考此文。

注意：电脑必须运行 PC 客户端才能访问小米路由器硬盘。

1. 微信的 H5 页面前端引导到：

   https://api.magcloud.cc/magshare/{siteId}?jump_url={jump_url}&content_url={content_url}

   各参数含义见官方文档：http://doc.magcloud.net/325339

   content_url 地址（一般仍为活动页面）接收参数 magshareredirect，值为 1 则跳转到自定义的引导页。
   

2. 自定义引导页按 iOS 和安卓显示图文和箭头，引导用户点击右上角菜单，在浏览器中打开。

3. 在浏览器 H5 中引导打开：

   {siteId}://pagejump?jump_url={jump_url}

   各参数含义见第 1 步中的文档。

   这里涉及一个“若未安装则引导安装”的过程，可以选择下方合适的一种方式实现：

• A 标签的 href 填入下载地址，onclick 事件 location 到 App

• onclick 事件 location 到 App，再用 setTimeOut location 到下载地址

• 若仍无法实现预期效果，可以在弹出层中放置“未安装，前往下载”和“已安装，立即打开”两个按钮，让用户自己选择

4. 若下载地址为应用宝，那么在 iOS 中可能会出现“打开 App 后继而自动打开 App Store”的情况，可以自建中转的 App 介绍页引导到 App Store 或应用宝。

5. 分别实现微信和 MAGAPP 客户端的分享
   

Orbi 型号命名规则：

套装：RBK

主体：RBR

分身：RBS、RBW 等

套装对比：

分体价格：

• 本体 RBR20：599
  

• 本体 RBR40：999

• 本体 RBR50：999 活动
  

• 分身 RBS20：699

• 分身 RBW30 插墙：999

• 分身 RBS40：1099
  

• 分身 RBS50：1449
  

• 分身 RBS50Y 室外：未知
  

价格采自2019年8月

主体/分身 匹配：

• 分身 RBS20 可作为 RBR20, RBR40 or RBR50 的卫星

• 分身 RBW30 可作为 RBR40 or RBR50 的卫星

• 分身 RBS40 可作为 RBR40 or RBR50 的卫星

• 分身 RBS50 可作为 RBR50 的卫星

• 分身 RBS50Y 可作为 RBR50 or RBR40 or SRR60 的卫星
  

• RBK13 = 1个 RBR10 + 2个 RBS10

• RBK20 = 1个 RBR20 + 1个 RBS20

• RBK23 = 1个 RBR20 + 2个 RBS20

• RBK30 = 1个 RBR40 + 1个 RBW30
  

• RBK33 = 1个 RBR40 + 2个 RBW30

• RBK40 = 1个 RBR40 + 1个 RBS40

• RBK43 = 1个 RBR40 + 2个 RBS20
  

• RBK44 = 1个 RBR40 + 3个 RBS20

• RBK50 = 1个 RBR50 + 1个 RBS50
  

• RBK53 = 1个 RBR50 + 2个 RBS50

扩展阅读：Mesh 路由器有线回程布线方案

* 以上规则仅针对虚拟商品

“✘”是指：不能展现任何有购买、支付的功能、页面、按钮，即使实际上它们都不可使用；也不得引导至外部网站或 APP 来实现支付功能。

“虚拟商品”包括但不限于购买：会员、月卡、代金券、置顶服务。

“引导行为”包括但不限于引导至：App、公众号、H5、个人号、网站、安卓手机。

参：微信小程序 - 运营规范 - 虚拟支付行为

微信内规则大部分基于 iOS 规则。

任何不被允许的虚拟支付只要能够通过内购实现，那么都变得允许，只不过到手只剩 70%。

本文介绍 ASP.NET 的 Swagger 部署，若您使用 ASP.NET Core 应用程序，请移步 ASP.NET Core Web API Swagger 官方文档：

https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/first-web-api?view=aspnetcore-5.0&tabs=visual-studio

https://github.com/domaindrivendev/Swashbuckle.AspNetCore

安装

NuGet 中搜索安装 Swashbuckle，作者 Richard Morris

访问

http://您的域名/swagger

配置

显示描述

以将描述文件（xml）存放到项目的 bin 目录为例：

1. 打开项目属性，切换到“生成”选项卡

2. 在“配置”下拉框选择“所有配置”

3. 更改“输出路径”为：bin\

4. 勾选“XML 文档文件”：bin\******.xml，（默认以程序集名称命名）

5. 打开文件：App_Start/SwaggerConfig.cs

6. 取消注释：c.IncludeXmlComments(GetXmlCommentsPath());

7. 添加方法：

   public static string GetXmlCommentsPath()
   {
       return System.IO.Path.Combine(
           System.AppDomain.CurrentDomain.BaseDirectory,
           "bin",
           string.Format("{0}.xml", typeof(SwaggerConfig).Assembly.GetName().Name));
   }

   其中 Combine 方法的第 2 个参数是项目中存放 xml 描述文件的位置，第 3 个参数即以程序集名称作为文件名，与项目属性中配置一致。

如遇到以下错误，请检查第 2、3、4 步骤中的配置（Debug / Release）

500 : {"Message":"An error has occurred."} /swagger/docs/v1

使枚举类型按实际文本作为参数值（而非转成索引数字）

1. 打开文件：App_Start/SwaggerConfig.cs

2. 取消注释：c.DescribeAllEnumsAsStrings();

ASP.NET Web API 返回 Unauthorized 401 未授权代码：

return Unauthorized(new AuthenticationHeaderValue("getUserInfo"));

响应的头部信息是这样的：

以微信小程序中获取 header 的 www-authenticate 为例，不同操作系统中获取的 key 是不一样的：

iOS：

Android：

微信开发者工具：

所以，小程序端获取该值，暂时使用以下代码吧：

let www_authenticate;
if (!www_authenticate) {
	www_authenticate = res.header['Www-Authenticate']; // iOS
}
if (!www_authenticate) {
	www_authenticate = res.header['WWW-Authenticate']; // Android / 微信开发者工具
}
if (!www_authenticate) {
	www_authenticate = res.header['www-authenticate']; // ASP.NET Web API 原始输出
}
if (!www_authenticate) {
	www_authenticate = res.header['WWW-AUTHENTICATE']; // 其它情况
}

完整操作步骤如下：

1. 安装 NuGet 包：Microsoft.AspNet.Web.Optimization

2. 打开 Views 目录（如果是应用于区域，则为区域的 Views 目录）中的 web.config，在 <namespaces /> 节点中添加

   <add namespace="System.Web.Optimization" />

3. 在 App_Start 目录中创建类文件 BundleConfig.cs，更改其命名空间为应用程序的默认命名空间（即移除 .App_Start），创建方法：

   public static void RegisterBundles(BundleCollection bundles)
   {
       bundles.Add(new StyleBundle("~/虚拟路径（不能有点）").Include("~/CSS文件路径"));
       bundles.Add(new ScriptBundle("~/虚拟路径（不能有点）").Include("~/JS文件路径"));
   }

   虚拟路径应避免与页面访问路径相同。Include 可包含多个文件，效果是合并输出，注意引用的顺序。

4. 打开 Global.asax，在 Application_Start() 事件中添加代码

   BundleTable.EnableOptimizations = true; // 该设置使在开发模式中实现压缩代码，不设置则仅在发布后压缩代码
   BundleConfig.RegisterBundles(BundleTable.Bundles);

5. 视图页面中引用样式表或脚本

   @Styles.Render("~/CSS虚拟路径")
   @Scripts.Render("~/JS虚拟路径")

   使用 Render 的好处是，ASP.NET 会自动给引用地址加上参数，可在更改脚本或样式表内容后更改这些参数使浏览器缓存立即失效。

如果你的项目中已经安装并使用 Bundle，那么只需要参考第 4 步，将 BundleTable 的 EnableOptimixations 设为 true。

以下是一些常见异常的解决方法：

The name 'Styles' does not exist in the current context

The name 'Scripts' does not exist in the current context

解决：参步骤 2。

引用的样式表或脚本不存在（报 404 错误）

解决：步骤 3 中的虚拟路径不规范。